自定义战利品箱

Custom Lootbox

从服务器中的任何物品创建自定义战利品箱。配置概率、物品数量，并向玩家分发钥匙。

---

🎁 它的功能是什么？

Custom Lootbox 允许服务器管理员使用简单命令在世界任何地方放置战利品箱方块。每个战利品箱包含一个可配置的物品池，每个物品都有单独的权重和数量。玩家使用钥匙打开它们，并通过烟花庆祝获得随机奖励。

---

✨ 特性

• 使用 /lootbox create <x> <y> <z> 在任何位置放置战利品箱
• 可视化编辑器，包含 3 个标签页：物品、配置 和 概率
• 直接从你的背包将任何物品添加至战利品箱池
• 为每个物品单独设置权重（概率）和数量
• 每个物品的实时百分比显示
• 生成并向玩家分发钥匙 —— 每次开启消耗一把
• 钥匙支持物品堆叠：在创造模式下复制以分发
• 每个战利品箱具有唯一的 UUID —— 钥匙仅在其对应的战利品箱上有效
• 战利品箱在生存模式下不可破坏 —— 只有创造模式玩家才能拆除
• 每次开启时触发烟花效果
• 兼容任何模组的物品（Create、Cobblemon、Apotheosis 等）
• 支持自定义物品名称和 NBT 数据

---

🔧 需求

Minecraft	1.21.1
Mod 加载器	NeoForge 21.1.x
运行端	两端都需要（服务端和客户端必须安装）

无需其他模组。

---

🚀 如何使用

1. 放置战利品箱

需要管理员权限（等级 2）：

/lootbox create <x> <y> <z>

2. 配置它

在创造模式下，Shift + 右键点击战利品箱以打开编辑器。

物品标签页 —— 点击背包中的任意物品（左侧）将其添加至战利品箱池（右侧）。点击池中的物品可将其移除。

配置标签页 —— 设置战利品箱的显示名称。

概率标签页 —— 点击任意行以编辑其权重和数量。权重越高 = 概率越大。% 列会实时更新。

3. 获取钥匙

在编辑器中点击 "获取钥匙" 以获取该战利品箱的一把钥匙。在创造模式下复制它以分发给玩家。

4. 打开战利品箱

玩家右键点击战利品箱，同时手持对应的钥匙。钥匙被消耗，授予随机物品，并从方块处发射烟花。

---

⚙️ 概率系统

所有物品默认权重为 1.0（概率均等）。你可以为每个物品设置任意正小数。

示例：

物品	权重	概率
钻石	0.5	10%
金锭	2.0	40%
铁锭	2.5	50%

战利品箱可无限次打开 —— 除非你编辑它们，否则概率永远不会改变。

---

🔒 权限

操作	要求
放置战利品箱 (/lootbox create)	OP 等级 2
编辑战利品箱（Shift + 右键点击）	创造模式
拆除战利品箱	仅限创造模式
使用钥匙打开战利品箱	任何玩家

---

为 NeoForge 1.21.1 制作