HTVouchers

HTVouchers

Discord : https://discord.gg/y6RemcjSaD

一个专为 Hytale 服务器设计的兑换券/箱柜钥匙系统。创建自定义的可兑换物品，支持加权随机奖励、声音/粒子特效以及完整的游戏内 UI 编辑器。兑换券从现有游戏物品中克隆而来，并赋予自定义交互、名称、描述和战利品表——所有配置无需重启服务器即可生效。

命令

命令	用法	描述
/voucher give	/voucher give <玩家> <兑换券> [数量]	给予玩家兑换券物品
/voucher list	/voucher list	列出所有已配置的兑换券
/voucher info	/voucher info <兑换券>	显示兑换券详情和奖励概率
/voucher preview	/voucher preview <兑换券>	显示带百分比条的奖励表
/voucher reload	/voucher reload	从磁盘重载配置并重新注册物品
/voucher ui	/voucher ui	打开游戏内兑换券编辑器 GUI

别名： /v（例如 /v give Player1 htvouchers:common_crate 3）

权限

权限	描述
htvouchers.admin	所有管理员命令的基础权限
htvouchers.admin.give	给予玩家兑换券
htvouchers.admin.list	列出所有已配置的兑换券
htvouchers.admin.info	查看兑换券详情
htvouchers.admin.preview	预览奖励表
htvouchers.admin.reload	重载兑换券配置
htvouchers.admin.ui	打开兑换券编辑器 UI

特性

• 自定义物品 — 克隆任何基础游戏物品，拥有自定义 ID、显示名称、描述、品质/稀有度和堆叠数量
• 加权奖励 — 每个兑换券都有一个战利品表，支持加权随机选择；每次使用支持多次抽取
• 命令奖励 — 奖励可执行服务器命令（或使用 player: 前缀执行玩家命令），支持 {player} 占位符
• 特效 — 兑换时支持可配置的声音和粒子效果
• 冷却时间 — 每个兑换券在使用之间有时间间隔
• 广播消息 — 可选择在兑换时发布全服公告，支持 {player}、{voucher}、{reward} 占位符
• 游戏内 UI 编辑器 — 完整的 GUI，用于创建/编辑/删除兑换券、管理奖励、向玩家或所有在线玩家发放物品
• 富文本描述 — 多行物品描述，支持 <color is="#hex">text</color> 语法
• 热重载 — 配置更改立即应用，无需重启服务器

配置

兑换券存储在 vouchers.json 文件中，首次运行时自动生成示例配置。通过 UI 编辑器进行的所有更改都会自动保存。