85 lines
4.8 KiB
Markdown
85 lines
4.8 KiB
Markdown
# Archipelago Setup Guide
|
|
|
|
This guide is intended to provide an overview of how to install, set up, and run the Archipelago multiworld software.
|
|
This guide should take about 5 minutes to read.
|
|
|
|
## Installing the Archipelago software
|
|
|
|
The most recent public release of Archipelago can be found on the GitHub Releases page. GitHub Releases
|
|
page: [Archipelago Releases Page](https://github.com/ArchipelagoMW/Archipelago/releases).
|
|
|
|
Run the exe file, and after accepting the license agreement you will be prompted on which components you would like to
|
|
install.
|
|
|
|
The generator allows you to generate multiworld games on your computer. The ROM setups are required if anyone in the
|
|
game that you generate wants to play any of those games as they are needed to generate the relevant patch files.
|
|
|
|
The server will allow you to host the multiworld on your machine. Hosting on your machine requires forwarding the port
|
|
you are hosting on. The default port for Archipelago is `38281`. If you are unsure how to do this there are plenty of
|
|
other guides on the internet that will be more suited to your hardware.
|
|
|
|
The `Clients` are what are used to connect your game to the multiworld. If the game/games you plan to play are available
|
|
here go ahead and install these as well. If the game you choose to play is supported by Archipelago but not listed in
|
|
the installation check the setup guide for that game. Installing a client for a ROM based game requires you to have a
|
|
legally obtained ROM for that game as well.
|
|
|
|
## Generating a game
|
|
|
|
### What is a YAML?
|
|
|
|
YAML is the file format which Archipelago uses in order to configure a player's world. It allows you to dictate which
|
|
game you will be playing as well as the settings you would like for that game.
|
|
|
|
YAML is a format very similar to JSON however it is made to be more human-readable. If you are ever unsure of the
|
|
validity of your YAML file you may check the file by uploading it to the check page on the Archipelago website. Check
|
|
page: [YAML Validation Page](/mysterycheck)
|
|
|
|
### Creating a YAML
|
|
|
|
YAML files may be generated on the Archipelago website by visiting the games page and clicking the "Settings Page" link
|
|
under any game. Clicking "Export Settings" in a game's settings page will download the YAML to your system. Games
|
|
page: [Archipelago Games List](/games)
|
|
|
|
In a multiworld there must be one YAML per world. Any number of players can play on each world using either the game's
|
|
native coop system or using Archipelago's coop support. Each world will hold one slot in the multiworld and will have a
|
|
slot name and, if the relevant game requires it, files to associate it with that multiworld.
|
|
|
|
If multiple people plan to play in one world cooperatively then they will only need one YAML for their coop world. If
|
|
each player is planning on playing their own game then they will each need a YAML.
|
|
|
|
### Gather All Player YAMLs
|
|
|
|
All players that wish to play in the generated multiworld must have a YAML file which contains the settings that they
|
|
wish to play with.
|
|
|
|
Typically, a single participant of the multiworld will gather the YAML files from all other players. After getting the
|
|
YAML files of each participant for your multiworld game they can be compressed into a ZIP folder to then be uploaded to
|
|
the multiworld generator page. Multiworld generator
|
|
page: [Archipelago Seed Generator Page](/generate)
|
|
|
|
#### Rolling a YAML Locally
|
|
|
|
It is possible to roll the multiworld locally, using a local Archipelago installation. This is done by entering the
|
|
installation directory of the Archipelago installation and placing each YAML file in the `Players` folder. If the folder
|
|
does not exist then it can be created manually.
|
|
|
|
After filling the `Players` folder the `ArchipelagoGenerate.exe` program should be run in order to generate a
|
|
multiworld. The output of this process is placed in the `output` folder.
|
|
|
|
#### Changing local host settings for generation
|
|
|
|
Sometimes there are various settings that you may want to change before rolling a seed such as enabling race mode,
|
|
auto-release, plando support, or setting a password.
|
|
|
|
All of these settings plus other options are able to be changed by modifying the `host.yaml` file in the Archipelago
|
|
installation folder. The settings chosen here are baked into the `.archipelago` file that gets output with the other
|
|
files after generation so if rolling locally ensure this file is edited to your liking *before* rolling the seed.
|
|
|
|
## Hosting an Archipelago Server
|
|
|
|
The output of rolling a YAML will be a `.archipelago` file which can be subsequently uploaded to the Archipelago host
|
|
game page. Archipelago host game page: [Archipelago Seed Upload Page](/uploads)
|
|
|
|
The `.archipelago` file may be run locally in order to host the multiworld on the local machine. This is done by
|
|
running `ArchipelagoServer.exe` and pointing the resulting file selection prompt to the `.archipelago` file that was
|
|
generated. |