Tracks & races

Shipped tracks

The named city tracks — every one a post-flood city, real or fictional — are the playable lineup:

Track	URL	Notes
Mayday Bay	?track=sandbar	Tutorial lagoon; Reef Cup opener. Art-dressed. (Slug stays sandbar; display name is Mayday Bay.)
Angel Basin	?track=mexico-city	Reef Cup round 2. Greybox route-stub.
Container Chaos	?track=cape-town-drift	Reef Cup finale. Greybox route-stub.
The Maw	?track=the-maw	Figure-8 slalom. Art-dressed.
Shibuya Submerged	?track=shibuya-submerged	Greybox route-stub.
Liberty Drowned	?track=liberty-drowned	Greybox route-stub.
Kilauea Crown	?track=kilauea-crown	Greybox route-stub.
Marina Bay 7	?track=marina-bay-7	Greybox route-stub.
Doge's Drift	?track=doges-drift	Greybox route-stub.
Aqualand	?track=aqualand	Greybox route-stub.
Angkor Drowned	?track=angkor-drowned	Greybox route-stub.
Hatteras Light	?track=hatteras-light	Greybox route-stub.
Golden Gate Drowned	?track=golden-gate-drowned	Greybox route-stub.

Only two are art-complete

status: 'ship' means wired and playable, not art-complete. Only Mayday Bay and The Maw are dressed; the rest are greybox route-stubs awaiting the v2 art pass. The current proof-of-thesis is the Reef Cup (Mayday Bay → Angel Basin → Container Chaos) — see docs/tracks/README.md for the canonical lineup.

A handful of procedural dev tracks also ship for engine and physics work — they're built in code, not authored as city levels:

Track	URL	Notes
Lagoon Loop	/ (default) or ?track=lagoon	Stadium loop with a jump ramp on the right straight. Exercises raycast-vs-static-collider, surface alignment on a slope, and water re-acquisition on landing.
Cliffside	?track=cliffside	Mesa with a climb ramp on one side and a JetMoto-style cliff drop on the other. Doubles as the Blender-export reference layout.
Calibration	?track=calibration	Spec → GLB pipeline test. Round-trips through tools/blender/build_track.py. Useful as a clean reference scene.
Test Ring	?track=test-ring	Tiny diagonal-octagon for quick physics smoke tests.

?track= and ?bike= compose: http://localhost:5191/?track=cliffside&bike=stunt is "the most fun config" per the README.

Race rules

• 3 laps to finish by default (lapsToFinish in track JSON).
• Checkpoint enforcement: a checkpoint is only counted when crossed in order, in the forward direction — driving backwards through a gate is ignored.
• The direction arrow (Crazy Taxi style) above the player points to the next checkpoint. A sky beacon marks the gate itself.
• Crossing the start line after the final lap triggers the finish overlay — best lap, total time, and a Restart (R) prompt.
• Best lap is saved to localStorage per (track, bike) pair. View / clear it from the Garage menu.
• Boost pads are live gameplay: driving over a pad's volume applies a forward boost (boostPads in track JSON). Place them in Blender or the in-app editor.

AI racers

The grid is 8 bikes: you plus seven AI opponents. They:

• Follow a smooth-arc racing spline (buildStadiumAISpline) through the corners with per-bike line offsets so they hold parallel lines instead of converging into a pile-up.
• Scan ~1.5 s of upcoming spline, derive an implied corner radius, and cap target speed at √(latAccel × radius). Brake fires when current speed exceeds that target.
• Rubber-band to the leader — top speed adjusts to gap so the pack stays tight.
• Fire their own pickups via aiCombatSystem (see Pickups & combat).

Cliffside AI is rough

The climb ramp + cliff drop create a dead-end the AI can't recover from once it lands off-mesa. The bottom half of the track is fine. This is a level-design limitation, not a controller bug — see status.md and the README's Known issues.

Auto-play mode

Press T or F1 to toggle auto-play — the AI takes over the player bike. Useful for:

• Testing physics or input changes without holding a controller
• Demoing without a controller plugged in
• Sanity-checking that an AI spline actually completes a lap

Player and AI share the same ControlIntent plumbing — auto-play just adds AITag to the player so aiControlSystem writes their intent. Player intent is suppressed while auto-play is on.

Spawning

The player spawns on the racing line at the start gate, facing forward. The respawn action (default Backspace, rebindable in Settings → Controls) snaps you to the nearest racing-line point with zero velocity — and an automatic rescue fires on its own after ~2.5 s wedged against terrain or riding riderless. Useful when you've yeeted yourself off the world.

Track data format

Two flavors of track exist:

• Procedural (lagoon, cliffside) — built in code, in src/game/tracks/lagoon-loop.ts and cliffside.ts. Not editable in the in-app editor.
• JSON-driven (calibration, test-ring, lagoon-edit, anything you author) — gameplay data lives in public/tracks/<id>.json, optionally referencing a Blender-built environmentGlb.

For authoring, see Modding → Tracks.