UniRedeem

插件

· 作者 miner_bomb

适用于 Spigot、Bungee 和 Velocity 的通用兑换码插件。内置 REST API,支持高级限制功能,并采用 SQLite/MySQL 双存储方案。

0 本站下载 0 关注 更新于 3 个月前

最新 1.1.0 · 26.2 · BungeeCord / Folia

一键开服(送7天)

? UniRedeem

Minecraft 网络服终极通用兑换码插件。 由 Univolve 团队 用 ❤️ 开发。

UniRedeem 是一款现代化、高性能的多平台兑换码解决方案。它从头开始构建,通过单个 Universal Jar(通用 Jar 包)同时支持 Spigot、Paper、Purpur、Folia、BungeeCord 和 Velocity 网络架构,兼容 Minecraft 1.13 至 26.2+(Chaos Cubed)。


✨ 功能特性

  • ⚡ 多平台支持(通用 Jar): 单个 .jar 文件即可在 Spigot、Paper、Purpur、Folia、BungeeCord 和 Velocity 上无缝运行。
  • ? 已验证的 Minecraft 26.2 支持: 采用向前兼容的抽象层构建,已在 Minecraft 26.2(Chaos Cubed)及更早版本(低至 1.13)中验证。
  • ? 游戏内管理 GUI: 交互式 54 格箱子界面(/uniredeemadmin gui),可一键查看、管理和撤销激活中的兑换码。
  • ? 批量/批量代码生成器: 使用 /uniredeemadmin generatebatch 命令一次性生成数十个唯一的赠送密钥。
  • ⌨️ 智能 Tab 补全: 在所有平台上对所有玩家和管理命令提供完整的自动补全功能。
  • ?️ 防刷与速率限制: 内置冷却时间(general.cooldown-seconds),防止暴力猜测兑换码。
  • ? 防小号与 IP 保护: 可选的 IP 地址验证功能,阻止玩家在备用账号上领取一次性兑换码。
  • ? Discord Webhooks: 实时 Discord 通知和嵌入消息,用于兑换记录和管理员操作。
  • ? 音频与视觉反馈: 可配置音效(ENTITY_PLAYER_LEVELUP)以及屏幕上的标题(Titles)和操作栏提示(ActionBars)。
  • ? 双存储引擎: SQLite(本地零配置)和 MySQL/MariaDB(网络同步),均由高性能 HikariCP 连接池驱动。
  • ? 限制与过期系统:
    • 最大全局使用次数: 限制一个兑换码在全球范围内可被领取的总次数。
    • 每位玩家最大使用次数: 限制每个用户的领取次数(例如仅限一次使用的兑换码)。
    • 过期时间(时限): 从兑换码生成起算的到期日期或倒计时时长。
    • 权限节点要求: 要求玩家拥有特定权限才能领取兑换码。
  • ⚙️ 多上下文多命令奖励: 针对不同执行上下文,为每个兑换码运行多条命令:
    • [CONSOLE] - 由控制台在本地服务器执行。
    • [PLAYER] - 由领取兑换码的玩家执行。
    • [PROXY] - 通过插件消息转发并在代理控制台(BungeeCord/Velocity)上执行。
  • ? 嵌入式 HTTP REST API 服务器: 使用安全的 Bearer Token JSON API 连接你的网站、Discord 机器人或商店门户。
  • ? 丰富的占位符: 支持本地占位符,并原生注册 PlaceholderAPI(在 Bukkit/Paper 上)。

?️ 命令与权限

命令 描述 权限 平台
/redeem <code> 兑换代码并领取奖励。 无(默认) Bukkit, Bungee, Velocity
/redeem help 查看玩家帮助菜单。 无(默认) Bukkit, Bungee, Velocity
/redeem reload 重新加载插件配置和数据库。 uniredeem.admin Bukkit, Bungee, Velocity
/uniredeemadmin gui 打开交互式游戏内代码管理 GUI。 uniredeem.admin Bukkit, Paper, Purpur
/uniredeemadmin list 列出所有活跃代码、使用次数和过期日期。 uniredeem.admin Bukkit, Bungee, Velocity
/uniredeemadmin generate <args> 生成自定义兑换码。 uniredeem.admin Bukkit, Bungee, Velocity
/uniredeemadmin generatebatch <args> 生成具有共享奖励的大量随机代码。 uniredeem.admin Bukkit, Bungee, Velocity
/uniredeemadmin revoke <code> 删除/撤销兑换码。 uniredeem.admin Bukkit, Bungee, Velocity
/uniredeemadmin reload 重新加载插件配置和数据库。 uniredeem.admin Bukkit, Bungee, Velocity

生成示例:

1. 单个代码:

/uniredeemadmin generate VIP 50 1 86400 none [CONSOLE] lp user %player_name% parent add vip; [CONSOLE] msg %player_name% Enjoy VIP!

(生成代码 VIP,全局使用次数 50,每位玩家最多 1 次,24 小时过期,无需权限要求,执行由 ; 分隔的多个控制台命令)

2. 批量赠送批次:

/uniredeemadmin generatebatch 20 PROMO 1 1 604800 none [CONSOLE] give %player_name% diamond 10

(生成 20 个带有前缀 PROMO- 的唯一随机密钥,每个全局使用 1 次,7 天过期)


? 嵌入式 REST API

在 config.yml 定义的端口上启动嵌入式 JSON Web 服务器。使用 Bearer Token 授权头进行安全保护:Authorization: Bearer <secret-token>

端点

  • POST /api/generate - 生成代码。
    {
      "code": "SUMMER2026",
      "maxGlobalUses": 100,
      "maxUsesPerPlayer": 1,
      "durationSeconds": 604800,
      "permission": "uniredeem.claim",
      "commands": [
        "[CONSOLE] give %player_name% gold_ingot 10",
        "[PLAYER] say I just claimed a Summer Code!"
      ]
    }
    
  • GET /api/status/{code} - 获取代码有效性、剩余使用次数和过期详情。
  • DELETE /api/revoke/{code} - 手动撤销代码。

? 占位符

在命令、消息或通过 PlaceholderAPI 集成中使用这些变量:

  • 玩家相关: %player_name%, %player_uuid%, %player_ip%, %player_ping%
  • 代码相关: %redeem_code%, %code_remaining_uses%, %code_max_uses%, %code_expiry_date%
  • 服务器相关: %server_time%, %server_date%, %server_name%

? 支持与开发致谢

UniRedeem 由 Univolve 团队 维护和发展。请查看我们的频道以获取更新、贡献方式和错误报告。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源