1
0
Fork 0
mirror of https://github.com/zeldaret/oot.git synced 2024-11-25 09:45:02 +00:00
Decompilation of The Legend of Zelda: Ocarina of Time
Find a file
fig02 82968a7381
All Effect Overlays and z_effect_soft_sprite_old_init.c OK (#396)
* fix colliderinit typo

* dead sound done

* deadsound documentation

* blast done

* progress

* spk init

* progress

* spark done

* ss bomb ok

* bomb done

* cleanup

* progress

* progress

* almost done with bomb2

* clean up gossip stone

* more

* cleanup and format

* remove unused asm file

* nonmatching reloc

* done i think

* mistakes

* fix headers

* idk how that got in here

* EffectSsStick OK

* progress

* fix conflicting name

* progress

* splash OK

* uname fields

* progress

* lightning OK

* remove unwanted files

* kirakira ok

* kirakira done

* magma OK

* remove files

* ss_g_fire OK

* name funcs

* progress

* progress

* magma2 and kakera OK

* eff_ss_dead_dd OK

* fcircle OK

* stone1 OK

* sibuki2 OK

* dt_bubble OK

* deaddb OK

* sibuki OK

* dead_ds OK

* ice_smoke OK

* hitmark OK

* hahen OK

* k_fire OK

* en_fire OK

* starting colors

* color changes 1

* color switch done

* init file data migrated

* data cleanup

* ice_piece OK

* en_ice OK

* progress

* progress

* docs progress

* fix blast color names

* documentation pass 1

* progress

* cleanup pass 2

* touchups

* added to functions.h

* small changes

* fix functions.h

* renaming progress

* name progress

* color enum

* more cleanups

* enice changes

* final cleanups

* remove unwanted file

* lightning -> shock

* pr suggestions

* fix comment

* remove unwanted comments
2020-09-29 20:18:46 -04:00
asm All Effect Overlays and z_effect_soft_sprite_old_init.c OK (#396) 2020-09-29 20:18:46 -04:00
assets First proper commit. 2020-03-17 00:31:30 -04:00
data All Effect Overlays and z_effect_soft_sprite_old_init.c OK (#396) 2020-09-29 20:18:46 -04:00
docs Native MacOS build support (#399) 2020-09-21 03:00:28 -04:00
include All Effect Overlays and z_effect_soft_sprite_old_init.c OK (#396) 2020-09-29 20:18:46 -04:00
scenes All 110 scenes decompiled. (#175) 2020-05-29 17:59:10 -04:00
src All Effect Overlays and z_effect_soft_sprite_old_init.c OK (#396) 2020-09-29 20:18:46 -04:00
tools Decompile En_Mag (#406) 2020-09-27 10:14:25 -04:00
.clang-format Setup formatting with clang-format and clang-tidy 2020-03-22 20:18:10 +01:00
.clang-tidy Setup formatting with clang-format and clang-tidy 2020-03-22 20:18:10 +01:00
.gitattributes First proper commit. 2020-03-17 00:31:30 -04:00
.gitignore fix m2ctx incompatibility on MacOS (#354) 2020-09-02 07:13:21 -04:00
.gitmodules First proper commit. 2020-03-17 00:31:30 -04:00
checksum.md5 Added 'extract' target to makefile 2020-03-27 22:30:19 -04:00
diff.py Update asm-differ to commit 9d79eb9 2020-09-08 (#404) 2020-09-20 12:11:05 -04:00
diff_settings.py First proper commit. 2020-03-17 00:31:30 -04:00
docker-compose.yml Docker Support for OSX (#91) 2020-04-24 20:34:00 -04:00
Dockerfile Decompiled ovl_En_Zl2 (2 nonmatchings) (#223) 2020-07-04 14:34:51 +02:00
Doxyfile Configure Doxygen (#206) 2020-06-28 14:42:16 -04:00
extract_assets.py Various repo improvements (#316) 2020-08-15 14:08:53 -04:00
extract_baserom.py Various repo improvements (#316) 2020-08-15 14:08:53 -04:00
first_diff.py Add COMPARE and NON_MATCHING build options (#275) 2020-07-19 15:42:05 -04:00
fixbaserom.py Docker Support for OSX (#91) 2020-04-24 20:34:00 -04:00
fixle.sh Setup formatting with clang-format and clang-tidy 2020-03-22 20:18:10 +01:00
format.sh Decomp BgYdanHasi (#263) 2020-07-18 23:06:26 -04:00
Jenkinsfile Ido Static Recomp (#337) 2020-08-22 19:06:52 -04:00
Makefile Native MacOS build support (#399) 2020-09-21 03:00:28 -04:00
progress.py CSV Progress (2) (#219) 2020-06-21 20:58:56 -04:00
README.md Native MacOS build support (#399) 2020-09-21 03:00:28 -04:00
spec All Effect Overlays and z_effect_soft_sprite_old_init.c OK (#396) 2020-09-29 20:18:46 -04:00
sym_info.py Change Colors To Decimal (#260) 2020-07-16 21:37:53 -04:00
THANKS.md Add installation instructions to the README (+ minor improvements) (#100) 2020-04-30 21:47:42 -04:00
undefined_syms.txt All Effect Overlays and z_effect_soft_sprite_old_init.c OK (#396) 2020-09-29 20:18:46 -04:00

The Legend of Zelda: Ocarina of Time

- WARNING! -

The ROM this repository builds cannot be 'shifted', primarily due to some hardcoded pointers which have yet
to be dumped. Thus this repository is currently in an experimental and research phase and cannot yet be used
traditionally as a source code base for general changes.

This is a WIP decompilation of The Legend of Zelda: Ocarina of Time. The purpose of the project is to recreate a source code base for the game from scratch, using information found inside the game along with static and/or dynamic analysis. The only build currently supported is Master Quest (Debug), but other versions are planned to be supported.

It builds the following ROM:

  • zelda_ocarina_mq_dbg.z64 md5: f0b7f35375f9cc8ca1b2d59d78e35405

Note: This repository does not include any of the assets necessary to build the ROM. A prior copy of the game is required to extract the needed assets.

Website: https://zelda64.dev/

Discord: https://discord.zelda64.dev

Installation

Windows

For Windows 10, install WSL and a distribution by following this Windows Subsystem for Linux Installation Guide. We recommend using Debian or Ubuntu 18.04 Linux distributions.

For older versions of Windows, install a Linux VM or refer to Docker instructions.

macOS

For macOS, use homebrew to install the following dependencies:

  • coreutils
  • make
  • python3
brew update
brew install coreutils make python3

You'll also need to build and install mips-linux-binutils.

Going forward in this guide, please use gmake whenever you encounter a make command. The make that comes with MacOS behaves differently than GNU make and is incompatible with this project. You should now be able to continue onto step 3.

Linux (Native or under WSL / VM)

1. Install build dependencies

The build process has the following package requirements:

  • git
  • build-essential
  • binutils-mips-linux-gnu
  • python3

Under Debian / Ubuntu (which we recommend using), you can install them with the following commands:

sudo apt-get update
sudo apt-get install git build-essential binutils-mips-linux-gnu python3

2. Download and set up qemu-irix (optional)

Note: We are currently testing a recompiled version of the compiler that does not require qemu-irix. This step allows you to build with qemu-irix and the original compiler by adding ORIG_COMPILER=1 to the make command in step 6, for example if you experience issues with the recompiled version.

Download qemu-irix from the Releases section in the repository. Place it at a location of your choosing.

Open up your .bashrc file (~/.bashrc), scroll to the bottom, and add the following, replacing the paths as necessary:

export QEMU_IRIX="path/to/your/qemu-irix"

Save and close/reopen your terminal window.

3. Clone the repository

Clone https://github.com/zeldaret/oot.git where you wish to have the project, with a command such as:

git clone https://github.com/zeldaret/oot.git

4. Prepare a base ROM

Copy over your copy of the Master Quest (Debug) ROM inside the root of this new project directory. Rename the file to "baserom_original.z64" or "baserom_original.n64", depending on the original extension.

5. Setup the ROM and build process

Setup and extract everything from your ROM with the following command:

make setup

This will generate a new ROM called "baserom.z64" that will have the overdump removed and the header patched. It will also extract the individual assets from the ROM.

6. Build the ROM

Run make to build the ROM. Make sure your path to the project is not too long, otherwise this process may error.

make

If all goes well, a new ROM called "zelda_ocarina_mq_debug.z64" should be built and the following text should be printed:

zelda_ocarina_mq_dbg.z64: OK

If you instead see the following:

zelda_ocarina_mq_dbg.z64: FAILED
md5sum: WARNING: 1 computed checksum did NOT match

This means that the built ROM isn't the same as the base one, so something went wrong or some part of the code doesn't match.

Docker

1. Setup requirements

To use Docker, you'll need either Docker Desktop or Docker Toolbox installed and setup based on your system.

You'll also need to prepare a local version of the project with a copied base ROM (see Step 4 and 5 of the Linux instructions).

2. Create the docker image

From inside your local project, run the following command:

docker build . -t oot

3. Start the container

To start the container, you can mount your local filesystem into the docker container and run an interactive bash session.

docker run -it --rm --mount type=bind,source="$(pwd)",destination=/oot oot /bin/bash

4. Setup and Build the ROM

Once inside the container, you can follow Step 6 and 7 of the Linux instructions to setup and build the ROM, or run any other command you need.

Contributing

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.