Sea of Stars — Archipelago Multiworld

This is an Archipelago integration for Sea of Stars.

What's randomized

Feature	Status
Treasure chests (scrolls, key items, factory lockers)	✅
Boss defeat locations	✅
Rainbow Conchs (60)	✅
Progressive weapons & armor	✅
Relics	✅
Party members (Seraï, Resh'an)	✅
Death Link	✅
Shops	🔧 In progress
Enemy randomization	🔧 Planned

Setup

Requirements

• Sea of Stars (Steam)
• BepInEx 6 IL2CPP (bleeding-edge build for Unity IL2CPP)
• An Archipelago server to connect to

Install the mod

1. Install BepInEx 6 into your Sea of Stars folder.
2. Launch the game once so BepInEx generates its interop assemblies, then close it.
3. Copy SeaOfStarsAP.dll, Archipelago.MultiClient.Net.dll and Newtonsoft.Json.dll into: Sea of Stars/BepInEx/plugins/SeaOfStarsAP/

Connect

Launch the game. On the title screen the Archipelago connection window will appear automatically.
Enter your server address, slot name and password, then click Connect before starting or loading a save.

Generate a multiworld

Add worlds/sea_of_stars/ to your Archipelago installation and generate normally.

Development

# Python world (logic, items, locations)
cd worlds/sea_of_stars
python -m unittest test.test_generation

# C# mod (BepInEx plugin)
cd worlds/sea_of_stars/mod
dotnet build -c Release

Set the environment variable SOS_GAME_PATH to your Sea of Stars directory, or edit the path in SeaOfStarsMod.csproj. The build automatically copies the output to BepInEx/plugins/.