# Clair Obscur: Expedition 33 AP Setup Guide

## Required Software

* [Archipelago 0.6.1+](https://archipelago.gg/tutorial/Archipelago/setup/en)
* A legal version of Clair Obscur: Expedition 33 (Steam or Gamepass)
* [Latest clair_obscur.apworld](https://github.com/Demorck/ClairObscur_APWorld/releases) (by @Jostar)
* [Latest version of the client mod](https://github.com/Demorck/ClairObscurArchipelagoRandomizer/releases) (by @Demorck)

## Recommended Software

* [Poptracker](https://poptracker.github.io/)
  * [Our autotracker for Poptracker](https://github.com/Demorck/ClairObscur-Archipelago-Poptracker/releases) (by @Yezzdia)
* [A map tracker for COE33](https://www.nexusmods.com/clairobscurexpedition33/mods/383)

## Setup

1. Find your Archipelago directory, and put `clair_obscur.apworld` in the `custom_worlds` folder
2. Create a yaml settings file, and put it in the Archipelago directories `players` folder. You can generate a template yaml with the archipelago launcher.
3. Generate your game
4. Host the game, either locally or via the archipelago web hosting service
5. Download the right file in the release tab of the mod client. (Steam or gamepass version).
6. Extract it in the root of the game folder. To be sure that is well extract, you need to find 3 files called ClairObscurRandomizer.pak, ClairObscurRandomizer.ucas and ClairObscurRandomizer.utoc in `\Sandfall\Content\Paks\LogicMods` and ue4ss folder in `\Sandfall\Binaries\[WinGDK or Win64]`
7. Profit !

## Connecting to a game
1. In the main menu, there is an "Archipelago" button. If you don't find it, your installation is not correct.
2. Enter your rooms information like this example:
  * __Host__ : archipelago.gg
  * __Port__ : 69420
  * __Slot__ : MaelleLaPlusBelle
  * __Password__ :
3. Click on "Connect" and wait until it says connected.
4. Create a new save if you are connected for the first time. __NOTHING WILL HAPPEN UNTIL SPRING MEADOWS. WHEN YOU ARE IN SPRING MEADOWS, PRESS CTRL + F2__ (for now)

## Further Reading
- [wiki](https://github.com/Demorck/ClairObscur_APWorld/wiki/)