Popover Menu get started
f.a.q discord
Menu
supported games setup guides f.a.q. generate game host game user content discord
Minecraft Guide

Minecraft Randomizer Setup Guide

Required Software

Configuring your YAML file

What is a YAML file and why do I need one?

See the guide on setting up a basic YAML at the Archipelago setup guide: Basic Multiworld Setup Guide

Where do I get a YAML file?

You can customize your options by visiting the Minecraft Player Options Page

Joining a MultiWorld Game

Obtain Your Minecraft Data File

Only one YAML file needs to be submitted per Minecraft world regardless of how many players play on it. All players on the world will work on progression together.

When you join a multiworld game, you will be asked to provide your YAML file to whoever is hosting. Once that is done, the host will provide you with either a link to download your data file, or with a zip file containing everyone's data files. Your data file should have a .apmc extension.

Double-click on your .apmc file to have the Minecraft client auto-launch the installed NeoForge server. Make sure to leave this window open as this is your server console.

Connect to the MultiServer

Open Minecraft, go to Multiplayer > Direct Connection, and join the localhost server address.

If you are using the website to host the game then it should auto-connect to the AP server without the need to /connect.

Otherwise, once you are in-game, type /connect <AP-Address> (Port) (Password), where <AP-Address> is the address of the Archipelago server. (Port) is only required if the Archipelago server is not using the default port of 38281. Note that there is no colon between <AP-Address> and (Port). (Password) is only required if the Archipelago server you are using has a password set.

Example usage: /connect archipelago.gg 38281 password123

Play the game

When the console tells you that you have joined the room, you're all set. Congratulations on successfully joining a multiworld game! At this point any additional minecraft players may connect to your NeoForge server. To start the game once everyone is ready use the command /start.

Non-Windows Installation

The Minecraft Client will install NeoForge and the Archipelago mod. On supported operating systems, it will additionally download a local copy of the Temurin JRE.

For other operating systems, you will need to have a Java installation available on your system path to install and launch the server. Head to [minecraft_versions.json] to see which Java version is required. When in doubt, the latest release of Java should almost always work on modern (1.17+) releases of Minecraft.

Full Manual Installation

If you're crafty, the Archipelago client is fully optional. The following steps may help you setup an Archipelago on a remotely hosted server. Exact version numbers are omitted; refer to [minecraft_versions.json] for specifics.

minecraft_version.json