Skeli789 / Dynamic-Pokemon-Expansion

A tool to ease the process of expanding the number of Pokemon in Fire Red. It is meant to be used alongside the Complete FireRed Upgrade.
Other
248 stars 194 forks source link

Dynamic-Pokemon-Expansion [FR]

What is this:

A dynamic data insertion tool for expanding Pokemon data in FireRed.

Features:

NOTE It is highly recommended to apply the Complete Fire Red Upgrade following the insertion of this hack. Otherwise, make sure to comment out the line #define EXPAND_LEARNSETS in the defines file or your game will crash (unless you have expanded movesets manually). Additionally, if you're not using the Complete Fire Red Upgrade, in bytereplacement, find the changes for the seen and caught flag ram, and change it to some free save space. Make sure to apply a saveblock hack first and a TM/Tutor expansion first, though.

Installation Instructions:

1. Download devkitpro. Follow the instructions.
(Note: you can only install devkitARM)
For Windows users, follow steps 4-6 from this tutorial:
https://www.pokecommunity.com/showpost.php?p=8825585&postcount=96

2. Download the latest version of python (3.7.2).
After downloading and before proceeding to install make sure that the 'add to path' 
checkbox is ticked, otherwise you'll have to add the python path in the environment 
variables manually.

**NOTE**: If a python version lower than 3.6 is installed, you'll need to uninstall it and manually
remove it from your path before installing the newer version of Python.

3. Download the master folder from this github page.
(click 'Clone or Download', then 'Download Zip')

4. Get your ROM, rename it BPRE0.gba and 
place it the main (master) folder.

5. To decide the offsets where you want to insert the code:

a) In the 'make.py' file in the folder 'scripts' change OFFSET_TO_PUT=YYY to the location 
   you want to insert the data (let it be X). Don't worry about changing 'insert.py' also.
   'make.py' automatically updates the 'insert.py' file and linker file.

7. Run cmd.exe in the main folder. You can do this by typing 'cmd' and hitting enter in the 
url address or selecting 'run command prompt from here' from right clciking on empty space 
while holding the shift key.

8. Only if you would like to use the data extractor, in command prompt window,
type 'python scripts//data_extractor.py' This extracts the graphics data from 
BPRE0.gba and places it in the directory *extracted*. Make sure to update the
files in *src* with this extracted data. Do not overwrite the files in *src*.
Only replace Pokemmon that are in your hack. Leave the expanded graphics data alone.

9. Once you're done editing the source files to your liking, in the command prompt window, 
type 'python scripts//make.py'. If you have never compiled before, the first time
compilation will take a few minutes. However, as long as you don't clean the build
data, all following compilations will be much quicker.

A new gba file will appear named as test.gba and an offsets.ini file.
That is your resultant file.

About TM/HM & Move Tutors

When looking in the src directory, you will notice two subdirectories, tm_compatibility (for modifying TM/HM data) and tutor_compatibility (for modifying Move Tutor data). Contained within these directories are files corresponding to each TM/HM and Move Tutor. Unlike most tools and expansions, this engine allows modification by TM/HM and Move Tutor number, as opposed to by species. To give a species a certain TM/HM or Move Tutor, simply add the species name to the appropriate file. If you want to change one of the pre-defined TM/HM's or Move Tutors, simply change the name of the file (leaving the number the same), and update the corresponding data in the files include/tutors.h and/or src/TM_Tutor_Tables.c.

Extracting Old Data:

When using this expansion, you may wish to keep using the sprites already inserted in your rom. If so you will need to extract the original graphics data pointers from your rom. To do this, overwrite the BRPE0.gba file in the root with this rom that has the graphics data (always make a backup first!). Then, open scripts/data_extractor.py and change the line NumberOfPokemon to the number of species graphics data you wish to extract from your rom + 1. Go back to the root, open the command line, and type python scripts//data_extractor.py. Extracted graphics data will be pulled from your rom and placed in a new folder extracted. Copy the contents of the tables found in these files and overwrite the tables found in the equivalent files found in src. Once the extraction is complete, make sure to either add (void*) to the beginning of each pointer in these extracted files, or open include/graphics.h and replace any relevant instances of const u8* with u32. This will allow the files to compile warning free. Now, the next time you insert this hack, all of your graphics pointers will remain unchanged, allowing you to make changes to things such as the Pokedex data and level-up movesets without worrying about repointing anything.