mirror of
https://github.com/zeldaret/tp
synced 2026-05-23 15:01:53 -04:00
Jonathan Wase
bc428f7f65
* moved elf2dol * removed postprocess.py * removed vtables.py * find_unused_asm.py * removed section2cpp.py * removed splitter/* * fixed symbol names due to iconv file rename * fixed problem building RELs caused by #160 * improved performance of a few python tools * added new tool for finding conflict when not OK * added ./tp setup * don't install dol2asm dependecies with requirements.txt * format and check for imports * remove unused tools/difftools.py * fixed ignore to include elf2dol * fix compiler patcher * ok-check now creates the patched compiler at mwcceppc_patched.exe * Add new command to copy the build folder to the expected folder * 'make clean' will now only clean main.dol stuff. (added clean_rels and clean_all) * './tp pull-request' and './tp check' now doesn't include RELs by default. Use '--rels' to include them in the process. * './tp remove-unused-asm --check' added, exitcode 0==no files, 1==exists files Co-authored-by: Julgodis <>
The Legend of Zelda: Twilight Princess
This repo contains a WIP decompilation of The Legend of Zelda: Twilight Princess (GCN USA).
It builds the following DOL:
main.dol - sha1: 4997D93B9692620C40E90374A0F1DBF0E4889395
And will eventually build all the RELs.
Windows Prerequisites
- Download and run the latest release of the Windows devkitpro installer
- Run the executable located at
devkitPro\msys2\msys2.exe - Update pacman by running the following command:
pacman -Syu - Install the necessary dependencies by running the following command:
pacman -S python3-pip base-devel gcc vim cmake - Change to the directory of where you cloned this repository
- Install the required python dependencies with
python3 -mpip install -r tools/requirements.txt
Build Instructions
- Obtain a clean DOL of TP (GCN USA) and place it at the root of the repo and name it
baserom.dol. - Obtain a copy of the MWCC PowerPC compiler (version 2.7 to be exact). See below for a link to our Discord server which has the CodeWarrior compilers pinned in the #tp-decomp channel.
- Replace
tools/mwcc_compiler/2.7/mwcceppc.exewith the custom one also pinned in the #tp-decomp channel. - Run
makeat the root of the repo.
Dump Assets
- Place a vanilla copy of the NTSC-U version at the root of the folder and call it
gz2e01.iso. - Make the game directory.
mkdir game
- Run make assets.
make assets
Contributions
All contributions are welcome. This is a group effort, and even small contributions can make a difference. Some tasks also don't require much knowledge to get started.
Most discussions happen on our Discord Server, where you are welcome to ask if you need help getting started, or if you have any questions regarding this project and other decompilation projects.