Skip to content

Setting up the Disassembly

Drenn1 edited this page Dec 21, 2016 · 3 revisions

This page will instruct you on how to set up the disassembly so that it produces an Oracle of Ages ROM.

Table of Contents

Windows

Procedure

  • Download and install Cygwin on your computer. Cygwin provides a linux-like environment on Windows.
  • During the installation process, select the following packages:
    • Python2

Linux

Prerequisites

  • Standard building tools (Bash, Make, gcc)
  • Git
  • Python 2

Procedure

  • Clone this fork of wla-dx and checkout the "labels" branch:
git clone https://github.com/Drenn1/wla-dx
cd wla-dx
git checkout labels
  • Compile and install it: (this should install the executables to /usr/local/bin
cmake .
make
sudo make install
  • Continue to the Building section.

Building

  • Clone the disassembly:
git clone https://github.com/Drenn1/ages-disasm
cd ages-disasm
  • Run make. On a successful build, the final line should look say rom.gbc: OK, indicating that the ROM produced is an exact copy of the US Oracle of Ages rom.

Configuring

By default, the disassembly is configured to build a clean ROM by using precompressed assets. This isn't useful if you want to edit graphics or text, for example.

To change this, run the "swapbuild.sh" script. The output should look like this:

$ ./swapbuild.sh
Switching to modifiable (non-precompressed) mode
'build' -> 'build_v'
'build_e' -> 'build'
removed 'rom.gbc'
Then, copy fixbuild.sh to your git hooks (this may save some headaches later):
cp fixbuild.sh .git/hooks/post-checkout
You can now run make again to build everything from uncompressed assets. This first build may take a minute or more, depending on your computer's speed.
Clone this wiki locally