Archipelago implementation for Dark Souls Remastered

This implementation is still considered unstable/in alpha. Expect bugs and issues.

How does it work? See the Game Page.

Setting up? See the Setup Guide.

Table of Contents

Compatibility
Known issues
Changelog
Roadmap
Contributors

Compatibility

• This version has been tested with Dark Souls: Remastered, Steam version (App ver. 1.03.1 & Regulation ver. 1.04) on Windows 11, with Archipelago Launcher version 0.6.6. Using incorrect versions of Dark Souls: Remastered may result in a crash upon connecting.
• Linux has preliminary support via Proton with v0.1.0. You should be able to add PROTON_REMOTE_DEBUG_CMD="/full/path/to/DSAP.client.exe" %command% to your steam Launch Options (tested with Proton Hotfix branch on 2026-03-27) to run both DSAP and DS:R in the same environment. It has not been thoroughly tested, however, so 1) consider it unstable, 2) let us know how it plays/runs (whether well or badly), and 3) Please report any issues.

Known issues

• Master Key chosen from character creation (whether as a gift or thief starting item) is not considered to be in-logic. Randomized Character creation/gifts replaces the master key from the thief's starting item and the starting gifts respectively.
• Placing Lord Souls at Firelink Altar does not open the door - This seems to be due to not having received some number of the Lord Souls or Lordvessel. We could use information for this - If you see this, please run the /lordvessel command, which will both provide diagnostic information & the missing items. Please provide a screenshot of the output with any additional context you can provide about the missing items to the dark-souls-1 channel in the AP discord (such as, if you know it, did the items come in while you were offline, was it with other items, etc).
• v0.0.22.0 and v0.0.21.0: Hard lock / infinite loop of receiving Rubbish if player has been /send'd a valid AP item that the client doesn't know about (Estus flask, Event items, etc). Resolved in v0.1.0 with an error message instead.
• v0.0.21.0: Dispelling of Golden fogwalls inconcorrectly considered in logic once player had Lordvessel, even if it cannot be placed at Firelink Altar.
• v0.0.21.0: Boss fog walls in the DLC do not correctly "Lock" with boss fog wall locks on.
• v0.0.21.0 and lower: Once a save receives an item from the server, it cannot be re-received to a new save or different player. Fixed with v0.0.22.0 (Multi-save support!).
• v0.0.21.0 and lower: Prism stone received at locations in DSR player's game which are replaced with other multiworld players' items. Updated to no longer occur with v0.0.22.0 (AP items as DSR items).
• v0.0.21.0 and lower: Items will only ever be sent to one save. This is fixed in v0.0.22.0+.
• v0.0.20.0 and lower: Goal may not send upon completion. It is recommended to upgrade the DSAP client to v0.0.21.0, connect, and run the /goalcheck command. v0.0.21.0 of the client is fully compatible with v0.0.20.0-generated apworlds.
• v0.0.19.1 and lower: If you receive an item while on the main menu, it will be lost, requiring admin intervention. For safety, you should only run the client once loaded into game.
  • Furthermore, you should close the client before quitting to menu or quitting the game.
• v0.0.19.1 and lower: Looting the "key item chest" in Firelink Shrine behind Frampt will break logic for DSR. In a vanilla playthrough, this chest is usually empty/already open, and only has items if you somehow don't have a key item you "should have", depending on where you are in the game. In a randomizer environment, those normal circumstances don't apply! As an example: if you loot this chest after looting the vanilla "Basement Key" location, it will have a Basement Key - but in AP randomizer that key can even be in another game! In v0.0.20+ it gives rubbish instead.
• v0.0.19.1 and lower: On reconnect, player can receive duplicate items. The items are specifically those from "door"-type location checks in their own world.
• v0.0.19.1 and lower: Some enemy drops (invaders, Havel, etc) are erroneously replaced with prism stones, but do not grant an AP item. The player should get the standard enemy drop in these locations instead.
• v0.0.19.1 and lower: Not receiving deathlinks - a potential workaround is to close DSAP client, completely exit game to desktop, relaunch DSR + DSAP, load in with your character, and then reconnect with DSAP client. This occurs when the game happens to load your player character information near enough to a 65k boundary (limit of a 2^16 "short" int), which could in some cases happen each time you load in. Anecdotally, restarting the game from desktop makes it most likely to allocate your memory in a better spot. This is fixed in v0.0.20+.
• v0.0.19.1 prerelease: While unhollowed/human, the player is detected as "not in game". This can result in no items or deathlinks being sent to other players.
• v0.0.18.3: DSR game and DSAP.client.exe both crash upon connect - you must load into the game and be able to move your character around before connecting with the client.
• v0.0.18.2 and lower: Items do not get replaced. Upgrade your client version.

Changelog

Version 0.1.0

• Version update -> 0.1.0. Both Apworld and Client have updated. This Client version will NOT be compatible with earlier versions of the apworld.
• Feature: Linux support - huge thanks to discord user @theabysmalkraken. From basic tests appears to work, but not tested thoroughly - should be considered somewhat more unstable.
• Feature: Starting loadout, gifts, and spells randomization - including yaml options for controlling them. See the options for more details.
• Feature: Server-delivered items - Items will now always be delivered by the server. This may cause a slightly delayed item popup.
• Feature: Synced "looted" items between saves - Now upon starting a new save on an in-progress slot, you'll get all the items that slot ever looted. For now, "empty" items at those locations will still exist in the world. Possible due to Server-delivered items.
• Feature: Synced "warp points" between saves/co-op on same slot.
• Feature: Custom Controls window for client settings. Settings do not yet persist between sessions, but are a lot easier to change. Deathlink can be more easily toggled from here as well.
• Feature - Item popup options - In the "Custom Controls" window, player can now change the categories of items for which they will get popups. Granular - can choose different settings for items that come from your own game & items sent to & from others' games.
• Feature: Yaml option (QoL) - Can Warp Without Lordvessel - on by default.
• Feature: Yaml option - Remove weapon stat requirements - off by default.
• Feature: Yaml option - Remove spell stat requirements - off by default.
• Feature: Yaml option - Remove miracle covenant requirements - for those miracles that have them - on by default.
• Feature: Add /lordvessel command - For players to use if placing all 4 souls at the Firelink Altar doesn't open the Kiln door. Intended to catch the case where the client didn't receive the items correctly - both getting diagnostics & making player whole (gives them the missing "received" items). Please provide the output to us in the dark-souls-1 discord channel if you have to use this command to help us debug this issue!
• QoL: Sanitization on host and slot, remove "/connect " prefix if it's in host string, and trim spaces from both strings.
• Fix: Logic - Basement Door access no longer requires Taurus Demon defeat
• Fix: Unreceivable items causing infinite rubbish loop. Now they will just display an error message instead.
• Fix: Improved messaging for case where player connects with save from a previous instance of a multiworld (when a 2nd room is created from 1 seed / AP_####.zip).
• Fix: DLC Boss Fog Walls added to All DLC regions location group.
• Code quality: massive refactoring of code which updates DSR item lots, messages, and params
• Documentation: Created Setup Guide and Game Page (linked at top of this file).

Version 0.0.22.1 (Client Hotfix)

• Client Version update -> 0.0.22.1. Fully compatible with 0.0.22.0 worlds, but not compatible with apworlds at or below v0.0.21.
• Apworld is unchanged.
• Fix: Crashes, incorrect items when too many non-local items are located within DSR, due to incorrectly built item params.

Version 0.0.22.0

• Version update -> 0.0.22.0. Both Apworld and Client have updated. This Client version will NOT be compatible with earlier versions of the apworld.
• Feature: The Item Pool is now generated based on the vanilla item pool, with slight modifications. You can actually get rings, and the Zweihander now! You can expect to get less Soul items / less souls from the average soul item compared to v0.0.21 and lower.
• Feature: See received items! Item popups will now appear for items received by other players. You can disable showing the popup for non-progression or all items via the /ripshow text command in DSAP (see /help for details)
• Feature: See sent items! AP Items as DSR Items: Items for other players, and your own Fog Wall Keys now show what they are in the standard in-game item popup, instead of showing up as prism stones. And no more of those stones weighing down your bag! They do still look like prism stones, though.
• Feature/Fix: Multi-save support! Now you (or somebody else!) can start a new character on your slot without risk of losing items! Note: Most local items will still have to be re-acquired in the new save. Same-slot seamless co-op play may also be possible (not thoroughly tested) - see the Co-op Toleration section below.
• Feature: "Excluded Location Behavior" yaml option added, t