Random Loot Chest - （随机宝箱）

简介

Random Loot Chest 是一款为 Minecraft 服务器增添随机宝箱的插件。宝箱会在地图中随机或固定位置刷新，内含随机战利品，为玩家带来探索与惊喜的乐趣。此版本为原版插件的分支，增加了更多功能与兼容性。

💡主要特性

• 随机位置宝箱：在指定世界和坐标区域内自动生成宝箱。
• 固定位置宝箱：管理员可手动设置固定位置，宝箱会定期刷新内容。
• 智能生成：宝箱可在雪地、地毯、房屋、洞穴等多种地形和方块上生成，并在消失后恢复原方块。
• 随机朝向：宝箱生成时朝向随机（东、南、西、北）。
• 可配置消息：可独立启用或禁用生成、被搜刮、消失时的公告消息。
• 视觉效果与音效：支持为宝箱配置生成、更新时的粒子效果和声音。
• 兼容性：支持 Multiverse 等多世界插件。

🎮指令与权限

指令列表

• /rlc – 显示帮助信息。
• /rlc additem – 打开物品提交 GUI。
• /rlc addchest – 右键点击一个箱子，将其添加为固定宝箱。
• /rlc delchest – 右键点击一个箱子，将其从固定宝箱集合中移除。
• /rlc delall – 删除所有固定宝箱。
• /rlc killall – 清除服务器上所有随机宝箱。
• /rlc togglebreak – 切换是否允许通过破坏来清除随机宝箱。
• /rlc forcespawn – 强制生成一个随机宝箱。
• /rlc rndtime – 随机化宝箱的消失/更新时间。

权限节点

• randomlootchest.general – 使用 /rlc 的基础权限。
• randomlootchest.additem – 使用 /rlc additem。
• randomlootchest.fixedchest – 使用 /rlc addchest 和 /rlc delchest。
• randomlootchest.delall – 使用 /rlc delall。
• randomlootchest.killall – 使用 /rlc killall。
• randomlootchest.togglebreak – 使用 /rlc togglebreak。
• randomlootchest.forcespawn – 使用 /rlc forcespawn。
• randomlootchest.rndtime – 使用 /rlc rndtime。

🔧配置详解

通用设置

• World：宝箱生成的世界名称（随机和固定宝箱均在此世界）。

随机位置宝箱

• LargestDinctance_X/Z 与 SmallestDinctance_X/Z：定义宝箱生成的坐标区域范围。
• LargestDinctance_Y 与 SmallestDinctance_Y：定义生成的垂直高度范围。
• SpawnChestPerTime：生成新宝箱的间隔时间（秒）。
• KillChest：是否启用宝箱自动消失。
• KillChestAfterTime：宝箱生成后多久自动消失（秒）。
• NotAbleToBreakAchest：玩家无法破坏宝箱时的提示消息。
• MessageOnSpawn：宝箱生成时的公告消息。留空可禁用。
• MessageOnLoot：宝箱被搜刮时的公告消息。留空可禁用。
• MessageOnKill：宝箱消失时的公告消息。留空可禁用。
• CommandsToExecuteOnLoot：玩家打开宝箱后执行的命令列表（支持变量 {player}）。
• RandomChestEffect：宝箱激活时的粒子效果。
• RandomChestSound：宝箱生成时的音效。
• RandomChestOpenSound：宝箱被打开时的音效。

宝箱生成条件（高级设置）

警告：修改此部分需谨慎，可能影响插件稳定性。所有条件必须同时满足。

• SpawnBlockCondition：宝箱可以替换的方块条件（例如：AIR,SNOW,CARPET）。
• UnderBlockCondition：宝箱下方方块的条件（例如：!_TRANSPARENT_,!WATER）。
• SideBlockCondition：宝箱侧面方块的条件（例如：!CACTUS）。

**条件语法说明**

• 使用空格、逗号或分号分隔多个条件。
• 使用 ! 表示“不能是此材料或属性”。
• 可使用材料属性，如 _TRANSPARENT_（透明）、_SOLID_（固体）等。
• 示例：!RAILS, _TRANSPARENT_, !SAPLING 表示“方块必须是透明的，且不能是铁轨或树苗”。

**重要提示**

• 插件会保存被宝箱替换的方块数据（包括材料及额外数据，如 CARPET:3），并在宝箱消失后恢复。
• 请勿将条件设置为允许替换如双倍植物、高草、告示牌等方块，它们可能无法正确恢复。

固定位置宝箱

• FixedChestUpdateTimeMin / FixedChestUpdateTimeMax：宝箱内容刷新的时间间隔（秒，在此范围内随机）。
• FixedChestEffect：固定宝箱更新时的粒子效果。
• FixedChestSound：固定宝箱更新时的音效。

物品提交 GUI

• Inventory_Name：提交物品界面的标题。
• Inventory_Slots：界面大小（槽位数）。
• ItemAmountToAdd：每次可提交的物品数量。

效果与音效值

• 效果和音效选项可使用 NONE 来禁用。
• 效果值可参考 Effect 或 Particle 的合法名称。
• 音效值可参考 Sound 的合法名称（注意 1.8 与 1.9+ 版本名称不同）。
• 可在单个选项中指定多个值，用 |、空格、逗号或分号分隔。插件将按顺序尝试使用第一个可用的值。这有助于跨版本兼容。

启用插件

• EnablePlugin：在完成所有配置后，请将此选项设为 true 以启用插件。

✨安装与更新

安装步骤

• 下载插件文件，将其放入服务器的 plugins 文件夹。
• 重启服务器。首次运行时插件默认禁用。
• 打开 plugins/RandomLootChest/config.yml，根据需求调整所有配置。
• 将配置末尾的 EnablePlugin: false 改为 true。
• 再次重启服务器。

从旧版本升级

• 新版本（2.0 之后）的 config.yml 格式有所变化。替换插件文件并重启后，控制台会提示需要修复配置文件。
• 插件文件夹内会生成一个 config-example.yml 参考文件。请依照此文件更新你的 config.yml。
• 旧版的 database.yml 格式通常兼容，无需修改或删除。

❓注意事项与支持

• 请将所有问题与错误报告发布在插件页面的 “Discussion”（讨论区），而非评论区内。
• 感谢原插件作者 RestrictedPower 的杰出工作。若作者需要，分支开发者乐意提供源代码。
• 欢迎留下积极的评价与反馈。

插件原始地址：https://www.spigotmc.org/resources/★random-loot-chest★.26009/