# 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 |
# ClimbFollower (traversalKit)
An NPC that follows a player everywhere, up walls included. Put it on an NPC body that walks on the built-in `CharacterController` with climbKit's `ClimbMover` and traversalKit's `Traverser` (add `ClimbRig` so it looks the part), or spawn one ready-made with `kit.spawnFollower`.
```luau
local K = require("traversalKit.kit")
K.spawnFollower({ position = { 0, 0, 10 }, feel = "armoured" }) -- follows the nearest player
```
It drives the body only through the controller's input bus, like a player's controls, so every move of the kit is open to it. On walkable ground it follows a path from navKit (`NK.findPath`; it bakes a grid map once if none exists). When the one it follows is higher and no walk gets there, it heads straight for them: climbable walls are climbed, low ones mantled, smooth ones run up, ropes and ladders climbed, ledges pulled over. While holding on it pushes toward them.
| Field | Default | |
|---|---|---|
| `target` | none | entity to follow; empty = nearest player (with `followNearestPlayer`) |
| `followNearestPlayer` | true | |
| `followDistance` | 2.2 | stop this close (m) |
| `climbWhenHigher` | 1.0 | go straight and climb when the target is this much higher and unreachable on foot |
| `speedScale` | 1 | fraction of the body's move speed |
| `replanEvery` | 0.8 | seconds between path plans |
| `bakeIfMissing` | true | bake a navKit map once if there is none |
| `state` | (synced) | `idle`, `walking`, `climbing`, `waiting`, `lost` |
Events: `onStartClimb {height}`, `onReached`. Only the peer that owns the NPC runs it.
# ClimbNav
Lets an ordinary aiKit guard climb after the player. Put it on an entity that also carries a `navKit.NavMap` (a `multiLevel` map, so the ground and the wall tops are both walkable). On every peer it defines the aiKit preset `climbingGuard` (aiKit's own `guard`, moving on navKit's `climber` style), waits for the map to bake, then calls traversalKit's `K.linkClimbableWalls` for the walls within `radius`: each wall that climbs by rule (or is marked climbable) becomes a navKit `ladder` link from its foot to its top. A guard with `aiKit.Brain { preset = "climbingGuard" }` then plans its chase up the wall when the player climbs it. `linked` reports how many links were made.
# ClimbRig (traversalKit)
How a climber looks and sounds, on every peer. Put it on the same body as `Traverser` and climbKit's `ClimbMover`. It writes no synced state, so it runs everywhere and every player sees every climber the same way.
- **Animation**: crossfades the kit's climbing clips (`anims/`: climb up/side/idle, ladder, rope, hang, shimmy, mantle, vault, wall run, balance walk/wobble, slip, land roll) on the body's own Locomotion graph and back to walking, at the speed the climber moves and the feel's `animSpeed`.
- **Hands and feet on the holds**: four `IKLimb`s (the engine's IK): hands on the ledge edge while hanging or pulling up, hand over hand on the wall while climbing (on the rungs of a ladder), round the rope on a rope; feet on the wall, rungs or rope.
- **Facing**: turns the body the way a traversalKit move goes (rope, vault, wall run, balance); climbKit faces its own moves.
- **Sounds**: each hold kind's own grab, hand, foot and slip sounds plus vault, hard-landing, wobble and pull-up (`holdSounds.module`, through soundstage).
- **Feedback**: juiceKit `landingHard`, `shakeLight` on a slip or a helped catch, `dust` on a vault, fired once from the owner's peer (juiceKit shows it to everyone).
| Field | Default | |
|---|---|---|
| `animate` | true | play the climbing clips |
| `placeHands` / `placeFeet` | true | IK on hands / feet |
| `sounds` | true | hold sounds |
| `feedback` | true | juiceKit feedback |
| `volume` | 1 | hold sound volume |
The clips are made with the engine's animation generator (anim_gen) on a humanoid rig and play on any humanoid avatar; `anims/clipImport.module` takes out their travel, blends the loops' seams and trims the one-shots to the move. Replace any clip with your own by putting a clip of the same name in its folder (its play rate and length are set in `RATE` and `LENGTH` at the top of this component).
# ClimbSurface (traversalKit)
Mark something climbable on purpose and say what kind of hold it is. Most surfaces need nothing: traversalKit climbs steep, tall, rough surfaces by rule. Use a marker for what the rule cannot see (a rope, a ladder, a bamboo pole too thin to have a face), to choose the hold kind, or to forbid climbing.
```luau
ladder.component.add("traversalKit.ClimbSurface", { kind = "ladder" })
glassTower.component.add("traversalKit.ClimbSurface", { climbable = false })
```
| Field | Default | |
|---|---|---|
| `kind` | `stone` | `stone`, `timber`, `tiles`, `rope`, `ladder`, `tree`, `cliff`, `bamboo`: how it handles, sounds and is held |
| `climbable` | true | true: always climbable; false: never (its ledges can still be grabbed and mantled). A `rope` is climbed by traversalKit's rope move along it, never as a wall, so climbKit is told it is not a wall. |
| `tint` | false | tint the Model with the kind's gallery colour (greyboxing) |
It writes the `climbable` and `climbKind` attributes climbKit and traversalKit read, on every peer, and applies changes while running, so a level can swap a wall from stone to tiles with one field. It marks its entity and everything under it.
# TraverseHud (traversalKit)
A small ink-on-paper panel for the local player's climber: what they are doing (mode and hold), grip when it runs low, and two buttons that cycle the movement feel and the assist level while playing. Tap them on a phone, click with a mouse, or press **F** (feel) and **G** (help). Put it on any entity in a scene; it finds the local player's body and draws only on this peer, in a top corner so the lower corners stay free for touch controls.
```luau
entity.spawn("Hud").component.add("traversalKit.TraverseHud", { corner = "topLeft" })
```
| Field | Default | |
|---|---|---|
| `showSwitchers` | true | feel / help buttons and F / G keys |
| `showMode` | true | mode, hold and grip |
| `corner` | `topLeft` | `topLeft` or `topRight` |
| `accent` | `#b5361e` | accent colour |
# TraverseZone (traversalKit)
A box volume that switches a climber's movement feel and/or assist level when they step in: "heavy armour from here on", a strict ice section, gallery pads. Each player's own peer switches their own climber.
```luau
pad.component.add("traversalKit.TraverseZone", { feel = "armoured", sizeX = 2, sizeY = 3, sizeZ = 2 })
```
| Field | Default | |
|---|---|---|
| `feel` / `assist` | empty | what to switch to (empty leaves it alone) |
| `sizeX` / `sizeY` / `sizeZ` | 2 | box size in the entity's axes (scaled by it); Y measured up from the entity |
| `restoreOnExit` | false | put the previous feel and assist back on leaving |
Events (local): `onEnter {bodyId}`, `onExit {bodyId}`.
# Traverser (traversalKit)
The rooftop-and-climbing layer on a character body. Put it on a body that walks on the built-in `CharacterController` and carries climbKit's `ClimbMover` (the player body a `PlayerPrototype` names, or an NPC). Add `ClimbRig` beside it for animations, hand/foot IK, sounds and feedback. `traversalKit.kit.equip(body)` adds all three.
```luau
body.component.add("climbKit.ClimbMover", {})
body.component.add("traversalKit.Traverser", { feel = "nimble", assist = "standard" })
body.component.add("traversalKit.ClimbRig", {})
```
## What it adds to climbKit
| Move | How it starts |
|---|---|
| Climb by rule | Any steep, tall-enough surface of a climbable material (stone, wood, bark, rock, terrain, rough unknowns) climbs with no marker. Registered with climbKit's `ledge.addClimbRule`; `climbByRule = false` turns it off. |
| Vault | Running at `vaultMinSpeed` or faster at a thin top up to `vaultMaxHeight` (feel) with ground beyond: over it in `vaultTime`, keeping the run's speed. |
| Balance | Walking along a top narrower than the body (a beam, a wall cap, a roof ridge): movement is held to the ridge, sideways input steers a wobble. Past full lean: a slip. |
| Slip and catch | A slip slides down the roof to the eave and falls; jump in the window (assist `slipCatchWindow`, automatic on arcade) catches the edge as a hang. |
| Wall run | Running into a wall with jump when its edge is beyond a jump's reach but within `wallRunSteps` x `wallRunRise`: a few steps up, then a mantle or a hang. |
| Rope | Touching a surface of kind `rope` (or jumping at it): climb up and down along it, sideways goes round it, jump leaves it, pushing on at the top pulls onto the ledge there. |
| Ladder | A surface of kind `ladder` climbs through climbKit at the ladder's speed; the mode reads `ladder`. |
| Helped catch | Airborne toward a ledge or post within the assist's `catchRadius`: steered onto it and caught. |
| Drop and catch | Letting go of a ledge (back) catches the next ledge below (assist `dropCatch`). |
| Edge catch | Stepping off an edge and pulling back toward it within 0.9 s catches it as a hang, on every help level; arcade catches an edge walked off without the pull-back. Walking or running straight off still drops. |
Hold kinds tune climb and shimmy speed; under the strict assist, grip drains while holding on and lets go at zero.
## Fields
| Field | Default | |
|---|---|---|
| `feel` | `nimble` | `nimble`, `armoured`, `ordinary`, `acrobat` (see `feels.module`). Change it while running. |
| `assist` | `standard` | `arcade`, `standard`, `strict` (see `assists.module`). Change it while running. |
| `climbByRule` | true | surfaces nobody marked climb by rule |
| `vaultEnabled`, `balanceEnabled`, `wallRunEnabled`, `ropeEnabled`, `assistEnabled` | true | each move on or off |
## Telemetry (synced: read it on any peer)
`mode`: `grounded`, `airborne`, `falling`, `climbing`, `ladder`, `rope`, `hanging`, `mantling`, `vaulting`, `wallrunning`, `balancing`, `slipping`. `hold`: the hold kind in the hands (or underfoot on a ridge), `holdMaterial`, `balance` (-1..1), `grip` (0..1), `gripX/Y/Z` (where the hands hold), `ropeAxisX/Y/Z`, `facingX/Z`, `moveProgress`.
## Events (synced: they fire on every peer)
`onModeChanged {from, to}`, `onGrab {kind, how}`, `onRelease {kind, reason}`, `onPullUp {height}`, `onVault {height, speed}`, `onWallRun {steps, height}`, `onWobble {amount}`, `onRecover`, `onSlip {side}`, `onCatch {assisted, how}`, `onLand {speed, heavy}`.
```luau
local tr = body.component.get("Traverser")
tr.events.onGrab:connect(function(e) print("grabbed", e.kind) end)
tr.events.onPullUp:connect(function(e) print("up and over", e.height) end)
```
## Methods
`setFeel(name)`, `setAssist(name)`, `isHolding()`, `letGo()`.
## Multiplayer and controls
Only the peer that owns the body runs the moves; the body's position replicates with the engine's interpolation, `mode` and the events are synced, and `ClimbRig` draws every climber on every peer. It reads the controller's input bus (whatever drives the body: the controller's own input map, controlsKit's schemes on keyboard, gamepad and touch, or an AI), so there are no new bindings.
## Balance direction
A balance runs along the beam itself: the longer horizontal axis of whatever is underfoot (a beam, a ridge cap, a roof slab), pointed the way the player is going, so stepping on a few degrees off still walks straight along it. Shapes with no clear long axis (terrain ridges) follow the direction the player stepped on with.
## Ropes
- Up and down on a rope follow the player's forward (stick, keys or touch pad) against the camera, the same way a ladder does, whichever side of the rope they caught it from. AI and scripted climbers use the way the body faces.
- The lowest hold is floor-aware: a rope whose foot hangs just above a deck or roof keeps the climber's feet on that floor, and pushing down there steps off onto it.
- At the top, pushing on pulls onto the ledge the player is pushing toward first, then onto one the body faces.
# balance_walk
Looping in-place careful walk along a narrow beam or roof ridge, arms out for balance.
- Duration: 4.00 s
- Looping: yes (seam blended, in place)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
Generated by the engine's animation generator (anim_gen) from the prompt "walking slowly and carefully along a narrow beam, one foot placed directly in front of the other, both arms stretched out to the sides for balance, tilting as the weight shifts, looking down, looping, in place", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# balance_wobble
One-shot loss of balance on a beam: tipping, arms windmilling, then settling back to a steady stance.
- Duration: 2.30 s
- Looping: no (one-shot)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
- Trimmed to 0.7-3.0 s of the generated 4 s take, the move itself.
Generated by the engine's animation generator (anim_gen) from the prompt "standing on a narrow beam and losing balance: body tips to the right, left leg kicks out, both arms windmill in big circles, over-corrects, then settles back to a steady stance with arms out", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# catch_ledge
One-shot jump-and-catch: take-off, reach, both hands catch a ledge, legs swing under and settle into a hang.
- Duration: 1.80 s
- Looping: no (one-shot)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
- Trimmed to 0.3-2.1 s of the generated 4 s take, the move itself.
Generated by the engine's animation generator (anim_gen) from the prompt "crouched take-off and jump upward, reaching with both arms, catching a high ledge with both hands, legs swing under the body, settling into a still hang with straight arms", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# climb_idle
Looping idle for holding still on a vertical climbing wall: hands on holds above the shoulders, feet on footholds, slow breathing.
- Duration: 4.00 s
- Looping: yes (seam blended, in place)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
Generated by the engine's animation generator (anim_gen) from the prompt "holding still on a vertical climbing wall facing the wall, both hands gripping holds above the shoulders, both feet on footholds in a frog stance, slow breathing, small glance over the shoulder, looping idle", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# climb_side
Looping in-place sideways traverse on a vertical wall toward the character's right; mirrored or reversed for leftward moves.
- Duration: 4.00 s
- Looping: yes (seam blended, in place)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
Generated by the engine's animation generator (anim_gen) from the prompt "traversing sideways to the right on a vertical climbing wall facing the wall, right hand reaches out wide, body shifts across, right foot steps out, left hand and foot follow in, looping, in place", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# climb_up
Looping in-place climbing cycle for a vertical wall, hand over hand with alternating high steps; played backwards for climbing down. Hands and feet are pinned onto holds by IK at runtime.
- Duration: 4.00 s
- Looping: yes (seam blended, in place)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
Generated by the engine's animation generator (anim_gen) from the prompt "climbing straight up a vertical rock wall facing the wall, hand over hand, one hand reaching high while the other pulls down by the shoulder, alternating high steps with the feet, steady looping climb cycle, in place", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# clipImport
Makes traversalKit's climbing clips from clips the engine's animation generator (`anim_gen`) produced. Each generated clip is read with `skeleton.clipToTable`, its pelvis's net travel is taken out (traversalKit moves the body itself, so a clip that travelled would double the motion), a looping clip's last fifth is blended back into its first pose so the cycle has no seam, and the result is written as `<name>.animation` in `traversalKit.package/anims`, keeping that clip's folder and guid so every reference keeps working.
```luau
local CI = require("traversalKit.anims.clipImport")
local dur = CI.import("vault", "/zero/source/generated/climbAnims/vault_anims/a.animation", {
loop = false, prompt = "running fast and speed vaulting over a waist-high wall ...",
description = "One-shot speed vault at running pace over a waist-high wall.",
})
```
`CI.inPlace(clip)` and `CI.loopSeam(clip, share?)` work on any clip table on their own. Called by whoever regenerates the clip set; nothing calls it at runtime.
# hang_idle
Looping idle for hanging from a ledge by both hands: arms straight overhead gripping the edge, body hanging still below with a gentle sway.
- Duration: 4.00 s
- Looping: yes (seam blended, in place)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
Generated by the engine's animation generator (anim_gen) from the prompt "hanging from a ledge by both hands, arms straight overhead, body hanging still and relaxed below, legs together slightly bent, a gentle small sway, looped idle", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# ladder_climb
Looping in-place ladder climb, opposite hand and foot up one rung at a time.
- Duration: 4.00 s
- Looping: yes (seam blended, in place)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
Generated by the engine's animation generator (anim_gen) from the prompt "climbing up a vertical ladder facing it, hands gripping the rungs close in front, alternating opposite hand and foot up one rung at a time, looping, in place", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# land_roll
One-shot landing from a high drop into a forward shoulder roll and back up to standing.
- Duration: 3.00 s
- Looping: no (one-shot)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
- Trimmed to 0.3-3.3 s of the generated 4 s take, the move itself.
Generated by the engine's animation generator (anim_gen) from the prompt "landing from a high drop: feet hit the ground, knees absorb deeply, dive forward into a tucked shoulder roll, come up out of a crouch to standing", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# mantle
One-shot pull-up and mantle: from hanging on a ledge, pull up, press over the edge, knee onto the top and stand.
- Duration: 2.20 s
- Looping: no (one-shot)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
- Trimmed to 1.2-3.4 s of the generated 4 s take, the move itself.
Generated by the engine's animation generator (anim_gen) from the prompt "hanging by both hands from a high ledge, then pulling up, pressing down over the edge with straight arms, bringing the right knee onto the top and standing up", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# rope_climb
Looping in-place climb up a vertical rope hand over hand, legs clamping the rope.
- Duration: 4.00 s
- Looping: yes (seam blended, in place)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
Generated by the engine's animation generator (anim_gen) from the prompt "climbing up a hanging vertical rope hand over hand, hands close together, one reaching high while the other pulls in at the chest, legs tucking to clamp the rope then extending, looping, in place", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# shimmy
Looping in-place shimmy along a ledge toward the character's right while hanging by both hands.
- Duration: 4.00 s
- Looping: yes (seam blended, in place)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
Generated by the engine's animation generator (anim_gen) from the prompt "hanging by both hands from a ledge with straight arms and shimmying sideways to the right, right hand slides out, body swings across under the hands, left hand follows, legs dangling, looping, in place", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# slip_catch
One-shot slip and save: the feet slip off a roof edge, one hand snatches the edge and the body swings to a one-handed hang.
- Duration: 2.40 s
- Looping: no (one-shot)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
- Trimmed to 0.2-2.6 s of the generated 4 s take, the move itself.
Generated by the engine's animation generator (anim_gen) from the prompt "standing on a roof edge, feet slip, body drops past the edge, right hand snatches the edge, body jolts and swings, left arm flails and reaches but misses, ending hanging by the right hand alone", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# vault
One-shot speed vault at running pace over a waist-high wall: one hand plants, the legs swing over to the side, landing back into a stride.
- Duration: 1.60 s
- Looping: no (one-shot)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
- Trimmed to 0.6-2.2 s of the generated 4 s take, the move itself.
Generated by the engine's animation generator (anim_gen) from the prompt "running fast and speed vaulting over a waist-high wall: left hand plants on top, legs swing over to the side, landing back into a running stride", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# wall_run
One-shot wall run-up: sprint into a wall, a few steps up its face, reach high for the top.
- Duration: 2.60 s
- Looping: no (one-shot)
- Root motion: none; the net travel is taken out and the pelvis stays over the entity (traversalKit moves the body itself)
- Trimmed to 0.5-3.1 s of the generated 4 s take, the move itself.
Generated by the engine's animation generator (anim_gen) from the prompt "sprinting at a wall, running three steps up the wall face leaning back, then reaching both arms high overhead to grab the top", on a humanoid rig (`animGenHumanoid.rig`, in this folder), so it retargets onto any humanoid body (the built-in `@builtin::avatars.humanoid` included). Made in place by `traversalKit.anims.clipImport`. Part of traversalKit; play it with `ClipPlayer` or an AnimGraph `Clip` node.
# traversalKit.assists
The three amounts of help, swappable while running with the Traverser's `assist` field.
| Level | Jumps | Slips | Ridges | Grip | Climb by rule |
|---|---|---|---|---|---|
| `arcade` | steered onto ledges and posts within 1.6 m, +0.8 m reach | caught automatically | barely wobble, mostly self-correct | unlimited | generous: 62°+, 1.2 m+, any rough-ish surface |
| `standard` | steered within 0.9 m, +0.4 m | jump within 0.55 s to catch | a wobble you steer out of | unlimited | 68°+, 1.5 m+ |
| `strict` | no help | jump within 0.3 s | wobbly, no self-correction | runs out while holding on | 72°+, 1.8 m+, only rough stone and wood |
On every level, stepping off an edge and pulling back toward it catches it as a hang (the player's own move). Arcade also catches an edge you walk off without asking, and catches the ledge below when you let go (standard does the drop-catch too).
Fields of an assist level: `catchRadius`, `catchUp`, `magnet`, `slipCatchWindow`, `autoSlipCatch`, `wobbleScale`, `autoBalance`, `gripLimit`, `edgeCatch`, `dropCatch`, `regrabDelay`, `hangCatchSpeed`, `ruleSteepness`, `ruleRoughness`, `ruleMinHeight`, `ruleMaxHeight`.
```luau
local Assists = require("traversalKit.assists")
Assists.define("kids", { catchRadius = 2.2, autoSlipCatch = true, wobbleScale = 0.1 }, "arcade")
```
`get(id)`, `has(id)`, `define(id, def, base?)`, `list()`, `order`.
# traversalKit.feels
The four movement feels, each one table of the numbers that make a climber feel a certain way, spread over the CharacterController (`moveSpeed`, `jumpForce`, …), climbKit's ClimbMover (`reach`, `climbSpeed`, `shimmySpeed`, mantle times, kick-off, corner time) and traversalKit's own moves (vault speed and height, wall-run steps, balance skill, rope speed, grip time, animation speed).
| Feel | What it is |
|---|---|
| `nimble` | Light and quick: a shinobi who flows up walls and along ridges. 3 wall-run steps, steady on ridges. |
| `armoured` | Heavy and deliberate: a samurai in plate. Slow climbing, short reach, 1 wall-run step, wobbly on ridges. |
| `ordinary` | Cautious and human: a townsperson who climbs carefully. |
| `acrobat` | Showy and springy: long reach, 4 wall-run steps, big kick-offs, rolls out of hard landings. |
Switch while running with the Traverser's `feel` field (`kit.setFeel(body, "armoured")`). Add your own:
```luau
local Feels = require("traversalKit.feels")
Feels.define("ninjaCat", { climbSpeed = 3.0, reach = 2.8, label = "Ninja cat" }, "acrobat")
```
`get(id)`, `has(id)`, `define(id, def, base?)`, `list()`, `order`.
# holdSounds
Sounds for every kind of climbing hold in traversalKit. Climbing code calls
`require("traversalKit.holdSounds").play(kind, event, position, volume?, key?)` when a hand
catches a hold, a hand or foot is placed, a foot slips, or the climber vaults, lands hard,
wobbles or pulls up. The sound plays in 3D at `position` on the calling peer only: call it
on every peer that should hear it (each peer runs the climbing code for what it sees).
## Kinds and events
- Kinds: `stone`, `timber`, `tiles`, `thatch` (the soft tiles), `rope`, `ladder`, `tree`,
`cliff`, `bamboo`. Aliases such as `wood`, `masonry`, `roof`, `tiles_soft`, `bark`,
`rock` map onto these (`M.ALIASES`); anything unknown plays as `stone`.
- Per-kind events: `grab` (hands catch the hold), `hand` (a short hand placement),
`foot` (a foot scuff or step), `slip` (scrape, clatter, rope burn, gravel trickle).
- Shared events: `vault`, `land_heavy`, `wobble`, `pullup`.
## API
- `M.play(kind, event, position, volume?, key?)` plays a random take (soundstage's
shuffle bag, ±6% pitch, ±10% volume) and returns the clip ref it played, or nil when it
was throttled. Each event has a minimum interval (`M.MIN_INTERVAL`, per `key`), so
spamming does not stack.
- `M.clips[kind][event]` lists the clip names per event; shared events are under
`M.clips.common`. `M.clip(name)` resolves one name to its soundClip, `M.takes(kind, event)`
lists an event's names, `M.kindOf(kind)` answers the kind a name plays as.
- `M.LEVEL` (per-event level), `M.MAX_DISTANCE` (28 m) tune the mix.
Playback goes through `soundstage.sfx` (its pooled 3D voices on the `sfx` mix group).
Clips come from `traversalKit/sounds` (generated for this kit, plus three published clips),
soundstage's stone/wood/gravel footsteps and thuds and alpineKit's
rockfall.
# traversalKit.holds
The catalogue of hold kinds: **stone** (stone blocks), **timber** (posts, beams), **tiles** (roof tiles and thatch), **rope**, **ladder**, **tree**, **cliff** (rock faces, terrain) and **bamboo**. Each kind carries how it handles (`climbSpeed` / `shimmySpeed` multipliers, `grip`, `slip` underfoot, `handSpacing` for hand IK, `snapAxis` for things climbed on one line), whether it is climbable by rule when steep, a gallery colour, and the words in a material or entity name that mark it.
```luau
local Holds = require("@root::traversalKit.holds") -- ~.holds inside the package
local c = Holds.classify(hit.entityId)
print(c.kind, c.source) -- "timber", "material"
print(Holds.get("rope").climbSpeed)
```
`classify(entityId)` walks the entity and its parents: a `ClimbSurface` component or `climbKind` attribute decides on purpose; otherwise the first collider's material name, then its entity name, then terrain (cliff). Smooth materials (glass, ice, metal, polished, …) are reported as `smooth`, which the climb rule never climbs. Results are cached for 2 s; `invalidate(entityId?)` clears them.
# traversalKit.kit
The one interface for game code.
```luau
local K = require("traversalKit.kit")
K.equip(body, { feel = "nimble", assist = "standard" }) -- ClimbMover + Traverser + ClimbRig
K.mark(rope, "rope") -- climbable on purpose, as a rope
K.mark(glass, "stone", false) -- never climbable
K.setFeel(body, "armoured") -- swap while running
K.setAssist(body, "arcade")
print(K.state(body).mode) -- grounded, climbing, hanging, vaulting, balancing, …
K.on(body, "onGrab", function(e) print("grabbed", e.kind) end)
K.on(body, "onPullUp", function(e) print("over the top") end)
K.spawnFollower({ position = { 0, 0, 8 }, feel = "armoured" }) -- an NPC that follows players up walls
print(K.explain(wall, hit).reason) -- why it does or does not climb by rule
```
| Function | |
|---|---|
| `equip(body, opts?)` | Adds climbKit's ClimbMover, Traverser, ClimbRig (unless `rig = false`) and ClimbCamera (unless `camera = false`). Works in a scene build or at runtime. Answers the Traverser. |
| `mark(entity, kind?, climbable?)` | Adds or updates a ClimbSurface. |
| `setFeel(body, name)` / `setAssist(body, name)` | Swap while running (on the body owner's peer). |
| `state(body)` | `{ mode, hold, holding, balance, grip, feel, assist }`, on any peer. |
| `on(body, event, fn)` | Connect to a synced Traverser event. |
| `spawnFollower(opts)` | Synced NPC climber with ClimbFollower. |
| `explain(entity, hit?)` | The climb-by-rule verdict and its reason. |
Also `K.feels`, `K.assists`, `K.holds`, `K.rules`, `K.EVENTS`, `K.MODES`, `K.VERSION`.
# navClimb
Tells navKit which walls traversalKit can climb. `link(opts)` probes every wall face round a point (or the walls you list): a face that climbs (by rule, or marked climbable) and has a top a character can stand on becomes a navKit `ladder` link from the ground at its foot to its top. An NPC on navKit's `climber` style (an aiKit guard, any `NavAgent`) then plans its route up that wall the way a player would climb it, instead of walking round.
```luau
local K = require("traversalKit.kit")
K.linkClimbableWalls({ center = { 0, 0, 0 }, radius = 40 }) -- once the level has loaded
```
Options: `center`, `radius` (60), `entities` (exact walls instead of a search), `spacing` (4 m between links on one face), `minHeight` (1.6 m; lower walls are stepped or mantled), `maxHeight` (14 m). `clear()` removes the links it made, `links()` lists their ids. Called by game code on every peer after the level is built (the links are navKit's own, which every peer registers the same way).
# traversalKit.rules
Climbable by rule, so a town or a mountain with sensible colliders just works with no tagging. traversalKit registers this test with climbKit (`ledge.addClimbRule`); it decides only for surfaces nobody marked (a `climbable` attribute or a `ClimbSurface` always wins).
A surface climbs when:
1. it is not a moving body (characters, dynamic or kinematic physics) and not smooth (glass, ice, metal, polished, chrome, plastic, lacquer, water, by material or entity name);
2. it is steep enough: at least the assist's `ruleSteepness` degrees from horizontal;
3. it is tall enough: the face stands at least `ruleMinHeight` above the ground under it (shorter ones are mantled and vaulted instead);
4. it gives a hold: a known hold kind by its material or name (stone, brick, ashlar, wood, timber, plank, bark, rock, cliff, granite, bamboo, rope, ladder, …) or terrain (cliff); or an unknown material at least `ruleRoughness` rough and no taller than `ruleMaxHeight`.
Usable edges (ledges, wall tops, eaves) are always grabbable and mantled by climbKit whatever the rule says.
```luau
local Rules = require("traversalKit.rules")
print(Rules.explain(wall.id, hit).reason) -- "stone by material", "too shallow (40 deg < 68)", ...
```
`install(assist)`, `uninstall()`, `explain(entityId, hit)`, `active()`, `RULE_NAME`.
# bamboo_foot_1
One take of a foot scuffing and finding purchase on a bamboo pole, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# bamboo_foot_2
One take of a foot scuffing and finding purchase on a bamboo pole, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# bamboo_grab_1
One take of hands catching hold of a bamboo pole with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# bamboo_grab_2
One take of hands catching hold of a bamboo pole with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# bamboo_hand_1
One take of a short hand placement on a bamboo pole while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# bamboo_hand_2
One take of a short hand placement on a bamboo pole while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# bamboo_slip_1
One take of a slip on a bamboo pole: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# bamboo_slip_2
One take of a slip on a bamboo pole: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# cliff_grab_1
One take of hands catching hold of a rock cliff face with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# cliff_grab_2
One take of hands catching hold of a rock cliff face with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# cliff_hand_1
One take of a short hand placement on a rock cliff face while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# cliff_hand_2
One take of a short hand placement on a rock cliff face while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# cliff_slip_1
One take of a slip on a rock cliff face: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# cliff_slip_2
One take of a slip on a rock cliff face: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# hoist_creak
Hemp under load and a timber jib taking the weight of the bell in three long complaints.
3.00 s, 22050 Hz, mono, a one-shot stored as Opus.
Synthesised from `game.audio.recipes` by `game.audio.bake`.
# impact_wood
A heavy body hitting wooden planks: a hollow wooden knock and creak. Generated for Stair Dismount; played by `game.feel.sound`.
# ladder_foot_1
One take of a foot scuffing and finding purchase on a wooden ladder, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# ladder_foot_2
One take of a foot scuffing and finding purchase on a wooden ladder, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# ladder_grab_1
One take of hands catching hold of a wooden ladder with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# ladder_grab_2
One take of hands catching hold of a wooden ladder with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# ladder_hand_1
One take of a short hand placement on a wooden ladder while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# ladder_hand_2
One take of a short hand placement on a wooden ladder while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# ladder_slip_1
One take of a slip on a wooden ladder: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# ladder_slip_2
One take of a slip on a wooden ladder: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# land_heavy_1
One take of a heavy landing thud after a long drop, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# one_small_hollow_bamboo_woodblock_tick
Managed audio asset. Edit the `.metadata` `settings` block to change compression.
# pullup_1
One take of a short, non-verbal exertion grunt pulling up over a ledge, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# pullup_2
One take of a short, non-verbal exertion grunt pulling up over a ledge, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# pullup_3
One take of a short, non-verbal exertion grunt pulling up over a ledge, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# rope_foot_1
One take of a foot scuffing and finding purchase on a hemp rope, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# rope_foot_2
One take of a foot scuffing and finding purchase on a hemp rope, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# rope_grab_1
One take of hands catching hold of a hemp rope with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# rope_grab_2
One take of hands catching hold of a hemp rope with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# rope_hand_1
One take of a short hand placement on a hemp rope while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# rope_hand_2
One take of a short hand placement on a hemp rope while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# rope_slip_1
One take of a slip on a hemp rope: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# rope_slip_2
One take of a slip on a hemp rope: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# stone_grab_1
One take of hands catching hold of stone blocks with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# stone_grab_2
One take of hands catching hold of stone blocks with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# stone_hand_1
One take of a short hand placement on stone blocks while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# stone_hand_2
One take of a short hand placement on stone blocks while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# stone_slip_1
One take of a slip on stone blocks: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# stone_slip_2
One take of a slip on stone blocks: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# thatch_foot_1
One take of a foot scuffing and finding purchase on a thatched roof, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# thatch_foot_2
One take of a foot scuffing and finding purchase on a thatched roof, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# thatch_grab_1
One take of hands catching hold of a thatched roof with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# thatch_grab_2
One take of hands catching hold of a thatched roof with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# thatch_slip_1
One take of a slip on a thatched roof: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# thatch_slip_2
One take of a slip on a thatched roof: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tiles_foot_1
One take of a foot scuffing and finding purchase on clay roof tiles, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tiles_foot_2
One take of a foot scuffing and finding purchase on clay roof tiles, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tiles_grab_1
One take of hands catching hold of clay roof tiles with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tiles_grab_2
One take of hands catching hold of clay roof tiles with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tiles_hand_1
One take of a short hand placement on clay roof tiles while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tiles_hand_2
One take of a short hand placement on clay roof tiles while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tiles_slip_1
One take of a slip on clay roof tiles: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tiles_slip_2
One take of a slip on clay roof tiles: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# timber_grab_1
One take of hands catching hold of timber posts and beams with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# timber_grab_2
One take of hands catching hold of timber posts and beams with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# timber_hand_1
One take of a short hand placement on timber posts and beams while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# timber_hand_2
One take of a short hand placement on timber posts and beams while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# timber_slip_1
One take of a slip on timber posts and beams: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# timber_slip_2
One take of a slip on timber posts and beams: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tree_foot_1
One take of a foot scuffing and finding purchase on tree bark, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tree_foot_2
One take of a foot scuffing and finding purchase on tree bark, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tree_grab_1
One take of hands catching hold of tree bark with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tree_grab_2
One take of hands catching hold of tree bark with a firm grab, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tree_hand_1
One take of a short hand placement on tree bark while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tree_hand_2
One take of a short hand placement on tree bark while climbing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tree_slip_1
One take of a slip on tree bark: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# tree_slip_2
One take of a slip on tree bark: a scrape and loss of footing, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# vault_1
One take of a running vault: a cloth whoosh and a hand slapping the top of a low wall, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# vault_2
One take of a running vault: a cloth whoosh and a hand slapping the top of a low wall, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# wobble_1
One take of a sharp intake of breath when losing balance on a narrow ridge, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# wobble_2
One take of a sharp intake of breath when losing balance on a narrow ridge, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# wobble_creak_1
One take of a wooden creak under a climber losing balance on a beam, for traversalKit's climbing holds. Played by `traversalKit.holdSounds` (through soundstage's 3D sfx voices) when a climber does that on that kind of hold; several takes of each event are shuffled so repeats do not sound the same.
# traversalKit_rules
Checks traversalKit's climb-by-rule test and hold catalogue against real colliders, through climbKit's own wall probes: a tall unmarked stone wall climbs and a low one does not, glass and `climbable = false` never climb, an unknown wall climbs only on arcade help, a 40° roof is too shallow, hold kinds come from a `climbKind` marker, entity names and material names, and the feel and assist catalogues fall back and extend as documented. It does not drive a character through the moves (vault, balance, rope, wall run): those are exercised in play in the gallery scene.