High Ground: Climbing, Ledges, Vaults and Rooftop Running Kit
README.md
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.
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.