Super Mario 64 DS

A work-in-progress decompilation of Super Mario 64 DS.

Important

This repository does not contain any game assets or assembly whatsoever. An existing copy of the game is required. This project itself is not, and will not, produce a port, to PC or any other platform. It is a decompilation of the original game code, which can be compiled back into a binary identical to the original.

Setup

Prerequisites

• Zig (for build system)
• dsd (DS decomp toolkit)
• MWCC ARM compiler (place in build/compiler/mwccarm.exe)
• Wine (Linux/Mac) for running MWCC
• objdiff-cli (optional, for progress tracking)

Building

1. Place your SM64DS ROM as sm64ds.nds in the root directory

2. Extract the ROM:

   zig build extract

3. Generate delink data:

   zig build delink

4. Generate objdiff configuration:

   zig build objdiff

5. Compile all enrolled files:

   zig build

Workflow

• zig build single -- path/to/file.o - Compile a single file
• zig build all - Compile all enrolled files
• zig build report - Generate objdiff progress report

See CONTRIBUTING.md for more details.