又一个世界守护者

又一个世界保护者（Yet Another World Protector）

又一个世界保护者（YAWP）是一款用于保护你的 Minecraft 服务器（专用服务器、局域网以及单人游戏！）的管理工具。它适用于（Neo-）Forge 和 Fabric。

YAWP 设计用于专用服务器，但也可用于单人世界和开放至局域网的世界。它允许管理员（以及被授予权限的玩家）保护他们的建筑免受玩家、生物和环境的各种事件/行为影响。

为你的建筑创建区域，并应用区域标志来保护它们。将玩家或原版队伍分配到区域，以便他们能管理自己的区域。

YAWP 的灵感来源于 Forge 模组 WorldProtector 和 WorldGuard 插件。

如果你有任何问题或建议，请加入我们的 Discord：YAWP Discord

---

| Discord | Paypal | Patreon | Github | Wiki | Issues | Curseforge | Modrinth |

---

该模组目前处于测试阶段，许多功能尚未实现，但即将推出。这些功能将包含你从 WorldProtector 和 WorldGuard 中熟知的大部分内容。

该模组将针对 Minecraft 1.16.5+ 版本发布。如果你停留在过去，正在寻找 Minecraft 1.12.2 的版本，我建议你使用 WorldDefender。

从 Minecraft 1.20.4 开始，YAWP 将不再支持 Forge，转而适配 NeoForge。

---

在 YAWP 中有三种不同类型的区域来保护你的服务器：

全局区域

全局区域就是……全局。在全局区域中设置的标志适用于服务器的所有维度，因此也适用于所有本地区域。

维度区域

维度区域是特殊的区域，与一个维度绑定——就像不同维度的游戏规则标志。

维度区域在对应维度中没有空间限制。维度区域的工作方式与普通区域相同，但绑定于一个维度。

它们无法手动创建。事实上，它们是随着每个新维度自动生成的。当服务器创建时，主世界的第一个维度区域就会生成。

当玩家前往一个新维度时，后续的维度区域就会随之创建，从而生成带有各自维度区域的新维度。模组添加的维度同样支持。

本地区域

本地区域很可能就是你从 WorldGuard 或 WorldProtector 中了解的那种区域。它们有明确的定义工作范围，并且仅限于该范围。

通过本地区域，你可以在你的世界中创建区域，保护它们免受由玩家、其他实体或环境引起的特定行为/事件影响。

要创建本地区域，你需要拥有父区域的权限或配置文件中授权的权限。

可以通过使用区域标记器标记区域并执行相应命令来创建本地区域，或者直接使用命令而不使用区域标记器。

目前，区域的范围可以定义为长方体或球体形状，但我计划在未来的更新中添加更多区域形状。

---

区域的属性

区域的属性、标志、组等都可以通过交互式命令行界面（CLI）进行管理。

彩色文本表示交互式快捷命令或命令建议。所有彩色文本都有悬停提示，简要说明点击相应链接的作用。

点击它们会为玩家提供执行命令的建议，或者有时会直接执行悬停文本所提示的命令。

区域只能由其所有者，或拥有所需 OP 级别/配置文件中条目的玩家进行管理。更多信息，请访问 Wiki。

---

每当创建一个新的本地区域而未指定父区域时，其父区域将设置为该新本地区域所在维度的维度区域。

本地区域也可以拥有子区域。本地区域的子区域必须包含在父区域的范围内。区域层级也定义了区域优先级。子区域的优先级必须始终高于其父区域。

维度区域始终以全局区域为父区域，因此全局区域拥有所有维度区域作为子区域。

---

区域拥有所有者和普通成员。所有者被允许管理区域并绕过标志，成员仅被允许绕过区域中设置的标志。

所有者和成员可以是单个玩家或一个队伍。

组允许你为不同的玩家和队伍分配特定的区域权限。目前，只有两个默认组：owners（所有者）和 members（成员）。

---

• 所有者可以自行管理他们的区域，并添加其他玩家/队伍到区域中。他们还可以在自己的区域内创建子区域、管理标志等，当然，所有者可以绕过标志。
• 成员仅被允许绕过标志。

我计划在未来的更新中添加 LuckPerms 集成，这样你就可以定义自己的组和权限。

如果你在设置区域时遇到问题，请访问 Discord 寻求帮助。

---

标志是区域保护系统的核心。它们定义了哪些行为在区域中是允许或禁止的。标志可以设置为

• 允许，以允许相应行为，
• 拒绝，以拒绝相应行为，
• 禁用，以在标志检查中禁用特定标志。

子区域从其父区域继承标志。此外，可以通过相应地设置父区域标志的 override（覆盖）属性来覆盖子区域的标志状态。

关于不同标志的更多细节，请参阅标志页面。

我计划在未来添加更多标志。我打算逐步添加到模组中的建议标志列表可以在这里找到：标志建议

未来还会有更复杂的标志。比如 ListFlag（列表标志），它允许你定义一个在某个标志上下文中被禁止的方块/实体/等列表。

---

---

该模组的命令也设计为可由服务器控制台使用，并可由命令方块执行。

这允许你自动化区域设置、添加/移除玩家、启用或禁用区域等。

---

YAWP 提供了一个不断完善的模组集成 API，以便更轻松地进行模组和整合包集成。目前，该 API 允许其他模组监听区域创建、更改和删除事件，并可取消这些事件以阻止其发生。

此外，还有关于标志检查及其结果的事件，可用于操纵标志检查的结果。

---

模组的客户端安装以资源包的形式提供语言支持（I18n）。目前支持英语、德语和俄语。

从模组版本 0.0.2.9-beta2 和 Minecraft 1.19.4 开始，YAWP 提供默认的英文翻译。

如果你的语言尚未支持，欢迎通过 Discord 联系我，或者通过 Github 发起拉取请求！:)

---

模组的配置文件允许你控制谁可以使用该模组、为本地区域和维度区域设置默认标志、命令行界面选项等。

配置被拆分到不同的文件中，涵盖不同的主题。

• yawp-common.toml - 命令权限配置
• yawp-flags.toml - 标志、自定义标志消息等配置
• yawp-region-defaults.toml - 默认区域属性配置

由于 YAWP 是一个服务端模组，其配置文件位于你的 Minecraft 世界目录下的 /serverconfig 目录中。

---

模组的文档目前还比较精简，但在不断增长。我正努力跟上内容更新的步伐。你可以在<<此处>>找到文档。

文档涵盖

• 不同区域的描述
• 入门 & 常见问题解答
• 可用命令 & 标志
• 配置
• 以及更多……

如果某些内容未被涵盖，欢迎加入我们的 Discord 服务器并在那里提问。:)

---

路线图

未来还有更多功能。该模组正在积极开发中！以下列表并不全面。

• 不同的标志类型（列表、效果等）以实现更精细的控制
• 数据包驱动的标志配置
• 区域边界可视化
• 定义你自己的区域组，以实现更精细的区域管理（LuckPerms）
• 更精细的权限系统（与更精细的组功能结合）
• 区域模板，以便更轻松地管理具有不同空间属性的相同区域
• 进入/离开区域的区域触发器（用于显示消息、执行命令等）*
• 不同形状的区域（圆柱体、棱柱体、3D 多边形）*
• <你的建议填在这里>