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

Guild Wars 2 for Archipelago Setup Guide

Required Software

Installing the Archipelago Mod using BlishHUD

  1. Move BlishHUD to a convenient location. You will need to open it manually.
  2. Move Gw2Archipelago.bhm to the BlishHUD module directory. This will probably be Documents/Guild Wars 2/addons/blishud/modules
  3. Launch Gw2
  4. Open BlishHUD
  5. Click the BlishHUD icon in the upper left hand corner of the Guild Wars 2 screen
  6. Follow the instructions in "Manage API Keys" to register an API key with BlishHUD
  7. Under Manage Modules, make sure that Archipelago is enabled

Configuring your YAML File

What is a YAML and why do I need one?

A YAML file is the way that you provide your player options to Archipelago. See the basic multiworld setup guide here on the Archipelago website to learn more.

Where do I get a YAML?

Until this world is released you will have to edit your YAML manually. You can modify the provided template, but it is recommended that you generate one using the provided gw2YamlGenerator.exe to create one with triggers for using your existing characters. These triggers will set the profession and race to match the character and update the max_quests value to be the number of quests that character has remaining in the storyline. You may modify the generated yaml how you like as well.

Generating a multi-world

  1. Double click the .apworld file to install it into your Archipelago/custom_worlds/ directory.
    • If you have an old version installed in Archipelago/lib/worlds/ you will need to delete that.
  2. Follow the standard instructions for generating a game locally

Joining an Archipelago Game in Guild Wars 2

  1. Start the game and open the BlishHUD window.
  2. Under "Manage Modules", click "Archipelago"
  3. Enable all requested API Permissions
  4. Enter the Archipelago Server URL including the port number
  5. Enter your slot name
  6. If the "Enable Module" button is not disabled, click it.
  7. Click on the archipelago icon at the top of the screen to open the Archipelago window.
  8. Click "Connect"
  9. If you don't know what character you will be playing it should populate on the modules screen now.
    • The profession and race will also be shown. If you are making a new character, make sure they match these
  10. Log into your chosen character
    • If you created a new character for this, change the character name in the manage modules at this time
  11. Click "Generate Locations." This can take several minutes, and when it's done you will see a selection of achievement locations at the bottom of the archipelago window
  12. In your Hero panel, clear an equipment template and a build template and activate the empty templates
  13. Equip gear, skills, and traits that the Archipelago module says you are allowed to use.
    • If you created a new character, feel free to continue using the starting weapon until you finish the tutorial zone

Hints and other commands

While playing in a multiworld, you can interact with the server using various commands listed in the commands guide. You can use the Archipelago Text Client to do this, which is included in the latest release of the Archipelago software.

Notes about Gw2 implementation