/godot-master

TPS / hybrid gunplay core

Shared combat theory for this skill (TPS, cover, soft-lock). FPS viewmodel/recoil polish → godot-genre-shooter-fps.

WeaponData (never hardcode in nodes)

class_name WeaponData extends Resource

@export var damage: int = 20
@export var fire_rate: float = 0.1
@export var magazine_size: int = 30
@export var range: float = 100.0
@export var is_hitscan: bool = true
@export var projectile_scene: PackedScene

Balance in .tres, not scattered @export on scene logic.

Hitscan vs projectile

Hitscan must run in _physics_process with PhysicsDirectSpaceState3D.intersect_ray, not _process or Area3D overlap.

var query := PhysicsRayQueryParameters3D.create(origin, origin + dir * range)
query.exclude = [shooter.get_rid()]
query.collision_mask = enemy_mask
var hit := space.intersect_ray(query)

Recoil (three layers)

1. Camera kick — visual rotation, recover over time
2. Spread bloom — accuracy loss while firing
3. Learnable pattern — Array[Vector2] spray resource (weapon_recoil_pattern.gd)

NEVER apply recoil only to weapon mesh — players feel kick via camera + crosshair spread.

TPS-specific

Controller assist: friction near targets + subtle magnetism — tune in soft-lock script; do not snap aim.

Weapon balance heuristics

Hitscan for bullets; physical sim for explosives.

Feel polish

• Layered gunfire audio (mechanical + shot + tail) on separate AudioStreamPlayer3D — godot-audio-systems
• Impact Decal nodes, not flat Sprite3D billboards
• Crosshair: anchor center, not pixel offsets

Pitfalls