🎁 MysteryBox
🎁 Crack open tiered loot boxes for epic rewards!
Overview
MysteryBox brings the excitement of crate openings to your server. Admins give players boxes and matching keys for each configured tier — common, rare, and legendary out of the box. Players place a box block, right-click it with the correct key, and a particle-and-sound animation builds suspense before the box bursts open. Each tier has its own reward pool with weighted chances. Rewards can be items, vanilla experience, or console commands, letting you deliver anything from a handful of arrows to a custom netherite sword. Everything is defined in config.yml, so server owners shape the entire economy of drops without touching code.
Features
Tiered Loot
Define unlimited box tiers with their own display name, block type, and reward pool.
Key System
Boxes only open when the player holds a matching tier key, which is consumed on use.
Opening Animation
Each box plays a timed witch-and-flame particle sequence with chest and explosion sounds before revealing loot.
Weighted Rewards
Reward chances act as weights so rarer drops appear less often than common ones.
Flexible Reward Types
Drops can be items, vanilla XP, or console commands using the {player} placeholder.
Commands
/mbox give <player> <tier> | /mbox key give <player> <tier> | /mbox spawn <tier>Admin commands to give boxes, give keys, or spawn a box at the block you are looking at.
Permissions
mysterybox.adminAllows use of all /mbox commands.
Default: opInstallation
- 1Drop the .jar into your server's /plugins folder.
- 2Restart the server (Minecraft 1.21, api-version 1.21).
- 3Edit the auto-generated config.yml to customize tiers and rewards.
Configuration
config.yml defines a tiers section where each tier sets display, block, animation-seconds, and a rewards list of type/id/amount/chance entries that control what drops and how often.
🤖 MysteryBox was created with Spaleforce AI.
Create your own for free