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 an Archipelago 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:
- Install MultiworldGG v0.7 or higher.
Make sure to install the Generator if you intend to generate multiworlds. - If you want to use AP: The latest version of the Twilight Princess APWorld.
If you're playing Twilight Princess, you'll also need:
- Install Dolphin Emulator.
We recommend using the latest release. - A legaly obtained Twilight Princess ISO.
If you intend to play under Linux, you will need to consider the following information.
- Grab the
tar.gzversion of MultiworldGG, not theAppImage. The file name should be similar to the following on the release page:Archipelago_X.X.X_linux-x86_64.tar.gz. - For Dolphin, you can use the flatpak package available on Flathub.
Installation (Archipelago only)
All users should follow these steps:
- Unzip the downloaded Twilight Princess APWorld zip file.
- Double-click the
twilight_princess.apworldfile. It should automatically install the APWorld after a little while. You will get a little dialog window telling you it has been installed successfully. * Alternatively, copy thetwilight_princess.apworldto your Archipelago installation'scustom_worldsfolder (Windows default to:%programdata%/Archipelago).
Note: If you have a previous version of the apworld you will need to remove it.
If you're playing Twilight Princess, you must also download the REL loader from https://tprandomizer.com/downloads/ and place it in the save data of dolphin (See Placing the files).
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.
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:
- Gather all player's YAMLs. Place these YAMLs into the
Playersfolder of your MultiworldGG installation. If the folder does not exist, then it must be created manually. The files here should not be compressed. - Modify any local host settings for generation, as desired.
- Run
MultiworldGGGenerate.exe(without.exeon Linux) or clickGeneratein the launcher. The generation output is placed in theoutputfolder (usually named something likeAP_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. - Unzip the
AP_XXXXX.zipfile. It should include a.aptpfile for each player in the room playing Twilight Princess. Each file will be namedAP_XXXXX_P#_<name>.aptp, where#corresponds to that player's slot number and<name>is their slot (player) name. The.aptpis used to create a seed file. This will be explained shortly. - In the next section, use the archive file
AP_XXXXX.zipto 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.
Generating a Seed File
In order to connect to a room you will need the seed file for the world.
You will need the .aptp file created during generation. If your multiworld is hosted on a MultiworldGG webserver you can download the patch from there or ask the host for your file.
- Visit https://ap.tprandomizer.com/
- Choose to randomize cosmetics / audio as you wish.
- Upload
.aptpfile to the "AP File Upload" Section. - Press "Get Download Link" and download the file.
- If you dont yet have the REL loader downloaded, download it at the bottom of the page (Note that it is region specific i.e. NA, PAL, and JP).
If you would like to patch your game instead of using a seed, before downloading, upload your ISO and select Patch ISO. Then you can place the patched ISO wherever your vanilla ISO is.
Placing the files
You should now have a seed and REL Loader file.
- Ensure that GCI Folder is the selected method. You can check this by going to 'Options > Configuration > Gamecube > Device Settings' Slot A should be selected as GCI Folder.
- Note: If you see a folder path under the Slot A drop down that is the folder you should put the file in.
- Now you will want to find where your dolphin is installed. By deafualt this is in
C:\Users\[your username]\AppData\Roaming\Dolphin Emulator - Travse to
Dolphin Emulator\GC\USA\Card Aand place your files there. - If you see a file named
01-GZ2E-gczelda2.gcithat is your vanilla save data. You will need to remove / delete it.
Connecting to a Room
Before connecting make sure you have created and placed your seed file.
Once you do, follow these steps to connect to the room:
- Open Dolphin and use it to open Twilight Princess. (Ensure
Enable Emulated Memory Size Overrideis disabled. See troubleshooting for more details) - Start the REL loader save file and select APTest as the seed you want to use. The game will restart if you press 'R + Z' a console will pop up and it should say "Archipelego Randomizer - v1.3" at the top
- Start a new save file and leave links name as default, it will change when you begin.
- Start
MultiworldGGLauncher.exe(without.exeon Linux) and chooseTwilight Princess Client, which will open the text client. It should automatically connect to Dolphin. - You will see a message saying "Randomizer loaded .... Using Seed ID [Seed name] that is the name of the current seed.
- 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 bemultiworld.gg:<port>, where<port>is the port number. If a game is hosted from theMultiworldGGServer.exe(without.exeon Linux), this will default to38281but may be changed in thehost.yaml. - If the incorrect seed was loaded a message will appear with the name of the seed you are supossed to load.
Troubleshooting
- Ensure that you are running version v0.7 or higher of MultiworldGG, and the latest version of the world.
- If you do not see the client in the launcher, ensure the
Twilight Princess.apworldfile is in the correct folder (thecustom_worldsfolder of your Archipelago installation). - If the client says that seed version and client version do not match, it is recomended regenerate the seed with the current version. Differences in version can cause bugs which may make it unplayable.
- If the client throws an error along the lines of "could not read memory at < some-number >", dolphin has been disconnected. It should automaticly reconnect, so ensure that dolphin is open and running
- Ensure that you do not have any Dolphin cheats or codes enabled. Some cheats or codes can unexpectedly interfere with emulation and make troubleshooting errors difficult.
- If Dolphin is not connecting, ensure that
Enable Emulated Memory Size Overridein Dolphin (underOptions>Configuration>Advanced) is disabled. - If you run with a custom GC boot menu, you'll need to skip it by going to
Options>Configuration>GameCubeand checkingSkip Main Menu. - If Dolphin does load the RELoader save file and has a popup saying something like "Save file cannot be loaded", There may be a normal save file in your dolphin save folder, this will need to be removed in order for the randomizer to load.
- If you have killed Ganon but the world has not been realesed. Ensure that the host settings allows player releases. Check that the Archipelego Randomizer is loaded by bringing up the console window.