Skip to content

Latest commit

 

History

History
90 lines (61 loc) · 2.21 KB

INSTALL.md

File metadata and controls

90 lines (61 loc) · 2.21 KB

Installation

Run the following commands (first, see this if you are on macOS or this if you are on old Windows):

Prerequisites

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

Installation

> 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

macOS

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

Old Windows

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.

Windows 10

Install the Windows Subsystem for Linux, and run the commands.