Path of Exile Archipelago Setup Guide

1) Prerequisites

Path of Exile installed and playable.
Python 3.12 installed. (Python 3.13 will not work)
Archipelago (latest release).
The Path of Exile .apworld file from the Path of Exile APWorld release page.
- github.com/stubobis1/Archipelago/releases

2) Download & Install Archipelago

Download the latest MultiworldGG release
Install Python if needed from here

3) Add the Path of Exile `.apworld` (not needed with MWGG)

Download the .apworld file from Github:
Place the .apworld file into the MultiworldGG/custom_worlds/ folder.

4) Generate / Join a Multiworld

Launch MultiworldGGLauncher.exe from your Archipelago folder.
Generate Template Options
Modify MultiworldGG/Players/Templates/Path of Exile.yaml to change options to your liking.
Setup a Multiworld session:

If self-hosting / playing single player:
- place the Path of Exile.yaml in your Players directory
- run MultiworldGGLauncher.exe
- Select Generate Game.
- Select Host, and select the generated file from /output
- By default the server will run on port 38281
If playing with others:
- Send your yaml to whomever is generating and hosting
- Get your slot name from the host, and the server address (IP or domain) and port.

5) Setup Poptracker (Optional but Highly Recommended)

Download Poptracker from: github.com/black-sliver/PopTracker/releases
Extract / Setup Poptracker to a folder of your choice.
Download the PoE Archipelago Poptracker pack from: github.com/stubobis1/PathOfExilePoptracker/releases
Place the zip file into the poptracker/packs directory.
Launch PopTracker.exe.
Click on the AP button at the top.
Enter your slot name and server address from step 4. (Example: 127.0.0.1:38281, slot Player1, no password)
If the AP button is green you are connected.

6) Start the Client

In MultiworldGGLauncher.exe run Path of Exile from the client list.
Enter the slot name and server address in the top bar
- something like Player1:@127.0.0.1:38281
  - (note the : after the slot name is where you would put the password, if one was set by the host).
Click Connect.
(optional) Run /received to see which class you have received. (not needed if you setup poptracker)
Run /poe_auth in the client console to authenticate your PoE account.
Set the character you will be playing with /char YourCharacterName.
Set your client.txt path by running /client "C:\PathOfExile\logs\Client.txt" (adjust path as needed). Note the Quotation marks.
Set your item filter path by running /filter <filterName>.filter
- this should be a local filter, and exist at something like C:\Users\<USERNAME>\Documents\My Games\Path of Exile
(Optional) Enable or Disable DeathLink with /deathlink if you want to share deaths with other players.
If you haven't already, Launch Path of Exile and LOGIN.
Run /start in the client.
Start playing Path of Exile!
- Enter a zone to trigger an initial check.
- Pick up items to unlock things.
- Change zones to send checks for newly found items/conditions.

7) In‑Game Chat Commands (Whisper Yourself)

Send whispers to your own character using @YourCharacterName followed by a command. Example:

@YourCharacterName !gems

Commands:

!ap char                  - Set your character
!deathlink                - Toggle DeathLink
!goal                     - View your current goal
!passive or !p            - List usable passive points
!usable skill gems        - List usable skill gems (by level)
!usable support gems      - List usable support gems
!usable utility gems      - List usable utility gems
!usable gems              - List all usable gems
!main gems                - Show main skill gems received
!support gems             - Show support gems received
!utility gems             - Show utility gems received
!all gems or !gems        - Show all gems received
!gear                     - Show usable gear
!weapons                  - Show usable weapons
!armor                    - Show usable armor
!links                    - Show maximum link allowance
!flasks                   - Show flask unlocks
!ascendancy               - Show unlocked ascendancies
!help                     - Show help message

Note: Commands must be whispered to yourself (not global chat) using @YourCharacterName.

8) Tips & Troubleshooting

If you get problems when you are trying to write the filter, it could be Windows OneDrive interfering. Try disabling OneDrive.
Keep the Archipelago client running while you play PoE.
If you pick up an item and no check is sent, enter a new zone to trigger a check.
Make sure your PoE logs are being read (client should detect zone changes and chat whispers).
If your normal item filter isn't working, load it with /filter in the client console.
OAuth/API: Ensure your PoE account is properly authenticated if the client needs character data from the API.
DeathLink: When enabled, your deaths (and others’) can be shared as events across players.
F11 will restart the client if you run into issues.
F12 will force the client to do a check.
- The API still only updates when changing zones, but this is helpful if something gets messed up. (AP can't read the client.txt file)

9) Quick Start Summary

Install Python (3.12) and MultiworldGG.
Drop the PoE .apworld into Archipelago/custom_worlds/.
Use the Launcher to generate or connect to a multiworld.
Start playing PoE with the client open.
Whisper yourself for status/info commands and change zones to send checks.

Happy mapping, and good luck with your drops!