Mount Panorama — Bathurst
A browser racing game on a real-scale Mount Panorama Circuit, Bathurst NSW, with
generated (code-only) medium-poly Gen3 Supercars: the Chevrolet Camaro ZL1, the
Ford Mustang GT and the Toyota GR Supra (new in 2026), plus a tribute car: Peter Brock's 1979
Holden Torana A9X hatchback #05 with 1979 Group C physics. Built with three.js, TypeScript and Vite.
Plan
The work order and item status are in docs/PLAN.md: graphics realism (toward about 75 % of the way to photoreal), phone strength, then racing realism.
This run ships to the codex/bathurst-plan preview branch. Main and production
stay at their existing revision. Phase 1 adds measured afternoon light, AgX tone
mapping, cascaded shadows, generated asphalt and terrain detail, eucalyptus crowns,
trackside detail and High-only AO, bloom, SMAA and camera effects. The fixed photo
round is in docs/REALISM.md; user review is pending. The rejected
car-material and floor-spark candidates are recorded in the plan rather than shipped.
High/Medium/Low pass the four frozen Mac evidence points. Real iPhone Medium
(three laps, at least 50 fps) and Low remain pending. See docs/VERIFICATION.md
for the per-tier feature audit and the limits of phone emulation.
Run
npm install
npm run dev # http://127.0.0.1:5180/
Production build: npm run build, then npm run preview (http://127.0.0.1:5181/).
Choose Circuit on the title screen to step through Mount Panorama, Adelaide
Parklands and Surfers Paradise. Switching reloads the scene.
- Adelaide opens directly with
?track=adelaide. The current 2026 Supercars
layout is 3.219 km, clockwise, with 14 numbered turns and generated
city/parkland surroundings. Sources and estimates:
docs/research/adelaide.md.
- Surfers Paradise (Gold Coast) opens directly with
?track=gold-coast. The
2025 Gold Coast 500 layout is 2.960 km, anticlockwise, with 15 numbered turns,
the beach chicane, the OSM high-rise skyline, the beach and the Broadwater.
The hairpins, the beach chicane and Hill Parade are measured from Queensland
Government aerial photos. The G:link tram and the public Gold Coast Highway
run beside the pit straight, and three pedestrian bridges cross the track.
Sources and estimates:
docs/research/gold-coast.md.
Elevation, road widths, sectors and timing lines on both street circuits are
documented estimates.
Shootout
Both Shootout modes run at Bathurst with the Camaro, Mustang, or Supra. After
picking a car, every run asks where the warm-up starts: the grid (pole position,
start lights and one full warm-up lap; the default) or after Forrest's Elbow (the
car is held for a 3, 2, 1 countdown on Conrod Straight just past the Elbow, then
rolls on warm tyres). The last answer is remembered per mode
in this browser. Then comes one full timed lap from the line. Both use full damage, track limits,
tyre wear, automatic gears, soft tyres, and the standard setup. ABS, traction
control and steering assist are on for everyone (phone and keyboard pedals are
on/off, so without them every brake press locks the wheels). Racing lines and
automatic recovery are disabled; Top 10 shows no ghost, while Arcade races the
current #1 lap for the car (or your own Arcade best). Steering sensitivity, touch
auto-throttle, analog pedals and other controls stay the player's choice in
Settings during a run. On a touch screen, every run
then asks whether to steer with Finger or Tilt. Tilt drives straight when the
phone's left-right axis is level, however upright or flat it is held; Centre tilt
makes the angle held straight ahead (up to 15° off level). Touch controls include
gear buttons when manual gears are active.
Each warm-up and flying lap ends at the 10-minute limit without a score. The
result screen explains the timeout and offers another warm-up or the main menu.
A warm-up timeout uses no competition attempt. A timed Top 10 timeout keeps
the attempt used; Arcade practice remains unlimited.
- Shootout Arcade allows unlimited practice runs. It never uses a competition
attempt or publishes an official score.
- Shootout Top 10 runs in weekly seasons, from Monday 00:00 to the next Monday
00:00, Sydney time. Each browser gets three competition attempts per season,
shared across all three cars. A warm-up costs nothing. Crossing into the timed lap
uses an attempt, including a lap that is abandoned or invalidated. The attempt is
saved in the browser at the line and confirmed with the server in the background.
- After a valid Top 10 lap, you can submit a public nickname or skip publication.
Skipping first shows a warning that the lap receives no leaderboard recognition
and the attempt remains used. Failed submissions stay saved for retry. If the
server refuses a lap, the reason is shown and the nickname can be changed, or the
lap skipped; a refused lap never blocks the next attempt.
- Nicknames are 1 to 24 characters after Unicode NFKC normalisation and trimming,
with no control, format (bidi, zero-width), private-use or unassigned characters,
and not on a short blocklist (matched case-insensitively with leetspeak folded).
The browser, the API and the database apply the same rules.
The boards show the current season only: all cars together, or one car. Each shows
the fastest published lap per browser, the Top 10, and refreshes every 15 seconds.
After publishing, the result shows the lap's place among every browser this season.
Board laps carry a replay that Arcade can race as a ghost. The introduction shows the
rules, remaining attempts, and previous results. Competition is unavailable until the
shared database is configured. Arcade remains available.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
