n64decomp/sm64
Sm64
This project is a game source code decompilation effort that reconstructs a functional C source code representation of a commercial game from its original binary. It provides a compilation system designed to produce binary ROM files that are bit-for-bit identical to original commercial releases.
The project utilizes a containerized toolchain environment to ensure consistent compilation of legacy game source code across different operating systems. This pipeline transforms the decompiled C source into hardware-compatible binaries for the Nintendo 64.
The workflow encompasses C-based source reconstitution, cross-compiler target mapping for MIPS architecture, and the integration of static assets. Integrity is maintained through binary verification, comparing the hashes of newly built binaries against original ROMs to ensure byte-perfect matching.
Features
- Binary Decompilers - Reconstructs functional C source code representations of a commercial game from its original binary.
- Byte-Perfect Verifications - Provides binary verification by comparing newly built ROM hashes against original files to ensure byte-perfect reconstruction.
- Byte-Perfect Binary Generators - Implements a compilation system designed to produce binary files that are bit-for-bit identical to original commercial releases.
- Containerized Build Toolchains - Wraps compilers and libraries in a containerized environment to ensure consistent binary output across different host operating systems.
- Reproducible Build Environments - Packages the required toolchain and dependencies into a container to ensure consistent compilation across different operating systems.
- Build Environment Isolation - Uses containers to ensure game code compiles identically across different operating systems and development setups.
- Game ROM Compilers - Transforms decompiled source code into functional binary ROM files for various regional releases and hardware configurations.
- Binary Integrity Verification - Compares the hash of the newly built binary against original files to ensure byte-perfect accuracy.
- Decompiled Project Reconstructions - Reconstructs original game binaries from source code to verify the accuracy of the reverse engineering project.
- Cross-Compilation Toolchains - Utilizes a specialized toolchain to generate MIPS architecture binaries for legacy hardware from a modern host environment.
- Static Asset Embedding - Links external game data and static assets into the compilation process to replicate the original ROM memory layout.
- C Language Game Implementations - Provides a toolchain for compiling a C-based game implementation into hardware-compatible binary ROMs for the Nintendo 64.
- Platformers and Action - Full decompilation of a classic 3D platformer.
