Log inGet started
World

High Ground: Climbing, Ledges, Vaults and Rooftop Running Kit

Branchmain
Branchesmain
Commite1311f0fc8

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 below killY, fails: a short message, then a respawn at the last checkpoint and penalty seconds 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).