R.E.P.O. Archipelago Client Mod
What is Archipelago
Archipelago is a multi-game open-source randomizer that combines a variety of games into a single multiplayer experience.
More information at https://archipelago.gg/
Multiworld Setup Instructions
- Download the latest repo.apworld from releases
- Follow the instructions on https://archipelago.gg/tutorial/Archipelago/setup/en on generating a game. Note that you will have to place the .apworld file in the lib/worlds folder of your Archipelago install and generate locally.
- Using the Archipelago.gg website or a local machine, host a server using the output file generated.
Thunderstore instructions
- Install a Mod Manager (I personally recommend r2modman or Gale, but Thunderstore Mod Manager is also an option)
- Open the mod manager and create a new profile. Select that profile, then open the tab that lets you browse mods and install Archipelago Randomizer for REPO and it's dependencies. Alternatively, go to https://thunderstore.io/c/repo/p/Automagic/Archipelago_Randomizer_for_REPO/ and click the "Install with Mod Manager" button.
- Click the Run Modded button to launch R.E.P.O. When the main menu loads, you should see a new button at the bottom of the screen that says "ARCHIPELAGO".
- On the main menu, click on the Archipelago button to open the connection menu. Enter your multiworld's address, port, password (if it has one, otherwise leave the box blank), and your slot name, then click CONNECT. If you entered everything correctly, the text above the address box should change from 'Not connected' to 'Connected'.
- After a successful connection, start a new save file and begin playing.
Manual Client Install Instructions
- Download version 5.4.21 of BepInEx from https://thunderstore.io/c/repo/p/BepInEx/BepInExPack/
- Follow the instructions on Thunderstore to manually install BepInEx.
- Run R.E.P.O. so BepInEx completes its installation.
- Download the latest release of the client plugin.
- Extract the contents of the downloaded zip folder into the BepInEx/Plugins folder.
- Download MenuLib and REPOLib from Thunderstore and add them to your plugins folder.
- Launch R.E.P.O.
- On the main menu, click the Archipelago button and enter the server address, port, server password, and player slot name into the listed fields.
- After a successful connection, start a new save file and begin playing.
Downpatching the Game
When REPO receives major updates, this mod may not work correctly until it is updated to support the latest game version. If that happens, you will need to downpatch the game to an older version.
- Follow the first 6 steps of this guide, but replace the command in step 5 with download_depot 3241660 3241661 180069324351455863
- Open your REPO folder (in the steamapps/common folder of Steam)
- Open the Depot folder (in steamapps/content)
- Drag all the files in the depot folder (including the REPO.exe file) and replace the files in the REPO folder (steamapps/common)
- Go into your steam library, right click REPO, click Properties -> Updates, and set it to only update when the game is launched (this will cause it to update if it is launched in Vanilla but not Modded)
- In your mod manager or manual installaton, ensure that the versions of REPOLib and MenuLib you have installed are for the previous game version.
- If you are using a mod manager, launch the game from it. If you are not using a mod manager, switch steam to Offline mode before launching the game. Once REPO finishes launching, you can switch back online.
Randomized Items
- Upgrades
- Levels
- Unlock Items in Shop
- Shop Stock
Randomized Locations
- Shop Items
- Pelly Extraction
- Valuable Extraction
- Monster Soul Extraction
Known Issues
- Unsecure socket notification in server. This is from an upstream library and causes no gameplay issues currently.
