Setup Guide
Kingdom Hearts III
The normal install, patch, connection, and Save Manager workflow for Kingdom Hearts III.
Guide
This is the normal setup path for Kingdom Hearts III on Steam or the Epic Games Store. The KH3 client handles the runtime, game mods, player pak, and save-run management for you.
KH3 AP is currently an Alpha release. Start every seed from a fresh KH3 save and keep the KH3 client connected while playing.
What You Need
- Kingdom Hearts III on PC.
- Archipelago 0.6.6 or newer.
- The Kingdom Hearts III APWorld.
- The server address and exact slot name for your Archipelago room.
1. Install the APWorld
- Download
kh3.apworldfrom the link above. - Open the Archipelago Launcher.
- Click
Install APWorldand selectkh3.apworld. - Restart the Archipelago Launcher.
After restarting, KH3 Client should appear in the launcher.
2. Patch the Game
- Close Kingdom Hearts III.
- Open
KH3 Clientfrom the Archipelago Launcher. - Open the
KH3 Configtab. - If the game was not detected automatically, select your Kingdom Hearts III
install folder on the
KH3 Dirrow. - Make sure the detected
Save Diris correct. - Leave save cleanup set to
Backupunless you intentionally want old saves deleted without a new backup. - Click
Patch Gameand wait for it to finish.
Patch Game installs everything KH3 AP needs. You normally do not need to
download Garden of Assemblage, UE4SS, or any other runtime files yourself.
It also prepares the .NET SDK used to generate player paks, reusing a compatible
installation or downloading one into the client's tool cache if needed. Wait
for patching to finish successfully before connecting. If SDK setup fails,
resolve the reported error and run Patch Game again.
For Steam, the client also tries to disable Steam Cloud for Kingdom Hearts III only. Follow the client warning if Steam Cloud must be disabled manually.
Run Patch Game again whenever you install a newer KH3 APWorld.
3. Connect to Your Server
- Keep Kingdom Hearts III closed.
- Enter the room's server address in
KH3 Client. - Click
Connect. - If prompted, enter your exact room slot name and password.
- Wait for the client to finish preparing and installing your player file.
- Click
Launch KH3, then start a fresh KH3 save for this seed.
The client downloads or builds the correct player pak automatically. Most
players never need to use KH3 Pak Generator or manually copy a pak into the
game folder.
Keep KH3 Client connected before launching or loading into KH3. If you change
seeds or patch files, close and restart KH3 so the new files load.
Extra Victory Bonuses
Every victory bonus gives three randomized rewards: the original check plus
Reward 2 and Reward 3, both named after the original encounter. Completing
the original check collects all three. The extra checks follow the same access,
junk, and exclusion rules as the original, and can hold items for any player.
The two additional checks always exist, regardless of item-pool composition. Archipelago fills all three from the shared randomized item pool: progression (including progressive items), useful items, filler, and traps are all eligible, subject to the original check's configured restrictions.
Save Manager
The client adds a run to Save Manager after connecting successfully. Each run
keeps its player pak, bridge state, connection details, and KH3 gameplay saves
together.
Continue a saved run
- Close KH3 and disconnect the client.
- Open
Save Manager. - Click
Activatebeside the run you want. - Reconnect and launch KH3.
Activation installs that run's player pak and restores its KH3 saves. The server address is remembered for the next connection.
Start a different seed
Connect to the new room with KH3 closed. The client can preserve the current run and prepare the new seed automatically.
If the client says the active saves belong to another seed, either:
- enable
Auto remove saves on new seed; or - close KH3 and use the trash button on the
Save Dirrow.
With cleanup set to Backup, the old saves are archived first.
Manual files
Use Import Seed Pak only when an organizer gives you a .pak, .apkh3, or
generated Archipelago .zip. Import the file, then click Activate beside the
correct run.
Delete or leave Archipelago
Deleteremoves the selected AP run after confirmation.Restore Vanilla KH3on the Config tab restores protected vanilla saves.
Inactive stored runs can be deleted while connected. Deleting the active run requires disconnecting and closing KH3. Close KH3 before switching runs.
Quick Troubleshooting
| Problem | What to do |
|---|---|
KH3 Client is missing from the launcher. |
Install kh3.apworld again and restart the Archipelago Launcher. |
| Checks do not appear in the client. | Close KH3, run Patch Game, connect the client, and then relaunch KH3. |
| The installed pak or save seed does not match the room. | Close KH3, activate the correct run in Save Manager, and reconnect. |
| The client blocks a new seed because of old saves. | Close KH3 and use automatic save cleanup or the Save Dir trash button. |
| The game still behaves like the previous seed. | Close KH3 completely and launch it again after the client finishes installing the new seed. |
For manual pak installation, alternate seed sources, Linux/toolchain details, mod compatibility, or deeper recovery steps, see the Advanced Setup and Troubleshooting Guide.