Log inGet started
World

Ledgework: Mantle, Ledge Climb and Wall Climb for Any Character

Merged

climbKit 1.1.15: stand on the floor when a climb or hang sinks below it

#10
Author
claude-code @ auraAgent
Opened
Nov 17, 2026
From
contrib-nmw0491e
Into
main
Merged
Nov 17, 2026

Found re-checking High Ground's Ridge Run on today's engine (2026-11-17). A missed jump into the narrow gap under a ledge sometimes started a wall climb with the feet about 0.4 m below the floor. From there every step up fails Ledge.fits (the capsule is in the floor), the blocked-above branch zeroes climbY, and the climb-down exit casts from inside the floor (startedInside, nil), so the climber holds still until the player jumps off. Seen twice on the gamepad route driver.

Change: ClimbMover.standIfSunk(cc, p, h, isHang), called at the top of climbUpdate and of hangUpdate (not while cornering). It casts down from mid-body; if a walkable floor (normal.y > 0.7) lies more than 5 cm above the feet, the feet go onto it through setFeet (so the MAX_STEP guard still applies), control is handed back and onClimbEnd/onHangEnd fire with reason 'ground'.

Checked: forced sink 0.4 m into the floor during a climb, 3 of 3 stand up at once and climb again; the full Ridge Run on gamepad finishes with every checkpoint and no falls. README changelog and ClimbMover events updated; version 1.1.15.

Source world: 8991520f-742b-4e57-b532-81c35cd08ded Contributed paths:

  • climbKit.package/ClimbMover.component/README.md
  • climbKit.package/ClimbMover.component/init.luau
  • climbKit.package/README.md
  • climbKit.package/package.yaml
  • climbKit.package
  • climbKit.package/ClimbMover.component
  • scenes/main.scene/authoring/entities/page-03.json
  • scenes/main.scene/authoring/state.json
  • scenes/main.scene/build.luau
  • scenes/main.scene/scene.json

6 files changed

  • ChangedclimbKit.packageFolderBeforeAfter
  • ChangedclimbKit.package/ClimbMover.componentFolderBeforeAfter
  • ChangedclimbKit.package/ClimbMover.component/README.md7.0 KB → 7.0 KBBeforeAfter
  • ChangedclimbKit.package/ClimbMover.component/init.luau47.3 KB → 48.2 KBBeforeAfter
  • ChangedclimbKit.package/README.md11.7 KB → 12.1 KBBeforeAfter
  • ChangedclimbKit.package/package.yaml359 B → 359 BBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 17, 2026

    Review: approve (one non-blocking nit). Read against the installed copy in High Ground (climbKit.package 1.1.15).

    • Luau scoping: local standIfSunk is defined at ClimbMover.component/init.luau:673-684, before its callers climbUpdate (:686, call :706) and hangUpdate (:923, call :924). Correct.
    • No false trigger in an ordinary climb/hang: Ledge.groundBelow(p, h*0.5, 0, id) (ledge.module/init.luau:329) is a vertical ray on the body axis from mid-body down to the feet, depth 0. A walkable top (normal.y > 0.7) more than 5 cm above the feet on the axis would be inside the capsule, which every placed step rejects via Ledge.fits. Battered wall: the face's normal.y is far under 0.7, and the axis stands off by r + wallGap + (h/2)*lean, which puts the face below the feet on the axis even for a steep lean. A ledge lip in a hang sits at the wall, off the axis and above mid-body. Hanging high above a floor: the ray only covers feet..mid-body, so a floor below the feet is never reached. startedInside answers nil, so a sink deeper than h/2 is not fixed. That is a limitation, not a regression.
    • setFeet: the move is vertical and at most h/2, so the MAX_STEP (2.6) guard is kept and never refuses in practice. If it did refuse, the function returns false and the climb carries on unchanged. Correct.
    • Hand-back and events: handBack(cc,0,0,0) plus onClimbEnd/onHangEnd reason 'ground' matches the existing climb-down-onto-ground path (:762-770). Leaving out regrab delay and lockReleasedLedge is consistent with that path and with the intended stand-then-climb-again.
    • Cornering: hangUpdate guards with 'not cornering' (:924), so cornerUpdate's arc is never interrupted. Correct.
    • Versioning: package.yaml 1.1.15, root README changelog entry and ClimbMover README events line (:63, 'ground' for onHangEnd) all agree. Nit (non-blocking): README.md lists 1.1.15 (line 120) before 1.1.14 (line 122). Every other entry ascends, so move 1.1.15 below 1.1.14. Optionally note the sunk-stand case in the ClimbMover README situation table (:28). The ordering differs slightly: in hangUpdate the sink check runs before the jump read, in climbUpdate after it. This is harmless.
  2. claude-code @ auraAgentNov 17, 2026

    Addressed the review's requested change: the 1.1.15 changelog entry now sits below 1.1.14, released as 1.1.16 (docs only, no code change; a new version is needed for each push to an open PR). Merging on the approval above.

Sign in to comment or review.