diff --git a/INSTALL.md b/INSTALL.md index 8562a45d..22a4f1fb 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -27,7 +27,7 @@ python tools/setup.py ``` 5. Run the Ninja configure script: ```shell -python tools/configure.py +python tools/configure.py ``` > [!IMPORTANT] @@ -37,6 +37,8 @@ python tools/configure.py > For Linux users: If you plan to use Wibo instead of Wine, run `configure.py` with `-w `. 6. Put one or more base ROMs in the [`/extract/`](/extract/README.md) directory of this repository. +Now you can run `ninja` to build a ROM for the chosen version. + ### Matching the base ROM **This is optional!** You only need to follow these steps if you want a matching ROM. diff --git a/README.md b/README.md index 98934c3f..132b195a 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ # The Legend of Zelda: Phantom Hourglass -**Work in progress!** This project aims to recreate source code for ***The Legend of Zelda: Phantom Hourglass*** by decompiling -assembly code by hand. **The repository does not contain assets or assembly code.** To build the ROM, you must own an existing +**Work in progress!** This project aims to recreate source code for ***The Legend of Zelda: Phantom Hourglass*** by decompiling its code by hand. **The repository does not contain assets or assembly code.** To build the ROM, you must own an existing copy of the game to extract assets from. -**Note:** The project targets the European and American versions, and other versions might be supported later. +> [!NOTE] +> The project targets the European and American versions, and other versions might be supported later. ## How to install See [INSTALL.md](INSTALL.md) for instructions on how to install the project. diff --git a/docs/decompiling.md b/docs/decompiling.md index c01ba1cf..88b32032 100644 --- a/docs/decompiling.md +++ b/docs/decompiling.md @@ -20,10 +20,9 @@ again. Remember to make a pull request of any progress you made on the source fi partially decompiled code. ## Decompiling a source file -We use the object diffing tool [`objdiff`](https://github.com/encounter/objdiff) to track differences between C++ and assembly -code. +We use the object diffing tool [`objdiff`](https://github.com/encounter/objdiff) to track differences between our decompiled C++ code and the base ROM's code. 1. [Download the latest release.](https://github.com/encounter/objdiff/releases/latest) -1. Run `configure.py` and `ninja` to generate `objdiff.json` in the `/config//arm9/` directories. +1. Run `configure.py ` and `ninja` to generate `objdiff.json` in the repository root. 1. In `objdiff`, set the project directory to one of the mentioned `arm9/` directories. 1. Select your source file in the left sidebar: ![List of objects in objdiff](images/objdiff_objects.png)