Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Software:The Legend of Zelda: The Wind Waker

From ReverseEngineering.wiki
Software
Developer Nintendo EAD
Publisher Nintendo
Engine In-house EAD engine on Library:JSystem
Uses Library:JSystem, Library:Dolphin SDK
Platforms Platform:Nintendo GameCube
Versions GZLJ01 (JPN), GZLE01 (USA; also Korea), GZLP01 (PAL), D44J01 (Japanese kiosk demo)
On this wiki Facts · Code · Notes · Topics

Action-adventure game by Nintendo EAD (Japan December 2002, North America March 2003, Europe May 2003) for the Platform:Nintendo GameCube. sys/main.dol holds the engine (m_Do, f_pc/f_op process framework, d_* game code), Nintendo's Library:JSystem and the Library:Dolphin SDK; about 415 actors and objects are Format:REL relocatable modules, many packed in a Yaz0-compressed Format:RARC archive (files/RELS.arc). A matching decompilation (zeldaret/tww, CC0) maps every build.

Overview

The game is the reference subject of zeldaret/tww, a matching decompilation (Technique:Matching decompilation) that supports all GameCube releases. The project publishes no game code or assets; its configuration (SHA-1 of every original file, section splits and a full symbol list) is an exact memory map of each build.

Code layout

From config/GZLE01/splits.txt (USA): the DOL (framework.dol in the project, sys/main.dol on disc) has about 13,800 functions. Prefixes of the game's own source files tell the layers apart:

  • m_Do_* (machine/OS glue: main loop, graphics, audio, DVD thread, memory card, GBA link), f_ap, f_pc_* (process framework: every actor, scene and overlay is a process with a profile), f_op_* (process operations: actor, camera, message managers),
  • d_* (game code: d_a_* actors, d_stage, d_com_inf_game), c_* and SSystem (math and collision helpers),
  • Library:JSystem (~4,000 functions), JAZelAudio, the Library:Dolphin SDK, the CodeWarrior runtime and MSL C/C++, MetroTRK and the debugger stubs (OdemuExi2, amcstubs).

RELs: 415 for GZLE01 (build.sha1 lists the DOL and every REL). 180 sit in files/RELS.arc (119 under rels/mmem, 61 under rels/amem, read by DynamicModuleControl::mountCallback with JKRMountArchive("RELS.arc", MOUNT_COMP, ...)); the others are loose files under files/rels/. f_pc_profile_lst.rel holds the profile list that maps process names to modules. DynamicModuleControl::do_link (src/DynamicLink.cpp) links them with OSLink, or OSLinkFixed for version-3 modules so that the memory after fixSize becomes BSS.

Toolchain

Tool:Metrowerks CodeWarrior GC/1.3.2 for most code (GC/1.2.5n and GC/1.3 for some libraries), with -RTTI off and -Cpp_exceptions off, so there are no __RTTI__ symbols. The project's symbols are marked as generated from maps/framework.map, a linker map of the DOL (config/GZLE01/config.yml): names are the original ones, not contributors' guesses.

Builds

Code & repositories

  • https://github.com/zeldaret/tww @ 8b93b372dc8e841f12ddfb7e0215626f62b05417 · license: CC0-1.0
    Matching decompilation of The Wind Waker for all GameCube releases (GZLE01, GZLP01, GZLJ01, D44J01), CC0-1.0. Decompiled JSystem (JKernel archives and Yaz0/Yay0 decoders), Dolphin SDK (OS, OSLink REL linker, DVD, GX), CodeWarrior runtime; config/<ID>/build.sha1, symbols.txt and splits.txt map every build.
    Tested on: Read at commit 8b93b37: config/GZLE01 (build.sha1, config.yml, symbols.txt, splits.txt), include/dolphin/os/OSLink.h, src/dolphin/os/OSLink.c, src/dolphin/os/__start.c, include/JSystem/JKernel/JKRArchive.h, src/JSystem/JKernel/JKRDecomp.cpp, JKRArchivePri.cpp, JKRCompArchive.cpp; no game files used. · checked 2026-10-17; last activity 2026-10-14