Kingdom Hearts Save Editor

List of supported games:

• Kingdom Hearts (all vanilla releases)
• Kingdom Hearts Final Mix (Remix too)
• Kingdom Hearts II Japan
• Kingdom Hearts II USA (EU should be the same as this)
• Kingdom Hearts II Final Mix (Remix too)
• Kingdom Hearts III + ReMind (PC only)

The idea to write my own save editor came from the fact that Kingdom Save Editor is abandoned and it is very barebones in terms of knowledge and it can't be run on Android. For a university assignment I had to work with the ipywidgets Python package so I thought I could use it for my save editor. It turned out that it's not optimized for small screens so I was looking for GUI packages. I mostly stayed with Python since it can be easily used on Android. So after multiple restarts and a second university class influence I landed on Dash.

So I want to emphasize that the priority is to run the app on smartphones hence the overly vertical alignment.

How to run

This is a Plotly Dash app written in Python so you need to have Python installed. After then install the dash package via pip install dash.

Open a terminal in the repo's folder and run the command "python kh1se.py" alternatively if you have Jupyter Notebook installed you can run the 1st code cell in the ipynb file. I recommend the latter on Android. For KH2 do the same with kh2se.py.

Create a files and a saved folder in the repo's folder. Put your save files or even better save slot folders into the files folder. The app saves modified files into the saved folder. The output will ALWAYS be a folder slot to avoid issues. I changed this to load save files per game subfolders so KH1 save files or save folders must be in files/kh1 and for KH2 in files/kh2. The output is also put into game specific subfolders.

Dependencies

• Python (any version that supports the following packages)
• Plotly Dash (pip install dash==v3.3.0)
• Pandas + NumPy (pip install pandas) (NumPy is included with Pandas; the KH1 Gummi Ship viewer needs these)
• PyCryptodome (pip install pycryptodome) (KH3 needs this for the AES encryption)
• Jupyter Notebook (more stable launching on Android)
• Pydroid 3 (Android app I use to run the my apps so on PC you don't need this)

Features

What not to expect

• Don't expect support for the PC Remix PNG files, use Kingdom Save Editor for them. I have no reason to copy that functionality.
• No memory card file support. Use folder type memory card and put the save slot's folder into the repo's files folder that YOU need to create.

KH1 features

• Support for both vanilla and Final Mix save files.
• Playtime: Hours, minutes, seconds and the modulo 60 since it's stored in frames which are seconds $\cdot$ 60 (in NTSC builds; I haven't tested any PAL versions).
• Characters:
  • Base Stats
  • Sub MP: The orange MP bar. Remix versions are bugged, they might not load this.
  • Elemental Resistances
  • Abilities
  • Equipment
  • Equipped Items
  • Spells that a party member can use.
• Leveling Curve and Path
• Magic levels
• Unlocked Summons
• Jiminy's Journal:
  • Ansem's Report unlock flags
  • Character and Heartless journal entries
  • Heartless kill counts
  • 99 Puppies unlock flags
  • Everything Trinity related
  • Mini Game records.
  • Battle Report (—Battle Record—)
  • Treasure Chest and Atlantica Clam flags. (Vanilla chest contents aren't always correct yet but FM should be 100% correct.)
• Config menu options. It reflects the PS2 versions' options. Some of them are repurposed in Remix versions. PS3 and PC differs in that PC repurposes more options.
• World statuses and landing point flags
• Gummi Ships:
  • Name
  • Block Count
  • Assembly Area
  • Transform Pair
  • Every property of its Gummi Blocks:
    • Type
    • Coordinates
    • Orientation
    • Color (for now you must specify its ID because I haven't named the shades)
  • Gummi Inventory including Final Mix exclusives
  • Gummi Ship Control Config (PC Remix ignores it but PS3 Remix doesn't)
• Inventory and Ability dropdowns feature Final Mix exclusives in vanilla mode for modding reasons.
• The kh1.py file documents more known fields than the current app can edit. You can for example reset the Xemnas fight.
• PCSX2 attach:
  • Set slot to 0.
  • Set if you play vanilla or FM; vanilla means the USA ROM, won't work with other vanilla ROMs
  • Compatible with BOTH PCSX2 1.6.0 and PCSX2 Qt!
  • Windows only

KH2 features

• Support for vanilla Japanese, vanilla USA and Final Mix save files. Vanilla JP is entirely my research because it greatly differs from vanilla USA so I had to rediscover the equivalent fields.
• Global playtime
• Leveling path
• World, room, flag
• Munny
• EXP
• Current Drive Form and Summon
• Characters:
  • Level
  • Current and max HP and MP
  • Number of applied AP, Strength, Magic and Defense Boosts
  • Equipment
  • Abilities. Due to technical reasons I only allow you to fill max - 2 slots.
  • Auto Reload
  • Shortcuts for Sora, battle style and ability styles for allies
• Drive Forms
• Inventory
• Jiminy's Journal:
  • Bestiary:
    • Heartless and Nobody kill counts
    • Reaction Command counters
    • Limit max scores
  • Minigame records
• Difficulty

KH3 features

• Support for both raw encrypted and decrypted save files
• Proper decryption and encryption
• You need to provide your account ID if it's not 1638
• Saving will put out both encrypted and decrypted files
• Playtime
• Desire and Power Choices
• Party
• Munny
• EXP
• Difficulty
• Advanced general options:
  • Map Path and Map Spawn
  • Player Script and Player Pawn

Documentation

For now, kh1_src/kh1.py and kh2_src/kh2.py double as save file documentations for the respective games. It's another long term goal to create user-friendly documentations.

Known issues

• It's heavily work in progress so expect issues.
• Some fields aren't saved yet.
• There are placeholder tabs that won't show anything. This isn't a bug, they just aren't implemented yet.
• The KH1 minigame records can shift up if you unset then set a record. The method I use for KH2 might solve this when I port it back.

Special thanks

• Xeeynamo: Kingdom Save Editor the main inspiration of the project
• Game Tools Collection for an online PS2 KH1 save editor that provided lots of used info
• GICU for providing various KH1 flags like the treasure chests and other helps
• dedede123 & fungualtissue1230 for the PowerShell script to decrypt and encrypt the KH3 PC save files
• The OpenKH community for various helps including modding the KH games
• The RetroAchievements community for the Code Notes and the fun sets and not just the KH ones