战利品宝箱

概述

Loot Chest 插件为你的 Hytale 服务器带来了令人兴奋的奖励系统！玩家可以开启虚拟的 loot chests，伴随着令人满意的赌场风格轮盘动画，奖励选项会滚动展示，最终停在玩家的奖品上。

服务器管理员完全掌控：

• 每个稀有度等级中出现的物品
• 每位玩家可开启的箱子数量
• 每种奖励的掉落概率

完美适用于小游戏、生存服务器、奖励系统，或是任何希望增加引人入胜的战利品机制的服务器！

---

功能

轮盘动画

• 流畅的滚动动画，展示 9 个物品槽位
• 物品在停止于最终奖励前会逐渐减速
• 旋转过程中伴有令人满意的音效
• 清晰的自定义界面，不影响游戏体验

五个稀有度等级

每个等级拥有独立的战利品表，可自定义奖励：

等级	颜色	描述
普通	灰色	基础物品，掉落率较高
罕见	绿色	中级物品
稀有	蓝色	较少见的物品
史诗	紫色	有价值的物品
传说	金色	最稀有最有价值的奖励

玩家平衡系统

• 每位玩家拥有每个稀有度的个人 loot chest 数量
• 平衡数据在服务器重启后依然保留
• 管理员可以给予或移除玩家的箱子
• 玩家随时可以查看自己的余额

管理面板

• 漂亮的游戏内用户界面，用于配置战利品表
• 只需几次点击即可添加、编辑或移除奖励
• 使用内置搜索栏搜索所有可用物品
• 设置精确的掉落概率（基于百分比系统）
• 在专用管理面板中查看所有玩家余额

持久化存储

• 所有配置保存为 JSON 文件
• 玩家余额按玩家（基于 UUID）保存
• 服务器关闭时自动保存
• 易于在不同服务器间备份和迁移

---

命令

玩家命令

命令	描述
/lootchest <稀有度>	开启一个指定稀有度的 loot chest
/lc <稀有度>	/lootchest 的别名
/lootbalance	显示你所有稀有度的 loot chest 余额
/lb	/lootbalance 的别名

管理员命令

命令	权限	描述
/lootgive <玩家> <稀有度> <数量>	lootchest.admin	给予玩家 loot chests
/lg <玩家> <稀有度> <数量>	lootchest.admin	/lootgive 的别名
/lootadmin <稀有度>	lootchest.admin	打开战利品表配置界面
/lootbalances	lootchest.admin	在界面中查看所有玩家余额
/lbs	lootchest.admin	/lootbalances 的别名
/lootbalance <玩家>	lootchest.admin	查看另一名玩家的余额

---

权限

权限	描述
lootchest.admin	访问所有管理员命令（给予箱子、配置战利品表、查看所有余额）

注意：开启 loot chests (/lootchest) 不需要任何权限——玩家只需在余额中拥有箱子即可。

---

配置

战利品表文件

位于 plugins/LootChestPlugin/ 目录：

lootchest_common.json
lootchest_uncommon.json
lootchest_rare.json
lootchest_epic.json
lootchest_legendary.json

战利品表格式

{
  "rewards": [
    {
      "itemId": "Food_Bread",
      "minQuantity": 1,
      "maxQuantity": 5,
      "chance": 15.0
    },
    {
      "itemId": "Ore_Iron",
      "minQuantity": 1,
      "maxQuantity": 3,
      "chance": 10.0
    }
  ]
}

玩家余额文件

位于 plugins/LootChestPlugin/balances/ 目录：

<玩家-uuid>.json

每个文件存储了玩家的用户名及其每个稀有度的箱子数量。

---

安装

1. 下载插件 JAR 文件
2. 将其放入你的 Hytale 服务器的 plugins 文件夹
3. 启动/重启服务器
4. 使用 /lootadmin <稀有度> 配置战利品表，或直接编辑 JSON 文件
5. 使用 /lootgive <玩家> <稀有度> <数量> 给予玩家箱子

---

使用示例

作为管理员：

/lootgive Steve common 10      → 给予 Steve 10 个普通 loot chest
/lootgive Steve legendary 1    → 给予 Steve 1 个传说 loot chest
/lootadmin rare                → 打开稀有等级配置界面
/lootbalances                  → 查看所有玩家余额

作为玩家：

/lootbalance                   → 查看你的箱子余额
/lootchest common              → 开启一个普通 loot chest
/lc legendary                  → 开启一个传说 loot chest

---

Bug 报告与建议

发现了 Bug 或有建议？随时联系我们！