Skip to the content.

PC - Steam and Epic Setup Guide

Heads up!


Installing OpenKH Mods Manager and Seed Generator

  1. Start by downloading the 3 programs from the download links above
  2. Install .NET6 Runtime by running the windowsdesktop-runtime-6.0.25-win-x64.exe executable you just downloaded
  3. Create a KH2 Rando folder (you may give it any name) on the same hard drive you have the game installed. This is where we will be installing the Mods Manager and Seed Generator

First Warning

  1. Extract the OpenKH Mods Manager to the “KH2 Rando” folder
    • It’s recommended to give each app its own subfolder to make navigating their files easier (See screenshot)
  2. Place the Seed Generator exe into its own “Seed Generator” folder in the “KH2 Rando” folder. When we run the Seed Generator for the first time later in this guide, it will place a few new files and folders into its directory and we don’t want to get them mixed up with our other stuff

Rando Folder

Setting Up OpenKH Mods Manager:

  1. Find and run the OpenKh.Tools.ModsManager.exe from inside the OpenKH installation folder
    • The Setup Wizard will open automatically, click Next to start

Wizard Differences

  1. Click on the Game Edition drop-down menu and select PC Release
  2. In the next drop-down menu, choose Epic Games Store as your launcher (or Steam if you have the Steam version)
  3. Once you have selected the launcher, click on the Detect Installations button to have the wizard automatically locate your game install folders (KH 2.8 is also supported by the Mods Manager but is not required to complete the setup)
    • If the wizard fails to automatically detect your game install folder you will need to manually navigate to it by clicking the folder icon on the right of the input line
  4. Once your game folder is found, click Next

    Setup Wizard-Game Edition

  5. On the Panacea installation page, first set the Game Collection drop-down menu to KINGDOM HEARTS 1.5 + 2.5 ReMIX
  6. Then, click the Install Panacea for Windows button. This will install Panacea (a real time mod loader) to your game installation folder. Then click Next
    • If you want to verify it was added successfully, check your game’s install folder for a file called DBGHELP.DLL and a folder called Dependencies

    Panacea Wizard Window

  7. On the Install LuaBackend page, verify the Game Collection is set to KINGDOM HEARTS 1.5 + 2.5 ReMIX
  8. Then enable the KH2 check box and click Install and Configure Lua Backend
    • You may enable the other games now if you want, or re-run the setup wizard at any time to add support for the rest in the future.
  9. Once the LuaBackend install is complete click Next

    LuaBackend Install Window

Extraction Note

  1. Leave the extraction location as default, then press the Extract Game Data button to begin. The upscaled textures have increased the time needed to extract all of the game files. It may take anywhere from 15-30 minutes to fully extract KH2 so please be patient. The progress bar may sit around the 75% mark for a few minutes so make sure to wait for the page to say the extraction is done before continuing.

    Extraction Window

  2. Once the extraction is complete, click on Next and on the final window click Finish. You have successfully installed the Mods Manager!

Garden of Assemblage Mod Installation:

Installing new mods into the Mods Manager is easy! Follow these steps to get the main Garden of Assemblage mod installed:

  1. Be sure the game selected in the top right of the Mods Manager main window shows Kingdom Hearts 2
  2. Next, Click Mods in the top left drop down menu, and then click Install a new mod

    Install New Mod

  3. In the Add a new mod from GitHub section, type in KH2FM-Mods-Num/GoA-ROM-Edition. This will download the GoA mod from its hosted GitHub repo
    • You can find more mods posted in the KH2 Rando Discord Server HERE

    Install GoA ROM

  4. To enable GoA, be sure to click the checkbox next to the newly added mod in the list

    Enable GoA ROM

  5. Then click Mod Loader and then Build and Run which will build your new mod and run the game for you automatically

    Build Only

Second Warning

Installing a new seed to play:

  1. Open the Seed Generator app by double clicking the KH2.Randomizer.exe program you downloaded earlier. If this is your first time starting the program, it may take some time to open as it extracts the necessary folders and files it uses to run.
  2. Choose your seed settings in the generator window, or choose one of the built in presets under the Preset tab (I recommend the “StarterSettings” preset) and then click on Generate Seed in the bottom right

    Generate Seed

Third Warning

  1. This will open up a window to save the seed as a zip file. Save it anywhere that works for you (I like to place it in the same folder as the generator)
  2. Once saved, return to the Mods Manager and click on Mods, then Install a New Mod
  3. This time click on Select and Install Mod Archive or Lua Script, navigate to your new seed zip file and click Open

    Install New Seed

    Target New Seed

Fourth Warning

  1. Be sure to click on the check box next to the seed, then click on Build and Build and Run to enable the mod in game. Note the 5 buttons to the right of the mod list. The first button places a mod at the top of the list. The second moves a mod up the list one space, the third moves it down the list by one space. The green ‘+’ icon is a shortcut to install a new mod, while the red “-“ icon is a shortcut to deleting a mod
    • How to install a new seed in the future: Create a new zip seed file using the generator. Delete the current seed from your Mods Manager. Add the new zip seed to your Mods Manager. Enable the seed and then Build and Run

    Enable New Seed


You Mods Manager should look like this when you are done:

Final View

You are now ready to play the KH2 Randomizer!

Please use the #help channel in our Community Discord if you have any errors or questions.

Technical And Stability Notes

  1. As mentioned earlier in the guide, the Mods Manager/Lua doesn’t seem to work if the folder is under a “OneDrive” directory. We don’t know exactly why but it’s a consistent thing between users. Be sure to move your folders and re-run the setup wizards if you installed in a “OneDrive” directory.
  2. Recommended to set fps limit to 60fps.
  3. Recommended to run game in Windowed/Borderless Fullscreen. Fullscreen is stable but the game can crash if you alt-tab out.
  4. Overlays that hook onto the game process (Steam, RivaTuner, NVIDIA Overlay, etc) and recording programs (OBS, Streamlabs, Xsplit) seem to decrease stability when playing rando. It’s recommended to disable them, or in the case of recording programs use window/desktop capture, in order to minimize your chances of a crash.
  5. GoA ROM and the Seed Generator will always be compatible with one another. Any other mods beyond that should be compatible as long as they don’t overlap on changes. Mods at the top of the list will overwrite mods below them if there’s any overlapping files. Feel free to ask in the Community Discord if you aren’t sure.
  6. Boss/Enemy Rando is amazing but still a work in progress. Please report any bugs/softlocks/out-of-bounds glitches you encounter to the corresponding Google Form listed in the #bug-reports channels of our Discord.