RedeemCodes - The Ultimate Minecraft Voucher & Rewards Plugin
Create custom redeem codes, vouchers, and rewards for your Minecraft server with infinite possibilities!
RedeemCodes is the most advanced, free Minecraft Redeem Codes and Vouchers plugin available for Spigot, Paper, and Folia servers. Whether you are running a survival SMP, Skyblock, or Factions server, RedeemCodes allows server administrators to easily create, manage, and distribute custom codes to reward their players.
From simple item drops to complex gacha-style reward pools, RedeemCodes provides everything you need to boost player engagement through giveaways, vote rewards, and VIP perks.
? Key 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, per-IP, 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. - File Tracker - Monitors all plugin files and notifies admins about invalid formats, syntax issues, and errors
- Async Data Management - Reads and writes data asynchronously to ensure smooth, lag-free file management
- Infinite Rewards - Create command-based rewards that execute console commands, or design custom rewards with our various reward types, unlocking infinite possibilities.
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
eventsfolder. - 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:
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
/redeem <code>
Redeem a code and claim its reward. ⤷ Permission: None (available to all players)
Admin Commands
| Command | Description |
|---|---|
/rc create <code> |
Create a new code and initialize settings. |
/rc remove <code> |
Delete a code completely. |
/rc list |
List all existing codes with their active status. |
/rc show <code> |
Show details and configured rewards of a code. |
/rc redeemed <code> [page] |
View a paginated list of players who redeemed a code. |
/rc reward |
Add, remove, or view code rewards. |
/rc sack |
Add, remove, edit, or give Sack integrations. |
/rc premade |
Add, remove, or view Premade reward sets. |
/rc event |
Add, remove, or test Event hooks. |
/rc gui |
Open the interactive RedeemCodes Admin Menu. |
/rc reload |
Reload the configuration safely. |
/rc version |
View the active plugin version. |
/rc test <code> |
Dry run a code to safely test its rewards. |
/rc info |
View detailed plugin information and credits. |
/rc help [page] |
Show the help menu. |
/rc review <message> |
Send a review or bug report to the developers. |
Note: All admin commands support seamless Tab Completion and can be run from the Server Console.
⤷ 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
Code List Menu
View all available codes at one glance
!
Code Editor Menu
Edit rewards, settings, and options directly in-game
Example Code Setup
codes.yml
# ==============================================================================
# 兑换码配置
# ==============================================================================
# 此文件包含所有兑换码及其设置。
# 您可以使用游戏内 GUI 命令 /rc gui 创建兑换码。
# ==============================================================================
Codes:
# 示例代码:"welcome_gift"
# 用户通过输入以下命令进行兑换:/redeem welcome_gift
welcome_gift:
# 立即启用或禁用该代码。
enabled: true
# 权限设置 [需要 LuckPerms 等权限插件]
# 如果 required 为 true,则玩家必须拥有列表中列出的任一权限。
permisson:
required: false
list:
- code.redeem.welcome
# 兑换限制
# player: 单个玩家最多可兑换此代码的次数。
# ip: 单个 IP 地址最多可兑换此代码的次数。
# global: 整个服务器中此代码最多可被兑换的总次数。
redeem-limit:
player: 1 # 每个玩家允许兑换的次数(设置为 -1 表示无限)。
ip: 1 # 每个 IP 地址允许兑换的次数(设置为 -1 表示无限)。
global: -1 # 全局库存中的代码数量(设置为 -1 表示无限)。
cooldown: 0 # 两次使用之间的冷却时间(分钟)(0 表示禁用)。
cooldown-message: "&c您必须等待 %Cooldown% 分钟后才能再次兑换!"
# 过期时间(秒)。-1 表示永不过期。
expire-time: -1
# 玩家数据与黑名单
Playerlist:
# 黑名单控制
# 类型 (Type):
# ENABLED -> 列表中的玩家 CANNOT 使用该代码。
# REVERSE -> 只有列表中的玩家 CAN 使用该代码(白名单模式)。
# DISABLED -> 忽略该列表。
Blacklist:
Type: ENABLED
List:
- notch
- herobrine
# ==========================================================================
# 奖励
# ==========================================================================
# 奖励系统允许您混合搭配不同类型的奖励。
#
# 分配类型 (rewards.type):
# ALL -> 玩家将收到下面定义的所有奖励。
# RANDOM -> 玩家将从所有定义的组合包中随机获得一个奖励。
# DRAW -> 玩家根据加权概率系统获得一个奖励。
#
# 奖励类别:
# 1. Commands: 要执行的控制台命令列表。
# 2. Sacks: 直接给予背包的物品集合(在 /sacks/ 中定义)。
# 3. Premades: 在 premades.yml 中定义的复用命令列表。
# 4. Events: 在 /events/ 中定义的特殊视觉/音频效果。
#
# 命令中的占位符:
# %player% -> 玩家名称
# %uuid% -> 玩家 UUID
# %world% -> 世界名称
# %displayname% -> 显示名称
# %random-x-y% -> x 和 y 之间的随机数
# ==========================================================================
rewards:
type: ALL
# --- 事件 ---
# 触发 'events' 文件夹中文件的视觉效果/音效。
events:
- celebration # 播放 'events/celebration.yml'
# --- 命令组合包 ---
# 专属于此代码的自定义命令组。
commands:
basic_stuff:
- "say Welcome %player%!"
- "give %player% apple 5"
- "weight: 10" # 当 type 为 DRAW 时使用(权重越高 = 几率越大)
lucky_roll:
- "eco give %player% %random-50-100%"
- "msg %player% &aYou got some lucky cash!"
- "weight: 5"
# --- 物品袋 (Sacks) ---
# 在 'sacks' 文件夹中定义的物品。格式:"sackname:weight"
# 如果 type 为 ALL,则忽略权重。
sacks:
- starter: 1
- miner: 1
# --- 预设奖励 (Premades) ---
# 在 'premades.yml' 中定义的复用奖励。格式:"premadename:weight"
premades:
- vip_rank: 1
- money_small: 2
可配置音效
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
完全自定义消息
messages:
usage: "&c用法: /redeem <code>"
not-exist: "&c此代码不存在!"
blacklisted: "&c您不允许兑换此代码。"
already-used: "&e您已经兑换过此代码。"
redeem-success: "&a成功兑换代码!"
reload-success: "&a所有配置文件已重新加载!"
no-permission: "&c您没有使用此功能的权限。"
code-exists: "&c代码已存在!"
code-created: "&a创建新代码: %code%"
code-removed: "&a移除代码: %code%"
reward-added: "&a向 %code% 添加奖励,ID 为 %id%"
reward-removed: "&a移除奖励 ID %id%"
reward-not-found: "&c该奖励 ID 不存在!"
invalid-reward-id: "&c无效的奖励 ID!"
command-usage: "&c用法: /redeemcodes <command> [arguments]"
unknown-action: "&c未知操作: %action%"
code-disabled: "&c此代码当前已禁用。"
out-of-stock: "&c此代码已售罄!"
code-expired: "&c此代码已过期。"
要求
- Minecraft 1.8.8+
- 服务端软件:Paper, Purpur, Spigot, Bukkit, Folia
为什么选择 RedeemCodes?
无论您是组织活动、赠品抽奖、忠诚度计划还是简单的玩家奖励,RedeemCodes 都提供了一种无缝、轻量且高度可定制的方式来增强您的服务器社区互动。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
使床在所有维度中爆炸的模组
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
评论 0
登录后参与评分
还没有评论,来抢沙发吧