Race modes & tracks

Procedural tracks

Every track is a closed-loop circuit generated in code from a seed — the same seed always produces the same track. Nothing is pasted from a schematic.

A generated track includes:

• Themed road with a dashed center line and red/white curbs.
• Glass barriers with lamps down both sides.
• A checkered start/finish line and a start gate that opens at GO.
• Checkpoint arches with hanging lanterns, in order around the loop.
• A tribune and an elevated lobby platform.
• Gentle slab-ramped hills (no jumping needed). Car tracks are always flat and hole-free.

Building is asynchronous and chunk-batched, so generating a big track never freezes the server.

/race generate <name> [seed] [laps] [length] [width] [theme]

• seed — any number; reuse it to rebuild the exact same track.
• laps — number of laps (default 3).
• length — control-point count ≈ track size (24 ≈ a ~900-block lap).
• width — road width in blocks (odd numbers recommended; cars need 9+).
• theme — one of the four below.

Four themes

Theme	Feel
NORMAL	Classic circuit.
ICE	Faster and slippery — higher top speed.
NETHER	Dark, warm-lit track.
NEON	Bright, glowing night track.

Two race modes

• Foot race — the default. Run the loop through the checkpoints.
• Car race — /race create <name> car. Each racer drives a detailed display vehicle with fully manual controls. See Car race & controls.

Live HUD

• Bossbar — current lap, position and time.
• Sidebar — the top racers plus your own line (hud.scoreboard-lines, default 8).
• Titles & actionbars — countdown beeps, a goat-horn start and status messages.
• Direction guidance — a pulsing particle arrow at GO and after every rescue, plus a WRONG WAY! warning when you run against the track flow.
• Finish fireworks — a firework per finishing position.

Custom music

A programmatic note-block engine — no resource pack:

• A lobby theme and per-theme racing themes.
• The final lap speeds up (150 → 200 BPM) and transposes up.
• A victory fanfare on the win.
• DISC mode plays jukebox discs instead, and each player can toggle music with /race music.

Survival-safe

• Players keep their own inventory — it is never touched, so dupes are impossible.
• No item drops or pickups during a race, no PvP and no damage.
• A command allow-list, plus elytra and ender-pearl blocks.
• Optional hotbar freeze.
• Falling off the track respawns you at your last checkpoint (no fall damage).

Everyone is restored to their original location, gamemode, flight and health on finish, leave, relog or the next server boot.

Next: Car race & controls.