DeluxePouches | Animated Rewards 2.2.0

📚 The Wiki Is Live

DeluxePouches now has a proper wiki: greenarrowlol.github.io/DeluxePouches-2.0. Nineteen pages covering installation, pouches, rewards, animations, effects, holograms, the menu, custom items, every config file, permissions, commands, placeholders, the developer API, an FAQ, and support.

It was written against the actual source, so a few things are documented properly for the first time. Worth a skim even if you've been using the plugin a while:

• chance on a reward is a weight, not a percentage. Values don't have to add up to 100, and a reward with chance: 100 next to others is not guaranteed
• reward-amount draws that many times, and each draw is independent, so the same reward can come up twice in one opening
• Pouch cooldown is shown in the menu but is not enforced
• The pouch menu shows every pouch's reward list and chances to anyone who can open it. Keep deluxepouches.gui.open to staff if you'd rather players not read the odds
• Several keys in the shipped configs aren't read by the plugin. The Configuration page lists them, so you're not left tuning a setting that does nothing

🐛 WorldGuard Region Blacklist Works Now

The WorldGuard region blacklist could never work in earlier versions. Two things were wrong at once: the plugin read the settings from settings.worldguard, but config.yml shipped them at the top level as worldguard, so the toggle was always off and the region list always empty. On top of that, entries have to be written world;region and the shipped examples were bare region names, which are skipped. Both are fixed now.

If you never used the region blacklist, there's nothing to do. If you had filled in the old top-level worldguard block, see the upgrade note below.

📊 ArrowStats Metrics

The plugin now reports anonymous usage data to ArrowStats alongside bStats: server and player counts, versions, and a few counters like how many pouches are configured and which integrations are present. No player names, no config contents.

Opt out for every ArrowStats plugin on the server at once by setting enabled: false in plugins/ArrowStats/config.yml.

📝 Upgrade Notes

Drop the new jar in and restart. Your pouches.yml and lang.yml are untouched. config.yml updates itself and keeps your values.

One thing to redo by hand: if you had filled in the old top-level worldguard block, it's removed on startup (nothing ever read it). Set your regions again under settings.worldguard in world;region form:

settings:
  worldguard:
    enabled: true
    blacklisted-regions:
      - "world;spawn"
      - "world;pvp"

📦 Install

Replace the old jar in plugins/ with DeluxePouches-2.2.0.jar and restart. Requirements are unchanged: Minecraft 1.21 or newer on Paper, Java 21.

⚠ Version Requirements Changed

This release requires Minecraft 1.21 or newer and Java 21. If you're on 1.20 or below, stay on 2.0.0.

🐛 Fixes

• Right-clicking a pouch now opens it properly again
• Nexo pouches work end-to-end (ItemsAdder uses the same path but hasn't been tested recently, feedback welcome)
• Custom-textured heads render correctly, and a bad texture now reports the problem in console instead of silently showing a blank head
• Skull pouches keep their name and lore
• Faster startup
• Shift-clicking a stack of pouches now uses the whole stack, not just one
• All nine effect types now work (PARTICLE_SPIRAL, PARTICLE_VORTEX, SOUND_WAVE, RAINBOW_BURST, GUARDIAN_BEAM, and ENDER_SIGNAL previously did nothing)
• The example enchanted book, sword, and elytra rewards work again on modern versions
• /dp give <player> <pouch> <amount> works again
• Particles and enchantments render cleanly on 1.21

✨ Improvements

• Hex colors and gradients now work everywhere text is displayed, holograms, titles, action bars, and broadcasts
• /dp give now confirms what it gave you, rejects silly amounts, and tab-completes players, pouch IDs, and amounts
• Command aliases: /dp and /pouches
• Sound names in your config keep working exactly as before
• Smaller jar (1.1 MB, down from 3.6 MB)

📝 Upgrade Notes

Drop the new jar in and restart. Your config.yml, lang.yml, and pouches.yml are kept as they are.

Three things worth checking if you customized the defaults:

• If you copied the old skull_pouch or pumpkin_skull example, its skull-texture value needs replacing, copy a fresh one from minecraft-heads.com, or take the updated ones from the new pouches.yml
• Any reward command using the old {Enchantments:[...]} or {StoredEnchantments:[...]} item NBT needs converting to data components, e.g. minecraft:enchanted_book[stored_enchantments={"minecraft:fortune":2}]. The shipped examples are already updated
• Prefix those with minecraft:give rather than give so Essentials doesn't intercept them

📦 Install

Replace the old jar in plugins/ with DeluxePouches-2.1.0.jar and restart.