Crates 📦

Reward crates that anyone can set up. Turn any ender chest into a crate, give players a key, and watch the chest pop open with a spinning prize wheel above it.

Features

• 📦 Any ender chest becomes a crate - no custom blocks, no resource pack
• 🎰 The lid opens and a prize spins above it before landing on your reward
• 🔑 Keys are real items you can hand out, trade and see in your inventory
• ✨ A floating label above every crate so players know what it is
• 👁 Click a crate empty-handed to see the rewards and their real chances
• 🖱 Everything is done from one menu - create crates and rewards without ever opening a config file
• 🎁 Rewards can be items, enchanted gear, or console commands (money, ranks, kits)

Install

1. Put Crates-x.y.z.jar in your plugins/ folder.
2. Restart the server. Done!

How to make a crate

1. Type /crate
2. Click ➕ Create a crate, give it a name
3. Hit an ender chest - it is now a crate
4. Click 🔑 Give keys to hand keys to your players

How to add rewards

1. Hold the item you want to give away
2. /crate > My crates > pick your crate > Edit rewards
3. Click Add the item in my hand

Its name, lore and enchantments are copied automatically. Then set how often it should drop, and optionally a console command to run and whether the win is announced to the server.

Everything is saved in plugins/Crates/crates.yml, which stays readable if you ever want to edit it by hand.

The menu

/crate shows different things depending on who you are:

• Players get the list of crates and can preview the rewards
• Admins get the full manager: create, place, delete, give keys, reload

Rewards

Each reward has a weight. The bigger the weight, the more often it drops - the plugin turns those into real percentages for you and shows them in the preview. A reward can give an item, run console commands, or both:

"4":
  weight: 8
  display: "§a5000 coins"
  item: "minecraft:gold_ingot"
  give-item: false
  commands:
    - "eco give {player} 5000"

Set broadcast: true on a rare reward to announce it to the whole server.

Commands & permissions

Command	Who	What
/crate	everyone	Opens the menu
/crate cancel	admins	Stops crate placement mode

Permission	Default	What
crates.admin	op	Create, place, delete crates and give keys

Admins can also sneak + break a crate to unlink it without deleting the crate type.

Requirements

PowerNukkitX 3.0.0+ · Java 21

For developers

./gradlew build

MIT license - do whatever you want with it.