ClimbCamera.component
README.md
ClimbCamera (traversalKit)
Camera framing for climbing and rooftop moves. Put it on the player's climbing body; kit.equip adds it (camera = false leaves it out). It works on the engine's orbit-follow camera (@builtin::controller.orbital_follow) and does nothing with any other camera.
On the peer that owns the body it eases the camera per move, then back to the player's own framing on the ground:
| Move | Framing |
|---|---|
| climbing, ladder, rope | pulls back (×1.2-1.25) and aims 0.55-0.6 m higher, so the next hold and the top are in view |
| hanging | pulls back ×1.2 and aims 0.8 m higher, at the ledge |
| pulling up, wall run | a little back and up |
| balancing, slipping | aims a little lower, so the drop reads |
| vault, wall run, slip | a short field-of-view kick for speed |
It keeps whatever zoom or aim height the player (scroll) or the game sets, using it as the new base, and writes to the camera only while a change is easing in, so the camera's own damping runs undisturbed the rest of the time.
| Field | Default | |
|---|---|---|
active | true | frame the camera for climbing moves |
strength | 1 | 0..1.5 scale on every framing change |
fovKick | 6 | degrees of field-of-view kick on a vault, wall run or slip |
ease | 3.5 | how quickly the framing follows the move, per second |
adoptCamera | true | a player camera on the engine's legacy third-person behaviour (what a new world's player scene starts with) is moved onto orbit-follow once, so climbing is framed and the camera swings behind the climber at corners; off leaves the camera alone |