BlockCrates

BlockCrates
Custom crates with keys, animations, custom chances, money rewards, holograms and quick commands.

Features

• 4 opening animations: Roulette, Wheel, Shuffle and Instant
• Virtual or physical keys: virtual keys are stored for the player, physical keys are real items
• Reward types: items, money (needs Vault) and console commands
• Custom chances: weighted rewards, and the GUI shows the real percentage
• Holograms: floating, customisable text above every crate
• In-game editor: build crates without touching config files
• Extras: particles, sounds, win broadcasts, a join reminder for unused keys and optional per-crate permissions

Requirements

• Spigot or Paper 1.21+
• Vault (optional, only needed for money rewards)

Quick setup

1. Drop the jar into /plugins and restart.
2. Run /crate create <id>, then add rewards with /crate add <crate> while holding an item.
3. Place the crate with /crate place <crate>.
4. Give keys with /crate givekey <player> <crate>.
5. Players right-click the crate to open it, or left-click to preview.

Commands
Aliases: /crate, /crates, /bcrates

Command What it does
/crate help Shows all commands
/crate list Lists crates
/crate preview <crate> Preview rewards
/crate open <crate> Open a crate with a key
/crate keys [player] View your keys, or another player's
/crate create <id> / delete <id> Create or delete a crate
/crate editor Opens the editor GUI
/crate add <crate> [chance] Add the item in your hand
/crate addinv <crate> [chance] Add your whole inventory
/crate additem <crate> <chance> Add an item reward
/crate addmoney <crate> <amount> <chance> Add a money reward
/crate addcommand <crate> <chance> <command> Add a command reward
/crate rewards <crate> List rewards
/crate removereward <crate> <#> Remove a reward
/crate chance <crate> <#> <value> Change a chance (15, +5, -5, x2, 10%)
/crate setanimation <crate> <type> ROULETTE, WHEEL, SHUFFLE or INSTANT
/crate setkeytype <crate> <type> VIRTUAL or PHYSICAL
/crate setname <crate> <name> Rename a crate
/crate place <crate> [block] Place a crate where you're looking
/crate setblock <crate> / removeblock Link or unlink a block
/crate remove Delete the crate you're looking at
/crate givekey / takekey <player> <crate> [amount] Give or take keys
/crate giveall <crate> [amount] Give a key to everyone online
/crate reload Reload the config
Permissions
Players (granted by default):

Permission Allows
blockcrates.use Open and preview crates by clicking them
blockcrates.open /crate open
blockcrates.preview /crate preview
blockcrates.keys /crate keys (own keys)
blockcrates.list /crate list
Staff (OP by default):

Permission Allows
blockcrates.use.* Open every crate when per-crate permissions are on
blockcrates.use.<crate> Open one specific crate (per-crate permissions)
blockcrates.keys.others /crate keys <player>
blockcrates.givekey /crate givekey
blockcrates.takekey /crate takekey
blockcrates.giveall /crate giveall
blockcrates.create /crate create
blockcrates.delete /crate delete
blockcrates.edit Editor GUI and all reward and crate edit commands
blockcrates.setblock /crate setblock and removeblock
blockcrates.reload /crate reload
blockcrates.admin All of the above
Configuration highlights

• per-crate-permissions: set to true to require blockcrates.use.<crate> for each crate.
• Every sound is editable, and you can set one to none to turn it off.
• Hologram lines support & and hex (&#RRGGBB) colours, plus the placeholders {crate}, {id}, {rewards} and {keytype}.
• Reward commands run from console, and %player% is replaced with the winner's name.
• Add broadcast: true to a reward to announce rare wins