Rushline
A browser-native 3D precision time-trial racer inspired by Trackmania. Chase medals, beat your ghost, and stick loops on nine hand-built tracks — or run Rush Cup. Desktop, touch, and gamepad.
Live stack: React 19 · TanStack Start · Three.js r185 · Zustand · Tailwind v4 · Web Audio
Feature map
The TM-depth set now on this build. Help (menu, pause, or Settings) opens the same catalog plus the live control sheet.
| Feature | What it is |
|---|
| Rewind | Hold Backspace or LB + Y to scrub the last few seconds. The race clock and ghost compare walk backward with you. Allowed in time trial and Rush Cup. Does not wipe a standing personal best — only a finish after rewind can replace it. Toggle Enable Rewind in Settings (on by default on desktop). |
| Surfaces | Plastic, dirt, ice, and tech change grip — not just paint. The HUD chip names the ribbon under the car. |
| Cameras | C cycles Chase → Far → Hood → Cabin. All four stay usable at speed. |
| Checkpoint respawn | R (or Y) returns you to the last checkpoint. Hold R / Y, or press Delete, to restart from lights-out. |
| Ghost share | Export a last-run or PB tape as JSON from Results or Tracks, then import a friend's file as a rival. Local download / pick-a-file only. A rival never overwrites your PB, last run, Rush Cup, or Garage paint. |
| Author ghosts | Every stock circuit ships an author-line ghost paced to the Author medal. A personal-best or imported rival replaces it. The rival hides through lights-out, fades when you overlap, and toasts PASSED / OVERTAKEN when the lead flips. |
| Editor 1.1 | Edit ribbon on Custom — control points, click-to-place checkpoints and boost pads, undo/redo, snap-to-grid, flatten, and a ribbon flythrough. Save stays on this device (rushline-custom-v1); Export / Import is JSON. Time trial only. |
| Hotseat | Two players on one device. P1 drives, then P2 races P1's ghost on the same circuit. A local scoreboard compares the times. |
| Validated | Finish without rewind and results shows a soft Validated badge. Rewind still counts for PB and medals. Local only — not online anti-cheat. |
| Stock laps | Settings can set time-trial and hotseat laps on the stock nine to 1 / 2 / 3 (or Track for each circuit's authored count). Medals scale with the lap count. Custom and Rush Cup keep their own laps. |
| Replay viewer | Watch replay from Results follows last run, the shipped author ghost, a PB, an imported rival, or a hotseat tape. Pause / play, scrub, then Done. Photo mode stays a still. |
| Photo mode | Freeze a still with the HUD hidden. Open from the camera button, Pause, Results, F, or LB + View. |
| Rush Cup | Clear Gold (or better) on all nine tracks in order, then Author Cup unlocks on the same nine. Progress lives in localStorage under rushline-cup-v1. |
| Garage | Six liveries: Ivory, Violet, Sun, Frost, Carbon, Hazard. Cosmetic paint persists in rushline-v1 and rushline-settings-v1. |
Help lists the keyboard, touch, and gamepad bindings that are actually live. Settings has a Slow / Normal / Fast steering preset for keyboard and pad (Track Assist scales are unchanged).
Tracks
| Track | Vibe | Length | Signature |
|---|
| Green Circuit | Stadium plastic | ~1064 m | Banked stadium oval, boost pads, tight chicane · 2 laps |
| Ridge Drop | Canyon dirt | ~1213 m | Paved start, dirt canyon, downhill jump |
| Night Helix | Night tech | ~727 m | Full loop, sticky metal helix, night lights |
| White Pass | Alpine ice | ~948 m | Switchbacks, packed ice, long descent |
| Arc Yard | Works tech | ~952 m | Metal docks, gantry climb, freight drop |
| Red Mesa | Desert dirt | ~1118 m | Dirt climb, plastic table, dirt edge drop |
| Black Hollow | Forest dirt | ~819 m | Moonlit dirt pines, then a tech clearing sprint |
| Ember Caldera | Lava dusk | ~1011 m | Ash rim, lava-glass hairpins, crater drop |
| Storm Dock | Rain city | ~901 m | Wet streets, ice plaza, tech pier sprint |
| Custom | Your ribbon | editor | Closed Catmull-Rom loop you place yourself |
Each stock track has author / gold / silver / bronze times, checkpoints, boost pads, and a shipped author ghost. Custom lives at the bottom of Tracks — Edit ribbon opens Editor 1.1 (control points, click-to-place checkpoints and boost pads, undo/redo, snap-to-grid, flatten, and a ribbon flythrough). Drive it in time trial. Rush Cup stays the stock nine.
Surfaces change how the car grips. Plastic (Circuit, Mesa table, Storm streets) is the stadium baseline — slide-friendly but readable. Dirt (Ridge, Mesa climb/drop, Hollow pines, Ember ash) enters a slide earlier and pulls accel. Ice (White Pass, Storm plaza) is the slipperiest: weak brakes, early slide, a high hiss. Tech (Helix, Yard, Hollow clearing, Storm pier) sticks later and stops harder.
A personal-best ghost is saved with the time and replaces the author line. If that ghost is missing or too thin, the last finished run is used instead. An imported rival also replaces the author line. Results can Retry vs last run to race that lap even when a stronger PB ghost exists. Best / last / medal times sit on each track card. The rival hides through lights-out so it does not sit on your grid car, fades when you overlap, and toasts PASSED / OVERTAKEN when the live split flips.
Ghost share files live in localStorage under rushline-ghost-share-v1. Clear the rival from Tracks when you want the usual ghost back.
Photo mode
Freeze a still with the HUD hidden.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
