🌟 RedeemCodes – Easy & Powerful Code Redemption Plugin for Minecraft

RedeemCodes is a lightweight yet powerful plugin that allows server administrators to create, manage, and redeem custom codes to reward players.

🔧 Features

• 🎟️ Custom Redeemable Codes – Define unlimited codes with flexible reward options.
• ⛔ Blacklist/Whitelist System – Block or allow specific players for each code.
• 🔄 Redemption Limits & Cooldowns – Set per-player or global redemption limits with cooldown timers.
• 🎨 Interactive GUI Editor – Manage codes and rewards directly in an intuitive in-game GUI.
• 🔊 Success & Error Sounds – Configurable sounds that play on successful or failed redemption.
• 🧩 Placeholder Support – Use placeholders like %player%, %uuid%, %random-min-max%, and more inside reward commands.
• 🔐 Permission-Based Access – All admin commands are fully permission protected.
• 🧠 Fully Configurable – Customize all messages, sounds, and prefix in config.yml.

🎁 Reward System

• Console Command: Rewards are assigned as console commands, creating endless possibilities without limitations.
• Placeholder Support: Supports placeholders to add custom values in commands.

🧩 Supported Placeholders

• %player% – Player's name
• %uuid% – Player's UUID
• %displayname% – Player's display name
• %world% – World name
• %random-min-max% – Random number within a range

Example reward:

- "eco give %player% %random-100-500%"

📦 Commands & Permissions

✅ Player Command

/redeem <code>

Redeem a code and claim its reward. ⤷ Permission: None (available to all players)

🔧 Admin Commands

/rc create <code>                - Create a new code
/rc remove <code>                - Remove a code
/rc addreward <code> <command>   - Add a reward command to a code
/rc removereward <code> <id>     - Remove a reward by ID
/rc list                         - List all codes
/rc redeemed <code>              - Show players who redeemed a code
/rc rewards <code>               - Show rewards attached to a code
/rc reload                       - Reload plugin configs
/rc version                      - View plugin version
/rc show <code>                  - Show details of a code
/rc rewards <code> [page]        - View rewards with pagination
/rc redeemed <code> [page]       - View redeemed users with pagination
/rc review <message>             - Send a review or bug report to developers
/rc gui                          - Open the RedeemCodes menu interface
/rc help [page]                  - Show the help menu

⤷ Permission: redeemcodes.admin

🖥️ GUI System

The plugin includes a modern and easy-to-use GUI for code management:

• Main Menu

  • Create Code
  • Codes List
  • Admin Panel

  

• Codes List GUI

  • View all available codes at a glance

  !

• Code Editor

  • Edit rewards, settings, and options directly in-game

  

🛠 Example Code Setup

# Example structure for creating a redemption code.
# This list contains all the codes and their associated information.
Codes:
  samplecode: # The name of the code. This is used by the /redeem command to redeem the code.
    enabled: true # Whether the code is enabled or not.
    # If the player needs a certain permission to use the code or not [Requires LuckPerms to use it].
    permisson:
      required: false # Set to true if permission is needed to redeem the code.
      list:
        - code.sample.redeem

    redeem-limit:
      # Types:
      # PLAYER -> how many times a player can redeem it
      # CODE -> how many times this code can be redeemed in total, with a limit per player
      Type: PLAYER
      Count: 1 # The number of times the code can be redeemed by a player or overall (set to -1 for no limit).
      Cooldown: 5 # Cooldown time (in minutes) between each redemption of this code by a player.
      Cooldown-message: "&cYou must wait %Cooldown% before redeeming again!"
    expire-time: -1 # Time in seconds until the code expires. Set to -1 for no expiration.
    Playerlist:
      Used: [] # Backup list of players who have already used this code. Do not change it.

      # This list contains the names of players who are blacklisted from using this code.
      # Types: ENABLED/DISABLED, REVERSE -> changes this list to a whitelist.
      Blacklist:
        Type: ENABLED
        List:
          - reyalp
    # This list contains the commands that are executed by the server after a player uses the code.
    # Placeholders:
    # -> %player% : returns the username of the player who used this code.
    # -> %uuid% : returns the player's UUID.
    # -> %world% : returns the name of the world.
    # -> %displayname% : returns the player's display name.
    # -> %random-<min_value>-<max_value>% : returns a random number between the min and max value range (e.g., %random-1-10%).
    rewards:
      - say %player% (%uuid%) is in %world% with name %displayname%
      - give %player% diamond %random-1-5%

🔊 Configurable Sounds

sounds:
  success: ENTITY_PLAYER_LEVELUP
  failure: BLOCK_ANVIL_LAND

💬 Fully Customizable Messages

messages:
  usage: "&cUsage: /redeem <code>"
  not-exist: "&cThis code doesn't exist!"
  blacklisted: "&cYou are not allowed to redeem this code."
  already-used: "&eYou have already redeemed this code."
  redeem-success: "&aSuccessfully redeemed the code!"
  reload-success: "&aAll configuration files reloaded!"
  no-permission: "&cYou don't have permission to use this."
  code-exists: "&cCode already exists!"
  code-created: "&aCreated new code: %code%"
  code-removed: "&aRemoved code: %code%"
  reward-added: "&aAdded reward to %code% with ID %id%"
  reward-removed: "&aRemoved reward ID %id%"
  reward-not-found: "&cThat reward ID doesn't exist!"
  invalid-reward-id: "&cInvalid reward ID!"
  command-usage: "&cUsage: /redeemcodes <command> [arguments]"
  unknown-action: "&cUnknown action: %action%"
  code-disabled: "&cThis code is currently disabled."
  out-of-stock: "&cThis code is out of stock!"
  code-expired: "&cThis code has expired." 

📚 Requirements

• Minecraft 1.20.2 - 1.21.x
• Paper / Purpur

📌 Why Use RedeemCodes?

Whether you’re organizing events, giveaways, loyalty programs, or simple player rewards, RedeemCodes offers a seamless, lightweight, and customizable way to engage your server community.