·
scene · drop-in viewer
What it does
No description provided yet.
Interface
What this asset declares: the schema it conforms to, what it exposes, and the rendered structured payload.
This asset doesn't declare a schema or structured payload.
Sub-parts
Everything contained inside this part. Assets are composite children (clickable cards). Files are leaf payloads. Expand any row to view its source.
Showing up to 3 levels deep. Open a part to see what it holds further down.
34+items
# gp
One-paragraph description of what this module provides and who consumes
it.
## Exports
- `M.exampleFn(arg) -> result` — what it does and when to call it.
- `M.exampleValue: type` — what value it carries.
## Usage
```luau
local M = require("@<youridentity>::modules.gp")
M.exampleFn("foo")
```
## Notes
- Anything callers need to know about THIS module: required runtime
ordering, state ownership, side effects.
▲ 0↑ born
# hud
<!-- zero:scaffolded-readme -->
<!-- Replace the line below with what this module provides and who
consumes it, then delete both comment lines. -->
TODO: describe this module.
▲ 0↑ born
# combat — crates and missiles
The ammunition on the road and the weapon it loads.
Ten crates hover on the racing line, alternating side to side so a lap
offers a choice of line. Any racer that drives through one is armed, the
crate goes dark, and it comes back eight seconds later. A held round is
spent with **Space**: it leaves the chair, follows the road at 72 m/s,
snakes through the corners after the racer ahead, and detonates on it.
The victim loses control for a little over two seconds, which on a lap
this long is a place.
## What the scene calls
```luau
Combat.build() -- lay the crates, build the missile and blast pools
Combat.update(dt) -- pickups, triggers, flight, impacts
Combat.teardown() -- clear everything the slice spawned
```
Two read-only extras, useful from a console or a HUD:
```luau
Combat.inFlight() -- rounds in the air right now
Combat.status() -- slice clock, crates live/away, next crate back, pool size
```
## How it is put together
Everything that moves comes out of a **pool built once** in `build()`:
six missiles, five blasts, ten crates, all parented to `combat_root`.
Adding a `Model` component costs milliseconds, so nothing is spawned at
the moment a trigger is pulled — a sleeping body is woken, flown, and put
back. `combat_root` is marked temporary, so none of it is saved into the
scene; it is rebuilt from code every load.
**Guidance** runs in two phases. Far from the target the round reads the
racing line ahead of itself and slides across toward the victim's line,
so it follows the circuit instead of driving into a barrier. Inside
`lockRange` it abandons the road and flies straight at where the chair
*will* be, leading its speed. The barriers contain a round rather than
killing it — it scrapes the wall and is turned back down the road, so a
shot fired from a chair a metre onto the run-off still counts.
**Impact** is a swept proximity fuse: at 72 m/s a frame is three metres,
so the test is the closest approach along the whole step, not the point
where the step happened to end.
The slice keeps **its own clock**. Crate respawns and rival reload timers
are measured against it and not `GP.state.clock`, which the race director
rewinds to zero at every start.
## Rivals shoot too
A rival holding a round takes the shot at whoever is in front of it,
after a moment of hesitation and with a cooldown between shots — so the
field fights among itself and a place is never safe. Turn it off with
`GP.TUNE.missile.aiFire = false`.
## Firing with nobody ahead
Leading the race, the trigger keeps the round and the HUD is told
`NOTHING AHEAD`. A missile is only worth spending at something.
## Range
A round burns out after `lifetime` seconds, which at `speed` is about
430 metres of road. That is far more than the gap between two racers in a
real race, and less than a full lap — a racer half a circuit ahead is out
of reach, which is the point.
## The numbers
All of them live in `GP.TUNE.missile` and `GP.TUNE.pickup` and are read
live, so a change is felt without a reload.
▲ 0↑ born
# racer
<!-- zero:scaffolded-readme -->
<!-- Replace the line below with what this module provides and who
consumes it, then delete both comment lines. -->
TODO: describe this module.
▲ 0↑ born
# field
<!-- zero:scaffolded-readme -->
<!-- Replace the line below with what this module provides and who
consumes it, then delete both comment lines. -->
TODO: describe this module.
▲ 0↑ born
# HARBOUR NIGHT
The circuit CHAIRSHIFT GP is raced on: 1121 m of street track, eleven
corners, run under floodlights.
```
START/FINISH 216 m of pit straight, the boost straight
T1 MARINA r 20 hard right off the straight, the harbour outside it
T2 QUAYSIDE r 34 long open right past the container yard
T3/T4 CHICANE r 13 left-right flick under the sponsor arch
T5 SWEEPER r 70 97 m of one radius, flat out, main grandstand
T6 KINK r 55 barely a lift, onto the 135 m north straight
T7 CATHEDRAL r 26 entry past the spire
T8 HAIRPIN r 15 40 m of arc round the hotel, the slowest point
T9 RAMPART r 16 exit along the old wall
T10 DOCKSIDE r 30 under the cranes
T11 HARBOUR r 30 long, slow, and it opens onto the straight
```
Every corner carries a lit board on its approach, and every corner has
something beside it you can only find there — the marina, the containers,
the grandstand, the spire, the hotel, the cranes, the pit lane. You should
never have to look at a map to know where you are.
## How it is built
The circuit is a closed polygon of eleven corner vertices, each fitted with
a circular arc of a stated radius; the straights are whatever is left of the
edges between them. The polygon closes, so the lap closes — a radius can be
changed without re-solving the whole shape. `CORNERS` at the top of
`init.luau` is the whole design.
That path is walked at a uniform 2.2 m step. Every other sample becomes the
racing line published to the rest of the game through
`GP.setCentreline(points, { halfWidth = 8 })`, which is the only thing any
other slice reads from here.
The road, kerbs, walls, glowing panels and every piece of scenery are built
as runtime meshes, one per material, rather than as thousands of cubes. A
1121 m circuit with a city around it costs 19 mesh entities, 26 floodlights
and 13 lit boards.
## Numbers worth knowing
| | |
|---|---|
| Lap | 1121 m |
| Road | 16 m wide (`halfWidth` 8) |
| Verge | 2 m either side, then the wall |
| Wall | inner face at 10 m — exactly where a chair is held |
| Longest straight | 216 m |
The wall is drawn at `halfWidth + 2`, which is the same number the chair and
the rivals clamp themselves to, so the barrier a driver hits is the barrier
a driver sees.
## Exports
- `Track.build()` — publishes the racing line, then lays the circuit.
- `Track.update(dt)` — re-publishes the line if the shared module reloads
and resets it.
- `Track.teardown()` — removes the circuit and the night grade.
- `Track.cornerAt(t)` — the corner number and name at a lap fraction, or
`0, "STRAIGHT"`.
- `Track.CORNERS` — the design itself.
▲ 0↑ born
▲ 0↑ born
backing path · scenes/main.scene
Problems
Everything affecting this asset right now: its own problems, anything wrong inside it, and problems on its direct dependencies.
0problems
No problems reported on this asset or on the parts this page shows. Parts it leaves out are not counted here.
⌬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
+ 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.