Setup Guide

Kingdom Hearts III

The normal install, patch, connection, and Save Manager workflow for Kingdom Hearts III.

GuideQuick Setup Guide
LanguageEnglish
AuthorsCodex, Aesais

Guide

Follow the setup path below and expand optional details as needed.

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

  1. Download kh3.apworld from the link above.
  2. Open the Archipelago Launcher.
  3. Click Install APWorld and select kh3.apworld.
  4. Restart the Archipelago Launcher.

After restarting, KH3 Client should appear in the launcher.

2. Patch the Game

  1. Close Kingdom Hearts III.
  2. Open KH3 Client from the Archipelago Launcher.
  3. Open the KH3 Config tab.
  4. If the game was not detected automatically, select your Kingdom Hearts III install folder on the KH3 Dir row.
  5. Make sure the detected Save Dir is correct.
  6. Leave save cleanup set to Backup unless you intentionally want old saves deleted without a new backup.
  7. Click Patch Game and 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

  1. Keep Kingdom Hearts III closed.
  2. Enter the room's server address in KH3 Client.
  3. Click Connect.
  4. If prompted, enter your exact room slot name and password.
  5. Wait for the client to finish preparing and installing your player file.
  6. 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

  1. Close KH3 and disconnect the client.
  2. Open Save Manager.
  3. Click Activate beside the run you want.
  4. 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 Dir row.

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

  • Delete removes the selected AP run after confirmation.
  • Restore Vanilla KH3 on 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.