This is an item randomizer for Death's Door.

For a room/transition randomizer, see Spr3AD's DD_Randomizer.

How to use

Automatic installation

The easiest way to install this mod is by using the Raven mod installer. Once you download it, launch it and then enter these commands:

setup
install modlist randomizer recentitemsdisplay

(ModList and RecentItemsDisplay are not required to use the randomizer, but are recommended.)

Manual installation

To use this mod, you will need:

• BepInEx 5.4.22 or later 5.x versions
• AlternativeGameModes
• ItemChanger
• RandomizerCore
• RandomizerCore.Json
• MultiWorldLib
• MagicUI

After installing BepInEx, install this mod and the above-listed dependencies onto the BepInEx plugins directory. Then launch the game, select an empty save slot, and press left or right while the "Start" option is selected until it reads "Start Rando". Select that to start a randomized game.

Recommended additions

There are some additional pieces of software to enhance your randomizer experience:

• RecentItemsDisplay - a mod that shows a list of recently-acquired items on a corner of the screen.
• DD_rando_tracker - a standalone program that reads the savedata for files that use ItemChanger (including plando and randomizer files) and displays a summary of the current inventory and recently-acquired items.

Randomizable pools

• Spells and their upgrades
• Weapons
• Giant Souls
• Vitality and Magic Shrines
• Shiny Things
• Life Seeds
• Soul Orbs
• Levers
• Doors
• Green, Yellow and Pink Keys
• Crow Souls

Skips

This randomizer includes optional logic for the following skip types:

• Geometry Exploits: tricks that rely on rolling or landing onto walls, gates or other surfaces that aren't flat ground.
• Offscreen Targeting: tricks that involve hitting enemies or switches that aren't visible on screen from where you take the shot.
• Gate Rolls: skips that require rolling into a room transition to bypass locked gates.
• Early Night: the skip that uses a bomb fired from a railing to hit the belltower's bell, bypassing the need for the Rusty Belltower Key.
• Roll Buffers: tricks that involve rolling in mid-air out of a heavy attack.

For more details on which specific tricks are included in each of these categories, see the corresponding .addon.txt files in your randomizer installation.

Custom logic packs

In addition to the skip types mentioned above, the randomizer also can load custom logic packs that modify existing waypoint, transition or location logic. To install one, write your logic in a file with the extension .addon.txt and place it in the same directory as the Randomizer.dll file in your BepInEx installation. The custom logic pack will appear under the Skips section of the settings, with the name of the corresponding file minus the .addon.txt extension.

Each logic pack that is applied fully replaces the logic for the locations/transitions/waypoints that it specifies; if you only want to add to existing logic, the special keyword ORIG can be used to include the original logic in your custom logic expression.

For examples of how to write a logic pack, see the .addon.txt files included with the randomizer.

Configuration

This randomizer offers the following configuration settings:

• Seed: the main seed used for all randomization. May be any string; if left blank, a random seed is generated for each new file.
• Light State: whether to start the game in daytime, nighttime, or to choose randomly between the two. (defaults to Day)
• Weapon: which weapon to start the game with (defaults to Sword). Can also be randomized.
• Pools: whether to add each of the above randomizable pools to the overall pool. For pools that are not selected, all their locations are left as vanilla and their items will not be found elsewhere.
• Skips: whether to add each of the above skip types to the logic.
• Extra Life Seeds: adds additional life seeds to the item pool, to make it easier to plant pots for healing or to unlock the Green Ancient Tablet of Knowledge check. Use of this setting will create items bearing multiple life seeds if enough are added.
• Extra Vitality Shards: adds additional vitality shards to the pool, making it easier to get health upgrades and also allowing maximum health to go over the vanilla limit of 6.
• Extra Magic Shards: adds additional magic shards to the pool, making it easier to get upgrades and also allowing magic points to go over the vanilla limit of 6.
• Include Rusty Belltower Key: allows the Rusty Belltower Key location to be removed from the pool if Tablets are randomized.
• Green Tablet Door Cost: changes the number of planted pots required to open the tablet door in Estate to any number between 0 and 50.

To edit these settings, we recommend use of the BepInEx configuration manager mod, which provides an in-game GUI for mod settings (it also works with a few other Death's Door mods). Alternatively, you may edit the config/deathsdoor.randomizer.cfg file in your BepInEx installation folder directly; launching the game with the randomizer installed will generate this file if it doesn't already exist.

Multiworld

This randomizer supports multiworld games, where items are shuffled between several different players' worlds. It uses the same protocol as Hollow Knight's multiworld, which enables it to work with the regular multiworld server for that game as well as to play mixed multiworld randomizers with any other compatible game (Haiku and Hollow Knight as of this writing).

The buttons to control the connection state appear in the configuration manager UI mentioned above; that mod is therefore required to play multiworld with this game.

To play a multiworld game:

1. Set the server address, your nickname and a room name in the configuration as appropriate.
2. Enable randomization and select your settings as with a single-world game.
3. Press the Ready button in the config panel; if successful, a message will appear on screen indicating which players are in the same room.
4. Once this messsage appears, one player should press "Start MW" to generate the multiworld seed for everyone. (this can be done by any of the players in the room)
5. When the multiworld is successfully generated, you will see a message indicating you are ready to join, along with a hash that you can compare with other players to verify they have the same seed.
6. At this point, open a new save file to join you to the multiworld.

If you must leave the game early, the "Eject" button will return all items in your world that belong to other players, to their respective owners.

If you need to change your server, nickname or room name during the setup, press Disconnect, adjust your settings, then press Ready again.

Hash

In multiplayer settings, like races or co-op games, it may be necessary to verify that all players are on identical seeds. For this purpose, the randomizer calculates a hash based on all its item placements, which can be consulted at the phone booth in Hall of Doors, near the start of the game. It appears formatted as a phone number of the form (N) NNN NNN NNN.

Logic

The base logic for this randomizer is in the Randomizer/Logic directory, in three files:

• locations.txt - contains logic for all randomizable locations, plus flower pots.
• waypoints.txt - contains logic for various intermediate points that are not themselves randomizable locations.
• transitions.txt - contains logic for all scene transitions.

Logic expressions refer to items and locations using the same names they're given in ItemChanger, but with spaces replaced by underscores because of syntax constraints.

The logic is written under the assumption that the player can always return to the starting point of the game - the main lobby of Hall of Doors - at any time; ItemChanger includes the necessary patches to ensure that this remains the case when the randomizer is active.

The base logic approximately follows the Restricted ruleset used for speedrunning; movement or tricks that aren't allowed by that ruleset should usually be in a custom logic pack.

Waypoints

Most waypoints in the waypoints.txt file represent points of the game's map that are logic-equivalent to several other locations - that is, it's possible to walk between those locations without any equipment other than the starting set. Where possible, the logic is written so that any constraint on passing from one place to another is captured in a single place; so the majority of these are found in the waypoints and transitions files, and most locations just reference some existing waypoint for their logic, except for constraints which apply exclusively to that location.

Some waypoints - those with the keyword stateless before their names - have a different purpose: they represent some action/goal that has a permanent effect on the game, like rescuing Grunt from Mushroom Dungeon or lighting the lanterns in Old Watchtowers, which is not a randomizable location but needs to be tracked for logic purposes.

Acknowledgments

Thanks to Homothety for the RandomizerCore library, which provides the randomization algorithm for this randomizer (the same one used for the Hollow Knight randomizer).

Thanks to MrKoiCarp and TheDancingGrad for naming many of the items and locations in the game.

Thanks to all the people in the DD discord who tried this mod's precursor, Plando, and helped find bugs, SpR3AD in particular.