Chunkwright Crates

Name: Chunkwright Crates
Brand: Chunkwright
SKU: plugin-crates
Price: 9.99 USD
Availability: InStock

$9.99

Crate keys, a spinning roll menu, reward previews and holograms over every crate block.

Buy now $9.99

Instant download after payment. One purchase covers one server or network. Updates are free.

Server: Paper and Purpur
Minecraft: 1.21.4 to 26.1
Java: 21 or newer
Needs: No other plugins
Version: 1.0.0, 2026-10-12
Tested: Tested on real servers: 1,142 checks passed on Paper 1.21.4 to 26.1 and Purpur
Download: 0.06 MB zip

Chunkwright Crates: Crate blocks with floating text and circling particles

Chunkwright Crates: Right-click with a key: the middle row spins and slows down

Chunkwright Crates: The roll stops on the reward under the pointers and the border turns lime

Chunkwright Crates: Left-click a crate to see every reward and its chance

Chunkwright Crates: Rewards keep their names, lore and enchantments

Chunkwright Crates: Keys are real items with your own name, lore and glow

Chunkwright Crates: The reward goes straight into the inventory with a chat message

What it does

Turn any block into a crate and hand out keys. Right-click with a key and a roll menu spins, slows down and lands on the reward: items, console commands or both. Left-click shows every reward with its chance. Each crate block has floating text and particles, and nothing in the world can break, move or wash it away. Keys are real items with a hidden tag that can't be placed, crafted with or used up by accident.

Any block can be a crate: look at it, or give coordinates from the console
Roll menu that spins fast, slows down and stops on the reward, with tick and win sounds
Holograms over every crate block and idle particles you pick per crate
Preview menu with every reward and its chance, pages for big crates
Rewards give the item, run console commands, or both
Physical keys with a hidden tag: renamed keys work, lookalikes do not
Keys can't be placed, eaten, thrown, crafted with, smelted or fired from dispensers
Crate blocks safe from players, explosions, pistons, fire, water, falling and leaf decay
Closing the menu, logging out or a restart still pays out the reward
/crate open to start a roll without a key, for votes and events
All text in messages.yml (MiniMessage), every setting commented in config.yml

Install

Put Crates-1.0.0.jar in your server's plugins folder.
Start the server. The plugin writes plugins/Crates/config.yml and messages.yml with two example crates, vote and legendary.
Place a chest (or any block), look at it and run /crate set vote.
Give yourself a key with /crate give <you> vote and right-click the chest.

Requirements

Paper or Purpur 1.21.4 to 26.1
Java 21+

Commands

Alias: /crates. Tab completion shows only the sub-commands a player may use, then crate names,

Command	What it does	Permission
`/crate list`	Lists all crates and how many rewards each has	`crates.use`
`/crate preview <crate>`	Opens the reward preview	`crates.use`
`/crate give <player> <crate> [amount]`	Gives keys (1 to 2304). Works from the console	`crates.admin`
`/crate open <crate> [player]`	Starts a roll without a key. From the console, name a player	`crates.admin`
`/crate set <crate> [x y z [world]]`	Makes the block you look at (within 6 blocks), or the block at x y z, a crate	`crates.admin`
`/crate remove [x y z [world]]`	Turns the crate you look at, or the one at x y z, back into a normal block	`crates.admin`
`/crate reload`	Reloads config.yml, messages.yml and blocks.yml	`crates.admin`

Permissions

Permission	Default	What it gives
`crates.use`	everyone	Open crates with a key, preview, /crate list, /crate preview
`crates.admin`	op	give, open, set, remove, reload, and crates.use

Every setting is in the commented config.yml, and every message in messages.yml (MiniMessage). The README in the zip lists them all.

How we test it

Tested on real servers: 1,142 checks passed on Paper 1.21.4 to 26.1 and Purpur. Every release runs on Paper 1.21.4, 1.21.5, 1.21.8, 1.21.11, 26.1.2 and Purpur 1.21.11, next to LuckPerms, Vault, EssentialsX and PlaceholderAPI. The run covers unit tests, scripted players going through every command and menu, random input, restarts and reloads. In the soak run 12 bots used the plugin nonstop and the server held 20 TPS, at most 1.6 ms per tick on average.

Changelog

1.0.0 2026-10-12

First release.

Crate blocks on any block, physical keys with a hidden tag, roll menu with sounds, preview menu with chances.
Holograms and particles over crate blocks.
/crate open to start a roll without a key; /crate set and /crate remove with coordinates from the console.
Preview pages for crates with more than 28 rewards, in the Chunkwright menu look.
Crate blocks protected from players, explosions, pistons, fire, fluids, falling, leaf decay, endermen and melting.
Keys can't be placed, used as their item, crafted with, smelted or fired from dispensers.
Paper and Purpur 1.21.4 to 26.1.
A message missing from messages.yml now uses the built-in text instead of "Missing message". A missing prefix uses the built-in prefix.
Values inside a crate are read only from your config.yml. Before, a deleted reward command came back from the built-in config while a deleted weight did not.
A weight of .nan or .inf is now skipped with a clear console line instead of breaking the crate on start or reload.
A crate whose block is removed (by a command, or a torch losing its support) is forgotten, so a new block at that spot is not a crate.
Clicks that a protection plugin already cancelled no longer open crates.
Players without crates.admin no longer see crate names in admin tab completion.
A config update no longer adds back the example crates you deleted.

Questions

What is in the download?

One zip of 0.06 MB with the plugin jar, a README with setup, commands and config, the changelog and the licence.

Which servers does it run on?

Paper or Purpur 1.21.4 to 26.1, with Java 21 or newer (Java 25 for 26.1). We have not tested Spigot or Folia.

Can I use it on my server?

Yes. One purchase covers one server, or one network under one name. You can change the config and messages as you like. You cannot resell or share the plugin.

How do I get the files?

Right after payment you land on your download page, and we email you its link. The page keeps working, so you can download again later.

Are updates free?

Yes. When we release a new version, the same download link gives you the new zip. Every update is posted in #plugin-updates on our Discord.