Run the following commands (first, see this if you are on macOS or this if you are on old Windows):
You must install the devkitARM toolchain of devkitPro and add its environment variables.
export DEVKITPRO=/opt/devkitpro
echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc
export DEVKITARM=$DEVKITPRO/devkitARM
echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc
> git clone https://github.com/mmzret/rmz3
# install agbcc
> git clone https://github.com/pret/agbcc
> cd agbcc
> ./build.sh
> ./install.sh ../rmz3
> cd ../
> rm -rf ./agbcc
# install agbasm(custom arm-none-eabi-as)
> git clone https://github.com/luckytyphlosion/agbcc -b new_layout_with_libs
> cd agbcc
> make binutils
> cp ./gas/as-new ../rmz3/tools/binutils/bin/arm-none-eabi-as
# build gbagfx
> cd ../rmz3/tools/gbagfx
> make
# install mmzret/rmz-text-compiler
> cd ../../../
> git clone https://github.com/mmzret/rmz-text-compiler
> cd ./rmz-text-compiler
> cargo build --release
> cp ./target/release/rmz-text-compiler ../rmz3/tools/rmz-text-compiler
To build rmz3.gba:
> make
Run xcode-select --install
in Terminal, then proceed by executing the commands.
If pret/agbcc
build doesn't success in Apple Silicon, please try it.
# patch for https://github.com/pret/agbcc/blob/d59cfb5ac1ce13d4bc9875ffef1666b118338d33/gcc_arm/configure#L587
# pret/agbcc
> git apply ../rmz3/tools/agbcc.patch
For Windows 8.1 and earlier
Download and run the Cygwin setup, leaving the default settings intact. At "Select Packages", set the view to "Full" and choose to install the following:
make
git
gcc-core
gcc-g++
libpng-devel
Additionally, there are extra optional tools which require installing the following packages, although they are not necessary to build:
python-3
In the Cygwin command prompt, enter the commands.
If the command for building rmz3.gba does not work, run nproc
and use that value instead of $(nproc)
for make
.
Install the Windows Subsystem for Linux, and run the commands.