# Kingdom Hearts Randomizer Setup Guide

## Setting up the required mods

BEFORE MODDING, PLEASE INSTALL AND RUN KH1 AT LEAST ONCE.

1. Install OpenKH and the LUA Backend

    Download the [latest release of OpenKH](https://github.com/OpenKH/OpenKh/releases/tag/latest)
    
    Extract the files to a directory of your choosing.
    
    Open `OpenKh.Tools.ModsManager.exe` and run first time set up
    
    When prompted for game edition, choose `PC Release`, select which platform you're using (EGS or Steam), navigate to your `Kingdom Hearts I.5 + II.5` installation folder in the path box and click `Next`
    
    When prompted, install Panacea, then click `Next`
    
    When prompted, check KH1 plus any other AP game you play and click `Install and configure LUA backend`, then click `Next`
    
    Extracting game data for KH1 is unnecessary, but you may want to extract data for KH2 if you plan on playing KH2 AP
    
    Click `Finish`
    
2. Open `OpenKh.Tools.ModsManager.exe`

3. Click the drop-down menu at the top-right and choose `Kingdom Hearts 1`

4. Click `Mods>Install a New Mod`

5. In `Add a new mod from GitHub` paste `gaithern/KH-1FM-AP-LUA`

6. Click `Install`

7. Navigate to Mod Loader and click `Build and Run`


## Configuring your YAML file

### What is a YAML file and why do I need one?

Your YAML file contains a set of configuration options which provide the generator with information about how it should
generate your game. Each player of a multiworld will provide their own YAML file. This setup allows each player to enjoy
an experience customized for their taste, and different players in the same multiworld can all have different options.

### Where do I get a YAML file?

you can customize your settings by visiting the [Kingdom Hearts Options Page](/games/Kingdom%20Hearts/player-options).

## Connect to the MultiWorld

For first-time players, it is recommended to open your KH1 Client first before opening the game.

On the title screen, open your KH1 Client and connect to your multiworld.