Ignition / Funtracks decomp and port project
  • Python 59%
  • C 40.9%
  • CMake 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
F1r3f0x 06261676b6
Some checks failed
Repository policy / policy (push) Has been cancelled
Merge pull request 'Update Master' (#1) from decomp into master
Reviewed-on: #1
2026-10-20 02:33:07 -03:00
.agents/skills/ignition-windows-decomp Revert "Reapply "docs: add Luna and Antigravity Flash delegation workflow"" 2026-10-08 00:13:29 -03:00
.githooks chore: enforce staged agent workflow and validation handoffs 2026-10-07 13:01:26 -03:00
.github/workflows refactor: migrate verified Windows input and enforce module ownership 2026-10-12 22:18:57 -03:00
database Merge pull request 'Update Master' (#1) from decomp into master 2026-10-20 02:33:07 -03:00
decomp re: reconstruct Menu_ApplySettings 2026-10-20 01:41:32 -03:00
docs Merge pull request 'Update Master' (#1) from decomp into master 2026-10-20 02:33:07 -03:00
include/ignition PE executable scrubbed 2026-10-05 13:57:18 -03:00
src PE executable scrubbed 2026-10-05 13:57:18 -03:00
tests Merge pull request 'Update Master' (#1) from decomp into master 2026-10-20 02:33:07 -03:00
third_party/stb feat(port): complete initial reverse engineering, asset pipeline, and SDL2 source port scaffold (Phases 1-5) 2026-09-07 08:40:11 -03:00
tools Merge pull request 'Update Master' (#1) from decomp into master 2026-10-20 02:33:07 -03:00
.gitattributes refactor: migrate verified Windows input and enforce module ownership 2026-10-12 22:18:57 -03:00
.gitignore re(tools): implement dynamic runtime execution differ and memory telemetry harness 2026-10-02 11:02:15 -03:00
.python-version feat: initial project setup, GPLv3 license, technical documentation, asset pipeline and SDL2 source port scaffold 2026-09-03 16:34:06 -04:00
AGENTS.md refactor: migrate verified Windows input and enforce module ownership 2026-10-12 22:18:57 -03:00
CHANGELOG.md re: migrate Windows tracking and add evidence treemap 2026-10-07 08:49:22 -03:00
CMakeLists.txt port(lisa3d): decompile CDP animation and horizon panorama rendering functions 2026-09-12 13:27:27 -03:00
dashboard.html Merge pull request 'Update Master' (#1) from decomp into master 2026-10-20 02:33:07 -03:00
LICENSE feat: initial project setup, GPLv3 license, technical documentation, asset pipeline and SDL2 source port scaffold 2026-09-03 16:34:06 -04:00
objdiff.json port(dos): resolve all undefined symbols, link runtime libraries, and verify DOSBox execution 2026-09-30 00:40:07 -03:00
pyproject.toml re(tools): implement dynamic runtime execution differ and memory telemetry harness 2026-10-02 11:02:15 -03:00
README.md re: migrate Windows tracking and add evidence treemap 2026-10-07 08:49:22 -03:00
uv.lock re(tools): implement dynamic runtime execution differ and memory telemetry harness 2026-10-02 11:02:15 -03:00

Racing Dynamite

License: GPL v3 Standard: C11 Platform: SDL2

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.


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.