Game-Decompilation/tww
1
0
Fork 0
mirror of https://github.com/zeldaret/tww.git synced 2024-11-23 13:29:53 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
Decompilation of The Legend of Zelda: The Wind Waker
1,349 Commits 1 Branch 0 Tags 21 MiB
C++ 86.1%
C 11.7%
Python 1.3%
Pawn 0.9%
b6d0373644
Go to file
LagoLunatic b6d0373644 m_Do_ext
2024-03-21 17:53:48 -04:00
.github/workflows Update progress API endpoint 2023-09-26 18:13:12 -04:00
assets Import project 2023-09-10 00:48:55 -04:00
config Mark gpr/fpr funcs as stripped, runtime.c OK 2024-01-15 15:24:57 -05:00
docs Fix includes of .inc files, add src/ to includes 2023-10-22 21:41:05 -04:00
include m_Do_ext 2024-03-21 17:53:48 -04:00
orig Import project 2023-09-10 00:48:55 -04:00
src m_Do_ext 2024-03-21 17:53:48 -04:00
tools JUTException showFloatSub 2023-12-30 15:03:23 -08:00
.clang-format Import project 2023-09-10 00:48:55 -04:00
.gitattributes Import project 2023-09-10 00:48:55 -04:00
.gitignore Update .gitignore 2023-09-13 18:15:47 -04:00
configure.py d_a_player_npc OK, d_a_npc_os 100% except weakfunc order 2024-03-18 23:41:02 -04:00
LICENSE Initial commit 2023-09-09 10:08:34 -04:00
README.md Replace progress.deco.mp with progress.decomp.club 2023-10-05 00:04:18 -04:00

README.md

The Legend of Zelda: The Wind Waker
Build Status Progress DOL Progress RELs Progress Discord Badge

A work-in-progress decompilation of The Legend of Zelda: The Wind Waker for GameCube.

This repository does not contain any game assets or assembly whatsoever. An existing copy of the game is required.

All GameCube versions are supported:

  • GZLE01: Rev 0 (USA), Rev 48 (KOR)
  • GZLP01: Rev 0 (PAL)
  • 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 Python and add it to %PATH%.
  • Download ninja and add it to %PATH%.
    • Quick install via pip: pip install ninja

macOS:

  • Install ninja: 
    brew install ninja
  • Install wine-crossover: 
    brew install --cask --no-quarantine gcenx/wine/wine-crossover

After OS upgrades, if macOS complains about Wine Crossover.app being unverified, you can unquarantine it using:

sudo xattr -rd com.apple.quarantine '/Applications/Wine Crossover.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/zeldaret/tww.git
  • Using Dolphin Emulator, extract your game to orig/GZLE01 (or GZLJ01 for JPN, GZLP01 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
    To use a version other than GZLE01 (USA), specify --version GZLJ01 (JPN) or --version GZLP01 (PAL).
  • 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