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

/extract wizard[/B][/FONT][/CENTER][/B][/FONT][/CENTER]
[FONT=AlimamaFangYuanTiVF-Thin][B][CENTER][FONT=AlimamaFangYuanTiVF-Thin][B][CENTER]

/extract[/B][/FONT][/CENTER][/B][/FONT][/CENTER]
[FONT=AlimamaFangYuanTiVF-Thin][B][CENTER][FONT=AlimamaFangYuanTiVF-Thin][B][CENTER]

/ext /extraction[/B][/FONT][/CENTER][/B][/FONT][/CENTER]
[FONT=AlimamaFangYuanTiVF-Thin][B][CENTER][FONT=AlimamaFangYuanTiVF-Thin][B][CENTER]

warze.admin[/B][/FONT][/CENTER][/B][/FONT][/CENTER]
[FONT=AlimamaFangYuanTiVF-Thin][B][CENTER][FONT=AlimamaFangYuanTiVF-Thin][B][CENTER]

warze.use[/B][/FONT][/CENTER][/B][/FONT][/CENTER]
[FONT=AlimamaFangYuanTiVF-Thin][B][CENTER][FONT=AlimamaFangYuanTiVF-Thin][B][CENTER]

# WarZExtraction 配置文件[/B][/FONT][/CENTER][/B][/FONT][/CENTER]
[FONT=AlimamaFangYuanTiVF-Thin][B][CENTER][FONT=AlimamaFangYuanTiVF-Thin][B][CENTER]# 支持的模式: NORMAL (常规), PAID (付费), ITEM (物品), SWITCH (拉闸)

debug: false

# 默认撤离点设置
defaults:
  open-delay: 60    # 开启延迟（秒）
  enter-delay: 10   # 进入撤离点后的倒计时（秒）
  cooldown: 300     # 冷却时间（秒）

# 消息设置 (支持颜色代码 &)
messages:
  prefix: "&f[§6§lWarZ§f§lExtraction§f] "
  escape-title: "&7撤离倒计时&a {second}&7 秒"
  error-escape-title: "&c你没有权限使用该撤离点"
  no-permission: "&c✘ &f你没有权限执行此操作。"
  reload: "&a✔ &f配置文件已重载。"
  countdown-start: "&e⚠ &f撤离将在 &6%time% &f秒后开始..."
  extraction-success: "&a✔ &f撤离成功！"
  extraction-failed: "&c✘ &f撤离失败！你离开了撤离区域。"
  switch-activated: "&c⚠ &f%player% 拉响了 %point% 的警报！撤离点将在 %time% 秒后开启！"
  not-enough-money: "&c✘ &f你需要 &6$%amount% &f才能在此处撤离。"
  item-required: "&c✘ &f你需要 &6%item% &f才能在此处撤离。"

# 视觉效果设置
visuals:
  bossbar: true    # 是否显示 Boss血条 (1.9+)
  title: true      # 是否显示屏幕标题
  actionbar: true  # 是否显示操作栏信息

@EventHandler[/B][/FONT][/CENTER][/B][/FONT][/CENTER]
[FONT=AlimamaFangYuanTiVF-Thin][B][CENTER][FONT=AlimamaFangYuanTiVF-Thin][B][CENTER]public void onExtractionSuccess(ExtractionSuccessEvent event) {
    Player player = event.getPlayer();
    player.sendMessage("你成功撤离了！");
}

[/B][/FONT][/CENTER][/B][/FONT][/CENTER]
[FONT=AlimamaFangYuanTiVF-Thin][B][CENTER][FONT=AlimamaFangYuanTiVF-Thin][B][CENTER]# 🚁 WarZExtraction - 逃离塔科夫式撤离插件
> **硬核、专业、多功能 | 打造最真实的生存撤离体验**
WarZExtraction 是一款专为 Minecraft 生存/战争/大逃杀服务器设计的“撤离”机制插件。灵感来源于《逃离塔科夫》与《三角洲行动》，为玩家提供紧张刺激的战利品带出体验。
---
## ✨ 核心特性
*   **⚡ Folia 原生支持**: 完美适配 Folia 区域化多线程架构，高性能低延迟。
*   **🌍 全版本兼容**: 支持 1.13 - 1.21+ (低版本自动降级视觉效果)。
*   **🎮 沉浸式视听**:
    *   动态 BossBar 进度条
    *   屏幕标题 (Title) 倒计时
    *   音效反馈 (成功/失败/倒计时)
    *   全息显示 (Hologram - 计划中)
*   **🛠️ 四大撤离模式**:
    *   **常规撤离 (NORMAL)**: 进入区域倒计时即可撤离。
    *   **付费撤离 (PAID)**: 需消耗金币 (Vault) 才可开启撤离。
    *   **物品撤离 (ITEM)**: 需携带特定物品 (如门禁卡/钻石) 才可撤离。
    *   **拉闸撤离 (SWITCH)**: 需在地图某处拉下开关，撤离点才会限时开启。
*   **🧙‍♂️ 傻瓜式向导**: `/extract wizard` 开启聊天栏交互式创建向导，无需记忆繁琐指令。
*   **🔌 开发者友好**: 提供丰富的 API 事件 (`Start`, `Success`, `Fail`)，方便附属开发。
---
## 📥 安装与依赖
1.  **下载插件**: 将 `WarZExtraction.jar` 放入 `plugins` 文件夹。
2.  **前置依赖**:
    *   **Vault** (可选): 仅当使用 `PAID` (付费) 撤离点时需要。
    *   **经济插件** (如 Essentials, CMI): 用于处理金币扣除。
3.  **重启服务器**: 插件将自动生成配置文件。
---
## 🎮 命令与权限
所有命令主指令为 `/extract` (别名: `/ext`, `/extraction`)。
| 命令 | 描述 | 权限 |
| :--- | :--- | :--- |
| `/extract wizard` | **[推荐]** 启动交互式创建向导 | `warze.admin` |
| `/extract create <ID> <类型>` | 快速创建一个新的撤离点 | `warze.admin` |
| `/extract set <ID> region` | 设置撤离点区域 (需先选区) | `warze.admin` |
| `/extract set <ID> <参数> <值>` | 修改撤离点具体参数 (详见下文) | `warze.admin` |
| `/extract switch bind <ID>` | 绑定手中的开关到撤离点 | `warze.admin` |
| `/extract reload` | 重载配置文件 (支持热重载) | `warze.admin` |
| `/extract list` | 查看所有已加载的撤离点 | `warze.admin` |
| `/extract delete <ID>` | 删除撤离点 | `warze.admin` |
**普通玩家权限**:
*   `warze.use` - 允许使用撤离点 (默认拥有)。
---
## 🚀 快速上手指南
### 方式一：使用向导 (推荐)
1.  输入 `/extract wizard`。
2.  按照聊天栏提示输入 **ID** (如 `point_1`)。
3.  输入 **类型** (如 `NORMAL`)。
4.  输入 **显示名称** (如 `&a中央公园撤离点`)。
5.  使用左键/右键点击方块选择区域，输入 `done` 确认。
6.  输入 **撤离所需时间** (秒)。
7.  **完成！** 撤离点已生效。
### 方式二：手动指令创建
1.  **创建**: `/extract create test_point PAID`
2.  **选区**: 此时你会自动获得选区工具 (或手动进入选区模式)，左键点击起点，右键点击终点。
3.  **设区**: `/extract set test_point region`
4.  **设置价格**: `/extract set test_point price 5000`
5.  **设置等待时间**: `/extract set test_point enterdelay 10` (10秒撤离时间)
### 高级设置 (指令/权限/音效)
您可以使用 `/extract set` 指令配置更多高级功能：
*   **添加执行指令** (撤离成功后由控制台执行):
    *   `/extract set <ID> commands add <指令>`
    *   例如: `/extract set point_1 commands add say 恭喜 {player} 成功撤离！`
    *   例如: `/extract set point_1 commands add cmi spawn {player}`
*   **清空指令列表**:
    *   `/extract set <ID> commands clear`
*   **设置权限限制** (玩家需拥有该权限才可撤离):
    *   `/extract set <ID> permission <权限节点>`
    *   例如: `/extract set point_1 permission vip.use` (设置为 `none` 可清除)
*   **设置倒计时音效**:
    *   `/extract set <ID> sound <音效名>`
    *   例如: `/extract set point_1 sound BLOCK_NOTE_BLOCK_PLING` (设置为 `none` 可清除)
---
## 🧩 撤离点类型详解
### 1. 常规撤离 (NORMAL)
最基础的撤离点。
*   **逻辑**: 玩家进入区域 -> 开始倒计时 -> 倒计时结束 -> 撤离成功。
*   **适用**: 开放式路口、安全区入口。
### 2. 付费撤离 (PAID)
*   **逻辑**: 玩家进入区域 -> 检查余额 -> 扣除费用 -> 开始倒计时 -> 撤离成功。
*   **配置项**: `price` (金额)。
*   **适用**: 载具撤离 (如黑车、快艇)。
### 3. 物品撤离 (ITEM)
*   **逻辑**: 玩家进入区域 -> 检查背包是否有特定物品 -> 扣除物品 -> 开始倒计时 -> 撤离成功。
*   **配置项**: `item` (材质), `amount` (数量)。
*   **适用**: 攀岩绳撤离、门禁卡撤离。
### 4. 拉闸撤离 (SWITCH)
最复杂的撤离点类型。
*   **逻辑**: 撤离点默认为 **锁定** 状态 -> 玩家在别处拉下开关 -> 撤离点变为 **开启** 状态 (持续一段时间) -> 玩家前往撤离点撤离。
*   **配置项**:
    *   `require-all`: 是否需要拉下绑定的所有开关才开启。
    *   `opendelay`: 拉闸后，撤离点开启的持续时间 (秒)。
    *   `cooldown`: 撤离点关闭后的冷却时间。
*   **操作**: 使用 `/extract switch bind <ID>` 后右键点击物理按钮/拉杆进行绑定。
---
## ⚙️ 配置文件说明
### 全局配置 (`config.yml`)
```yaml
messages:
  # 撤离倒计时标题 (支持 {second} 变量)
  escape-title: "&7撤离倒计时&a {second}&7 秒"
  # 无权限提示标题
  error-escape-title: "&c你没有权限使用该撤离点"
```
### 撤离点配置 (`extractions/<ID>.yml`)
位于 `plugins/WarZExtraction/extractions/<ID>.yml`
```yaml
# 撤离点类型: NORMAL, PAID, ITEM, SWITCH
type: PAID
# 显示名称 (支持颜色代码)
display-name: "&6黑车撤离点"
# 世界名
world: world
# 区域坐标
region:
  min: 100,64,100
  max: 105,70,105
timing:
  # 玩家需要在区域内待多久才能撤离 (秒)
  enter-delay: 10
  # (仅SWITCH) 拉闸后开启时长 (秒)
  open-delay: 60
  # (仅SWITCH) 冷却时间 (秒)
  cooldown: 300
# (仅PAID) 价格
price: 5000.0
# (可选) 需要权限才能使用
permission: "vip.use"
# (可选) 倒计时音效 (留空则无)
sound: "BLOCK_NOTE_BLOCK_PLING"
# (可选) 撤离成功后由控制台执行的指令
commands:
  - "say 恭喜 {player} 撤离成功"
  - "cmi spawn {player}"
```
---
## 👩‍💻 开发者 API
### 监听事件
```java
@EventHandler
public void onExtractionSuccess(ExtractionSuccessEvent event) {
    Player player = event.getPlayer();
    String pointId = event.getPoint().getId();
    player.sendMessage("恭喜你从 " + pointId + " 成功撤离！");
    // 给予额外奖励...
}
```
*   `ExtractionStartEvent`: 玩家进入撤离点开始倒计时 (可取消)。
*   `ExtractionFailEvent`: 玩家离开区域或死亡导致撤离失败。
*   `ExtractionSuccessEvent`: 撤离成功即将传送 (可取消)。
---
## 📞 技术支持
*   **插件技术交流群**: `398893720`
*   **末日类服务器交流群**: `1063544727`
*   **作者**: Crazy_Jky
*   **定制开发**: QQ 1285988665
> *WarZExtraction © 2026. All rights reserved.*