Evidence at a glance #
source evidence…
What was done #
This project provides a byte-perfect C decompilation of the USA PlayStation release of Final Fantasy VII. It uses AI-assisted workflows to convert assembly to C, ensuring every function compiles to match the original game's instructions exactly.
The Final Fantasy VII (PS1) decomp project aims to decompile the USA PlayStation version of the game into C code that rebuilds into byte-perfect executables. The repository does not contain game files; users must provide their own disc images. The project utilizes a custom toolchain, including GCC 2.6.3 and 2.7.2, to ensure the resulting binaries match the original game's instructions. As of the latest documentation, 69% of the 8,424 functions across 319 executables have been decompiled into C, with the remainder still represented as assembly via INCLUDE_ASM. The author reports that most C code was written with AI assistance, specifically using Claude Code and Claude Opus 5.5 models to process assembly and m2c drafts. The workflow involves batches of agents, though progress is occasionally limited by usage caps. The project maintains strict verification: a function is only accepted if it compiles to match the original game's instructions exactly, with byte-for-byte comparisons performed against the source disc.
Reproduce it #
Users must set up a Python 3.12+ environment, install the required GNU toolchain for MIPS (PS1), and configure the specified C compilers. The build process involves using `tools/extract_disc.py` to extract files from the game disc and `tools/build.py` to compile and verify the output against the original binaries.