稀有宝箱

✨ RarityChests 是什么？

RarityChests 为 Minecraft 1.21.1 (NeoForge) 添加了 5 个等级的宝箱：铜 → 铁 → 绿宝石 → 钻石 → 下界合金。它们会在世界中自然生成，在黑暗中发光，每个宝箱都拥有独一无二的战利品——没有两个宝箱会包含相同的物品。

要打开宝箱，你需要对应稀有度的钥匙。钥匙有使用次数限制，可以通过合成、在宝箱中找到，或由管理员给予。完全可配置，无需重新编译。

🎮 特性

• 🗝️ 5 个宝箱等级 + 5 把对应钥匙（铜/铁/绿宝石/钻石/下界合金）
• 🌍 混合生成系统：新区块 + 玩家周围（可分别开关）
• 🎲 每个宝箱的独特战利品：从 JSON 表（每等级一个文件）中抽取 1–5 个不同物品
• 🔑 每等级钥匙拥有有限使用次数（例如铜 = 5，下界合金 = 1），可合成
• 🔄 重生系统：被搜刮的宝箱会在可配置延迟后于别处重生（全局 + 按维度，以秒为单位）
• 💨 消失：宝箱在关闭 X 秒后消失，并伴随特效
• 📦 可放置宝箱（v1.1+）：永久的钥匙↔战利品分发器——每位玩家抽取自己的个人战利品（模式：once / cooldown / unlimited）
• 📣 发现钻石/下界合金宝箱时向服务器广播（可开关）
• 🌐 内置英语 + 法语，配置自动重载，管理员命令

🕹️ 如何游玩

1. 探索——宝箱生成时会发光并散发粒子。
2. 携带同等级的钥匙（在提示框中查看剩余次数）。
3. 右键打开：生成你的独特 1–5 件物品战利品。
4. 钥匙消耗 1 次使用次数。通过合成、从宝箱战利品中获取（每个等级可掉落下一等级的钥匙），或使用 /rc givekey 获取新钥匙。
5. 被搜刮的宝箱消失 → 延迟后在别处重生一个新的。

⚙️ 配置

所有内容都位于 config/raritychests-common.toml（保存时自动重载，删除后自动以默认值重建，自动格式化以便阅读）：

• 生成开关 + 生成率、稀有度权重、维度白名单
• 以秒为单位的重生延迟（全局 + 按维度覆盖）
• 消失计时器、每等级所需钥匙 + 每把钥匙的使用次数
• 宝箱/钥匙显示名称、粒子、音效、广播
• 放置宝箱的战利品模式（once / cooldown / unlimited）

🎁 战利品表

每个宝箱在 config/raritychests/loot/ 中对应一个 JSON 文件（copper.json …… netherite.json），使用 /rc reload 实时重载。任何原版或模组物品：

{
  "rolls": { "min": 1, "max": 5 },
  "uniquePick": true,
  "items": [
    { "id": "minecraft:diamond", "min": 1, "max": 3, "chance": 0.9 },
    { "id": "raritychests:netherite_key", "min": 1, "max": 1, "chance": 0.12 }
  ]
}

⌨️ 管理员命令（/rc，权限等级 2）

命令	效果
/rc 或 /rc help	显示帮助
/rc spawn <tier> [x y z]	生成一个宝箱
/rc givekey <tier> [player] [count]	给予新的钥匙
/rc locate <tier>	定位该等级最近的宝箱
/rc list	列出活跃宝箱 + 待重生宝箱
/rc reload	重载战利品 JSON 表
/rc clear [dimension]	移除活跃宝箱（不掉落，不重生）
/rc resetloot <x> <y> <z>	重置一个放置宝箱（清除战利品 + 玩家记录）

📦 需求

• Minecraft 1.21.1 + NeoForge 21.1.249（或更新的 21.1.x）
• Java 21
• ⚠️ 服务器和客户端必须使用相同的 .jar 和相同版本（NeoForge 1.21 对于添加方块/物品的模组没有仅服务端模式）

❓ 常见问题

玩家被立即踢出 / 出现 "registry data" 错误？ 他们必须在其整合包中安装相同的 RarityChests .jar（参见需求）。

我删除了配置文件，一切都坏了？ 不会——raritychests-common.toml 会在下次启动时以默认值重建。

我可以在战利品中使用模组物品吗？ 可以："othermod:super_sword"。未知的 id 会被跳过并在控制台发出警告，绝不会崩溃。

🇫🇷 法语版本

✨ RarityChests 是什么？

RarityChests 为 Minecraft 1.21.1 (NeoForge) 添加了 5 个等级的宝箱：铜 → 铁 → 绿宝石 → 钻石 → 下界合金。它们会在世界中自然生成，在黑暗中发光，每个宝箱都包含独一无二的战利品——两个宝箱永远不会拥有相同的内容。

要打开宝箱，需要相同稀有度的钥匙。钥匙有有限的使用次数，可以合成、在宝箱中找到，或通过管理员命令给予。100% 可配置，无需重新编译。

🎮 功能

• 🗝️ 5 个宝箱等级 + 5 把对应钥匙（铜/铁/绿宝石/钻石/下界合金）
• 🌍 混合生成：新区块 + 玩家周围（每个系统可单独启用）
• 🎲 每个宝箱的独特战利品：从 JSON 表（每等级一个文件）中抽取 1 到 5 个不同物品
• 🔑 每等级钥匙拥有有限使用次数（例如：铜 = 5，下界合金 = 1），可合成
• 🔄 重生系统：被搜刮的宝箱会在可配置延迟后于别处重新出现（全局 + 按维度，以秒为单位）
• 💨 消失：宝箱在关闭 X 秒后消失，并伴随特效
• 📦 放置宝箱（v1.1+）：永久的钥匙↔战利品分发器——每位玩家抽取自己的个人战利品（模式：once / cooldown / unlimited）
• 📣 发现钻石/下界合金宝箱时向服务器广播（可关闭）
• 🌐 内置英语 + 法语，配置热重载，管理员命令

🕹️ 如何游玩

1. 探索——宝箱生成时会发光并散发粒子。
2. 准备好同等级的钥匙（提示框中显示剩余次数）。
3. 右键打开：生成你的独特 1 到 5 件物品战利品。
4. 钥匙消耗 1 次使用次数。通过合成、从宝箱战利品中获取（每个等级可给予下一等级的钥匙），或使用 /rc givekey 获取新钥匙。
5. 被搜刮的宝箱消失 → 延迟后在别处重生一个新的。

⚙️ 配置

所有内容都在 config/raritychests-common.toml 中设置（每次保存时重载，删除后以默认值重建，自动格式化）：

• 生成开关 + 生成率、稀有度权重、允许的维度
• 以秒为单位的重生延迟（全局 + 按维度覆盖）
• 消失计时器、每等级所需钥匙 + 每把钥匙的使用次数
• 宝箱/钥匙显示名称、粒子、音效、广播
• 放置宝箱的战利品模式（once / cooldown / unlimited）

🎁 战利品表

每个宝箱在 config/raritychests/loot/ 中对应一个 JSON 文件（copper.json …… netherite.json），使用 /rc reload 在游戏中重载。任何原版或模组物品：

{
  "rolls": { "min": 1, "max": 5 },
  "uniquePick": true,
  "items": [
    { "id": "minecraft:diamond", "min": 1, "max": 3, "chance": 0.9 },
    { "id": "raritychests:netherite_key", "min": 1, "max": 1, "chance": 0.12 }
  ]
}

⌨️ 管理员命令（/rc，权限等级 2）

命令	效果
/rc 或 /rc help	显示帮助
/rc spawn <tier> [x y z]	生成一个宝箱
/rc givekey <tier> [joueur] [nombre]	给予新的钥匙
/rc locate <tier>	该等级最近的宝箱
/rc list	活跃宝箱 + 待重生宝箱
/rc reload	重载战利品 JSON 表
/rc clear [dimension]	移除活跃宝箱（不掉落，不重生）
/rc resetloot <x> <y> <z>	重置一个放置宝箱（清除战利品 + 玩家记录）

📦 前置需求

• Minecraft 1.21.1 + NeoForge 21.1.249（或更新的 21.1.x）
• Java 21
• ⚠️ 服务器和客户端必须使用相同的 .jar 和相同版本（NeoForge 1.21 不再允许添加方块/物品的模组使用仅服务端模式）

❓ 常见问题

玩家被立即踢出 / "registry data" 错误？ 他们必须在其整合包中安装相同的 RarityChests .jar（参见前置需求）。

我删除了配置文件，一切都坏了？ 不会——raritychests-common.toml 会在下次启动时以默认值重建。

我可以把模组物品放进战利品中吗？ 可以："othermod:epee_op"。未知的 id 会被跳过并在控制台发出警告，绝不会崩溃。