- Python 59%
- C 40.9%
- CMake 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
Some checks failed
Repository policy / policy (push) Has been cancelled
Reviewed-on: #1 |
||
| .agents/skills/ignition-windows-decomp | ||
| .githooks | ||
| .github/workflows | ||
| database | ||
| decomp | ||
| docs | ||
| include/ignition | ||
| src | ||
| tests | ||
| third_party/stb | ||
| tools | ||
| .gitattributes | ||
| .gitignore | ||
| .python-version | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| CMakeLists.txt | ||
| dashboard.html | ||
| LICENSE | ||
| objdiff.json | ||
| pyproject.toml | ||
| README.md | ||
| uv.lock | ||
Racing Dynamite
Racing Dynamite is an open-source, portable C implementation and reverse-engineering effort of Ignition (1997, Unique Development Studios / Virgin Interactive), targeting the authentic standard Windows release (IGN_WIN.EXE). The DOS release (MAINDOS.EXE) is retained as a secondary reference.
Legal & Asset Notice
This repository contains strictly clean-room reverse-engineered source code, tools, and technical documentation.
No copyrighted game assets (graphics, 3D meshes, levels, sound effects, or music) are distributed with this repository.
To run the game, you must supply game assets from a legally purchased copy of Ignition (available on GOG.com or original CD-ROM).
Current Reconstruction Focus
As of 2026-10-07, the active goal is faithful reconstruction of
Ignition/Ignition/IGN_WIN.EXE, followed by modernization into C11/SDL2.
See the Windows decompilation plan for the verified target
fingerprint, migration boundaries, and next milestones. Windows reconstruction
replaces the superseded DOS work in decomp/; build tools, tracking, and symbol
maps will be retargeted in place. The old implementation is recoverable in Git
history and does not need a parallel source tree or maintained DOS build.
Historical DOS evidence remains a reference, not Windows completion. A provisional
x86 Clang/LLD harness now validates one routine; the active Windows SQLite inventory
and treemap report reconstruction and evidence separately. Original compiler
identification and native startup/gameplay validation remain pending.
Features & Goals
- Native Cross-Platform: Replaces legacy DirectDraw 3/5, DirectSound, and DirectInput with modern SDL2 (Windows, Linux, macOS).
- Accurate 1997 Simulation: Complete reverse-engineering of vehicle physics, surface interaction (
getsurf), AI waypoints (.POS), and track elevation (.SRF). - Software Rendering Parity: Authentic recreation of UDS's "Lisa3D" software rasterizer and 2D blitter.
- Thoroughly Documented: Every binary structure and engine subsystem is documented under
docs/. - Implementation Roadmap: Track completion milestones in
docs/roadmap.md.
Building from Source
Prerequisites
- C11 Compiler: GCC 14+, Clang 18+, or Visual Studio 2022.
- CMake: Version 3.20 or newer.
- Python & UV: Python 3.10+ managed via
uv. - SDL2: Development libraries (an automated fetch tool is provided).
1. Environment & Dependencies Setup
Install python tools and dependencies:
uv sync
Download SDL2 development files (if not using system package):
python tools/download_sdl2.py
2. Asset Extraction
Extract original game assets from your GOG install or CD image (game.gog):
python tools/extract_assets.py
(Assets are extracted locally to assets/ and remain strictly excluded from version control).
3. Compile & Run
Configure and compile using CMake:
cmake -B build -G "Ninja"
cmake --build build
Run format unit tests:
./build/test_formats
Launch the engine:
./build/racing_dynamite
4. Windows Reconstruction and Progress
decomp/ is the Windows reconstruction workspace. The focused C89 build and x86
emulator harness currently cover only Mem_InitHandles, not a playable game.
uv run tools/verify_matching.py
uv run python tools/verify_fidelity.py
uv run python tools/db.py status
uv run python tools/db.py update
uv run python tools/db.py update --check
The active store is database/decomp.db. JSON/Markdown/SQL snapshots and both
HTML dashboards are generated together. Open dashboard.html for the interactive
Windows treemap and evidence inspector. Read database guidance
before editing tracking. Most FPO candidates remain unidentified; no overall game
completion or native parity is claimed. Original assets remain untouched.
Project Structure
RacingDynamite/
├── include/ignition/ # Reconstructed engine headers, types, and format definitions
├── src/
│ ├── core/ # Engine entry point, timing, and main game loop
│ ├── formats/ # Binary asset decoders (.PIC, .COL, .SRF, etc.)
│ └── platform/ # SDL2 windowing, event loop, and framebuffer blitter
├── tests/ # Automated verification and format unit tests
├── tools/ # Python utilities (asset extraction, format inspectors)
├── docs/ # Full technical reverse engineering documentation
│ ├── formats/ # Binary file layout specifications
│ ├── engine/ # Engine architecture, game loop, physics, Lisa3D renderer
│ └── ghidra/ # Symbol tracking, function maps, and global memory tables
├── AGENTS.md # Repository rules and reverse engineering guidelines
├── CMakeLists.txt # CMake build configuration
└── LICENSE # GNU General Public License v3.0
License
This project is licensed under the GNU General Public License v3.0 (GPL-3.0-or-later).
Copyright (C) 2026 Patricio Labin Correa (@F1r3f0x).
See the LICENSE file for the full license text.