- What is pokecrystal11.gbc?
- What is pokecrystal-au.gbc?
- I can't build the ROM,
make
just prints an error! - How do I edit maps?
- How do I edit the colors of an image?
- How do I write new features?
- I need more help!
Version 1.1 of Pokémon Crystal, which fixed some issues with the initial international release. make crystal11
defines _CRYSTAL11
so the assembly builds the changed version.
The Australian release of Pokémon Crystal, which is based on the international 1.1 release but censors gambling references from the Game Corners. make crystal-au
defines _CRYSTAL11
and _CRYSTAL_AU
so the assembly builds the changed version.
Reread INSTALL.md carefully, and make sure you're following all its steps.
You need to install gcc
. If you're using Cygwin, re-run its setup, and at "Select Packages", choose to install gcc-core
.
Download rgbds 0.3.9 or newer. Older versions will not work.
Download rgbds 0.3.9 or newer. Older versions will not work.
If you are using 64-bit Windows, download 64-bit Cygwin and 64-bit rgbds.
If you have not changed any of the asm, make sure you have the latest version of pokecrystal and the correct version of rgbds (see INSTALL.md).
If you added or changed any code, it has to fit in the memory banks. The 2MB ROM is divided into 128 banks of 4KB ($4000 bytes) each, numbered $00 to $7F. The linkerscript pokecrystal.link lists which SECTION
s go in which banks. Try moving some code into a new section.
Run make clean
to remove all the old o
files, then re-run make
.
If you have not changed any of the asm, make sure you have the latest version of pokecrystal and the correct version of rgbds (see INSTALL.md).
If you added or changed any code, you've made a mistake while writing some of it. Re-read the modifications you've made to the file it complains about and try to compare them with other code.
For asm
scripts, read docs/map_event_scripts.md. For blk
layouts, use Polished Map.
Most .png
images are paletted PNGs. You can edit these with any program that supports creating PNGs with palette information. These palettes should consist of exactly 4 colors. Additionally, for Pokémon images, the first color should be white, and the last black. Tools such as Paint and GIMP will do the right job, while other tools such as paint.net or Photoshop might mess it up and output palettes of 255 colors even though only using 4. You may try using tools like GraphicsGale or IrfanView to fix this, or sometimes resaving the image in Paint seems to help.
Some image .png
files are greyscale. This indicates that even though these images do have proper colors in-game, they're shared with something else, and as such changing them will affect other things as well. Don't try opening the .2bpp
files, these only contain the image data as well, not the palettes.
It really depends on what image you're trying to change the colors of, where these colors are specified. Try looking for related files or .pal
files.
There are a number of special-purpose scripting languages, as described in docs. For more general features, you'll need to code directly in assembly language. Some of the tutorials for specific features may also be helpful.
Try asking on IRC or Discord (see README.md).