Files
tidewall/src/client/player_camera.gd
T
claudeandClaude Opus 5.5 70e88cec8a W1: Third-person character controller and camera
Simulation (src/sim/):
- SimGround holds the terrain heightfield (bilinear heights, normals)
  and axis-aligned box solids, with support, body-overlap, point and
  ray queries. The island generator and building will fill it.
- Movement steps a player per tick: walk, sprint (forward only),
  crouch (lower body, slower, no jump), jump with exact constant-gravity
  integration, air control, step-up onto ledges up to STEP_HEIGHT,
  ground snapping on downhill walks, slopes over MAX_SLOPE_DEGREES that
  block walking and jumping uphill and make players slide (speed capped),
  ceiling bumps, sliding along walls, and fall damage from impact speed.
- Gravity now applies on ticks with no command. on_ground and crouching
  are part of the state hash. New movement numbers are in Tuning.
- Fixed the strafe direction: right is forward x up in Godot's frame,
  (-cos yaw, 0, sin yaw). Documented the look convention.

Client (src/client/):
- CameraRig places an over-the-shoulder camera with an eased
  aim-down-sights blend (closer, narrower FOV), casting against the same
  SimGround: pivot to shoulder, shoulder back, then a straight line from
  the pivot, with a final clearance pull-in so the near plane never
  enters geometry.
- InputSettings: mouse sensitivity, aim sensitivity scale and invert-Y,
  clamped and saved to user://settings.cfg. PlayerCamera applies both.

Tests: 46 new across movement, ground queries, camera and settings,
including a 24,480-view scripted camera sweep through five arenas (wall,
corridor, low roof, corner, steep bank) that checks the eye and every
near-plane corner stay out of geometry with a clear line to the pivot.
The hash test now flips a high stick bit, because a 1/127 nudge to an
airborne player moves them less than the hash's millimetre.
Capture scenarios camera, camera_wall and camera_aim.

Closes #8

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 20:24:02 -05:00

43 lines
1.4 KiB
GDScript

## The local player's third-person camera. Turns mouse motion into a look direction using
## InputSettings, and places itself each frame with CameraRig, so it never clips through
## terrain or structures. The input layer reads `yaw` and `pitch` when it builds the
## player's commands.
class_name PlayerCamera
extends Camera3D
var settings: InputSettings = InputSettings.new()
var rig: CameraRig = CameraRig.new()
var ground: SimGround = SimGround.flat()
## Radians, in the simulation's convention (see docs/ARCHITECTURE.md).
var yaw: float = 0.0
var pitch: float = 0.0
var aiming: bool = false
## Where the followed player's feet are, and whether they're crouching. Set by whoever
## owns the player's presentation, from interpolated snapshots.
var target_feet: Vector3 = Vector3.ZERO
var target_crouching: bool = false
func _ready() -> void:
near = CameraRig.NEAR
fov = CameraRig.FOV
func _unhandled_input(event: InputEvent) -> void:
var motion: InputEventMouseMotion = event as InputEventMouseMotion
if motion != null and Input.mouse_mode == Input.MOUSE_MODE_CAPTURED:
var look: Vector2 = settings.apply_mouse(motion.relative, yaw, pitch, aiming)
yaw = look.x
pitch = look.y
func _process(delta: float) -> void:
rig.update_aim(aiming, delta)
snap()
## Places the camera for the current target and look direction immediately.
func snap() -> void:
global_transform = rig.solve(target_feet, yaw, pitch, target_crouching, ground)
fov = rig.fov()