Setup Guide

Note: Make sure to save often.

1. Retroarch

Download retroarch - Grab the latest release from the official site. The Steam build is currently unsupported. The Linux flatpak or AppImage versions work fine on most distributions.
Install the core - NOTE: Do this even if you've previously installed the core to ensure you have the latest version
1. Open Install/Load Core -> Download Core.
2. Navigate to Nintendo - Nintendo 64 (Mupen64Plus‑Next) and download it.
Return to the RetroArch main menu
Enable network commands & QoL settings
1. Choose Settings -> User Interface
  - Show Advanced Settings: ON
  - Pause Content When Menu Is Active: OFF
  - Pause Content When Not Active: OFF
2. Back to Settings -> Network
  - Network Commands: ON (near the bottom of the list)
Save your Configuration
- Main Menu -> Configuration File -> "Save Current Configuration"

Generate a seed and download the resulting .apz5 file.
Extract the .apz5 with Ark or other extraction tool on Linux, 7zip on Windows
Patch your ROM - you need the vanilla Ocarina of Time v1.0 ROM.
Randomizer generator: Ocarina of Time Randomizer (v7.1.0)
- Generate From Patch File option (near the bottom of the page)
- Override Original Cosmetics optionally un check this unless you specify new cosmetics on this page
Launch the patched ROM in RetroArch. The title screen should display "Randomizer".

Download the latest release of the client:
https://github.com/JoshuaEagles/Archipelago.RetroArchClient/releases/latest
Extract the archive.
Open a terminal (Linux & Mac) in the extracted directory and run:
```
./Archipelago.RetroArchClient
```

If the client disconnects you may need to restart the client to get it to reconnect. Improvements to the client are planned and in development.