The Legend of Zelda: The Wind Waker

This repository supports the following versions:

• GZLE01 - Rev 0 (USA), Rev 48 (Korea)
• GZLP01 - Rev 0 (EUR)
• GZLJ01 - Rev 0 (JPN)

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 ninja and add it to %PATH%.
• Install Python and add it to %PATH%.
  • Also available from the Windows Store.

macOS:

• Install ninja:

  brew install ninja
  

• Install wine-crossover:

  brew install --cask --no-quarantine gcenx/wine/wine-crossover
  

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

• Checkout the repository:

  git clone https://github.com/encounter/ww.git
  

• Using Dolphin Emulator, extract your game to orig/GZLE01 (or GLZJ01 for JPN, GLZE01 for PAL).
  
  • To save space, the only necessary files are the following. Any others can be deleted.
    • sys/main.dol
    • files/rels/*.rel
    • files/RELS.arc
• Configure:

  python configure.py
  

• Build:

  ninja
  

Diffing

Once the initial build succeeds, an objdiff.json should exist in the project root.

Download the latest release from encounter/objdiff. Under project settings, set Project directory. The configuration should be loaded automatically.

Select an object from the left sidebar to begin diffing. Changes to the project will rebuild automatically: changes to source files, headers, configure.py, splits.txt or symbols.txt.

More documentation

• Visual Studio Code