- 24
- Posts
- 8
- Years
- Seen Nov 3, 2018
Setting up and using Pokeruby/Pokeemerald
Part 0: An Introduction
Spoiler:
Part 1: Following pokeruby's INSTALL.md
Linux
Install devkitARM.
Then run the following commands.
Code:
export DEVKITPRO=/opt/devkitPro
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc
export DEVKITARM=$DEVKITPRO/devkitARM
echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc
git clone [url]https://github.com/pret/pokeruby[/url]
git clone [url]https://github.com/pret/agbcc[/url]
cd agbcc
./build.sh
./install.sh ../pokeruby
cd ../pokerubyTo build pokeruby.gba:
Code:
make -j4Mac
Install devkitARM.
Then in Terminal, run the following commands.
Code:
xcode-select --install
export DEVKITPRO=${HOME}/devkitPro
echo "export DEVKITPRO=${DEVKITPRO}" >> ~/.bashrc
export DEVKITARM=${DEVKITPRO}/devkitARM
echo "export DEVKITARM=${DEVKITARM}" >> ~/.bashrc
git clone [url]https://github.com/pret/pokeruby[/url]
git clone [url]https://github.com/pret/agbcc[/url]
cd agbcc
./build.sh
./install.sh ../pokeruby
cd ../pokerubyTo build pokeruby.gba:
Code:
make -j4Windows
Install devkitARM to the default directory (C:/devkitpro).
Then download Cygwin setup-x86_64.exe for 64-bit Windows, setup-x86.exe for 32-bit.
Run the Cygwin setup and leave the default settings. At "Select Packages", set the view to "Full" and choose to install the following:
- make
- git
- gcc-core
- gcc-g++
- libpng-devel
In the Cygwin terminal, enter these commands:
Code:
export DEVKITPRO=/cygdrive/c/devkitpro
echo export DEVKITPRO=$DEVKITPRO >> ~/.bashrc
export DEVKITARM=$DEVKITPRO/devkitARM
echo export DEVKITARM=$DEVKITARM >> ~/.bashrc
git clone [url]https://github.com/pret/pokeruby[/url]
git clone [url]https://github.com/pret/agbcc[/url]
cd agbcc
./build.sh
./install.sh ../pokeruby
cd ../pokerubyTo build pokeruby.gba:
Code:
make -j4Compiling Sapphire and later revisions
When you simply enter make and don't specify a target, then Pokémon Ruby 1.0 will be built. However, Sapphire can also be built, along with revisions 1 and 2 of both Ruby and Sapphire. Here is a listing of each ROM that can be made, along with the command to make the ROM.
Code:
Version | Command
-------------|---------------------
Ruby 1.0 | make ruby
Ruby 1.1 | make ruby_rev1
Ruby 1.2 | make ruby_rev2
Sapphire 1.0 | make sapphire
Sapphire 1.1 | make sapphire_rev1
Sapphire 1.2 | make sapphire_rev2Faster builds
After the first build, subsequent builds are faster. You can further speed up the build:
Parallel build
This significantly speeds up the build on modern machines.
By default make only runs a single thread. You can tell make to run on multiple threads with make -j. See the manfile for usage (man make).
The optimal value for -j is the number of logical cores on your machine. You can run nproc to see the exact number.
Code:
$ nproc
8If you have 8 cores, run:
Code:
make -j8-j on its own will spawn a new thread for each job. A clean build will have thousands of jobs, which will be slower than not using -j at all.
Disable the dependency scanning
If you've only changed .c or .s files, you can turn off the dependency scanning temporarily. Changes to any other files will be ignored, and the build will either fail or not reflect those changes.
Code:
make NODEP=1Part 2: Making changes and test them
Spoiler:
Conclusion:
You'll be able to make code changes with the disassembly similar to this fashion. To note: pokeemerald nor pokefirered is not ready for production yet, obviously, but this tutorial will teach you how to use it on a most basic level. Although this does and will open up gen 3 tremendously: there is much work to be done; we need to work more on pokefirered sometime down the line. Hopefully, now that you know how to setup the dissassemblies, you know how to make changes and eventually contribute to our cause. Thanks for reading.
Last edited:
