PromoCode – Minecraft 1.21.x Paper Plugin

PromoCode allows server administrators to create and manage promo codes that players can redeem for rewards. Each promo code can:

• Execute console commands ([console])
• Send custom messages to players ([message]) with full support for Minecraft color codes (&a, &c, etc.) and HEX colors (&#RRGGBB)
• Play Minecraft sounds ([sounds])

Features

• Create promo codes with usage limits or unlimited usage using /code create <player> <code> <uses|infinity>
• Players redeem codes using /code <code>
• Tracks the number of times a code has been used
• Customizable messages and actions for successful redemption and when code has no uses left (no-uses)
• Reload the plugin configuration at runtime using /code reload

Example Activation

Example of the chat message when a promo code is successfully activated (with HEX colors, formatted borders, and level-up sound).

Commands

• /code create <player> <code> <uses|infinity> – create a new promo code (admin only)
• /code <code> – redeem a promo code (player)
• /code reload – reload the plugin configuration (admin only)

Notes

• Supports multiple actions per code: console commands, messages, and sounds
• Ideal for giveaways, server events, or rewarding players with items, currency, or other benefits