Metroid - Zero Mission Decomp

This is a work in progress decompilation of Metroid - Zero Mission.

2704/2721 functions decompiled (99.38%, 17 left)

0x76b014/0x76b014 bytes of data not in blobs (100%, 0 left)

Progress can be seen here : https://docs.google.com/spreadsheets/d/1X8XarD5evY8ZI7r_GQqh1pYmdVMbBcINYfRBUlogmKY/edit#gid=0

This produces the following ROMs:

• mzm_us.gba: sha1: 5de8536afe1f0078ee6fe1089f890e8c7aa0a6e8

Discords:

• https://discord.gg/2MGB9Xbr9y MAGret
• https://discord.gg/WtekHKb MAGConst

Dependencies

• agbcc
• binutils-arm-none-eabi
• mzm_us_baserom.gba (sha1: 5de8536afe1f0078ee6fe1089f890e8c7aa0a6e8)
• python3
• g++

Setup

• WINDOWS ONLY : Install and setup WSL

• Run sudo apt update just in case

• Install binutils-arm-none-eabi by running this command : sudo apt-get install binutils-arm-none-eabi

• Install git by running this command : sudo apt-get install git

• Install make by running this command : sudo apt-get install make

• Clone agbcc by running this command : git clone https://github.com/jiangzhengwenjz/agbcc

• Enter the agbcc folder (run cd agbcc) and build it (run ./build.sh)

• Add agbcc to your path (export PATH="<agbcc_path>:$PATH", where <agbcc_path> is the full path to the agbcc directory)

• Locate yourself in the decompilation root, and then build preproc (run cd tools/preproc && make)

Build

• Run make clean if necessary
• Run the data extractor if necessary:
  • Compile: cd tools && . compile_c_extractor.sh && cd ..
  • Run: tools/c_extractor
  • If the C version doesn't work, run the C# version tools/extractor (may require chmod +x tools/extractor first)
• Run make (using the -j option is recommended to speed up the process)
• Optionally, you can combine the commands to make it easier : ./tools/extractor && make -j