Minecraft Loot Table Shuffler

Version: 1.0.0

Shuffled loot tables datapack generator for Minecraft, based on SethBling's loot table randomizer packed with more features and more control.

Randomizable loot tables: block drops, mob drops, loot chests, fishing, treasure and more!

Suitable for UHC, speedruns, survival and more!

Start Randomizing

The following dependencies must be installed on your system:

• Python3

Simply run shuffler.py via Python3 or use the CLI

Compatible Minecraft Versions

Following are the Minecraft versions which have been checked to be compatible with this script. Missing versions may still be compatible. Please submit a pull request if you have tested a missing version.

• Minecraft Java Edition 1.14 - "j1.14"

See Config/Target to find out how to change your target Minecraft version.

Config

This script's configuration is found inside config.json or another file if specified via the CLI.

Target

The "target" property changes what version of Minecraft should be targeted. Feel free to submit a pull request to add support for more targets. Available options:

• "j1.14"

See Compatible Minecraft Versions to determine what versions are supported

Shuffle Steps

The "shuffle_steps" property specifies a list of shuffle steps and which loot tables to be shuffled in each step.

This allows you to:

• Shuffle a custom selection of loot tables instead of all the loot tables.
• Shuffle different loot tables separately. For example, you can shuffle block drops separately from mob drops or chest loot.

Each value in the shuffle_steps list should be a Shuffle Step.

Shuffle Step

Each shuffle step is a list of strings, where each string is a glob of loot table files to be included in that shuffle step.

Globs may begin with ! to exclude files.

The root glob folder is targets/j1.14/loot_tables.

Command-line Interface

Syntax: $PYTHON3 shuffler.py [args]

Replace $PYTHON3 which your Python3 binary, often python or python3 will do.

Arguments:

• -d or --default
  • Uses default values for the following options instead of user input
• -s <seed> or --seed <seed>
  • Sets the seed used for the randomizer
    • Default value: user input or random if -d option is set
• -c <config_file> or --config <config_file>
  • Sets the location of the configuration file
  • Default value: user input or config.json if -d option is set
• -o <output_file> or --output <output_file>
  • Sets the output location of the datapack
  • Default value: user input or randomized_loot.zip if -d option is set

License

See LICENSE file.