RankItems

RankItems lets you turn your existing LuckPerms ranks/groups into physical Minecraft items that can be used as crate rewards, event rewards, giveaways, or purchasable items.

✨ Features

• 🎟️ Physical Rank Items — Turn any existing LuckPerms group into an item.
• ⏳ Temporary Ranks — Give ranks for a specific duration such as 30m, 1h, 7d, or 30d.
• 📦 Crate Compatible — Rank items are normal Minecraft items, making them easy to add to crate rewards.
• 🔐 LuckPerms Integration — Uses your existing LuckPerms groups and never creates new groups automatically.
• 🖱️ Right-Click Activation — Players simply right-click the rank item to activate it.
• 🗑️ Automatic Consumption — The rank item is consumed after successful activation.
• ⌛ Automatic Expiration — LuckPerms handles the temporary rank expiration automatically.
• 🎨 Custom Item Information — Items display the rank name and duration.
• 💾 Persistent Item Data — Rank information is stored directly on the item, making it safe to move through inventories and crates.

🛠️ Example

/rankitem give Player Owner 30d

The player receives an Owner Rank item. After right-clicking it, they receive the existing Owner LuckPerms group for 30 days.

Once 30 days are over, LuckPerms automatically removes the temporary inheritance.

🔒 Existing Groups Only

RankItems does not create LuckPerms groups.

If Owner exists:

Owner → ✅ Rank Item works

If SuperOwner doesn't exist:

SuperOwner → ❌ Rank Item cannot be created

This keeps your LuckPerms rank structure completely under your control.

Some of the code in this plugin is written by AI.