How it works

• On first interaction, a black shulker is filled via its snapshot inventory, then marked as "filled" using the PDC key hg_filled.
• The command scans loaded chunks and applies the same logic to each black shulker.
• Only loaded blocks are affected; load target areas before running a global restock.

Config reference

loot-settings

• min-items, max-items — number of items per chest (inclusive range)
• avoid-duplicates — prevent the same loot ID from appearing twice in one chest
• default-amount-min, default-amount-max — fallback stack sizes

loots — define entries using one of:

• <id>: <weight>
• <id>: "min-max" (amount range, implicit weight = 1.0)
• 
  
  Code (YAML):

  
  <id>:
    weight : <double>
    amount : <int | "min-max" >
  

amounts — optional overrides (take precedence over loots)
chances — optional per-entry chance (%) applied after the weighted pick
IDs and NBT

• Accepts Bukkit names (e.g., stone) and namespaced IDs (e.g., minecraft:stone).
• Supports NBT, e.g. minecraft:potion{Potion:"minecraft:healing"} or minecraft:diamond_sword{Unbreakable:1b}.

Troubleshooting

• Nothing happens on open — ensure the box is black; other colors are ignored.
• Boxes not affected by the command — load the area (the plugin processes loaded chunks only).
• Item not recognized — verify the ID/namespace and NBT syntax.

Roadmap

• Multiple crate types (vanilla + modded), each with its own loot table.
• Root command /crates (subcommands: restock, preview, reload).
• Preview GUI and basic tests.