LootChest - 可刷新战利品箱

LootChest 是一款高度可配置的宝箱刷新插件，允许你创建具有自定义物品、刷新时间、粒子效果和全息显示的宝箱。它支持从 1.7 到 1.21 的 Minecraft 版本，并提供直观的菜单进行管理。

💡主要特性

• 全版本支持：兼容 Minecraft 1.7 至 1.21（1.7 版本无全息显示）。
• 可视化菜单：通过菜单轻松创建和编辑所有内容。
• 自定义宝箱内容：
• 为每个宝箱编辑物品栏。
• 为每个物品设置独立出现几率（默认 100%）。
• 设置宝箱最大填充槽位数。
• 刷新与计时：
• 为每个宝箱设置独立的刷新时间。
• 宝箱被清空后会自动删除（但仍会按时刷新，可禁用）。
• 可设置刷新保护时间，期间无法被掠夺。
• 视觉效果：
• 为每个宝箱设置粒子效果（1.7支持33种，1.18支持约82种，可单独禁用）。
• 可编辑全局粒子的速度、数量、生成频率和半径。
• 酷炫的坠落效果（可完全自定义，可单独禁用）。
• 全息显示：
• 为每个宝箱设置可自定义的全息文本（可单独禁用）。
• 可在全息图上显示刷新倒计时（可禁用）。
• 智能生成：
• 在创建点周围半径内随机生成（可设置半径，可禁用）。
• 可选择在随机玩家周围生成。
• 可防止在保护区（如 Factions、Residence、WorldGuard 领地）内生成。
• 通知系统：
• 宝箱刷新/被拾取时发送广播消息（可单独禁用）。
• 支持 BungeeCord 跨服消息。
• 刷新时可发送世界内或全服通知。
• 管理与维护：
• 自动更新配置和语言文件，无需手动删除。
• 可复制现有宝箱配置。
• 可更改宝箱位置。
• 防止将漏斗放置在宝箱下方进行无限刷取。

🎮指令列表

使用 /lc help 查看游戏内完整帮助。

基础管理

• /lc create <名称>：创建宝箱并打开编辑菜单。
• /lc edit <名称>：打开指定宝箱的编辑菜单。
• /lc remove <名称>：删除指定宝箱。
• /lc list：列出所有宝箱。
• /lc reload：重载插件配置、语言文件和宝箱数据。
• /lc getname：查看你正在看的宝箱名称。

刷新控制

• /lc respawn <名称>：强制刷新一个宝箱。
• /lc respawnall [世界名]：刷新所有宝箱（可指定世界）。
• /lc despawnAll [世界名]：移除所有宝箱（可指定世界）。

属性设置

• /lc setholo <名称> <文本>：设置宝箱的全息文本。设置为 ""、" "、null、_ 或 none 可删除全息。
• /lc setpos <名称>：将宝箱位置设置到你当前位置。
• /lc settime <名称> <秒数>：设置宝箱的刷新时间（秒）。
• /lc randomspawn <名称> <半径>：设置宝箱的随机生成半径（设为0禁用）。
• /lc setprotection <名称> <时间>：设置宝箱生成后的保护时间（秒）。
• /lc maxfilledslots <名称> <数量>：设置宝箱的最大填充槽位数。
• /lc togglefall <名称>：启用/禁用宝箱的坠落效果。

实用功能

• /lc give <玩家> <宝箱名>：将宝箱内的物品直接给予玩家（类似礼包，可保留NBT标签）。
• /lc tp <名称>：传送至宝箱位置。
• /lc locate：显示所有启用了自然刷新消息的宝箱位置。
• /lc copy <源宝箱> <目标宝箱>：将一个宝箱的配置复制到另一个。

✨权限节点

• 通用命令权限：lootchest.<命令>，例如 lootchest.create。
• 管理员权限：lootchest.admin 或 lootchest.*。

🔧配置摘要

主要配置文件选项如下

基础设置

• CheckForUpdates：启动时检查更新。
• Cooldown_Before_Plugin_Start：插件启动延迟（秒），解决世界加载顺序问题。
• default_reset_time：默认刷新时间（分钟）。
• default_item_chance：物品默认生成几率（%）。
• UseHologram：是否使用全息显示。
• RemoveEmptyChests：玩家清空宝箱后是否移除宝箱实体。
• PreventHopperPlacingUnderLootChest：防止在宝箱下方放置漏斗。

粒子效果

• Particles.enable：总开关。
• default_particle：默认粒子类型（如 FLAME）。
• number、respawn_ticks、radius、speed：控制粒子数量、生成频率、半径和速度。

生成规则

• allow_spawning_on_water：是否允许在水上生成。
• use_players_locations_for_randomspawn：随机生成是否以玩家位置为中心（否则以创建点为中心）。
• Prevent_Chest_Spawn_In_Protected_Places：是否防止在保护区内生成。
• Minimum_Number_Of_Players_For_Natural_Spawning：自然生成所需的最低在线玩家数。
• Radius_Without_Monsters_For_Opening_Chest：开启宝箱时周围不允许有怪物的半径。

坠落效果

• Fall_Effect.Enabled：总开关。
• Block：坠落的方块类型（如 CHEST）。
• Height：坠落起始高度。
• Speed：坠落速度。
• Enable_Fireworks：是否启用烟花效果。

消息通知

• respawn_notify.bungee_broadcast：是否启用BungeeCord广播。
• respawn_notify.per_world_message：消息是否仅限宝箱所在世界。
• natural_respawn / respawn_with_command：分别配置自然刷新和指令刷新的消息。

⭐语言文件

所有提示信息均可通过 lang.yml 自定义，包括菜单文本、操作反馈、消息格式等。插件更新时会自动合并新条目，无需手动覆盖。

❓已知问题与说明

• 性能：如果遇到TPS问题，可以尝试禁用粒子效果以提升性能。全息显示已修复，通常不会造成问题。
• 宝箱类型变更：在编辑菜单中更改宝箱类型（方块）时，原宝箱内的物品会掉落在地上。这是正常机制，因为插件通过破坏旧方块并放置新方块来实现。
• 数据保存：建议保持 save_Chest_Locations_At_Every_Spawn: true，以防服务器崩溃导致宝箱数据错误。
• 全息显示：基于 DecentHolograms 的轻量分叉制作。不同服务器版本的全息显示高度可能不同，可通过 Hologram_distance_to_chest 调整。

🔧API 与开发

插件提供了简单的API供开发者使用。

• 事件：宝箱生成时会触发 LootChestSpawnEvent（当前不可取消），可从中获取宝箱信息。
• 主类：通过 fr.black_eyes.lootchest.api.LootChestAPI 类可以获取所有宝箱数据。Lootchest 类也提供了许多管理单个宝箱的方法。
• 代码使用：本插件为开源项目，允许你出于个人需求、帮助他人或开发自己的插件而使用代码（例如坠落效果、菜单系统、配置管理等功能）。请勿出售此插件的修改版本。

**开发者联系**

• 邮箱：[email protected]
• Discord：black_eyes72
• GitHub：见插件主页顶部
• 支持开发：PayPal捐赠

**演示视频**

• MusicTechnician（英语）
• Maxar628（西班牙语）
• 其他（俄语）