Do I need the original game files to run Sonic Heroes Decompilation?

Yes. The project does not include the original game's assets, so you need your own copy.

Sonic Heroes Decompilation

DecompilationActive

Source code reconstructed from the original game's compiled binary, so the game can be understood, rebuilt and ported.

About

A work-in-progress decompilation of Sonic Heroes for the Nintendo GameCube, supporting the G9SE8P North America (NTSC-U) revision 0 release. The main executable and all 17 configured REL modules rebuild byte for byte, though that does not mean every function has been reconstructed as source. It does not produce a playable game and is not a port, and the repository contains no game code or assets.

Getting started

Put your own copy of the game in the orig folder, either as a disc image or extracted with Dolphin. With Python and ninja installed, run the configure script and then ninja, and use objdiff to compare functions against the original.

Known issues & limitations

The project is a work-in-progress decompilation and does not produce a playable game or a port.

What you need to run it

Original game files required. The project ships code only; you provide your own copy of the game (GameCube version).

Status & roadmap

PAL (G9SP8P) and NTSC-J (G9SJ8P) versions are planned for later.

AI assistance

LLMs help write the decompilation, but every function must match the original byte for byte in objdiff and CI checks the built executable's SHA-1.

FAQ

What is Sonic Heroes Decompilation?: Sonic Heroes Decompilation is an open-source decompilation of Sonic Heroes. Source code reconstructed from the original game's compiled binary, so the game can be understood, rebuilt and ported. The original game ran on GameCube.
Do I need the original game files to run Sonic Heroes Decompilation?: Yes. The project does not include the original game's assets, so you need your own copy.