Static recompilation of Super Mario Bros. using doppelganger's disassembly
- D-Pad: WASD
- B: K
- A: L
- start: Enter
- select: Space
- z: Save state
- x: Load state
- Static translation of the disassembly to low-level C
- PPU & APU emulation layers
- Convert subroutines to C functions
- Convert most gotos to if statements
- Remove unused flag updates
- Replace PPU with direct draw calls
- Manually rewrite portions of the code to higher level C
- Fetch the submodules:
$ git submodule update --init --recursive-
Build raylib, follow the instructions here
-
Run
make buildin the root folder:
$ make build- Place a legally obtained dump/ROM of SMB called
smb.nesin the root folder to extract graphics data from - You can now run
./smb
- Install a recent version of
clangwith support for thewasm32target - Run
make wasm - Run an HTTP server in the
web/folder and openindex.htmlin your browser - Select a legally obtained dump/ROM of SMB to extract graphics data from
The output of the code generator is in the codegen/ folder. To regenerate it:
- Install Moonbit:
$ curl -fsSL https://cli.moonbitlang.com/install/unix.sh | bash -s '0.10.9+6e6c44045'- Run
make codegen
The generator accepts the original, unmodified disassembly. It assembles an original-address PRG image, recovers reachable instructions and callable regions, and emits structured C with the source comments. See the analysis and migration notes for techniques, validation, and current NROM limitations.
Run python3 tests/check_codegen.py for the ROM-free regression suite, or append
--rom with a local smb.nes to compare PRG bytes and replay the recorded 7,987
frames. These checks do not require Raylib.
Calls are emitted as CALL(routine, return_address) and keep the original
return addresses on the guest stack. Add EXTRA_CFLAGS=-DNATIVE_CALLS to any
make target to compile them as plain C calls instead.
To compile another compatible assembly input into a separate directory:
moon run src/main -- --input tests/nrom128.asm --output /tmp/nrom-codegen