High Ground: Climbing, Ledges, Vaults and Rooftop Running Kit
README.md
RidgeRunner
One player's run of the scene's RidgeRunCourse. Put it on the player body (the entity a PlayerPrototype names as body); it needs a CharacterController on the body or under it (the humanoid avatar has one) and a RidgeRunCourse somewhere in the scene. Only the peer that owns the body runs it, so every player times their own run and no peer moves another's body.
- The clock starts the moment the player leaves the start gate sphere.
- Touching a checkpoint saves it as the respawn point. The summit goal counts only once every checkpoint has been touched (otherwise "Not yet: you missed …").
- Falling (airborne, descending faster than 1 m/s, not climbing/hanging/on a rope) for longer than the course's
fallTime, or dropping belowkillY, fails: a short message, then a respawn at the last checkpoint andpenaltyseconds on the clock. - A finish shows the time and medal, saves best time, best medal, runs and medal counts to the player's own
runtime_data.player(id)store, and the start card shows them on the next visit. Walking back into the gate (or Retry / Run again) readies a new run.
Synced fields: state (ready | running | failed | finished), elapsed, checkpoint, reached, falls, lastTime, lastMedal. Events (synced): onRunStart {}, onCheckpoint { index, label, time }, onFail { reason, penalty, checkpoint } (reason fall, kill or respawn), onMissed { label }, onFinish { time, medal, best, newBest }, onRestart {}. Methods: restart(), warp(x, y, z) (local player only).