? 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 团队 维护和发展。请查看我们的频道以获取更新、贡献方式和错误报告。
? UniRedeem
The Ultimate Universal Redeem Code Plugin for Minecraft networks.
Developed with ❤️ by the Univolve team.
UniRedeem is a modern, high-performance, multi-platform redeem code solution. It is built from the ground up to support Spigot, Paper, Purpur, Folia, BungeeCord, and Velocity networks concurrently using a single Universal Jar supporting Minecraft 1.13 through 26.2+ (Chaos Cubed).
✨ Features
- ⚡ Multi-Platform (Universal Jar): Single
.jar file that runs seamlessly on Spigot, Paper, Purpur, Folia, BungeeCord, and Velocity.
- ? Verified Minecraft 26.2 Support: Built with forward-compatible abstractions verified on Minecraft 26.2 (Chaos Cubed) and older versions down to 1.13.
- ? In-Game Admin GUI: Interactive 54-slot chest interface (
/uniredeemadmin gui) to view, manage, and revoke active codes with one click.
- ? Batch / Bulk Code Generator: Generate dozens of unique giveaway keys in one command with
/uniredeemadmin generatebatch.
- ⌨️ Intelligent Tab-Completion: Full auto-completion for all player and administrative commands across all platforms.
- ?️ Anti-Spam & Rate Limiting: Built-in cooldowns (
general.cooldown-seconds) to prevent brute-force code guessing.
- ? Anti-Alt & IP Protection: Optional IP address validation to block players from claiming one-time codes on alternate accounts.
- ? Discord Webhooks: Real-time Discord notifications and embeds for redemptions and admin actions.
- ? Audio & Visual Feedback: Configurable sound effects (
ENTITY_PLAYER_LEVELUP) and on-screen Titles/ActionBars.
- ? Dual-Storage Engine: SQLite (local zero-setup) and MySQL/MariaDB (network synchronization) powered by high-performance HikariCP connection pooling.
- ? Limitation & Expiry System:
- Max Global Uses: Limit how many times a code can be claimed globally.
- Max Uses Per Player: Restrict claims per user (e.g. one-time use codes).
- Expiration (Time-Limits): Expiry dates or countdown durations from code generation.
- Permission Node Requirement: Require players to hold specific permissions to claim a code.
- ⚙️ Multicontext Multi-Command Rewards: Run multiple commands per code across different execution contexts:
[CONSOLE] - Executed by console on the local server.
[PLAYER] - Executed by the player redeeming the code.
[PROXY] - Forwarded via Plugin Messaging and executed on the Proxy console (BungeeCord/Velocity).
- ? Embedded HTTP REST API Server: Connect your website, Discord bot, or store portal using a secure Bearer token JSON API.
- ? Extensive Placeholders: Supports local placeholders and registers natively with PlaceholderAPI (on Bukkit/Paper).
?️ Commands & Permissions
| Command |
Description |
Permission |
Platform |
/redeem <code> |
Redeem a code and claim rewards. |
None (default) |
Bukkit, Bungee, Velocity |
/redeem help |
View player help menu. |
None (default) |
Bukkit, Bungee, Velocity |
/redeem reload |
Reloads plugin configs and database. |
uniredeem.admin |
Bukkit, Bungee, Velocity |
/uniredeemadmin gui |
Open interactive in-game code management GUI. |
uniredeem.admin |
Bukkit, Paper, Purpur |
/uniredeemadmin list |
List all active codes, uses, and expiration dates. |
uniredeem.admin |
Bukkit, Bungee, Velocity |
/uniredeemadmin generate <args> |
Generate a custom redeem code. |
uniredeem.admin |
Bukkit, Bungee, Velocity |
/uniredeemadmin generatebatch <args> |
Generate bulk random codes with a shared reward. |
uniredeem.admin |
Bukkit, Bungee, Velocity |
/uniredeemadmin revoke <code> |
Deletes/revokes a redeem code. |
uniredeem.admin |
Bukkit, Bungee, Velocity |
/uniredeemadmin reload |
Reloads plugin configs and database. |
uniredeem.admin |
Bukkit, Bungee, Velocity |
Generation Examples:
1. Single Code:
/uniredeemadmin generate VIP 50 1 86400 none [CONSOLE] lp user %player_name% parent add vip; [CONSOLE] msg %player_name% Enjoy VIP!
(Generates code VIP with 50 global uses, max 1 use per player, 24-hour expiry, no permission requirement, executing multiple console commands separated by ;)
2. Bulk Giveaway Batch:
/uniredeemadmin generatebatch 20 PROMO 1 1 604800 none [CONSOLE] give %player_name% diamond 10
(Generates 20 unique random keys with prefix PROMO-, 1 global use each, 7-day expiry)
? Embedded REST API
Boots an embedded JSON web server on the port defined in config.yml. Secured using Bearer Token authorization header: Authorization: Bearer <secret-token>
Endpoints
POST /api/generate - Generate code.
{
"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} - Retrieve code validity, remaining uses, and expiry details.
DELETE /api/revoke/{code} - Manually revoke a code.
? Placeholders
Use these variables in commands, messages, or through PlaceholderAPI integration:
- Player Related:
%player_name%, %player_uuid%, %player_ip%, %player_ping%
- Code Related:
%redeem_code%, %code_remaining_uses%, %code_max_uses%, %code_expiry_date%
- Server Related:
%server_time%, %server_date%, %server_name%
? Support & Dev Credits
UniRedeem is maintained and developed by the Univolve team. Please check our channels for updates, contributions, and bug reports.
评论 0
登录后参与评分
还没有评论,来抢沙发吧