原创 娱乐 经济 WarZHongBao —— 全版本｜金币红包｜点券红包｜物品红包｜拼手气机制｜沉浸互动【1.7 - 1.21+ 全兼容(Folia)】 1.9.15

[MD] ### v1.9.15 (2026-10-02) * **修复**：修复插件根指令被误写为 `/warzlore` 的问题。 * 原因是主类沿用了 WarZLore 插件的命令名，且 `plugin.yml` 中未声明该指令，导致根指令在游戏内无法使用。 * 现在根指令更正为 `/warzhongbao`，并在 `plugin.yml` 中补齐声明；执行后显示插件信息并提示使用 `/hb` 查看帮助。 * **兼容性**：不影响 `/hb`、`/fhb`、`/qhb` 现有命令与配置，可直接替换 jar 升级。 [/MD]

[MD] ## v1.9.14 更新内容 修复 ：物品红包领取后缺少公屏广播的问题 - 物品红包在 finishClaim 中提前 return，跳过了 broadcastPublicClaim 调用，导致非口令的物品红包只有领取者自己能看见提示，其他玩家看不到任何广播 - 修复后在 handleItemGrant 中补充了 broadcastPublicClaim ，物品红包领取后也会向全服广播"玩家: XXX 的物品红包被 YYY 抢到 Block of Redstone ×N" [/MD]

• 修复 [SchedulerUtil.java (line 232)](D:/workzone/Works/plugins/WarZ插件/WarZHongBao/src/main/java/com/crazy_jky/warzhongbao/util/SchedulerUtil.java:232)：优先使用 Bukkit 原生 Bukkit.isPrimaryThread() 判断主线程。
• 只有不在 Bukkit 主线程时，才继续检查 Folia/Luminol 的全局 tick 线程。

v1.9.11 修复 Leaf/Paper 1.21.11 下物品口令红包因异步聊天线程触发 World.dropItem(...)，导致 Asynchronous entity add 报错并吞物品的问题。领取发奖流程现在会统一切回安全线程；背包满时剩余物品优先掉落，掉落失败则写入暂存，玩家重新登录后可领取。无需新增配置或语言键，直接替换 jar 即可。

• 修复 Luminol/Folia 环境下自定义红包执行扣除/发放命令时报 Dispatching command async 的问题。
• 修复开启 scheduled_packets 后 /hb reload 因 BukkitRunnable#runTaskTimer 不兼容而报错的问题。
• 顺手把数据库红包轮询、异步保存后回主线程、过期退款等残留调度也统一收口到 SchedulerUtil，减少 Luminol 下继续炸线程调度的概率。
• 新增口令红包字数限制：
  • bribery_money.max_password_length: 20
  • 设置为 -1 可关闭限制。
• 新增语言项：
  • lang_85：口令过长提示。

• 新增 bribery_money.blocked_materials，可直接把 STONE、DIRT、minecraft:stone 这类原版材料拉黑。
• 新增 bribery_money.require_custom_item，开启后只允许带自定义名称、颜色名称、Lore 的 RPG 物品放进物品红包。
• 新增 bribery_money.max_item_amount，限制单个物品红包按堆叠数量统计的总物品数，防止一次塞太多。

[MD] - 物品红包 GUI 恢复支持从玩家背包使用 `Shift + 点击` 快捷放入普通物品。 - Shift 快捷放入不再一刀切阻止，只会拦截命中 `bribery_money.blocked_lores` 的黑名单物品。 - Shift 放入时会由插件手动把物品塞入红包物品区 `0-44`，避免误触底部翻页、数量调整、确认、取消等按钮。 - 确认发放前仍会全量复查红包内物品，继续保留最终黑名单保护，避免边缘交互绕过限制。 - 本次更新主要改善玩家批量放入物品红包的操作体验，同时不降低黑名单安全校验。 [/MD]

[MD] - 修复点：修复 Paper `1.21.11` 下自定义红包通过聊天口令领取时，后台出现 `Asynchronous Command Dispatched Async`，导致奖励无法领取的问题。 [/MD]

[MD] ### v1.9.6 (2026-05-09) * **修复**：修复旧版本服务端物品红包 GUI 在部分点击场景下触发 `NoSuchFieldError: SWAP_OFFHAND` 的问题。 * 原因是监听器直接引用了低版本不存在的 `ClickType.SWAP_OFFHAND` 字段。 * 现在改为安全兼容判断，避免因为副手热键枚举缺失导致 GUI 交互异常。 * **影响范围**：`/fhb item` 物品红包 GUI 中，放入物品、数字键换栏位以及相关热键交互。 * **结果**：降低旧版本环境下物品红包创建异常的概率，避免表现成“放了物品后红包异常、疑似只能一人抢”。 [/MD]

• 新增统一的点击消息组件发送逻辑：Util.convertColorToComponents / Util.sendClickableMsg。
• lang_16 现在会先解析成真正的 BaseComponent 颜色片段，再绑定 /qhb <id> 点击事件，避免 &#06D6A0 被当成最后一位传统色码 §0 渲染成黑色。
• 红包图片行点击区域和 lang_79 悬浮提示也同步走同一套 16 进制颜色解析。
• 已更新 pom.xml、dependency-reduced-pom.xml、plugin.yml、README.md、WIKI.md 到 1.9.5，并补了 v1.9.5 更新说明。