traversalKit.package
This package holds more than this page lists. See all of its files in its world.
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 |