RankVouchers - 等级凭证插件

欢迎使用 Voucher 插件！这是一款轻量、开源且易于配置的兑换券插件，支持 PlaceholderAPI 和多种奖励动作，为你的服务器提供灵活的奖励发放方案。

💡核心特性

• 开源与轻量：代码完全开源，性能高效，对服务器负担小。
• 易于配置：提供直观的配置文件，设置简单快捷。
• 面向对象：采用面向对象设计，兼容 Java 8 及以上版本。
• 开发者友好：提供完整的开发者 API，便于二次开发与集成。

🎮功能亮点

奖励与物品

• 基于动作的奖励：可配置多种奖励动作，如发送消息、执行命令、播放音效等。
• 累计奖励：支持设置累计使用兑换券可获得的特殊奖励。
• 物品属性：可为兑换券物品添加属性，例如不可破坏 (unbreakable)、发光 (glow) 等。
• 物品标志支持：全面支持 Minecraft 物品标志 (Item Flags)。
• 权限要求：可为每张兑换券设置使用权限，实现精细化管理。

集成与兼容

• PlaceholderAPI 支持：完美支持 PlaceholderAPI，可在奖励消息中使用各类占位符。
• 完全可定制：从兑换券名称、描述到奖励内容，一切皆可自定义。
• 名称补全：在命令中支持玩家名和兑换券名称的 Tab 键自动补全。

✨奖励动作类型

奖励动作需在配置文件中按指定格式编写。以下是支持的所有动作类型：

• [Message] <消息内容> - 向使用玩家发送一条私人消息。
• [Broadcast] <消息内容> - 向全服广播一条消息。
• [PlayerCommand] <命令> - 让使用玩家以玩家身份执行一条命令。
• [ConsoleCommand] <命令> - 让控制台执行一条命令。
• [Sound] <音效名> - 给使用玩家播放一个音效。
• [Title] <标题>;<副标题> - 给使用玩家显示一个标题（副标题为可选）。
• [Subtitle] <副标题> - 给使用玩家显示一个副标题。
• [ActionBar] <消息内容> - 在使用玩家的动作栏显示消息。

使用 PlaceholderAPI

如果你安装了 PlaceholderAPI，可以在上述所有 <消息内容> 中使用其占位符来丰富文本。

**示例**

[Broadcast] &b&lVoucher: &f%player_name% &7has used a voucher with &a%server_online% &7players online.

此条广播消息会动态显示玩家名和服务器在线人数。

🔧管理员命令

• /voucher help - 显示插件帮助信息。
• /voucher reload - 重载插件的配置文件。
• /voucher give <玩家名> <兑换券名称> [数量] - 给予指定玩家一定数量的特定兑换券。
• /voucher giveall <兑换券名称> [数量] - 给予在线所有玩家一定数量的特定兑换券。
• /voucher list - 列出所有已配置的兑换券。

❓体验与获取

想亲眼看看这款插件的效果吗？欢迎加入我们的测试服务器！

实时体验服务器 IP：play.minespira.net