Randomization Generator

The default randomizer experience in Bloodstained can get a bit samey, as items in chests and walls will only ever be shuffled amongst themselves, so you will always only find the same small subset of items every time.

This program generates a new .pak file every time it is run. Running the game with this file will give you enhanced randomization of items between findables (chests/walls), quest rewards and craftable items. More details can be found below.

The source code for the generator can be found on Github. The build provided on NexusMods comes packaged with all files needed for it to be run as-is. The file size is fairly large as it is packaged with the .net runtime, in order to be run from any windows computer without having to install anything else.

The generator should be pretty easy to extend with new functionality, so feel free to give suggestions for stuff you'd like to add or configure, and I'll see about adding more when I find the time.

Run the program by double-clicking on the .exe. This will generate an item randomization pak file with default settings in the same folder that the program was run from.

Alternatively, run the program from the command prompt. This allows you to change some behavior through command line arguments. --help will show all arguments available. The most relevant ones are described below.

General options

-s, --seed

Provide a text string that acts as a seed. This enables you to recreate the same mod file later. I recommend naming your save game the same as the seed, so you can go back to it easily. The generated file will be named the same as the seed.

-i, --input

Use this to specify the path to your own game files that are to be randomized. If you don't like the game play tweaks that are packaged into the generator, you can provide a folder path to your own files and have them be randomized for you. All data is collected directly from the provided files, so if the bundled files become out of date with a future game update, it should still work if you provide it with updated files.

Optional game modifications

-t, --type-randomize

Only has an effect when playing the randomizer with the "Retain Type" item setting.

This is for those who like it when items are fully random, but don't want to farm every enemy for progression shards.

• []Key items are more likely to be in chests guarded by bosses.

  []Key items in this mode will never be in walls.

  []Blue chests and consumables are left as-is in order to avoid a vanilla game bug that replaces important items with these chest types, causing those items to be unavailable in the game.

[]All randomized items will keep their original type, so there will always be the same number of each item type (weapon, scarf, consumable etc.) available from chests, quests and crafting as in vanilla.

[]There are no duplicate items, except if there were multiple in the vanilla game as well. In this case, the original number is retained where applicable (e.g. there are exactly 2 Plunderer's rings available). If an items is added to craftables, that counts as an infinite number being available.

[]Unique items that are not found in chests or by quests will be assigned a random crafting slot of a same-type item that is now findable elsewhere.

[]Key items are left untouched (this also includes Aegis Plate). This allows the game's softlock-prevention logic to keep working, and the base game's progression is not impacted.

[]Consumables (non-food) can be switched with any other consumable, and each one can be found in any quantity

[*]Food items that are found or