seedOf(s: string) → number

Deterministic RNG — a 32-bit LCG, seeded by a string. The world is multiplayer and the hazards are built independently on every peer. Seeding from a string (never from os.clock or math.random) is what makes two peers agree on where the debris is.

rng(seed: string | number) → void

next( ) → number

range(lo: number, hi: number) → number

int(lo: number, hi: number) → number

dir( ) → void

A random unit vector, evenly spread over the sphere.

add(a: ?, b: ?) → void

Vectors

sub(a: ?, b: ?) → void

scale(a: ?, k: number) → void

len(a: ?) → number

norm(a: ?) → void

lerp(a: ?, b: ?, t: number) → void

dist(a: ?, b: ?) → number

dist2(a: ?, b: ?) → number

Squared distance — for the range gates that run over every object every frame and never need the root.

arr(a: ?) → void

quatAxisAngle(axis: ?, angle: number) → void

Rotation Quaternion { x, y, z, w } for a rotation of `angle` radians about `axis`.

lookRotation(d: ?) → void

The rotation that points a mesh's +Z down `d`. Anything long and travelling — an ember on a flare front, a lantern's trailing bell — needs this, or it is a stretched sphere pointing the wrong way.

arr4(q: ?) → void

spawn(bag: ?) → void

Entity bookkeeping Everything a hazard module spawns is temporary (never saved into the scene) and tracked, so onDestroy can prove it left nothing behind.

despawnAll(list: { any }) → void

alive(e: ?) → boolean

despawnByPrefix(mount: ?, prefix: string) → number

Sweep a mount point for anything a PREVIOUS instance of this module spawned. A module-local list is not enough on its own. Editing a `.module` file hot-reloads it into a FRESH table with fresh locals, so the tracking list that held the last build's entities is gone while the entities themselves are still parented to the mount. Names are the only handle that survives the reload, so every hazard module prefixes what it spawns and sweeps that prefix when it starts.

queue( ) → void

A spawn queue, because a hazard field is a hundred entities and spawning a hundred entities inside one update() is a watchdog halt: "script halted by the watchdog: it ran for more than 1000 ms". Build enqueues; update drains a few per frame; the field fades in over about a second instead of stalling the whole engine for one.

push(bag: ?, assign: ?) → void

drain(budget: number) → number

pending( ) → number

clear( ) → void

routes(sites: ?, origin: ?) → void

Routes — the crossings the voyage is actually made of Every hazard in this slice is placed against THIS list rather than against hardcoded coordinates, so if Slice C moves a site the danger moves with it. A route is the straight line between two waypoints (the spawn origin counts as one); the list comes back longest first, because the long crossings are the ones worth making expensive.

along(route: ?, t: number) → void

A point `t` of the way along a route.