SMB

Play it online

Static recompilation of Super Mario Bros. using doppelganger's disassembly

Controls

• D-Pad: WASD
• B: K
• A: L
• start: Enter
• select: Space
• z: Save state
• x: Load state

Checkpoints

• 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

Building

Linux & MacOS

1. Fetch the submodules:

$ git submodule update --init --recursive

2. Build raylib, follow the instructions here

3. Run make build in the root folder:

$ make build

4. Place a legally obtained dump/ROM of SMB called smb.nes in the root folder to extract graphics data from
5. You can now run ./smb

WebAssembly

1. Install a recent version of clang with support for the wasm32 target
2. Run make wasm
3. Run an HTTP server in the web/ folder and open index.html in your browser
4. Select a legally obtained dump/ROM of SMB to extract graphics data from

Codegen

The output of the code generator is in the codegen/ folder. To regenerate it:

1. Install Moonbit:

$ curl -fsSL https://cli.moonbitlang.com/install/unix.sh | bash -s '0.7.1+c0b22a8b0'

2. Run make codegen

References & Resources

• doppelganger's disassembly
• SuperMarioBros-C by MitchellSternke
• Nesdev Wiki
• nessy
• An Overview of NES Rendering by Austin Morlan