pokecrystal-board/INSTALL.md

Instructions

These instructions explain how to set up the tools required to build pokecrystal, 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).

Windows 10

Download and install Windows Subsystem for Linux. Then open the WSL terminal.

WSL 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 pokecrystal within Windows. You'll have to change the current working directory every time you open WSL.

For example, if you want to store pokecrystal 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.)

Then follow the instructions for Linux to build pokecrystal.

If this doesn't work, try following the regular Windows instructions below.

Windows

1. Install the required software

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:

• make
• git
• gcc-core

Click once on the text that says "Skip" next to each package to select the most recent version to install.

Then download rgbds: the latest win64.zip or win32.zip release. Extract it and put all the exe and dll files individually in C:\cygwin64\usr\local\bin.

Note: If you already have an older rgbds, you will need to update to 0.3.7 or newer. Ignore this if you have never installed rgbds before.

2. Build pokecrystal

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 pokecrystal there, you'll have to change the current working directory every time you open Cygwin.

For example, if you want to store pokecrystal 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.)

To download pokecrystal:

git clone https://github.com/pret/pokecrystal
cd pokecrystal

To build pokecrystal.gbc:

make

To build pokecrystal11.gbc:

make crystal11

Mac OS X

Open Terminal and enter the following commands.

1. Install the required software

To install the Xcode Command Line Tools:

xcode-select --install

To install rgbds:

git clone --depth=1 https://github.com/rednex/rgbds
sudo make -C rgbds CFLAGS=-O2 install

2. Build pokecrystal

To download pokecrystal:

git clone https://github.com/pret/pokecrystal
cd pokecrystal

To build pokecrystal.gbc:

make

To build pokecrystal11.gbc:

make crystal11

Linux

Open Terminal and enter the following commands.

1. Install the required software

The commands to do this depend on which distro you're using.

Debian or Ubuntu

To install the software required for pokecrystal:

sudo apt-get install make gcc git

To install rgbds:

sudo apt-get install bison libpng-dev
git clone --depth=1 https://github.com/rednex/rgbds
sudo make -C rgbds CFLAGS=-O2 install

OpenSUSE

To install the software required for pokecrystal:

sudo zypper install make gcc git

To install rgbds:

sudo zypper install bison libpng16-devel
git clone --depth=1 https://github.com/rednex/rgbds
sudo make -C rgbds CFLAGS=-O2 install

Arch Linux

To install the software required for pokecrystal:

sudo pacman -S make gcc git

To install rgbds:

sudo pacman -S bison libpng
git clone --depth=1 https://github.com/rednex/rgbds
sudo make -C rgbds CFLAGS=-O2 install

Termux

To install the software required for pokecrystal:

sudo apt install make clang git sed

To install rgbds:

sudo apt install rgbds

Other distros

If your distro is not listed here, try to find the required software in its repositories:

• make
• gcc (or clang)
• git
• rgbds

If rgbds is not available, you'll also need these:

• bison
• libpng (and the development headers)

To install rgbds:

git clone --depth=1 https://github.com/rednex/rgbds
sudo make -C rgbds CFLAGS=-O2 install

2. Build pokecrystal

To download pokecrystal:

git clone https://github.com/pret/pokecrystal
cd pokecrystal

To build pokecrystal.gbc:

make

To build pokecrystal11.gbc:

make crystal11