WorldGuard 世界保护插件

WorldGuard 介绍

> 经典的世界保护与区域管理插件，允许管理员和玩家划定土地、抵御破坏者，并精细调整各区域的游戏玩法规则。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | WorldGuard |
| 开发组织 | EngineHub |
| 维护者 | me4502、wizjany 等 |
| 最新版本 | 7.0.18（2026-07-31） |
| 许可协议 | LGPL-3.0-only |
| 兼容版本 | 1.2.x – 26.2 |
| 运行平台 | Bukkit、Spigot、Paper、Folia（实验性） |
| 前置依赖 | WorldEdit（Bukkit 版） |
| 官方网站 | https://enginehub.org/worldguard/ |
| 官方文档 | https://worldguard.enginehub.org/ |
简介

WorldGuard 是一款面向 Minecraft 服务端的成熟世界保护插件。它让服主、管理员以及被授予权限的玩家能够圈定并守护特定区域（Region），防范恶意破坏（grief）与不受欢迎的行为；同时，还可以在不同区域分别开关、调整各类 Minecraft 游戏玩法特性——从方块破坏、PvP、火焰蔓延，到生物生成、物品掉落、天气与时间等，几乎覆盖所有游戏规则。

WorldGuard 通常与 WorldEdit 搭配使用：WorldEdit 负责选区与编辑，WorldGuard 负责把选区固化为受保护区域并施加规则。两者同属 EngineHub 生态。
核心特性
区域保护
多种区域形状：长方体（cuboid）为最基础形状；同时支持以 2D 多边形底面 + 上下高度（min/max y）定义的复杂区域，可贴合不规则地形
区域自动保存：对区域的增删改会自动持久化到磁盘，无需手动保存
优先级与继承：区域可设置 priority（优先级）与 parent（父区域），重叠时按优先级与继承关系决定最终生效的规则
黑白名单：可按玩家、权限组、区域成员关系（owners/members）精细控制谁能进入、建造、使用方块或交互
游戏规则（Flag）系统
WorldGuard 通过 Flag 覆盖几乎所有游戏行为，分为多种数据类型：
state：allow（允许）/ deny（拒绝）/ none（继承）
string / integer / double / boolean / location / set 等类型，适配不同规则
常用 Flag 涵盖：建造、破坏、PvP、伤害、火焰蔓延、 lava 流动、水流动、生物生成、物品掉落、爆炸、鞘翅、潜行、床的使用、雨雪、时间、饥饿、药水效果等
区域组（Region Group）
每个 Flag 可限定生效对象，支持：all（所有人）、members（成员）、owners（拥有者）、nonmembers（非成员）、nonowners（非拥有者），实现"仅成员可建造"或"对访客关闭 PvP"等常见需求。
全局规则与默认设置
提供 __global__ 全局区域，用于设定整张地图的默认规则
内置 anti-grief 默认配置，开箱即用抵御常见破坏
支持按世界分别配置
命令与权限
提供完整的区域管理命令（/rg ...），覆盖定义、删除、编辑、旗标、成员管理、查询等
权限节点体系与主流权限插件兼容，支持 worldguard. 聚合权限及 region.flag.、region.define、region.redefine 等细粒度节点
可与 WorldEdit 的选区命令联动，快速把当前选区转为受保护区域
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Bukkit / Spigot / Paper / Folia（实验性） |
| Minecraft 版本 | 1.2.x – 26.2 |
| 前置依赖 | WorldEdit（Bukkit 版，版本需与 WorldGuard 匹配） |
| Java 版本 | 26.1+ 需 Java 25+ |

> Folia 支持自 7.0.16 起加入，属实验性特性，生产环境建议先在测试服验证；官方安装文档仍声明"主要支持基于 Bukkit API 的服务端"。
安装方法
确认已安装匹配版本的 WorldEdit（Bukkit 版）
从官方渠道（EngineHub、Modrinth、CurseForge、Hangar）下载 WorldGuard 的 jar 文件
将 jar 放入服务端 plugins/ 目录
启动或重启服务端，等待 plugins/WorldGuard/ 下生成配置文件
按需编辑配置后重载（通常配合 WorldEdit 使用）
命令一览

> 以下为代表性子集，完整清单见官方 Wiki；命令示例板块已按需求省略。

| 命令 | 说明 | 权限节点 |
| --- | --- | --- |
| /rg define <id> | 用当前 WorldEdit 选区定义一个新区域 | worldguard.region.define |
| /rg redefine <id> | 用当前选区重定义已有区域 | worldguard.region.redefine |
| /rg remove <id> | 删除指定区域 | worldguard.region.remove |
| /rg flag <id> <flag> <值> | 设置区域的旗标 | worldguard.region.flag.<flag> |
| /rg addmember / addowner | 添加成员 / 拥有者 | worldguard.region.addmember 等 |
| /rg info [id] | 查看区域信息 | worldguard.region.info |
| /rg list | 列出区域 | worldguard.region.list |
| /worldguard reload | 重载配置 | worldguard.reload |

权限节点说明（本文按需求不展开为独立表格）：核心聚合权限为 worldguard.；区域相关细粒度节点遵循 worldguard.region.<动作> 及 worldguard.region.flag.<旗标名> 的命名规则，并区分 own / member 权限层级。
配置说明

WorldGuard 的配置文件位于 plugins/WorldGuard/ 下，主要包含：
config.yml：插件主体配置，含默认游戏规则、黑白名单、区域组设置等
worlds.yml / 各世界配置：按世界分别设定规则
区域数据文件：区域定义与旗标持久化存储（通常自动保存）

常用配置维度（非完整字段清单，以所装版本官方文档为准）：
全局与每世界规则覆盖
反破坏（anti-grief）默认值
方块、物品、生物相关的黑白名单
区域自动保存与数据库后端
使用场景
领地保护：玩家圈地后仅自己与授权成员可建造、使用容器，防止被破坏或偷窃
spawn / 主城：关闭 PvP、爆炸、火焰蔓延、物品掉落，营造安全公共空间
竞技场 / 副本：在特定区域开启 PvP、限制特定技能或物品，比赛结束后还原
资源世界：关闭熔岩/水流、限制生物生成，降低性能开销与破坏风险
规则过渡区：利用区域优先级与继承，实现"外圈允许建造、内圈仅管理员可改"的嵌套规则
近期更新
7.0.18（2026-07-31）：调整 lava-harden 标志行为；以 PigZapEvent 替换旧事件；优化 NPC 相关检查；过滤命令消息；修复区域文件损坏问题；明确 26.1+ 需 Java 25+
7.0.16：加入 Folia 实验性支持；多项区域与旗标修复
7.0.x 系列：持续适配新版 Minecraft、清理废弃 API、改进与 WorldEdit 的协同

> 具体版本与发布日期以 EngineHub 官方渠道、CurseForge 文件页及 GitHub CHANGELOG 为准。
相关链接
官方站点：https://enginehub.org/worldguard/
官方文档：https://worldguard.enginehub.org/
Modrinth 项目页：https://modrinth.com/plugin/worldguard
源码仓库：https://github.com/EngineHub/WorldGuard
问题追踪：https://github.com/EngineHub/WorldGuard/issues
WorldEdit（前置依赖）：https://modrinth.com/plugin/worldedit