RedeemMaster
RedeemMaster 是一个轻量级、无依赖的推荐与里程碑奖励框架,专为运行在 Paper、Purpur 或 Spigot 上的 Minecraft 1.21+ 网络服务器打造。
RedeemMaster 避免了硬编码经济插件或宝箱插件的 API,而是通过占位符令牌(<player>、<owner>、<count>)执行可配置的控制台命令。这使得你能够在任何经济、代币或宝箱插件(Vault、EssentialsX、PlayerPoints、ExcellentCrates)上触发奖励,而无需额外的软依赖。
⚡ 主要特性
- 零外部依赖: 原生 JVM 执行,直接通过服务器控制台命令分发奖励。
- 双层反小号保护:
- IP / 子网锁定: 防止同一网络或 IP 下的玩家领取彼此的推荐码。
- 游戏时长要求门控: 在允许兑换代码之前,使用原生统计数据(
PLAY_ONE_MINUTE)验证活跃游戏时间。
- 灵活的奖励引擎:
- 被推荐人奖励: 新用户在使用代码时获得的初始礼包。
- 线性主人奖励: 每成功推荐一人,向代码所有者发放固定奖励。
- 里程碑奖励: 支持循环触发(
EVERY_X,例如每第 5 次邀请)和一次性静态里程碑(EXACT,例如第 25 次邀请)。
- 高性能缓存: 使用反向 UUID 哈希映射实现 O(1) 运行时代码查找,底层由简单的扁平文件 YAML 存储(
invite.yml)支持。
- Geyser 与 Floodgate 支持: 兼容 Bedrock 玩家前缀(例如
.PlayerName)和离线 UUID 追踪。
? 命令与权限
根命令: /redeemmaster
别名: /redeem、/code、/ref
| 命令 |
权限 |
描述 |
/redeem <code> |
redeemmaster.use |
兑换有效的推荐码以获取初始奖励。 |
/redeem create [code] |
redeemmaster.use |
生成自定义的字母数字代码(3–12 个字符)或随机的 6 位代码。 |
/redeem info <player> |
redeemmaster.admin |
查看玩家的推荐统计信息、创建者 IP 和推荐数量。 |
/redeem revoke <player> |
redeemmaster.admin |
停用有效的推荐码。 |
/redeem reactivate <player> |
redeemmaster.admin |
重新启用已停用的推荐码。 |
/redeem verify <player> [qty] |
redeemmaster.admin |
强制验证待处理的推荐并触发里程碑检查。 |
/redeem reload |
redeemmaster.admin |
热重载配置文件和内存缓存。 |
⚙️ 配置示例
settings:
anti-alt:
prevent-same-ip: true
min-playtime-minutes: 15
referee-rewards:
- "[console]eco give <player> 5000"
- "[console]crates key give <player> starter 1"
owner-per-referral-rewards:
- "[console]points give <owner> 1"
owner-milestones:
5:
type: "EVERY_X" # 在第 5、10、15、20... 次时触发
commands:
- "[console]crates key give <owner> rare 1"
- "[console]broadcast &a[RedeemMaster] &e<owner> &7reached &b<count> &7referrals and earned a &6Rare Key&7!"
25:
type: "EXACT" # 在第 25 次推荐时的一次性大奖
commands:
- "[console]points give <owner> 25"
- "[console]crates key give <owner> legendary 1"
RedeemMaster
RedeemMaster is a lightweight, dependency-free referral and milestone reward framework built for Minecraft 1.21+ networks running Paper, Purpur, or Spigot.
Instead of hard-coding economy or crate plugin APIs, RedeemMaster executes configurable console commands using placeholder tokens (<player>, <owner>, <count>). This lets you trigger rewards across any economy, token, or crate plugin (Vault, EssentialsX, PlayerPoints, ExcellentCrates) without needing additional soft-dependencies.
⚡ Key Features
- Zero External Dependencies: Native JVM execution that dispatches rewards directly via server console commands.
- Dual-Layer Anti-Alt Protection:
- IP / Subnet Lock: Prevents players on the same network or IP from claiming each other's referral codes.
- Playtime Requirement Gate: Validates active gameplay time using native statistics (
PLAY_ONE_MINUTE) before allowing code redemptions.
- Flexible Reward Engine:
- Referee Rewards: Starter packages given to the newcomer upon code usage.
- Linear Owner Rewards: Fixed payouts given to the code owner for every referral.
- Milestone Rewards: Supports both cyclic triggers (
EVERY_X, e.g., every 5th invite) and one-time static milestones (EXACT, e.g., 25th invite).
- High-Performance Caching: Uses inverted UUID hash maps for O(1) runtime code lookups backed by simple flat-file YAML storage (
invite.yml).
- Geyser & Floodgate Support: Compatible with Bedrock player prefixes (e.g.,
.PlayerName) and offline UUID tracking.
? Commands & Permissions
Root Command: /redeemmaster
Aliases: /redeem, /code, /ref
| Command |
Permission |
Description |
/redeem <code> |
redeemmaster.use |
Redeems an active referral code for starter bonuses. |
/redeem create [code] |
redeemmaster.use |
Generates a custom alphanumeric code (3–12 chars) or a random 6-character code. |
/redeem info <player> |
redeemmaster.admin |
Inspects player referral stats, creator IP, and referral counts. |
/redeem revoke <player> |
redeemmaster.admin |
Deactivates an active referral code. |
/redeem reactivate <player> |
redeemmaster.admin |
Re-enables a revoked referral code. |
/redeem verify <player> [qty] |
redeemmaster.admin |
Force-verifies pending referrals and triggers milestone checks. |
/redeem reload |
redeemmaster.admin |
Hot-reloads configuration files and memory caches. |
⚙️ Configuration Example
settings:
anti-alt:
prevent-same-ip: true
min-playtime-minutes: 15
referee-rewards:
- "[console]eco give <player> 5000"
- "[console]crates key give <player> starter 1"
owner-per-referral-rewards:
- "[console]points give <owner> 1"
owner-milestones:
5:
type: "EVERY_X" # Triggers at 5, 10, 15, 20...
commands:
- "[console]crates key give <owner> rare 1"
- "[console]broadcast &a[RedeemMaster] &e<owner> &7reached &b<count> &7referrals and earned a &6Rare Key&7!"
25:
type: "EXACT" # One-time grand bonus at 25 referrals
commands:
- "[console]points give <owner> 25"
- "[console]crates key give <owner> legendary 1"
评论 0
登录后参与评分
还没有评论,来抢沙发吧