These instructions explain how to set up the tools required to build pokegold, 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).
Download and install Windows Subsystem for Linux. Then open the WSL terminal.
Update WSL's software before continuing. If you chose Debian, Ubuntu, or another distribution that uses apt-get, then enter this command:
apt-get update && apt-get upgradeWSL has its own file system that's not accessible from Windows, but Windows files are accessible from WSL. So you're going to want to install pokegold within Windows. You'll have to change the current working directory every time you open WSL.
For example, if you want to store pokegold in C:\Users\<user>\Desktop, enter this command:
cd /mnt/c/Users/<user>/Desktop(The Windows C:\ drive is called /mnt/c/ in WSL. Replace <user> in the example path with your username.)
If this works, then follow the instructions for Linux below for whatever distribution you installed for WSL.
Otherwise, continue reading below for the older Windows instructions.
Download Cygwin: setup-x86_64.exe for 64-bit Windows, setup-x86.exe for 32-bit.
Run setup and leave the default settings. At the "Select Packages" step, choose to install the following, all of which are in the "Devel" category:
makegitgcc-core
Double click on the text that says "Skip" next to each package to select the most recent version to install.
Then follow the rgbds instructions for Windows with Cygwin to install rgbds 0.4.2.
Note: If you already have an older rgbds, you will need to update to 0.4.2. Ignore this if you have never installed rgbds before. If a version newer than 0.4.2 does not work, try downloading 0.4.2.
Now open the Cygwin terminal and enter the following commands.
Cygwin has its own file system that's within Windows, at C:\cygwin64\home\<user>. If you don't want to store pokegold there, you'll have to change the current working directory every time you open Cygwin.
For example, if you want to store pokegold in C:\Users\<user>\Desktop:
cd /cygdrive/c/Users/<user>/Desktop(The Windows C:\ drive is called /cygdrive/c/ in Cygwin. Replace <user> in the example path with your username.)
Now you're ready to build pokegold.
Install Homebrew. Follow the official instructions.
Open Terminal and prepare to enter commands.
Then follow the rgbds instructions for macOS to install rgbds 0.4.2.
Now you're ready to build pokegold.
Open Terminal and enter the following commands, depending on which distro you're using.
To install the software required for pokegold:
sudo apt-get install make gcc gitThen follow the rgbds instructions to build rgbds 0.4.2 from source.
To install the software required for pokegold:
sudo zypper install make gcc gitThen follow the rgbds instructions to build rgbds 0.4.2 from source.
To install the software required for pokegold:
sudo pacman -S make gcc git rgbdsThen follow the rgbds instructions for Arch Linux to install rgbds 0.4.2.
If you want to compile and install rgbds yourself instead, then follow the rgbds instructions to build rgbds 0.4.2 from source.
To install the software required for pokegold:
sudo apt install make clang git sedTo install rgbds:
sudo apt install rgbdsIf you want to compile and install rgbds yourself instead, then follow the rgbds instructions to build rgbds 0.4.2 from source.
If your distro is not listed here, try to find the required software in its repositories:
makegcc(orclang)gitrgbds
If rgbds is not available, you'll need to follow the rgbds instructions to build rgbds 0.4.2 from source.
Now you're ready to build pokegold.
To download the pokegold source files:
git clone https://github.com/pret/pokegold
cd pokegoldTo build pokegold.gbc:
make goldTo build pokesilver.gbc:
make silverTo build both ROMs:
make