Rank Redeemer

Give your players a physical way to claim their ranks. Rank Redeemer turns a simple paper item into a redeemable rank voucher — right-click it, and the rank is applied instantly.

Perfect for crate rewards, store purchases, giveaways, and vote prizes — hand out a rank paper and let players redeem it whenever they like.

Features

• Right-click to redeem — players claim their rank by right-clicking the paper. No commands to remember.
• Fully config-driven ranks — define as many rank papers as you want in config.yml.
• Works with any rank system — each rank runs the console commands you choose, so it works with PowerRanks, LuckPerms, or anything else. You're not locked into one permission plugin.
• Custom name & lore — style each rank paper with colors, a display name, and lore text.
• One-time use (optional) — papers are consumed on redeem by default, or set consume: false to make them reusable.
• Redeem messages & broadcasts — send the player a confirmation and announce it to the server.
• Tamper-proof — rank papers carry a hidden tag, so players can't craft or fake their way into a rank with ordinary paper.
• Admin command — /rankredeemer give <player> <rank> (alias /rr) to hand out papers, with tab-completion.

Commands & permissions

Setup

1. Drop the jar in your plugins/ folder and restart.
2. Open plugins/RankRedeemer/config.yml and define your ranks — set the display name, lore, and the command(s) to run on redeem.
3. /rr reload to apply changes (no restart needed).
4. Hand out papers with /rr give <player> <rank>.

Example config

ranks:
  vip:
    display-name: "&6&lVIP Rank Paper"
    lore:
      - "&7Right-click to redeem your rank."
    commands:
      - "pr user %player% setrank vip"
    message: "&aYou are now VIP!"
    consume: true

Requirements

• Paper 1.21+ (built for any version)
• A rank/permission plugin whose commands you reference in the config (e.g. PowerRanks, LuckPerms)

Open source — the full code is available so you can see exactly what it does before running it. Suggestions and bug reports welcome in the comments.