[UNSUPPORTED] T-Vouchers - [不支持] T-Vouchers - 自定义代金券插件

T-Vouchers 是一款功能强大的自定义礼券插件，允许你创建、管理和分发带有自定义属性与效果的礼券。通过简单的配置文件，你可以轻松定义礼券的外观、命令、权限等，并通过直观的GUI界面进行管理。

💡核心功能

• 完全自定义礼券：在 vouchers.yml 中创建礼券，自定义其显示名称、材质、附魔、描述文本等。
• GUI 管理系统：通过图形界面创建、编辑、删除礼券，操作直观便捷。
• Hex 颜色支持：在礼券名称、描述及配置信息中使用十六进制颜色代码。
• PlaceholderAPI 支持：在消息和礼券属性中使用各类占位符。
• 自定义头颅支持：将礼券材质设置为自定义玩家头颅。
• 使用确认界面：可配置在兑换礼券前弹出确认界面，防止误操作。
• 物品标签支持：可为礼券添加如隐藏附魔等物品标签。
• 权限控制：可为每个礼券设置独立的兑换权限。
• 兑换次数限制：限制每个礼券可被兑换的总次数。
• Discord 集成：当礼券被兑换时，可通过 Webhook 发送通知到 Discord。
• 日志系统：记录礼券兑换日志，支持查看和清理今日日志。

🎮命令列表

• /voucher list - 列出所有已创建的礼券。
• /voucher give <voucher_name> <player_name> [amount] - 将指定礼券给予玩家，数量可选。
• /voucher gui - 打开礼券管理 GUI 界面。
• /voucher reload - 重载插件配置文件。
• /voucher giveall <voucher_name> [amount] - 将指定礼券给予所有在线玩家，数量可选。

🔧权限

默认权限为 timsixth.voucher。你可以在 config.yml 中修改此权限节点。

内部占位符

你可以在配置的消息或 Discord Webhook 消息中使用以下占位符：

• {NICK} - 获取玩家名称。
• {PLAYER_NAME} - 获取玩家名称（仅在一个特定消息中使用）。
• {VOUCHER_DISPLAY_NAME} - 获取礼券的显示名称（含颜色代码）。
• {VOUCHER_DISPLAY_NAME_WITH_STRIPED_COLORS} - 获取礼券的显示名称（不含颜色代码）。
• {PLUGIN_VERSION} - 获取插件版本。
• {PLUGIN_NAME} - 获取插件名称。

✨配置文件概览

config.yml

主要配置文件，用于设置全局权限、GUI参数、消息文本和 Discord Webhook 集成。

• permission: 设置使用插件命令的基础权限。
• gui_size, vouchers_gui_name: 控制GUI界面的大小和标题。
• use_confirmation_menu: 设置为 true 以启用兑换确认界面。
• discord.webhook: 配置 Discord Webhook 的 URL、名称、头像及消息格式。
• messages: 自定义插件运行时发送的所有提示消息。

vouchers.yml

在此文件中定义所有具体的礼券。

• vouchers: 根节点，其下每个键（如 test）代表一个礼券ID。
• commands: 礼券被兑换时执行的命令列表，可使用 {NICK} 占位符。
• displayname: 礼券在物品栏中的显示名称（支持颜色代码）。
• material: 礼券的材质（必须大写，如 PAPER）。
• permission: 兑换此礼券所需的权限。
• enchants: 礼券自带的附魔列表，格式为 '附魔名;等级'。
• lore: 礼券的描述文本，每行以 | 分隔。
• customHead.textures: 若使用自定义头颅，在此处设置头颅材质 Base64 编码。
• redeem_times: 礼券可被兑换的总次数，-1 为无限制，0 为禁止兑换。
• item_flags: 应用于礼券的物品标签，如 HIDE_ENCHANTS。

guis.yml

此文件定义了所有图形用户界面的布局和功能。

• guis: 根节点，其下每个键（如 main, voucherCreator）代表一个GUI界面。
• 每个界面可定义 displayname（标题）、size（大小）、empty_slots（空白槽位填充物）和 slots（功能槽位）。
• 每个槽位可设置 material（材质）、displayname（显示名）、lore（描述）和 click_action（点击动作）。
• click_action 的 type 定义了点击后的行为，如 OPEN_MENU（打开菜单）、CREATE_VOUCHER（创建礼券）等，args 为传递给动作的参数。

❓使用提示

• 创建自定义头颅礼券时，material 项仍需填写（如 PAPER），但实际显示由 textures 字段决定。
• 在 vouchers.yml 中，礼券ID（如 test）建议只使用字母和数字，作为命令中引用的名称。
• 配置 lore 或多项 commands 时，使用 | 字符来分隔不同行或不同命令。
• 修改配置文件后，可使用 /voucher reload 命令重载，无需重启服务器。