![Banner](https://cdn.modrinth.com/data/cached_images/2018cfdff840876bfa1c45b362fea47751057238.png) **RedeemCodes** is a 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. * **Permission System** - Develop permission-based codes to limit usage to a specific rank or group * **Events** - Trigger customizable actions such as fireworks, command sets, or animations when a reward is claimed * **Interactive GUI Editor** – Manage codes and rewards directly in an intuitive in-game GUI. * **Interaction Sounds** – Configurable sounds that play on events, successful or failed redemption. * **Permission-Based Access** – Every admin command is fully protected by permissions. * **Fully Configurable** – Customize all messages, sounds, and prefix in `config.yml`. ### Reward System Build anything from simple rewards to complex gacha-style reward pools by combining multiple reward types. * **Multiple Distribution Modes** – Choose how rewards are given: * **ALL** – Grant every configured reward. * **RANDOM** – Select one reward pack randomly. * **DRAW** – Select one reward using configurable weighted chances. * **Command Packs** – Group multiple console commands into reusable reward packs. * **Sacks** – Give predefined item collections directly to the player's inventory. * **Premade Rewards** – Reuse commonly used reward sets defined in `premades.yml`. * **Reward Events** – Trigger custom celebrations, animations, sounds, fireworks, or other effects from the `events` folder. * **Weighted Rewards** – Assign weights to reward packs for loot box or gacha-style reward systems. * **Mix & Match Categories** – Combine commands, sacks, premades, and events in a single reward for highly customizable redemption experiences. * **Placeholder Support** – Supports PlaceholderAPI and built-in placeholders. ### Built-in 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 configuration: ```yaml rewards: type: DRAW events: - celebration commands: lucky_cash: - "eco give %player% %random-500-1000%" - "msg %player% &aYou won a cash reward!" - "weight: 10" sacks: - starter: 5 - miner: 2 premades: - vip_rank: 1 ``` ### Commands & Permissions **Player Command** ```plaintext /redeem


```

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

**Admin Commands**

```plaintext
/rc create                 - Create a new code
/rc remove                 - Remove a code
/rc reward                       - Add/Remove/View rewards
/rc sack                         - Add/Remove/View Sacks
/rc event                        - Add/Remove/Play Events
/rc list                         - List all codes
/rc redeemed               - Show players who redeemed a code
/rc rewards                - Show rewards attached to a code
/rc reload                       - Reload plugin configs
/rc version                      - View plugin version
/rc show                   - Show details of a code
/rc redeemed  [page]       - View redeemed users with pagination
/rc review              - 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


![RedeemCodes Menu](https://cdn.modrinth.com/data/cached_images/e18682b3eed35a24d04218d5c268c7574e3f4a95.png)




Code List Menu
View all available codes at one glance


![Codeslist](https://cdn.modrinth.com/data/cached_images/04b1c2ff452fd8c3932b188e3ca825b7647dcfa3.png)!




Code Editor Menu
Edit rewards, settings, and options directly in-game


![Code editor](https://cdn.modrinth.com/data/cached_images/3f2f5a5ccc9a512f472b72afde68c135c3939fdb.png)


   

### Example Code Setup


codes.yml

```yaml
# ==============================================================================
#                           REDEEM CODES CONFIGURATION
# ==============================================================================
# This file contains all the redemption codes and their settings.
# You can create codes using the in-game GUI command: /rc gui
# ==============================================================================

Codes:
  # Example Code: "welcome_gift"
  # Users redeem this by typing: /redeem welcome_gift
  welcome_gift:

    # Enable or disable the code instantly.
    enabled: true

    # Permission Settings [Requires a permission plugin like LuckPerms]
    # If required is true, the player must have one of the listed permissions.
    permisson:
      required: false
      list:
        - code.redeem.welcome

    # Redemption Limits
    # Type:
    #   PLAYER -> Limits how many times a single player can redeem.
    #   CODE   -> Limits the total global uses of the code (e.g., first 10 people).
    redeem-limit:
      Type: PLAYER
      Count: 1 # Number of times allowed (Set to -1 for infinite).
      Cooldown: 0 # Cooldown in minutes between uses (0 to disable).
      Cooldown-message: "&cYou must wait %Cooldown% before redeeming again!"

    # Expiration time in seconds. -1 means it never expires.
    expire-time: -1

    # Player Data & Blacklisting
    Playerlist:
      Used: [] # Do not edit manually. Stores UUIDs of players who used the code.

      # Blacklist Control
      # Type:
      #   ENABLED  -> Players in the list CANNOT use the code.
      #   REVERSE  -> Only players in the list CAN use the code (Whitelist mode).
      #   DISABLED -> The list is ignored.
      Blacklist:
        Type: ENABLED
        List:
          - notch
          - herobrine

    # ==========================================================================
    #                                 REWARDS
    # ==========================================================================
    # The reward system allows you to mix and match different types of rewards.
    #
    # Distribution Types (rewards.type):
    #   ALL    -> The player receives EVERY reward defined below.
    #   RANDOM -> The player receives ONE reward selected randomly from all defined packs.
    #   DRAW   -> The player receives ONE reward based on a weighted chance system.
    #
    # Reward Categories:
    #   1. Commands: A list of console commands to execute.
    #   2. Sacks: A collection of items given directly to the inventory (defined in /sacks/).
    #   3. Premades: Reusable command lists defined in premades.yml.
    #   4. Events: Special visual/audio effects defined in /events/.
    #
    # Placeholders for commands:
    #   %player%      -> Player Name
    #   %uuid%        -> Player UUID
    #   %world%       -> World Name
    #   %displayname% -> Display Name
    #   %random-x-y%  -> Random number between x and y
    # ==========================================================================

    rewards:
      type: ALL

      # --- Events ---
      # Trigger visual/sound effects from files in the 'events' folder.
      events:
        - celebration # Plays 'events/celebration.yml'

      # --- Command Packs ---
      # Custom groups of commands specific to this code.
      commands:
        basic_stuff:
          - "say Welcome %player%!"
          - "give %player% apple 5"
          - "weight: 10" # Used if type is DRAW (higher weight = higher chance)

        lucky_roll:
          - "eco give %player% %random-50-100%"
          - "msg %player% &aYou got some lucky cash!"
          - "weight: 5"

      # --- Sacks ---
      # Items defined in the 'sacks' folder. Format: "sackname:weight"
      # If type is ALL, weight is ignored.
      sacks:
        - starter: 1
        - miner: 1

      # --- Premades ---
      # Reusable rewards defined in 'premades.yml'. Format: "premadename:weight"
      premades:
        - vip_rank: 1
        - money_small: 2
```

  


### Configurable Sounds

```yaml
sounds:
  success: ENTITY_PLAYER_LEVELUP
  failure: BLOCK_ANVIL_LAND
  click: UI_BUTTON_CLICK
  page-turn: ITEM_BOOK_PAGE_TURN
  error: ENTITY_VILLAGER_NO
  close: BLOCK_CHEST_CLOSE
```


### Fully Customizable Messages

```yaml
messages:
  usage: "&cUsage: /redeem "
  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  [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.8.8+
* Server Software: Paper, Purpur, Spigot, Bukkit, Folia


### 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.

Redeem Codes [⭐Gui]

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details