LootPainter is a lightweight Python tool designed to create, modify, and inject loot tables into target container blocks within Minecraft schematic files (.schem, .schematic, .nbt), primarily for use in WorldPainter. It allows users to create their own custom loot tables and inject those loot tables into schematics, as well as creates an appropriate datapack for the map folder.

• Visual Interface: Create and modify simple loot pools without writing JSON.
• Preset System: Includes preset tables for generic Dungeons, Shipwrecks, Villages, and more.
• Items: Contains an incomplete list of common loot items, but you can type in any item ID manually.
• NBT Editor: Add enchantments, names, colors, and potion effects to items.
• Export: Generates a ready-to-use datapack folder structure.

• Batch Processing: Select a folder of .schematic .schem or .nbt files.
• Targeting: Automatically finds containers (Chests, Barrels, Shulkers, etc.) inside the schematic.
• Injection: Replaces the target container’s contents with your custom LootTable path string (e.g., custom:chests/dungeon_tier_1).

Download the latest executable from the Releases tab. No Python installation required.

• Select a preset or import an existing .json loot table.
• From there you can type in an item ID or select one from the drop-down.
• “W” is your weight or probability, while “Min” and “Max” refer to minimum and maximum stack size.
• To edit an item’s nbt data, you can select it from the list, click “edit nbt”, and from there add what tags you like.
• “Simulate Chest” opens a new window that simulates a chest so you can get a good idea for how the weight and stacks work.
• Click “generate datapack” and keep this datapack to be placed in your map folder after exporting in WorldPainter. The “Filename” here will be needed in the “Injector” tab under “Loot Table String”

• Select the folder of schematics you’d like to inject
• Create an output folder and select it, this will place new edited copies of your schematics and keep the originals untouched for backups
• Target containers require the loot table string, which is “custom.[container]/[filename]”
• The loot table string points to the datapack created on the first tab

• Duplicate IDs: The generator currently does not prevent you from adding the same item ID twice. If you do, the last one entered will overwrite the previous ones in the final JSON.
• Generate Chest: Sometimes item icons don’t get displayed, and show as a yellow “!”. Hovering over the items shows its details however.
• Import .json: Currently this is a “lossy” import as LootPainter doesn’t mess with certain nbt tags that might appear in other loot tables. If you import a complex loot table containing conditions, predicates, or advanced functions, those extra features will be stripped out upon import.

• Supported Containers: Currently supports Chests, Barrels, Shulkers, Dispensers, Droppers, and Hoppers. Modded containers are not supported.

• The “Coordinator” tab is currently disabled in this beta build as it undergoes a rewrite.

1. Clone the repository.
2. Install dependencies:

   pip install nbtlib