WGExtender 扩展

WGExtender

> WorldGuard 功能扩展插件，为区域保护补齐自动关门、活塞保护、载具保护、反挤压、水下放置限制等原版 WorldGuard 未覆盖的细节行为。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | WGExtender |
| 开发者 | Sayaris 及 WGExtender 贡献者（GitHub: wgextend/WGExtender） |
| 最新版本 | 2.2.3（2026-08-11） |
| 许可协议 | MIT |
| 兼容版本 | 1.18.x – 26.1.x |
| 运行平台 | Bukkit / Paper / Purpur / Spigot |
| 前置依赖 | WorldGuard 7.0.0+（同时需要 WorldEdit） |
| 运行环境 | Java 17+（v2.0 起） |
| 官方文档 | https://wgextend.github.io/ |
简介

WGExtender 是在 WorldGuard 区域保护基础上做补充的扩展插件。WorldGuard 本身擅长处理方块破坏、交互、PVP、伤害等宏观规则，但对"自动关闭的门""活塞推动出区域""玩家被挤压""水下放置方块""载具被恶意破坏"这类细碎场景覆盖不足，正是 WGExtender 的用武之地。

它通过监听服务端事件，把这些边界情况纳入区域规则管理，使 WorldGuard 的保护更完整、更贴近实际游玩体验。配置通过 config.yml 完成，支持按 WorldGuard 区域开关各项功能。
核心特性
方块与机关
自动关闭：门、活板门、栅栏门在开启后自动关闭（auto-close- 系列开关）
活塞保护：限制活塞将方块推入受保护区域或从受保护区推出（piston-protection）
水下放置限制：禁止在区域内水下放置方块（prevent-place-in-water）
实体与载具
移除矿车 / 船：在特定区域自动清除矿车或船（remove-minecarts / remove-boats）
矿车伤害：控制矿车对玩家造成的挤压伤害（minecart-damage）
载人矿车 / 船保护：载有玩家的矿车、船受到保护，不会被轻易破坏或清除
末影人传送：限制末影人在区域内传送行为
环境与战斗
防止挤压：防止玩家被方块挤压窒息（prevent-suffocation）
滞留药水：限制滞留药水在区域内的效果扩散
反恶魂火箭：限制恶魂火箭对区域的影响

以上功能均可在配置文件中按区域独立开关，未启用的检查不消耗性能。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Bukkit / Paper / Purpur / Spigot |
| Minecraft 版本 | 1.18.x – 26.1.x |
| 前置插件 | WorldGuard 7.0.0+（同时需 WorldEdit） |
| Java 版本 | Java 17+（WGExtender v2.0 起要求） |
安装方法
确认服务端已安装并正常运行 WorldGuard + WorldEdit
从 Modrinth 或 GitHub Releases 下载 WGExtender 的 jar 文件
将 jar 放入服务端 plugins/ 目录
启动或重启服务端，生成默认 config.yml
按需修改配置后执行重载命令生效
命令一览

| 命令 | 说明 | 权限节点 |
| --- | --- | --- |
| /wgextender reload | 重载配置文件 | wgextender. |

官方 Wiki 仅明确列出 /wgextender reload 一条用户命令，其余行为均通过配置文件驱动，未提供更多的用户命令。权限以 wgextender. 通配形式授予。

> 命令示例板块已按需求省略，完整命令以所装版本 plugin.yml 为准。
配置说明

插件配置文件为 config.yml，按功能分系列开关，以下为结构概述（非完整字段清单）：
auto-close 系列：控制各类门、活板门、栅栏门的自动关闭及延迟时间
piston-protection：是否启用活塞跨区域推动保护
prevent-suffocation：是否防止玩家被方块挤压
prevent-place-in-water：是否禁止水下放置方块
remove-minecarts / remove-boats：是否自动清除区域内的矿车 / 船
minecart-damage：矿车挤压伤害相关设置
载人载具保护：载有玩家的矿车、船是否受保护
末影人传送、滞留药水、恶魂火箭：对应行为开关

配置支持按 WorldGuard 区域区分生效，具体字段与默认值以所装版本生成的 config.yml 为准。
使用场景
生存服区域保护：在出生点、主城等区域开启自动关门与挤压保护，避免机关被破坏或玩家窒息
小游戏地图：限制活塞推动、清除闲置矿车 / 船，保持地图状态干净
PVP / 副本区域：关闭载具保护、限制药水与火箭效果，控制战斗环境
与 WorldGuard Flag 配合使用：先用 WorldGuard 划定区域与宏观规则，再用 WGExtender 补齐细节行为
近期更新

| 版本 | 日期 | 主要变更 |
| --- | --- | --- |
| 2.2.3 | 2026-08-11 | 支持 26.1.x；修复 piston-protection 控制台报错；修复 elytra-rocket-protection 载具检查 |
| 2.2.2 | —— | 修复水下放置相关问题（prevent-place-in-water） |
| 2.2.x | —— | 持续适配新版服务端与 WorldGuard API |

> 精确版本与发布日期以 Modrinth 版本页及 GitHub Releases 为准。
相关链接
Modrinth 项目页
官方 Wiki
GitHub 仓库
WorldGuard 官方文档