This repo provides a simple extension that integrates the build of a Virtual Console .cia file to the pret pokemon Gen I / II repos, to ease the building of a VC .cia for your ROM Hack down to something as simple as make cia.

• A recent pokecrystal, pokegold, pokered, or pokeyellow installation, that supports building Virtual Console patches.
• An original (encrypted or decrypted) .cia file.
• ctrtool and makerom (Only master has been tested)

Obtaining the original file is outside of the scope of this document. It can be legally obtained by extracting it from your console through tools such as GodMode9 and/or FunkyCIA.

Run make to build both ctrtool and makerom, and put them in your $PATH.

To install, you need to clone the poke-cia repo into your Pret repository. The following is a pokecrystal example:

cd <path to pokecrystal>
git clone https://github.com/vulcandth/poke-cia poke-cia
echo "-include poke-cia/cia.mk" >> Makefile

Next you will need to create your poke-cia/cia-config.mk file by using poke-cia/cia-config.mk.template as a base.

cp ./poke-cia/cia-config.mk.template ./poke-cia/cia-config.mk

Modify your /poke-cia/cia-config.mk file using a text editor of your choice, adjusting the following line to match the pret repository your are using. In this example we are using pret/pokecrystal

vc_name       := $(vc_crystal_name)

Copy your original dumped .cia files to vc/<build_name>.orig.cia. Where <build_name> represents the names of the .gbc files that is output from your installed pret repository. In the case of Pokemon Crystal, it should be:

poke-cia/pokecrystal11.cia

Now you can run make cia and be on your merry way!