Animal Crossing Decompilation

Decompilation in progress of Animal Crossing (GAFE01)

A decompilation of the original N64 version of the game is being worked on here.

Cloning

Use --recursive when cloning to have ppcdis in the repository.

Building

ℹ️ When using Windows, it's recommended to use WSL.

Docker

1. Dump a copy of the game and extract all files.
2. Place main.dol, foresta.rel.szs, forest_1st.arc, and forest_2nd.arc in dump/.
3. Download the CodeWarrior 1.3.2, 1.3.2r, and 1.2.5n compilers and extract them to tools/1.3.2/, tools/1.3.2r/, and tools/1.2.5n/, respectively.
4. Install Docker.
5. Build the Docker image (docker build -t ac-decomp .).
6. Run configure.py (docker run --rm -v ${PWD}:/ac-decomp ac-decomp python3 configure.py).
7. Run build.py (docker run --rm -v ${PWD}:/ac-decomp ac-decomp python3 build.py).

Build manually

ℹ️ When building manually from a work directory originally used for Docker, you will need to run sudo ninja -t clean for the build to execute properly.

1. Dump a copy of the game and extract all files.
2. Place main.dol, foresta.rel.szs, forest_1st.arc, and forest_2nd.arc in dump/.
3. Download the CodeWarrior 1.3.2, 1.3.2r, and 1.2.5n compilers and extract them to tools/1.3.2/, tools/1.3.2r/, and tools/1.2.5n/, respectively.
4. Install Python, pip, and ninja using your package manager of choice.
5. Install Python modules from requirements.txt (pip install -r requirements.txt).
6. Install version 0.6.13 of wibo
   • Wibo is a lightweight Wine replacement that's tailor-made for use with decomp projects. Regular Wine can be used if preferred, but for the purposes of this guide, these instructions will use wibo.
   • Download version 0.6.13 GitHub release and run install ./wibo /usr/bin to install it to your system.
7. Install devkitPPC.
   • To get devkitPPC, you'll need devkitPro Pacman.
     • Run dkp-pacman -S devkitPPC once dkp-pacman is installed to install devkitPPC.
     • Set the DEVKITPPC environment variable to /opt/devkitpro/devkitPPC.
8. Set the N64_SDK environment variable to the path of your libultra or equivalent headers. If you need headers, you can use the ones from ultralib.
   • Headers should be located at $N64_SDK/ultra/usr/include.
   • You must modify Gpopmtx's param member to be unsigned int in gbi.h.
9. Run python3 configure.py.
10. Run python3 build.py.

Quick Guides

• Dumping Game Files
• Ghidra Setup
• Generating Decomp Context
• decomp.me Basics
• Ghidra Basics
• m2c Basics
• Decomp Basics

Credits

• jamchamb, Cuyler36, NWPlayer123 and fraser125 for past documentation of Animal Crossing.
• SeekyCt for ppcdis and helping setting up the project.
• msg for helping with tools/map.py.