Popover Menu get started
Popover Menu Tools
client discord
Menu
supported games setup guides f.a.q. generate game host game user content clients discord
Twilight Princess Guide

Setup Guide for Twilight Princess MultiworldGG

Welcome to Twilight Princess MultiworldGG! This guide will help you set up the randomizer and play your first multiworld. Whether playing, generating, or hosting a MultiworldGG room with Twilight Princess, you must follow a few simple steps to get started.

Unfortunately, Mac OS is not officially supported at this time.

Requirements

You'll need the following components to be able to play/generate with Twilight Princess:

If you're playing Twilight Princess, you'll also need:

If you intend to play under Linux, you will need to consider the following information.

Installation

If you're playing Twilight Princess, you must also download the REL loader from https://tprandomizer.com/ and the custom seed file and place both in the save data of dolphin, alongside the RandomizerAP.US.gci file from the zip folder

Setting Up a YAML

All players playing Twilight Princess must provide the room host with a YAML file containing the settings for their world. The TP APWorld download includes a sample YAML file for Twilight Princess. The comments in that file explain each setting's function.

Once you're happy with your settings, provide the room host with your YAML file and proceed to the next step.

Note: Please note the settings labled NON-DEFAULT CHOICE NOT REPRESENTED IN GAME, as these settings will alter logic however they will not be changed from default when playing the game.

Generating a Multiworld

If you're generating a multiworld game that includes Twilight Princess, you'll need to do so locally as the online generator does not yet support Twilight Princess. Follow these steps to generate a multiworld:

  1. Gather all player's YAMLs. Place these YAMLs into the Players folder of your MultiworldGG installation. If the folder does not exist, then it must be created manually. The files here should not be compressed.
  2. Modify any local host settings for generation, as desired.
  3. Run MultiworldGGGenerate.exe (without .exe on Linux) or click Generate in the launcher. The generation output is placed in the output folder (usually named something like AP_XXXXX.zip). * Please note that if any player in the game you want to generate plays a game that needs a ROM file to generate, you will need the corresponding ROM files. A ROM file is not required for Twilight Princess at this stage.
  4. Unzip the AP_XXXXX.zip file. It should include a .aptp file for each player in the room playing Twilight Princess. Each file will be named AP_XXXXX_P#_<name>.aptp, where # corresponds to that player's slot number and <name> is their slot (player) name. The .aptp file currently contains a spoiler log and other debug information it can be safely ignored.
  5. In the next section, use the archive file AP_XXXXX.zip to host a room or provide it to the room host.

Hosting a Room

If you're generating the multiworld, follow the instructions in the previous section. Once you have the zip file corresponding to your multiworld, follow these steps to host a room. Follow the instructions for hosting on the website from a locally generated game or on a local machine.

Connecting to a Room

You may have the .aptp file provided to you by the multiworld generator (you can ignore it.) You should also have the room's server name and port number from the room's host.

Once you do, follow these steps to connect to the room:

  1. Visit https://generator.tprandomizer.com/s/aptest to download the seed file needed to run the randomizer, Feel free to randomize cosmetics and audio as you would like
  2. If you haven't gotten the REL loader, now is a good time to do that from the randomizer website.
  3. From the zip folder downloaded add the RandomizerAP.US.gci to the dolphin save data. (If you are using a non-US version you will have to use the Randomizer file from tprandomizer website and killing gannon will not auto-complete your world)

Your save data folder should have aptest.gci, RELoader, and RandomizerAP.US.gci (Non AP for Non US versions)

  1. Open Dolphin and use it to open Twilight Princess. (Ensure Enable Emulated Memory Size Override is disabled. See troubleshooting for more details)
  2. Start the REL loader save file and select APTest as the seed you want to use. (If US Randomizer) The console should say "Archipelego Randomizer" at the top
  3. Start a new save file and leave links name as default for now, we will change it later.
  4. Start MultiworldGGLauncher.exe (without .exe on Linux) and choose Twilight Princess Client, which will open the text client. It should automatically connect to Dolphin.
  5. Now with dolphin connected run the /name command with the player name you put in the YAML file (max 16 characters.) eg: /name Player1
  6. Connect to the room by entering the server name and port number at the top and pressing Connect. For rooms hosted on the website, this will be multiworld.gg:<port>, where <port> is the port number. If a game is hosted from the MultiworldGGServer.exe (without .exe on Linux), this will default to 38281 but may be changed in the host.yaml.

Troubleshooting