Status
Early development. Tasks 1 through 20 are verified headlessly: project foundation, driving prototype, vehicle dynamics, data-driven architecture, suspension and tires, drivetrain, first circuit with a deterministic lap, race loop with lap state, one AI rival, chase cameras, live race positions, a multi-car field, varied AI pace, recorded race results, a full 3-lap race, a player-facing race HUD data path, a cockpit camera with view selection, line-commit AI racecraft, and defend-the-line AI racecraft. There is no public release yet.
Project
- Platform: macOS ARM64
- Engine: Unreal Engine 5.8.2
- Renderer: Metal
- Scope: one car, one track, single-player
- Direction: realistic simcade
Engineering
The game owns its vehicle and track architecture in a dedicated module
(Source/RacingGame): a vehicle actor with a public input
path, a data-driven movement component (force model, suspension, tire
forces on a friction circle), an engine/transmission/differential
drivetrain, a runtime-built circuit (road collision, boundaries,
centerline, ordered checkpoints), a race manager (phases, laps, timing),
a pursuit-driving AI rival, look-ahead chase cameras, live race
positions, a multi-car field on track-derived grid slots, varied AI
pace, recorded race results, a rigid cockpit camera with view
selection, and line-commit AI racecraft, and defend-the-line AI
racecraft, all
covered by automated headless verification. Template vehicle code is retained for
project defaults and
untouched by game code.
See docs/architecture.md
and docs/testing.md.
Verification
| Milestone | Functional gate | Visual verification | Human feel |
|---|---|---|---|
| Task 1: project foundation | PASSED | BLOCKED | NOT VERIFIED |
| Task 2: driving prototype | PASSED | BLOCKED | NOT VERIFIED |
| Task 3: vehicle dynamics | PASSED | BLOCKED | NOT VERIFIED |
| Task 4: vehicle architecture | PASSED | BLOCKED | NOT VERIFIED |
| Task 5: suspension and tires | PASSED | BLOCKED | NOT VERIFIED |
| Task 6: drivetrain | PASSED | BLOCKED | NOT VERIFIED |
| Task 7: first track and lap | PASSED | BLOCKED | NOT VERIFIED |
| Task 8: lap and race state | PASSED | BLOCKED | NOT VERIFIED |
| Task 9: AI opponents | PASSED | BLOCKED | NOT VERIFIED |
| Task 10: cameras | PASSED | BLOCKED | NOT VERIFIED |
| Task 11: race positions | PASSED | BLOCKED | NOT VERIFIED |
| Task 12: multi-car field | PASSED | BLOCKED | NOT VERIFIED |
| Task 13: AI pace variation | PASSED | NOT VERIFIED | NOT VERIFIED |
| Task 14: six-car field | PASSED | NOT VERIFIED | NOT VERIFIED |
| Task 15: race results | PASSED | NOT VERIFIED | NOT VERIFIED |
| Task 16: full 3-lap race | PASSED | NOT VERIFIED | NOT VERIFIED |
| Task 17: race HUD | PASSED | NOT VERIFIED | NOT VERIFIED |
| Task 18: cockpit camera and view selection | PASSED | NOT VERIFIED | NOT VERIFIED |
| Task 19: line-commit AI racecraft | PASSED | NOT VERIFIED | NOT VERIFIED |
| Task 20: defend-the-line AI racecraft | PASSED | NOT VERIFIED | NOT VERIFIED |
Rendered Metal verification is resolved (first frames captured; see Screenshots). Per-task visual status above reflects whether that task ran a capture pass. Full evidence: task-1-e2e.md, task-2-e2e.md, task-3-e2e.md, task-4-e2e.md, task-5-e2e.md, task-6-e2e.md, task-7-e2e.md, task-8-e2e.md, task-9-e2e.md, task-10-e2e.md, task-11-e2e.md, task-12-e2e.md, task-13-e2e.md, task-14-e2e.md, task-15-e2e.md, task-16-e2e.md, task-17-e2e.md, task-18-e2e.md, task-19-e2e.md, task-20-e2e.md.
Screenshots
Current prototype renders from the real Metal renderer. Evidence of rendering, not of gameplay quality, performance, or final graphics.
Roadmap
- Foundation: project, prototype environment (done)
- Driving: vehicle physics, suspension, tires, drivetrain (done)
- First track: circuit geometry, checkpoints, deterministic lap (done)
- Racing: lap systems, timing, race rules, AI rival (done)
- Cameras: chase cameras, look-ahead (done)
- Positions and field: live standings, 6-car grid (done)
- Pace and results: AI pace tiers, recorded race results (done)
- Full race: 3-lap completion, active-racer results (done)
- Race HUD: countdown, lap, position, result read-out data path (done)
- Cockpit camera: rigid cockpit view with deterministic switching (done)
- Line-commit racecraft: attacker commits to the free side and cedes (done)
- Defend-the-line racecraft: defender answers the rear window and cedes (done)
- Graphics: final vehicle, materials, lighting
- Audio and UI
- Optimization for Apple Silicon
- Beta and release
Releases
Not yet available. No version has been tagged.
Scholarship
The scholarship report is the chronological engineering record: what was built, measured, decided, and left unverified. It is append-only and evidence-first.