Mystery Crates & Daily Rewards

**A complete loot-crate system for Paper servers — plus a 30-day

daily-rewards board built in.** Ten crate tiers out of the box

(Common through Void, up to 99 types in config), physical keys,

in-game pool editing, and crates that can look like plain chests or

real trial-chamber vaults that show off their prizes and run the

full vault unlock show when a player opens one.

• Any item can be a prize. Pools are built in a chest GUI
• (/mystery configure) and store whole items, so vanilla items,
• custom-model-data items, other plugins' items, and map art all
• work exactly as you put them in
• 6 rarity rows per crate with configurable chances
• (defaults 25/20/15/12/10/8)
• Vault crates: the display inside the cage cycles through your
• own pool's prizes — never stock trial-chamber loot. Opening one
• runs the unlock animation: prizes flash past, the display settles
• on the win, and the prize pops out of the top of the vault,
• tagged for the opener so nobody can snatch it. Chest crates pay
• out instantly instead
• Exact odds per prize: hold an item, run /mcw, and set that
• one prize's real win chance — including 0 for "in the pool but
• never drops." The plugin tells you the item's actual % of opens
• Player preview: left-click a crate (or /mystery preview) to
• see every prize with its real win chance before spending a key
• Command prizes: a crate can pay out console commands instead
• of an item — money, ranks, keys for other crates, anything your
• server can run (%player% is replaced with the winner)
• Rare-win broadcast when someone hits a top row (configurable),
• and a pity guarantee: after a set number of opens without a
• top-row win, the next open is guaranteed from the pity row
• Tiered keys: low tiers use tripwire hooks, mid tiers trial
• keys, top tiers ominous trial keys (per-type override in config).
• /mystery key hands keys to one player; /mystery keyall gives
• one to every player online — included, not a premium extra
• Knockback guard: trying a crate without its key shoves the
• player back and tells them which key it needs (configurable, can
• be turned off)
• /daily — a 30-day rewards board: players claim one day at a
• time on a configurable cooldown (24h default), no streak loss for
• missed days, and the board restarts after Day 30. Each day can
• give an item, run console commands, or both — items are edited in
• game with /mystery dailyedit, commands are set in game with
• /mystery dailycmd or in config
• Admin-friendly: /mystery copypool clones a finished pool
• onto another tier; permissions mystery.admin, mystery.open,
• mystery.daily; full instructions in the README bundled in the jar

Requirements: A Paper 26.3 server (Minecraft 26.3). Drop the jar

in plugins/, restart, and start with /mystery give and

/mystery configure. No dependencies, no resource pack needed —

crates and vaults are real blocks, so they work for every player,

including Bedrock players joining through Geyser.

Honest notes: Changing a tier's key material or a crate's block

look applies to crates and keys given out afterwards — ones already

in players' hands keep the look and material they were issued with.

Daily day-items and commands are set by you; the board ships with

example economy commands on Days 1, 7, 14, and 30 that you can keep,

change, or clear.

Support: Hatter's Workshop Discord — https://discord.gg/3SeC3eRvNk