MossCrates: loot crates and keys (Paper 1.21+)

Loot crates on any block with keys, a roll animation, a reward preview and holograms.

Turn any block into a loot crate. Players open it with a key, watch the rewards roll past and get what it stops on. Right click without a key shows everything the crate can give.

It is small on purpose: one jar, one config file, no other plugins needed.

What it does

Any block can be a crate. Look at a block, run /crate set <crate> and it is one. Chests and ender chests work too, they just never open as a container.
Keys. Give them by command, to one player or to everyone online. The command works from the console, so vote and shop plugins can hand out keys.
Roll animation. A menu scrolls through the rewards and slows down on the prize. Length and speed are in the config.
Reward preview. Right click without a key opens a menu with every reward in the crate.
Weighted rewards. Each reward has a weight. A reward can be an item, a list of commands, or both.
Holograms. Floating text above each crate, made with display entities. No hologram plugin needed.
Server wide announcements for the rewards you mark as rare.
Protected. Crates cannot be broken or blown up, keys cannot be placed as blocks, and only one player can open a crate at a time.
No lost rewards. If a player closes the menu early or logs out during the roll, they still get the reward.
MiniMessage text everywhere: colors, gradients and hex in names, holograms and messages.

Commands

/crate key <player|all> <crate> [amount] gives keys
/crate set <crate> turns the block you look at into a crate
/crate remove turns it back into a normal block
/crate list shows the crate types
/crate reload reloads the config

Permissions

mosscrates.admin for all commands (ops by default)
mosscrates.use to open and preview crates (everyone by default)

Requirements

Paper 1.21 or newer (built and tested on Paper 1.21.1)
Java 21
No other plugins

Default config

# MossCrates
# Text uses MiniMessage: <green>, <bold>, <#55ff99>, <gradient:gold:yellow> ...
# In commands, %player% is replaced with the name of the player who won.

messages:
  no-key: "<red>You need a <key><red> to open this crate."
  won: "<gray>You won <reward><gray>!"
  broadcast: "<gold><player><yellow> pulled <reward><yellow> from the <crate><yellow>!"
  key-received: "<gray>You received <white><amount>x <key><gray>."
  busy: "<red>Someone is already opening this crate."

roll:
  steps: 34            # how many items scroll past before it stops
  close-after: 50      # ticks the result stays on screen

crates:
  mossy:
    name: "<green><bold>Mossy Crate"
    hologram:
      - "<green><bold>Mossy Crate"
      - "<gray>Right click with a key"
      - "<dark_gray>Right click to preview"
    key:
      material: TRIPWIRE_HOOK
      name: "<green>Mossy Crate Key"
    rewards:
      - item: EMERALD
        amount: 16
        weight: 30
      - item: DIAMOND
        amount: 3
        weight: 22
      - item: GOLDEN_APPLE
        amount: 2
        weight: 18
      - icon: EXPERIENCE_BOTTLE
        name: "<yellow>500 XP"
        weight: 15
        commands:
          - "xp add %player% 500 points"
      - item: ENCHANTED_GOLDEN_APPLE
        weight: 8
      - item: NETHERITE_INGOT
        weight: 5
        broadcast: true
      - item: ELYTRA
        name: "<light_purple>Wings of the Mossback"
        weight: 2
        broadcast: true

Need something it does not do?

Custom plugins are made to order, from one feature to a full server core. Get in touch.

Get MossCrates, $4.99