Super Smash Bros Melee

This repo contains a matching decompilation of Super Smash Bros Melee (US).

[!TIP] The DOL this repository builds can be shifted! Meaning you are able to now add and remove code as you see fit, for modding or research purposes.

It builds main.dol:

Version	Game ID	SHA-1
1.02	GALE01	08e0bf20134dfcb260699671004527b2d6bb1a45

Dependencies

Windows:

On Windows, it's highly recommended to use native tooling. WSL or msys2 are not required. When running under WSL, objdiff is unable to get filesystem notifications for automatic rebuilds.

• Install Python and add it to %PATH%.
  • Also available from the Windows Store.
• Download ninja and add it to %PATH%.
  • Quick install via pip: pip install ninja

macOS:

• Install ninja:

  brew install ninja
  

• Install Game Porting Toolkit (the wine-crossover cask was removed from this tap in favor of this one):

  brew install --cask gcenx/wine/game-porting-toolkit
  

After OS upgrades, if macOS complains about Game Porting Toolkit.app being unverified, you can unquarantine it using:

sudo xattr -rd com.apple.quarantine '/Applications/Game Porting Toolkit.app'

Linux:

• Install ninja.
• For non-x86(_64) platforms: Install wine from your package manager.
  • For x86(_64), WiBo, a minimal 32-bit Windows binary wrapper, will be automatically downloaded and used.

Building

• Clone the repository:

  git clone https://github.com/doldecomp/melee.git --depth=1
  

• Using Dolphin Emulator, find your ISO and click Properties. Go to the Filesystem tab, right-click Disc - GALE01 and select Extract System Data. Choose orig/GALE01 of this repository.
  • To save space, only main.dol (and .gitkeep) are necessary. Other files can be deleted.
• Configure:

  python configure.py
  

• Build:

  ninja
  

Tooling

We use Python for our command line tooling. It is recommended that you use a virtual environment.

1. Create a virtual environment.

   python -m venv --upgrade-deps '.venv'
   

2. You'll need to activate it whenever you open a new shell.
   • Windows:

     .venv/Scripts/Activate.ps1
     

   • Linux/macOS:

     . .venv/bin/activate
     

3. After that, you can install or update our packages with:

   pip install -r reqs/decomp.txt
   

4. Now you can run decomp.py to decomp a function using m2c. Pass it -h to see all the options.

   python tools/decomp.py my_function_name
   

This is the beginning of the README. Read the rest at the original. Read the full README ↗