ObraDinnArchipelago

Obra Dinn Archipelago

This is a mod to make Return of the Obra Dinn Archipelago compatible.

Note: Return of the Obra Dinn will not be merged into the main Archipelago repo due to its 18+ rating; as such, you

will need the host of your Archipelago session to manually generate the required Archipelago zip file instead of using

the website's generator. Instructions to do so can be

found here

Setup Instructions

First Time Setup

• Add the latest APWorld to your Archipelago 'worlds' folder.
• Download a supported mod manager (recommended), or manually set up the mod. If you need to switch methods, ensure all files and programs from one method are removed before switching.

Mod Manager Setup

• Download and install either r2modman or the Mod Manager
• Locate "Return of the Obra Dinn" in the list of games, then click on "Select Game" when hovering over it. Recommended: Star the entry before clicking on "Select Game", you'll need to find it every time you wish to launch the game
• On the Profile selection screen, select either "Create new" to create a new profile (if you want to keep this mod separate from other mods) or "Select profile" (if you're fine with keeping your mods in one place)
• In the sidebar, click on "Online", search for "Archipelago" in the top bar, click on the "Obra Dinn Archipelago" mod, then click "Download".

Manual Mod Setup

• Install BepInEx. Note: If on Windows, use the x86 version.
• Download and unzip the latest release to the bepinex plugins folder

Connecting to Archipelago

• Create your YAML file. Highly recommended to use different slot names for each Archipelago session, to help differentiate between saved sessions
• Launch the Obra Dinn client in the main Archipelago client (should be a button in the right column that says "Return of the Obra Dinn Client")
• Connect to your session through the Obra Dinn client
• Once connected, launch your modded copy of Return of the Obra Dinn:
• If you followed the Mod Manager Setup process:
• Launch r2modman Mod Manager
• Find "Return of the Obra Dinn" in the games list, then click "Select Game"
• Click "Select profile" on the profile that contains your Archipelago mod
• Click on "Start modded"
• If you followed the Manual Mod Setup process, locate your game executable and launch it.
• Once the game has launched, click "Start".
• If you're connecting to a session you've connected to before, the slot name and start date should be listed; click on

it and you should connect automatically

• If you're connecting to a new sessions, click on "New Connection". Enter the following details, then hit Connect
• Do not change the value in the first text box.
• Enter your slot name in the second text box
• Enter the server password in the third text box; if there's no password, clear the field
• A warning will appear if the details you've entered match an existing connection's details. If you're certain that you need to create a new session connection, hit 'Connect' again.
• You should be connected!

Development

Requirements

• PC Copy of Return of the Obra Dinn

• BepInEx x86 v5.4.23.2 or higher (but not v6)

-.NET 8.0

• A C#/.NET compliant IDE
• Visual Studio Community Edition,

with the.NET desktop and Unity development packages

• JetBrains Rider

• Unity 2017.4.37 (Optional, for creating assets)

• AssetStudio v0.16.47 (Optional, for updating assets)

• dnSpy v6.5.1 (Optional but recommended)

• Runtime Unity Editor v5.4 (Optional but

recommended)

A Note on Unity

The version of Unity used to create Return of the Obra Dinn is a bit of a unique version.

It was the last to offer direct support for AssetBundles, it doesn't have direct support for Unity Package Manager, and

it seems to have been scrubbed from Unity's download archive. As such, there's a lot of trial and error to get a

development setup functional for modding this game. These instructions may not provide the best development workflow,

but it was wha