FAQ

Work down this list:

1. Java version. A message about an unsupported class file version means the server is on Java 17 or older. DeluxePouches needs Java 21.
2. Server software. It needs Paper or a Paper fork on Minecraft 1.21 or newer. Plain Spigot and CraftBukkit will not work.
3. Licence check. The check runs on startup and needs the server to reach the internet. A blocked outbound connection looks the same as a failed licence.
4. Where you bought it. Only copies from the two stores on Download pass the check.

Still stuck, bring the full startup log to Support.

No. It compiles against Paper and uses Paper only API. On Spigot it will misbehave or fail outright. Any Paper fork, such as Purpur, is fine.

No. The minimum is Minecraft 1.21.

Almost always a missing deluxepouches.use permission. Test with a normal account, not an op account, because operators pass every check.

Next suspects: the pouch has its own permission set, or you are standing in a blacklisted WorldGuard region.

Pouches carry a hidden tag naming their pouch id. If you renamed a pouch id in pouches.yml, items already handed out point at an id that no longer exists.

Either put the old id back, or hand out replacements with /dp give.

A barrier is placed for the length of the animation to hold it in position, then removed. If one ever survives a crash, break it or restart.

Shift and right-click, or shift and place, opens the whole stack with no animation, so the rewards land instantly. That is the intended behaviour, not a bug.

Check its chance. A reward with chance: 0 is removed from the draw entirely.

Remember chances are weights, not percentages. chance: 5 next to a chance: 500 is about one in a hundred. See Rewards.

Expected. Each draw is independent, so with reward-amount: 3 the same entry can be picked more than once. Split rare items into their own pouch if you never want doubles.

1. Drop the leading slash. give ..., not /give ....
2. Run the command from console by hand and see if it works there. Reward commands run as console.
3. Turn on /dp debug toggle and open a pouch. Every command it runs is logged, along with any that failed.
4. Commands for another plugin need that plugin to allow console usage.

Use your economy plugin's own command as a reward:

        commands:
          - "eco give %deluxepouches_player% 1000"

There is no separate money reward type.

They drop on the ground at the player's feet, so nothing is lost.

Two usual causes:

• The material is not SKULL (or PLAYER_HEAD). On anything else the texture is ignored and a warning is logged.
• The wrong string was copied. You want the Value field under "For Developers" on minecraft-heads.com, a long base64 blob, not the URL or the id.

If you copied an example from an older version of pouches.yml, recopy the texture, some of the old shipped examples were broken.

Run /dp testmodel LEATHER 1001 with your own material and number. If that test item also shows plain, the problem is the resource pack or the pack is not loaded on your client, not the pouch config.

Those plugins load their items after the server starts, so DeluxePouches skips the pouch and logs a warning naming it. When Nexo reports its items are ready, the plugin reloads and picks the pouch up.

If it never appears, the item id is wrong or the plugin providing it is not installed. The console warning shows the exact string it could not resolve.

That block is a leftover, the plugin does not read it. Animation timings are fixed in code. What you can change is the performance section, see Animations.

In order:

1. Raise settings.performance.animation-tick-rate to 3.
2. Keep limit-particles: true and lower max-particles.
3. Use NONE or DEFAULT on the pouches players open in bulk, and save the long animations for rare ones.

Yes, with WorldGuard. Set settings.worldguard.enabled: true and list the regions as world;region. Full steps on Integrations.

No. The plugin has no PlaceholderAPI expansion, so those placeholders work inside DeluxePouches text only. It does read placeholders from other plugins if PlaceholderAPI is installed. See Placeholders.

Anonymous usage statistics to bStats and ArrowStats: server and player counts, versions, Java and OS details, plus a few counters such as how many pouches are configured. No player names, no config contents. Both can be turned off, see Integrations.