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>
This commit is contained in:
@@ -0,0 +1,42 @@
|
||||
## 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()
|
||||
Reference in New Issue
Block a user