Homura-Hime Randomizer Setup Guide

Required software

• Homura-Hime (Windows, Steam)
• BepInEx 5 (the x64 Mono build, version 5.4.x)
• The Homura-Hime Archipelago plugin (HomuraHimeArchipelago.dll and Archipelago.MultiClient.Net.dll), from the\n HomuraHimeArchipelago-plugin-<version>.zip of the GitHub release. Extracting that zip into the game folder does step 2\n below for you.
• The homura_hime.apworld, for generating (put it into the custom_worlds folder of your Archipelago install)

Installing the plugin

1. Extract BepInEx into the game folder (the folder with HomuraHime.exe) and start the game once, so BepInEx creates its folders. Close the game.
2. Copy both dll files into BepInEx/plugins/HomuraHimeArchipelago/.
3. Start the game. A small "Homura-Hime Archipelago" label in the top left corner shows that the plugin is loaded.

Creating a config file

On the options page of the website, the presets Standard (the defaults), Balanced Random (a world order that keeps the story's pacing, progressive keys, few traps) and Chaos (everything random, every extra location in, advanced movement required, Death Link on) are a quick start. Instead of the website you can use the template from the Archipelago Launcher ("Generate Template Options") once the apworld is installed. Save your yaml into the Players folder for generating.

Connecting

1. On the title screen press F10 to open the connection form (the game locks the mouse, so the form is driven by the keyboard).
2. Fill in Server (host:port, e.g. archipelago.gg:38281), Slot (your player name) and Password if the room has one. Tab or Up/Down switches fields, Ctrl+V pastes.
3. Press F11 to connect (F12 disconnects, F10 closes the form). The status line under the form shows the result.
4. Start a new game for a new seed. The randomizer's progress is stored in that save file, so later sessions continue where you left off: load the save and connect again.

The server, slot and (optionally) the password are remembered in BepInEx/config/com.homurahime.archipelago.cfg. Set AutoConnect = true there to connect when the game starts.

Troubleshooting

• "The seed was generated by an old/newer Homura-Hime world": the plugin and the apworld used to generate must have the same major.minor version. Update the one that is behind and, for an old world, generate again.
• Nothing happens on F10: check BepInEx/LogOutput.log for errors while the plugin loads.
• Item notifications are too frequent: ItemNotifications in the config file can be All, Important or Off.
• When reporting a bug, include BepInEx/LogOutput.log; the plugin logs the seed's options when it connects.