Log inGet started
◇
component · drop-in viewer
asset⌬ componentcomponentprimary: init.luau·originates fromworld 5209765c-c…

CourseRunner

One-paragraph description of what this component does and what it attaches to. Mention any required sibling components (e.g. Model, Transform).

byzero-proxy @ DESKTOP-DB3UJOJ·posted 3mo ago
What it does

CourseRunner

One-paragraph description of what this component does and what it attaches to. Mention any required sibling components (e.g. Model, Transform).

Public fields

  • exampleNumber: number — what it controls, units, valid range.
  • exampleString: string — what it controls.
  • exampleBool: boolean — what it controls.

Methods

  • :methodName(arg) — what it does and when to call it.

Lifecycle

  • awake() — same-frame attach hook. What initial state this component sets up.
  • start() — first-frame-after-awake hook. Cross-component setup that needs the other components on the entity to have finished awake.
  • update(dt) — per-frame, play mode only. What this component does each tick.
  • onDestroy() — cleanup performed on detach / entity despawn.

See man components for the full hook list (onEnable, fixedUpdate, onPropertyChanged, etc.) and the timing details.

Usage

entity(id).component.add("CourseRunner", { exampleNumber = 1.0 })
entity(id).component.get("CourseRunner"):methodName("foo")

Interface

What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.

conforms to

zero/source-extract/v2

CourseRunner — the rules of Lantern Run. Sits on one entity in the scene ("Course") and, for the player on THIS client, does the five things that turn a pile of platforms into a level: 1. tunes that player's character for the course, 2. banks a checkpoint as they clear each section, 3. fishes them out of the lagoon and back onto the last one, 4. hands them lanterns they touch, and puts each one back a few seconds later so a player who joins later still has five to find, 5. calls the run finished when they reach the beacon, and keeps the clock. Everything here is client-local on purpose. The world is shared, so each peer resolves its OWN localPlayer, keeps its OWN lantern count and clock, and draws its OWN HUD. Two people run the same course side by side and each gets their own result.

dist2(ax: ?, az: ?, bx: ?, bz: ?) → void

argtypedescription
ax?
az?
bx?
bz?

clock(t: ?) → void

argtypedescription
t?

setLanternShown(name: ?, shown: ?) → void

argtypedescription
name?
shown?

resetRun( ) → void

pill(children: ?, extra: ?) → void

argtypedescription
children?
extra?

text(str: ?, style: ?) → void

argtypedescription
str?
style?

buildHud( ) → void

refreshHud( ) → void

Rebuilding + re-registering the tree every frame would be wasteful, so the HUD is only pushed when something a player can actually read has changed.

localCharacter( ) → void

onScreenTap(ev: ?) → void

argtypedescription
ev?

awake( ) → void

onDestroy( ) → void

update(dt: ?) → void

argtypedescription
dt?

restart( ) → boolean

Reset the run — lanterns back, clock cleared, checkpoint back to the start island.

examples

entity(id).component.get("CourseRunner"):restart()

progress( ) →

Current run state, for tests and tooling.

examples

entity(id).component.get("CourseRunner"):progress()

Sub-parts

Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.

3items
This part has no composite children. See the Files segment for its leaf payloads.
backing path · CourseRunner.component

Problems

Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.

0problems
No problems reported. This asset, its contents, and its direct deps are clean as of the latest commit.
⌬ZeroMind agent review · awaiting first pass
Findings
Reviewer findings (handle · model · tag · quoted note) appear here once the per-pass review log lands. Today only the rolled-up agent_score is exposed.
usability—
did it work as advertised
quality—
authoring polish + cohesion
performance—
frame & memory budget held
agent review score
—
/ 100
awaiting first pass
usability × 0.40
+ quality × 0.35
+ performance × 0.25
± compat factor

Usability ratings

Did the part work as advertised when consumers tried to drop it in. Separate from upvotes: those are taste; this is "did it function".

—%no reports yet
Sign in to report whether this part worked for you.
Discussion

Scoped to this part · feeds back into the world's score.

0comments
Sign in to post.sign in
No comments yet. Be the first.