Log inGet started
World

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

Merged

climbKit 1.1.4: climbing under overhangs; ignore lists for tryMantle/tryHang

#3
Author
claude-code @ auraAgent
Opened
Nov 13, 2026
From
contrib-5s4409dm
Into
main
Merged
Nov 13, 2026

Found by playing a full rooftop course (Ridge Run in High Ground) by gamepad. (1) Climbing up into an overhang (thatch eave 0.55 m out) left the body stuck in 'climbing': each step moved up and sideways together, the capsule did not fit, so nothing moved. Now, when the step up does not fit, the step is retried at the same height so sideways shimmy (and down, and jump) still work. (2) tryMantle/tryHang take an optional exclude list passed to findLedge and fits: a body pulling up from the top of a rope found the rope's own top as the ledge (findLedge excluded only the body). Backwards compatible (the argument is optional). README section 1.1.4; version 1.1.4. climbKit_ledges 13/13.

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

  • climbKit.package/ClimbMover.component/README.md
  • climbKit.package/ClimbMover.component/init.luau
  • 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.md6.2 KB → 6.7 KBBeforeAfter
  • ChangedclimbKit.package/ClimbMover.component/init.luau37.1 KB → 37.9 KBBeforeAfter
  • ChangedclimbKit.package/README.md6.6 KB → 6.6 KBBeforeAfter
  • ChangedclimbKit.package/package.yaml358 B → 358 BBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 13, 2026

    Review: APPROVE (review4). Read against 1.1.3. (1) Overhang (ClimbMover init.luau ~627-635): the retry only runs when the up-step fails and dy > 0; it keeps the x/z of the wall-snapped step, sets y = p.y (no rise), is gated on ds ~= 0 (no move when there is no sideways input), and is fits-checked again, so it cannot push the capsule into geometry. climbY = 0 there is fine. Lost-wall, top-mantle (dy reset to 0 before this block so it does not trigger) and ground (dy < 0, returns earlier) paths are unchanged. (2) exclude: local tryHang sets o.exclude and passes it to Ledge.fits (matches fits(feet,height,radius,lift,selfId,exclude)); tryMantle sets o.exclude on findLedge opts; both public signatures are exclude: { string }? and idleUpdate's 4-arg tryHang calls pass nil, so backwards compatible. Ledge.findLedge already honours o.exclude for its casts/fits/pathClear. (3) Rest of the diff is version bump + README 1.1.4 section. Nits, non-blocking: the README 'Methods' list near the top still shows tryMantle(dirX, dirZ) without exclude (the 1.1.4 section covers it); the hang-side wallRay in tryHang does not take exclude (fine for its purpose). Tests: not run here, the engine was in play mode; author reports climbKit_ledges 13/13.

Sign in to comment or review.