Skip to content

Windows Installation Instructions

Skeli edited this page Oct 13, 2021 · 5 revisions

1. Download and install devkitPro.

a. Open the devkitProUpdater.exe file and let it install what it wants to.

image


Note: If you just started following this tutorial, ignore this note for now. If you see compile warnings when building a fresh CFRU or Ability Pop-Ups crash your game (or the graphics look corrupted) after the build process is finished, download from this link instead. Replace the devkitPro folder created when you installed devkitPro before (likely C:/devkitPro) with the contents of the downloaded archive.

image

2. Add devkitARM's bin folder to your path.

a. Open This PC. Right-click on the background and choose Properties.

image


b. On the sidebar, click Advanced System Settings.

image


c. In the pop-up window, click Environment Variables.

image


d. In the next pop-up window, find Path under System variables at the bottom and click Edit.

image


e. In this final pop-up window, click New and add devkitARM's bin folder. Most likely this will be at C:\devkitPro\devkitARM\bin.

image


f. Hit okay on everything to save and close it all.

3. Download and install Python 3.7.6.

Note 1: Make sure you allow Python to be added to your path as part of the installation. Otherwise, you will have to repeat step 2 for Python as well.

Note 2: DO NOT DOWNLOAD PYTHON 3.8 OR HIGHER!

4. Restart your computer.

This should be self-explanatory.

5. Download the CFRU.

Option a. On the main page, click Code and then or click Download Zip.

image


Option b. Download and install git, then open a command line and clone the repository with git clone https://github.com/Skeli789/Complete-Fire-Red-Upgrade.git. This is the preferred method as you can easily retrieve updates from GitHub.

image

6. Put your base ROM in the root.

a. Download a Pokemon FireRed 1.0 ROM. For legal reasons, no link will be provided.

b. Rename it to BPRE0.gba and place it in the root of the repository.

image

7. Choose your insert offset.

a. If you don't know what this means, skip to the next step.

b. By default, the CFRU is compiled to the offset 0x900000. If you would like to change this, open scripts/make.py and change the line OFFSET_TO_PUT = 0x900000.

8. Run the make script from the root.

a. Hold shift and right-click the background of the folder. In the context window pop-up, click Open command window here or Open PowerShell window here.

image


b. In the terminal that just opened, type python scripts/make.py.

image


c. Hit enter to run the script. When the build process is done, you should see something like this on the terminal:

image

In addition, these files will also now appear in the root:

image


Note 1: If you get an error with a mention of a file called libwinpthread-1.dll (or something similar), search Google for a 64-bit version of this file and add it to the root.

Note 2: If you receive several compile warnings during the build process, see the note in the first step.

9. Read the documentation thoroughly.

Once you've done that, you're good to go! Enjoy using the Complete FireRed Upgrade!

Other Links

  • If after following this tutorial you still are unable to use the CFRU, try watching this video instead.
  • If you have further questions and have not read the documentation, please see the FAQ here.
  • See this guide for a tutorial if you need help getting things set up once the engine is built.