pokecrystal-board/INSTALL.md
yenatch eab37ef920 hexdump for binary diffs
those with an existing repo should run:

git config diff.hex.textconv hexdump
2013-06-13 14:24:45 -04:00

2.1 KiB

Getting Started

Compiling requires a certain Pokemon Crystal ROM:

Pokemon - Crystal Version (UE) (V1.0) [C][!].gbc
md5: 9f2922b235a5eeb78d65594e82ef5dde

Save it as baserom.gbc in the repository.

Feel free to ask us on nucleus.kafuka.org #skeetendo if something goes wrong (remember to tell where)!

Don't know how to use IRC? Try mibbit.

Linux

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

# unittest2 is required if using python2.6
sudo easy_install unittest2
sudo easy_install pip

# download rgbds source code
git clone git://github.com/bentley/rgbds.git

# compile rgbds
cd rgbds
make
sudo make install

# check if rgbasm is installed now
which rgbasm

# download pokecrystal
git clone git://github.com/kanzure/pokecrystal.git
cd pokecrystal

# install python requirements
pip install -r requirements.txt

# use hexdump to diff binary files
git config diff.hex.textconv hexdump

To compile the ROM from ASM source:

make clean && make

That will take between 3 and 15 seconds, depending on your computer. If you see cmp baserom.gbc pokecrystal.gbc as the last line, the build was successful! Rejoice!

Windows

Set up GitHub for Windows and clone this repository.

If you haven't already, get Python 2.7 (64-bit).

Extract the following files from the RGBDS package into the repository: rgbasm.exe rgbds.exe rgbfix.exe rgblink.exe

Install make for Windows.

To compile the ROM from ASM source, run pokecrystal.bat.

That will take between 3 and 15 seconds, depending on your computer. If you see FC: no differences encountered, the build was successful! Rejoice!

Now you may try messing around with main.asm, or just do whatever you wanted to.

Contributions are welcome!