原创 付费 【1.7-1.21+/folia】🚁 WarZExtraction —— 高度还原三角洲/塔科夫里的撤离机制|拉闸|付费|常规|交付物品|高度自定义 1.2.9

[MD] ## v1.2.9 更新日志 - 新增 **随机拉闸撤离**： - 一个 `SWITCH` 撤离点可作为随机控制器，绑定一个或多个闸点。 - 当满足拉闸条件后，插件会从 `switch.random-points` 配置的候选撤离点中随机开放一个。 - 适合“三个撤离点绑定一个闸点”或“两个闸全部拉完后随机开放三个撤离点之一”的玩法。 - 新增指令：`/extract set <控制器ID> randompoints add/remove/clear/list <候选点ID>`。 - 被随机控制器引用的候选撤离点会默认保持锁定，仅在被抽中后按控制器的 `opendelay` 与 `openduration` 开放。 [/MD]

• 修复多世界同时拉闸时，拉闸倒计时 BossBar 被其它世界覆盖的问题。
• 拉闸点现在会记录本次触发所在世界，倒计时只显示给对应世界玩家。
• 新增配置开关：
  visuals.switch-countdown-world-only: true
• 默认开启按世界隔离倒计时；如果想恢复旧版全服显示，改成 false。
• 旧配置自动补全机制现在也会补 visuals 缺失项，不会覆盖服主已有配置。

• 新增撤离倒计时 BossBar 自定义配置。
• 新增 messages.escape-bossbar、messages.switch-countdown-bossbar、messages.switch-open-bossbar。
• 支持 %time%、{second}、%point% 占位符。
• 旧配置会在插件启动或执行 /extract reload 时自动补齐新语言键，不覆盖已有自定义文案。

[MD] ## v1.2.6 更新日志 - 修复 **物品撤离 / 付费撤离会先倒计时、后校验条件** 的问题： - `ITEM` 与 `PAID` 类型撤离点现在会在 **开始撤离前** 先检查条件。 - 当玩家未携带所需物品，或余额不足时，将 **不会再进入撤离倒计时**，避免出现“没有条件也在倒计时”的怪异体验。 - 修复 **撤离成功后仍弹出“撤离取消 / 离开区域”提示** 的问题： - 成功撤离后，不再错误触发离开区域的失败收尾提示。 - 解决了执行撤离成功指令（如控制台传送命令）后，玩家仍看到 `撤离取消` 副标题或 `离开物品撤离区域` 聊天消息的问题。 - 新增 **更多可配置的撤离提示消息**： - `NORMAL / PAID / ITEM / SWITCH` 类型的 **进入提示、离开提示、成功提示、条件不足提示** 现已支持通过 `config.yml -> messages` 自定义。 - 服主现在可以直接修改配置中的标题、副标题和聊天提示，无需再进入源码手改。 - 本次新增的消息键会在插件启动或执行 `/extract reload` 时自动补齐到旧配置中。 [/MD]

[MD] ## v1.2.5 更新日志 - 修复 **撤离轮询偶发报错 `ConcurrentModificationException`**： - 修复了插件在定时 `tick()`、BossBar 刷新、以及拉闸广播阶段，遍历在线玩家列表时可能出现的并发修改异常。 - 当玩家在同一时刻撤离成功、切换世界、掉线，或被其他命令移出在线列表时，不再导致整轮撤离检测报错中断。 - 同步优化了世界内广播与拉闸提示的玩 [/MD]

• 新增配置升级兼容：插件启动和重载时会自动补全缺失的 messages 语言键。
• 保留用户自定义内容：只补缺失项，不覆盖已有翻译。
• 修复广播前缀配置不生效的问题：撤离广播现在正确读取 messages.prefix。
• 修复 visuals.broadcast-world-only 读取错误的问题：跨世界广播限制现已正常生效。

[MD] ## v1.2.2 更新日志 - 新增 **世界激活冷却机制**： - 配置文件新增 `world-cooldowns` 模块。 - 功能：指定世界在第一名玩家进入后，需等待 N 秒才可使用撤离点（拉闸或进入区域）。 - 适用于防止玩家开局立即跑路，强制进行一段时间的生存/战斗。 [/MD]

WarZExtraction 修复与更新详情
1. 修复 BossBar 残留问题

- 问题原因 ：当撤离点配置为立即撤离（ enterDelay: 0 ）时，系统在同一帧内先设置了 BossBar，随后执行撤离和移除操作。由于逻辑顺序和网络发包原因，导致 BossBar 可能在撤离后依然短暂残留或未被正确清除。
- 修复方案 ：优化了 handleStay 逻辑，当倒计时结束（剩余时间 <= 0）时，不再发送 BossBar 更新包，彻底杜绝了立即撤离时的视觉残留。
2. 新增跨世界消息限制

- 配置文件 ： config.yml 新增 broadcast-world-only 选项（默认 false ）。
- 功能描述 ：
- 开启后（ true ），以下信息将 仅对撤离点所在世界的玩家 可见：
- 撤离点开启/关闭的全服提示。
- 拉闸（Switch）激活时的全服提示与音效。
- 屏幕上方的全服倒计时 BossBar。
- 这确保了在多世界/多战局服务器中，不同世界的玩家不会受到无关撤离点信息的干扰。

WarZExtraction更新总结 (v1.2.0)
1. 核心功能更新：撤离点重置机制

- 指令重置 ：新增 /extract reset <世界名> 指令，可立即重置指定世界内所有撤离点的状态（包括开关复位、冷却清除、门禁关闭等）。该指令支持 控制台 和 命令方块 执行，方便与战局/大逃杀插件对接。
- 自动重置 ：新增 auto-reset 模块。当配置的世界内玩家数量降为 0 时（玩家全部退出或切换世界），插件会自动执行重置操作，确保下一局游戏开始时撤离点处于初始状态。
2. 体验与优化

- 指令优化 ：解除了 reset , reload , delete , list 等管理指令必须由玩家执行的限制，现在后台控制台也可以进行管理操作。
- 文档更新 ： WIKI.md 已同步更新，添加了关于重置机制的详细说明与配置指南。

1.12.2 兼容性修复 :
- 声音系统 : 修复了 SoundUtils 在旧版本（如 1.12.2 CatServer）上因找不到特定声音枚举而导致报错的问题。现在使用 try-catch(Throwable) 进行容错，确保插件不会因声音缺失而崩溃。
- 任务调度 : 增强了 ExtractionManager 的心跳任务 ( tick ) 稳定性，添加了全局异常捕获，防止因单个模块报错导致整个插件的倒计时和逻辑停止。
- 开关状态自愈 : 修复了拉闸撤离点可能卡在“已激活”状态的问题。现在，如果检测到状态不同步（撤离点锁定但触发器显示已激活），插件会自动清除残留状态并允许玩家重新拉闸。