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

1. Download the latest repo.apworld from releases
2. 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.
3. Using the Archipelago.gg website or a local machine, host a server using the output file generated.

Thunderstore instructions

1. Install the Thunderstore Mod Manager at https://www.overwolf.com/app/thunderstore-thunderstore_mod_manager
2. Install the R.E.P.O. Archipelago mod and all dependencies by clicking on "Install with Mod Manager" at https://thunderstore.io/c/repo/p/Automagic/Archipelago_Randomizer_for_REPO/
3. On the Profile page of the Thunderstore Mod manager, click "Edit config" then click edit on "BepInEx/config/BepInEx.cfg". You may need to run the game modded first for this to appear.
4. Under the "Chainloader" section, set "HideManagerGameObject" to true and click save.
5. Click the Run Modded button to launch R.E.P.O.
6. On the main menu, click the Archipelago button and enter the server address, port, server password, and player slot name into the listed fields.
7. After a successful connection, start a new save file and begin playing.

Manual Client Install Instructions

1. Download version 5.4.21 of BepInEx from https://thunderstore.io/c/repo/p/BepInEx/BepInExPack/
2. Follow the instructions on Thunderstore to manually install BepInEx.
3. Run R.E.P.O. so BepInEx completes its installation.
4. In your R.E.P.O. game folder, open the BepInEx/config folder and open the BepInEx.cfg file with any text editor
5. Under [Chainloader] set HideManagerGameObject to true. Then save and close the file.
6. Download the latest release of the client plugin.
7. Extract the contents of the downloaded zip folder into the BepInEx/Plugins folder.
8. Download MenuLib and REPOLib from Thunderstore and add them to your plugins folder.
9. Launch R.E.P.O.
10. On the main menu, click the Archipelago button and enter the server address, port, server password, and player slot name into the listed fields.
11. After a successful connection, start a new save file and begin playing.

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.
• Truck messages will currently be displayed redundantly if there is more than one host (connected) player in the same lobby.

Mod:

• updated in-logic items and locations to match REPO v0.3.0 logic
• changed tracking of gathered pellys to use more consistent naming and added a 'found' label for collected valuables
• the store can no longer contain multiple copies of the same ap item
• small corrections to item sending and processing
• prevented creating and loading saves until connected
• some save data is now synced with clients so they can see what checks a valuable will grant
• the pelly goal now correctly requires the player to extract each pelly, even if the game it would grant an item for is already complete
• added two mod config options to reduce bad luck with monster and valuable spawns
• added a config option to stop multiworld messages from appearing on the truck screen

Apworld:

• updated in-logic items and locations to match REPO v0.3.0 logic
  • also added the peeper soul to logic
• added a manifest to ensure compatibility with future ap versions
• updated 'stun mine' item name to 'Trapzap'
• removed the small/medium/large health pack items (They are meant to be filler currently do nothing. Progressive health packs are what actually unlock each tier of the store items.)

Known issues:

• Upgrade items are not restored when the player gets a game over. This isn't a major issue because the save file gets deleted anyway, so they can just create a new one.
• In multiplayer, non-host players may see frequent warnings in their log about not being connected to the multiworld. These warnings can be ignored.