These instructions explain how to set up the tools required to build pokepinball, including rgbds, which assembles the source files into a ROM.
If you run into trouble, ask for help on IRC or Discord (see README.md).
Open Terminal and enter the following commands, depending on which distro you're using.
To install the software required for pokepinball:
sudo apt-get install make gcc git
Then follow the rgbds instructions to build rgbds 0.6.1 from source.
After that, you're ready to build pokepinball.
To install the software required for pokepinball:
sudo pacman -S make gcc git rgbds
Now you're ready to build pokepinball.
If you want to compile and install rgbds yourself instead, then follow the rgbds instructions to build rgbds 0.6.1 from source.
Install Homebrew. Follow the official instructions.
Open Terminal and prepare to enter commands.
Then follow the rgbds instructions for macOS to install rgbds 0.6.1.
Now you're ready to build pokepinball.
To build on Windows, install Cygwin with the default settings.
Dependencies are downloaded in the installer rather than the command line. Select the following packages:
- make
- git
- gcc-core
The latest pokepinball-compatible version of rgbds is 0.6.1. To install, put each of the files in the download in C:\cygwin\usr\local\bin
.
Now you're ready to build pokepinball.
To download the pokepinball source files:
git clone https://github.com/pret/pokepinball
cd pokepinball
To build pokepinball.gbc:
make
To remove all generated files by the build process:
make clean
To compare the built pokepinball.gbc to the original ROM:
make compare