Log inGet started
Package

ridgeRun.package

Newest version

This package holds more than this page lists. See all of its files in its world.

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).