Grim Dawn AP Installation Instructions (Windows)

Install Grim Dawn from steam.
In the Grim Dawn install directory, rename the file "lua51.dll" to "real_lua51.dll"
Download the lua51.dll file from Heinermann and place it in the install directory. https://github.com/heinermann/GrimDawnLuaUnlocker/releases/download/1.0/lua51.dll
Download the lua51.7z under "lua-apclientpp v0.4.9" from Black Sliver's github https://github.com/black-sliver/lua-apclientpp/releases/tag/v0.4.9 Make sure these files actually download, sometimes they get flagged as dangerous by your browser.
Extract "lua51\lua51-clang32-dynamic" from the zip. Place only the "lua-apclientpp.dll" file in the Grim Dawn install directory.
Download my mod from Nexus Mods https://www.nexusmods.com/grimdawn/mods/167/ and make sure you manually download it, don't use Vortex or another mod manager.
Create a folder named "mods" in the Grim Dawn install directory if it doesn't already exist. Place the mod archipelago.zip inside and "extract here" with 7zip/winrar. Make sure the folder named "archipelago" is directly in mods and not nested in another folder within mods.
Download arzedit from gitlab: https://gitlab.com/QuasiMod/arzedit/uploads/b48b7ed4f74717d2a8cf6b67b4f9d842/arzedit.exe and place it in your Grim Dawn install directory.
Download the grim_dawn.apworld https://github.com/routhken/Archipelago/releases and place it in your Archipelago apworld directory "...\Archipelago\custom_worlds" make sure there is no duplicate apworld in lib/worlds.
Open the archipelago launcher, click Generate Template Options to create a template yaml for you to edit settings. Put the yaml in "...\Archipelago\Players" and click Generate.
If you live in the US skip to step 12, otherwise go Control Panel -> Change date, time or number formats -> Format drop down menu -> English (United States). You can set it back once patching is done.
In the archipelago launcher, open the Grim Dawn Client, and connect to your slot through the client. The first time you try to connect it will ask you to locate your Grim Dawn install directory, probably something like "C:\Steam\steamapps\common\Grim Dawn". If everything is in the correct place, the client will say installation found, patching game please wait 30 seconds before loading a character. If you have a lot of apworlds in your custom_worlds folder, the client might be unresponsive for a while before it patches the game.
Launch the game using the 32-bit launcher, either by using the 32-bit launcher in Steam, or launching from the Grim Dawn executable in the main Grim Dawn install directory (not in the x64 folder). At the main menu, select the Custom Game tab -> Custom Game bubble -> "patchedArchipelago ~ world001.map"
The game should connect to the server as soon as you load into a world. If not, talk to Jarvis or Bourbon.
The patch will remember the last connect credentials given through the client, so if you are connecting to the same slot and port again, then you don't need to run the client again.
OPTIONAL to use the tracker, you will first need to download poptracker from https://github.com/black-sliver/PopTracker/releases and simply extract it somewhere. Get the grim dawn pack from https://github.com/routhken/Grim_Dawn_tracker/releases don't extract it, just put the zip file in poptracker/packs folder. Open poptracker and open the grim dawn pack

Linux Instructions

Instructions provided by Altener:

To compile a set of instructions for Enemy Rando and Skill rando in linux (based on Steam install and tested only in Steam deck) · Have protontricks installed · Install the Archipelago Launcher through protontricks into the Grim Dawn prefix · Follow the normal instructions for this implementation applied to the version we just installed as per the windows instructions above (in principle, archipelago will have installed under steam/steamapps/compatdata/219990/pfx/drive_C/ProgramData/, fairly sure appids dont change) · Make the connect.txt in the Grim Dawn install folder with the format: host = archipelago.gg:yourroomcode slot = YourSlotName password = ssp = false · Add and swap to US layout in your linux keyboard layouts (this will depend on distro, not sure if it affects linux but just in case) · Start archipelago, grim dawn client, connect, and a window asking for the Grim Dawn install folder will pop up: normally steam is installed under .local, a hidden folder, so the easiest way to point the location is to copy your system's one and convert it into the Windows one: change the /, and start with "Leter:" (ususlly wine/proton makes your system Z, while C is the prefix)

If you put the right location then it should freeze for a bit before saying its connected and to wait 30 seconds before starting a new file

Now if everything is correct, and this is a portable solution, you should find a patchedArchipelago mod in Custom Games and your mods folder (given ive done this in Steam Deck, if anyone gets it working like this elsewhere would love a confirmation :P)

FAQ / Troubleshooting

Q. Patched mod freezes after a second of loading, but non-patched mod loads fine. A. Patcher needs en-US region due to a bug in the extractor tool, refer to step 11.

Q. While generating the world, an error says invalid yaml and no apworld installed. A. Check if you have multiple copies of the grim dawn apworld (possibly one in lib/worlds and one in custom_worlds) and delete the extra copies.

Q. Does this work with multiplayer? A. Yes. All players must be using the same patched mod.

Q. The current Grim Dawn install directory doesn't point to the correct folder, how do I fix it? A. Go to your archipelago install directory and open your host.yaml there should be a line that is "grimDawnInstallPath" you can fix it to be the correct folder.

Q. When I hint for an item, the client tells me it doesn't exist in the multiworld A. You likely have progressive progression enabled, which converts major progression items to a generic item instead. Hint for Progressive Main Campaign, Progressive Ashes of Malmouth, or Progressive Forgotten Gods.