mzm/README.md
2024-07-29 18:19:56 +02:00

1.4 KiB

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:

Dependencies

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

Setup

  • WINDOWS ONLY : Install and setup WSL
  • Install the dependencies (an apt update might be necessary for binutils)
  • Build agbcc (run ./build.sh)
  • Add agbcc to your path (export PATH="<agbcc_path>:$PATH", where <agbcc_path> is the full path to the agbcc directory)
  • Build preproc (run make in tools/preproc)

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)