Codes

Create reward codes in-game and let players redeem them with /redeem <code>. Perfect for giveaways, events, social media rewards, compensation after downtime or welcome gifts.

✨ Features

• Item rewards. Hold any item and run /code additem. Full NBT is kept, so enchantments, custom names, lore and custom items from other plugins all work.
• Command rewards. Run any console command with a %player% placeholder: crate keys, money, ranks, whatever your server uses.
• Battle Pass rewards. If BattlePass is installed, codes can also give Battle Pass XP or the premium pass. These codes can only be redeemed while a season is running, and players never lose a code because of it.
• One use per player. Each player can redeem a code exactly once. On a network this is enforced by the database, so it's impossible to redeem a code twice on different servers, even at the same moment.
• Usage limits. Optionally limit how often a code can be used in total, e.g. "first 50 players only".
• Network sync. Create or change a code on one server and every other server picks it up automatically within seconds. No /code reload on every server.
• Safe. If a player disconnects while redeeming, the code is given back. Items that don't fit into the inventory are dropped at the player's feet. Code names are never shown in tab completion.
• Works without a database. Single servers can use local storage with zero setup.

📋 Commands

Command	Description
/redeem <code>	Redeem a code
/code create <name>	Create a new code
/code additem <name>	Add the item in your hand as a reward
/code addcmd <name> <command>	Add a console command reward (%player%)
/code bpxp <name> <amount>	Battle Pass XP reward (needs BattlePass)
/code bppremium <name> <true|false>	Grant the premium Battle Pass (needs BattlePass)
/code list · /code info <name>	Inspect codes
/code delete <name>	Delete a code
/code reload	Reload the config

🔑 Permissions

Permission	Default	Description
codes.redeem	everyone	Redeem codes
codes.admin	op	Manage codes

⚙️ Requirements

• Paper (or forks like Purpur) 1.21 – 26.2
• Java 21 (1.21.x) / Java 25 (26.x)
• Optional: MySQL/MariaDB for networks, BattlePass for Battle Pass rewards

🚀 Quick start

1. Drop the jar into plugins/ and restart.
2. For a network, set storage.type: mysql in config.yml and point all servers at the same database. For a single server, use local.
3. /code create summer → /code additem summer → players run /redeem summer.