falso
/
tp
mirror of https://github.com/zeldaret/tp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Decompilation of The Legend of Zelda: Twilight Princess (GCN, USA)
87 Commits 2 Branches 0 Tags 3.8 GiB
Assembly 61.1%
C++ 22.5%
Python 14.6%
C 0.9%
Makefile 0.7%
Other 0.1%
Go to file
Erin Moon 052119c7a7
a new tool: splitter (#39) 
* splitter: v0.1

* basic demangle stuff

* splitter: v0.2

- add from, to options to select line range in .s to process
- infer referred labels from both loads and stores
- dump our own function labels in addition to externs into functions.h,
  to provide forward declarations for labels that other functions might
  use.
- fix off-by-one which was eating the last instruction of some functions

* splitter: v0.3

merged a bunch of work lepelog did, including:
- demangling support
- better function identification
- automatic FORCEACTIVE

and did a little bit of cleanup

* splitter: improve sda hack and format

* splitter: fix comment_out(), patch GQR references

* splitter: some speed optimizations

* remove debug print

* splitter: forceactive options

* refactor demangler, add support for more operators and more mangling symbols

* array and member (still one non working case)

* fix some operands in demangler

* make parents for funcs_out

* splitter: fix off-by-one in last line of last function in some .s files

Co-authored-by: lepelog <lepelog@users.noreply.github.com>
Co-authored-by: Pheenoh <pheenoh@gmail.com>
 		2021-01-02 02:22:57 -05:00
.github/workflows add clang-format CI check 2020-12-26 13:18:14 -05:00
asm M_do_controller_pad split and partially matched (#36) 2021-01-02 02:02:19 -05:00
include JKRAssertHeap OK (#47) 2021-01-02 02:14:43 -05:00
libs JKRAssertHeap OK (#47) 2021-01-02 02:14:43 -05:00
src M_do_controller_pad split and partially matched (#36) 2021-01-02 02:02:19 -05:00
tools a new tool: splitter (#39) 2021-01-02 02:22:57 -05:00
.clang-format add missing class in d_save and clang-format 2020-12-25 21:11:16 -05:00
.gitignore move asm in TUs to files, add diff.py 2020-12-26 13:03:37 -05:00
Makefile OSX support (#48) 2021-01-02 01:41:40 -05:00
README.md Add discord server link 2020-09-05 15:21:05 -04:00
asmdiff.sh Start Z2SceneMgr and Various Fixes (#11) 2020-12-02 20:35:32 -05:00
diff.py move asm in TUs to files, add diff.py 2020-12-26 13:03:37 -05:00
diff_settings.py diff_settings.py: update for new ppc-enabled diff.py (#31) 2020-12-13 15:52:46 -05:00
dolzel2.sha1 ok 2020-08-29 17:54:55 -04:00
ldscript.lcf d_kankyo, d_kankyo_*: autosplit (#44) 2021-01-02 01:54:59 -05:00
obj_files.mk M_do_controller_pad split and partially matched (#36) 2021-01-02 02:02:19 -05:00
re_notes.md re_notes.md (#25) 2020-12-13 15:47:39 -05:00
rels_sha1.md ok 2020-08-29 17:54:55 -04:00

README.md

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

  1. Download and run the latest release of the Windows devkitpro installer
  2. Run the executable located at devkitPro\msys2\msys2.exe
  3. Update pacman by running the following command: pacman -Syu
  4. Install the necessary dependencies by running the following command: pacman -S python3-pip base-devel gcc vim cmake
  5. Change to the directory of where you cloned this repository and you are ready to build!

Build Instructions

  1. Obtain a clean DOL of TP (GCN USA) and place it at the root of the repo and name it baserom.dol.
  2. 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.
  3. Run make at the root of the repo.

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.