pokecrystal-board/INSTALL.md

Linux

sudo apt-get install make gcc bison git python python-setuptools

git clone git://github.com/bentley/rgbds.git
cd rgbds
sudo make install
cd ..

git clone --recursive git://github.com/kanzure/pokecrystal.git
cd pokecrystal

• Copy a Pokémon Crystal rom into pokecrystal/. Name it baserom.gbc. Eventually this will not be required.

To build pokecrystal.gbc:

make

OS X

On 10.8 or earlier, download and install Command Line Tools for Xcode.

On 10.9 or later:

xcode-select --install

In the shell, run:

git clone git://github.com/bentley/rgbds.git
cd rgbds
sudo make install
cd ..

git clone --recursive git://github.com/kanzure/pokecrystal.git
cd pokecrystal

• Copy a Pokémon Crystal rom into pokecrystal/. Name it baserom.gbc. Eventually this will not be required.

To build pokecrystal.gbc:

make

Windows

To build on Windows, use Cygwin (32-bit).

In the installer, select the following packages: make git python python-setuptools gcc libsasl2 ca-certificates

Then get the most recent version of rgbds. Put rgbasm.exe, rgblink.exe and rgbfix.exe in C:\cygwin\usr\local\bin.

In the Cygwin terminal:

git clone --recursive git://github.com/kanzure/pokecrystal.git
cd pokecrystal

• Copy a Pokémon Crystal rom into C:\cygwin\home\<username>\pokecrystal. Name it baserom.gbc. Eventually this will not be required.

To build:

make

Vagrant

The simplest way to get pokecrystal to compile is to use Vagrant and VirtualBox. Follow these steps:

• Download and install Vagrant
• Follow the instructions to download and install VirtualBox
• Run these commands:

	vagrant box add pokecrystal http://diyhpl.us/~bryan/irc/pokecrystal/pokecrystal.box
	mkdir vagrantbox
	cd vagrantbox
	vagrant init pokecrystal
	vagrant up
	vagrant ssh -c "cd /vagrant && git clone --recursive git://github.com/kanzure/pokecrystal.git"
	vagrant ssh

Running "vagrant ssh" will give you a shell to type commands into for compiling the source code. Then the "virtualbox" directory on the host appears as a shared folder inside of the guest virtual machine at "/vagrant".

To build the project, run these commands in the guest (that is, inside "vagrant ssh"):

cd /vagrant/pokecrystal
make

To make the build work you will need to copy baserom.gbc into the "pokecrystal" directory inside the "virtualbox" directory on the host machine. Eventually this will not be required.