原创 付费 【1.12-1.21+|Folia】☠️ WarZDeathChest —— 商业级死亡盒子插件 1.2.8

• 修复死亡箱多人同时打开时不同步的问题，改为共享同一个 Inventory，别人拿走后当前界面会直接刷新。
• 修复 Arclight 1.18.2 下 PlayerDeathEvent 只包含原版掉落、mod 物品消失的问题。
• 新增 death-chest.hybrid-mod-item-fallback，默认关闭；手动开启后可补抓未进入事件的非 minecraft 命名空间物品。
• 保留 1.2.7 的 DecentHolograms 软挂钩、hologram.provider、GUI 标题颜色修复和全息图清理优化。
• 版本号已更新为 1.2.8。

• 新增 death-chest.hybrid-mod-item-fallback 配置项，默认关闭。
• 开启后用于兼容 Arclight/Mohist 等 Hybrid 服务端：当死亡事件只捕获原版物品时，会从死亡时背包快照中补抓未进入事件的 Mod 物品，防止死亡后直接消失。
• 兜底只处理非 minecraft 命名空间物品，并会先抵扣已存在于死亡掉落事件中的同类物品，尽量避免重复。
• 保留 1.2.6 的 DecentHolograms 软挂钩、hologram.provider 配置、GUI 标题颜色修复和全息图生命周期清理优化。

• 新增 /wdc clearworld <世界名>，支持按世界清空全部死亡盒子。
• 清理时会处理已加载盒子的 GUI、方块、全息文字。
• 该世界的数据库记录会异步删除。
• 修复主命令未注册 Tab 补全的问题。

• 修复悬浮字体不会自动清除
• 修复黑名单世界仍生成全息文字
• 修复智能落点后位置记录异常引发的残留问题
• 发版 1.2.4 并同步文档说明

• 新增死亡盒子方块生成模式：固定/随机/按权限。
• 权限模式支持无限条规则，按配置顺序优先匹配。
• 随机模式从配置列表中随机选择材质。
• 保持旧配置兼容，block 仍可作为默认回退方块。

v1.2.2 更新内容总结
1. 1.12.2 Mohist/Cauldron 核心修复

- 修复了 NoSuchFieldError: CAVE_AIR 崩溃问题。
- 重写了 isSafe 方块检测逻辑，使用字符串名称匹配替代枚举直接引用。
- 解决了 1.12.2 与 1.13+ 对 GRASS (草方块 vs 草丛) 的语义冲突。
2. Folia (1.19.4+) 兼容性修复

- 修复了 GuiListener 在关闭箱子时传入 null 位置导致 Folia 服务器崩溃的问题。
- 现在正确使用箱子位置调度异步/同步任务。
3. 跨版本 GUI 兼容性

- 修复了在 1.12-1.15 版本上打开 GUI 可能报错的问题。
- 采用“通用降级”策略：所有版本 GUI 标题统一转换为 Legacy 颜色代码格式，确保在不支持 Component 标题的旧服务端上也能正常显示颜色。
4. 全版本稳定性增强

- 优化了全息图 (Hologram) 生成逻辑，确保兼容 1.12.2 ArmorStand 特性。
- 保留了 MiniMessage 消息格式支持，同时兼容旧版颜色代码。

- WarZDeathChest ( DeathChestManager.java ):

- 新增了 getLastChest(UUID owner) 方法，用于获取玩家最新创建的死亡盒子。
- WarZBackPack ( BackpackListener.java ):

- 修改了 onPlayerDeath 死亡监听逻辑。
- 现在通过反射机制（Reflection）检测并调用 WarZDeathChest 的功能：
- 尝试合并 ：优先查找玩家刚生成的死亡盒子，将背包物品直接放入其中。
- 自动创建 ：如果玩家身上没东西（未生成盒子），插件会强制为背包物品创建一个新的死亡盒子。
- 兼容性 ：如果未安装 WarZDeathChest 或操作失败，物品将按原逻辑自然掉落，确保物品不丢失。

修复全息图残留 Bug ：
- 问题 ：当死亡盒子所在区块被卸载（Unload）时，全息图（Hologram）实体引用会失效，导致盒子过期时无法正确清除全息图。
- 修复 ：将 DeathChest 对象中存储的 Entity 列表改为存储 UUID 。在清理全息图时，插件现在会检查区块状态，若区块未加载则强制加载，并通过 UUID 获取有效的实体引用进行移除，确保无残留。

WarZDeathChest v1.1.2 更新日志
1. 严重 Bug 修复 (Critical Fixes)

- 物品无限复制修复 :
- 问题 : 当死亡盒子过期自动消失时，如果玩家正打开着盒子界面，物品会掉落在地上，同时玩家界面里的物品仍然存在，导致物品双倍复制。
- 修复 : 现在当盒子过期时，插件会 强制关闭 所有正在查看该盒子的玩家界面，并 清空玩家光标上的物品 （防止玩家刚拿起来时盒子消失）。
- 全息图重叠/残留修复 :
- 问题 : 插件热重载 ( reload ) 后，旧的全息图没有被清除，新的又生成了，导致重叠且无法删除。
- 修复 :
- 优化了卸载 ( onDisable ) 和重载逻辑，确保旧全息图被正确移除。
- 新增 /wdc cleanup [半径] 命令，用于手动清理“僵尸”全息图。
- 生成新全息图时会自动检测并清理同一位置的旧全息图。
- GUI 标题变量修复 : 修复了 GUI 标题中 {player} 变量未显示玩家名字的问题。
2. 新增功能 (Features)

- 含水方块支持 (1.13+) : 死在水中生成的箱子现在会与水共存，不会产生气泡或断开水流。
- 物品过滤升级 : ignore-items 配置现在支持对 Name/Lore 进行 模糊匹配 （忽略大小写/颜色），并支持 Fallback 模式下的物品返还。

1. 核心兼容性修复
- 混合端修复 (Mohist/Arclight) ：解决了模组服 getDrops() 为空导致不生成箱子的问题。现在插件会自动检测并接管玩家背包数据，确保物品不丢失。
- 跨版本支持 (1.12-1.21+) ：移除了 api-version 限制，引入 XSeries 库，完美支持低版本及最新版本方块材质。
- Folia 支持 ：原生支持 Folia 多线程环境。
- 虚空保护 ：自动检测并修正掉落虚空或超高空的死亡箱子位置。 2. 智能防卡墙 (Smart Placement)
- 新增 智能选址算法 ：当死亡点有方块阻挡时，自动搜索 上/下/四周 的安全空位。
- 防建筑破坏 ：默认关闭 replace-blocks ，如果找不到空位，物品将安全掉落，绝不破坏玩家建筑。 3. UI/UX 视觉重构
- 像素机能风 ：所有默认消息和 GUI 均采用高端像素风格设计。
- 混合颜色支持 ：同时支持 Legacy ( & )、Hex ( &# ) 和 MiniMessage ( <gradient> ) 颜色代码，配置更灵活。
- 命令增强 ：新增 /wdc help 和 Tab 补全。 4. 调试与运维
- Debug 开关 ：在 config.yml 中添加 debug: false 选项，从此告别控制台刷屏，仅在需要时开启。
- 异常熔断 ：底层增加全链路异常捕获，即使生成箱子失败，也会自动回退到自然掉落模式，确保 0 丢包。