About
A native PC port of Hot Wheels Turbo Racing for the PlayStation (Stormfront
Studios / Electronic Arts, 1999, SLUS-00964), written in Rust from a reverse
engineering of the game. It plays your own disc.
Status: early. The port does not play yet. What runs today:
hwtris the port, and runs only ported code. So far it is the platform: window, pad, the disc's boot screens.- Ported and checked against the original: the game's flow (its table-driven state machine) and the car's physics step (tyres, suspension, engine and gearbox, aerodynamics, the rigid body, air control).
hwtr-viewer TRACKflies around any of the eleven tracks, drawn from the disc's data with the game's own texture lookup, cars on the start grid.hwtr-hleruns the original game, instruction by instruction, in this project's interpreter with the console's libraries supplied by the host. It is the reference:lockstepchecks every ported function on every call the running original makes.
Not an emulator
The port will run none of the PlayStation's code. The game is rewritten in Rust, subsystem by subsystem, and each part is checked against the original function: the original runs instruction by instruction in a small R3000A + GTE interpreter written for this project, and the port has to produce the same results. During play nothing from the PlayStation runs and no BIOS is needed.
What is here
| path | what |
|---|---|
retro_rt (rrt) | the shared runtime for the ports, a git dependency: the disc (CUE, raw sectors, ISO 9660 with CD-XA), the window and loop, the pad (DualSense or any gamepad as a PlayStation pad), wgpu plumbing, PNG |
crates/hwtr-data | reads the game's data: the BIG archives, and the asset formats as they are decoded |
crates/hwtr-psx | the PS-X EXE format, an R3000A + GTE disassembler, static analysis |
crates/hwtr-re | the reverse engineering command line |
crates/hwtr-cpu | an R3000A + GTE interpreter that runs original functions |
crates/hwtr-hle | runs the whole original game in it: GPU, DMA, SPU registers, CD and BIOS supplied |
crates/hwtr-game | the port: the game's systems rewritten in Rust |
crates/hwtr | the program: the port, on retro_rt's loop |
crates/hwtr-viewer | flies around the tracks |
symbols/ | names for the executable's functions and data, with confidence notes |
docs/ | the reference: what is true about the disc, formats and engine |
docs/cut/ | cut, missing and unreachable content, one page each |
WORKLOG.md | the worklog: how each fact was found |
plans/ | what comes next |
The reverse engineering tools are Rust, in the same workspace as the port, so the code that proved a format is the code the port uses.
Using it
Put the disc where the tools look for it, then extract:
&&
# the original, headless, frames to work/hle
# every ported function, checked in play
Any file argument may be disc:NAME to read straight off the CD.
No game data is in this repository; original/ and work/ are ignored.
License
MIT or Apache-2.0, at your option. Hot Wheels is a trademark of Mattel; this project is not affiliated with Mattel, Electronic Arts or Stormfront Studios.