Skip to main content

Lucky Drops

Lucky Drops is a Clash Royale–inspired "lucky chest" plugin for Bukkit, Spigot, and Paper servers. Players right-click a special item to open it: with each click the item's rarity can level up, and once the progress bar is full one final click cracks it open and hands out a reward from that rarity's loot table.

It's designed to be fully data-driven - the rarities, their odds, and the rewards are all defined in config and can be reshaped completely without touching code.

How a drop works​

  1. A player is given a Lucky Drop (a textured player head) at some starting rarity.
  2. Each right-click is one "tap". Every tap may upgrade the rarity to the next tier and fills one segment of the progress bar shown in the item's name.
  3. When the bar is completely full, the rarity is locked in. The drop is not opened yet.
  4. One more right-click opens the drop, consumes the item, and grants a weighted-random reward from the achieved rarity's pool.