Yet Another World Protector

Yet Another World Protector

Yet Another World Protector（YAWP）是一个用于保护你的 minecraft 服务器（专用服务器、LAN 以及单人游戏！）的管理员工具。它可用于（Neo-）Forge 和 Fabric。

YAWP 设计上主要用于专用服务器，但也可以在单人世界和开放到 LAN 的世界中使用。

它允许管理员（以及被授予权限的玩家）保护他们的建筑，免受玩家、生物和环境造成的各种事件/行为影响。

你可以为建筑创建区域，并应用区域标志来保护它们。

还可以将玩家或原版队伍分配给区域，这样他们就能管理自己的区域。

YAWP 的灵感来自 forge 模组 WorldProtector

以及 WorldGuard 插件。

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

该模组当前仍处于 beta 阶段，许多功能尚未实现，但将在后续加入。这些功能将包括你在 WorldProtector 和 WorldGuard 中熟悉的大部分内容。

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

从 Minecraft 1.20.4 开始，YAWP 将不再提供 Forge 版本，而是改为适配 NeoForge。

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

The Global Region

Global Region 是……嗯，全局的。设置在 Global Region 中的标志会应用到服务器的所有维度，因此也会应用到所有

Local Regions。

Dimensional Regions

Dimensional Regions 是一种特殊区域，它们绑定到某一个维度——有点像不同维度的 gamerule-flags。

Dimensional Regions 在对应维度中没有空间范围限制。它们像普通

区域一样工作，但会绑定到某个维度。

它们不能被手动创建。事实上，每当出现一个新维度时，它们都会自动生成。主世界的第一个 Dimensional

Region 会在服务器创建时生成。

每当玩家前往一个新维度时，都会创建对应的 Dimensional Region，因此新创建的维度也会拥有其各自的 Dimensional Region。

同样也支持模组添加的维度。

Local Regions

Local Regions 是你大概率已经从 WorldGuard 或 WorldProtector 中了解的那种区域。它们有明确定义的作用范围，

并且只在该范围内生效。

通过 Local Regions，你可以在世界中创建想要保护的区域，以防止某些由玩家、其他实体或环境引发的行为/事件。

要创建 Local Regions，你需要拥有父区域的权限，或者在配置中拥有相应权限。

Local Regions can be created

方法是使用 RegionMarker 标记区域后执行相应命令，或者直接通过命令创建而不使用

RegionMarker。

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

区域的属性

区域、标志、组等属性都可以通过

一个交互式 CLI进行管理。

彩色文本表示可交互的快捷命令或命令建议。所有彩色文本都有一个 tooltip 提示，

会简要说明点击对应链接后会执行什么。

点击它们后，会为玩家提供一个命令执行建议，或者有时会直接执行 hover 文本中提示的命令。

区域只能由其所有者管理，或由拥有所需 OP 等级、或在配置中有相应条目的玩家管理。更多信息请参阅 wiki。

当创建新的 Local Region 且未指定父区域时，其父区域将被设置为该 Local Region 所在维度的 Dimensional Region。

Local Regions 也可以拥有子区域。Local Regions 的子区域必须包含在父区域的范围内。区域层级还定义了区域优先级。

子区域的优先级必须始终高于其父区域。

Dimensional Regions 始终以 Global Region 作为父区域，因此 Global Region 的子区域就是所有 Dimensional Regions。

区域有所有者和普通成员。所有者可以管理区域并绕过标志限制，而成员

只能绕过该区域中设置的标志。

Owners 和 Members 可以是单独的玩家，也可以是一个队伍。

组允许你为不同玩家和队伍分配特定的区域权限。目前，只有两个

默认组：owners 和 members。

• Owners 可以自行管理自己的区域，并向区域中添加其他玩家/队伍。他们还可以在自己的区域内创建

子区域、管理标志等等，当然所有者也可以绕过标志。

• Members 只允许绕过标志。

我计划在未来更新中加入 LuckPerms 集成，

这样你就可以定义自己的组和权限。

如果你在设置区域时遇到问题，欢迎到 discord 寻求帮助。

Flags 是区域保护系统的核心。它们定义了在区域中哪些行为被允许或拒绝。Flags

可以设置为：

• Allowed：允许对应行为，
• Denied：拒绝对应行为，
• Disabled：在标志检查时禁用该特定标志。

子区域会继承父区域的标志。此外，还可以通过相应设置父区域中该标志的 override 属性，

来覆盖子区域中的标志状态。

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

我计划在未来加入更多标志。一个建议中的标志列表，我会逐步将其加入模组，可在这里查看：

Flag suggestions

未来还会加入更复杂的标志。例如 ListFlag，它将允许你定义一个允许的

方块/实体/... 列表，用于限制某个标志上下文中的内容。

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

这使你能够自动化区域设置、添加/移除玩家、启用或禁用区域等操作。

YAWP 提供了一个不断扩展的模组集成 API，以便更轻松地与其他模组和整合包进行集成。目前，该 API 允许其他模组

监听区域创建、更改和删除事件，并可取消这些事件以阻止其发生。

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

标志检查的结果。

[

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

german 和 russian。

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

如果你的语言尚未被支持，欢迎通过 discord 联系我，或者通过 github 提交 pull request！ :)

该模组的配置允许你控制谁可以使用该模组、设置 Local 和

Dimension Regions 的默认标志、命令行界面选项等。

配置被拆分为不同文件，用于覆盖不同主题。

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

由于 YAWP 是一个服务端模组，它的配置位于你的 minecraft 世界目录中的 /serverconfig

目录下。

[

该模组的文档目前还不多，但正在不断完善。我正在努力跟进内容更新。你可以在

这里查看文档：>。

文档内容包括：

• 不同区域的说明
• 快速开始 & FAQ
• 可用命令与标志
• 配置
• 以及更多……

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

路线图

还有很多功能即将到来。该模组正在积极开发中！

以下列表并不完整。

• 不同类型的标志（List、Effect、...），以实现更细粒度的控制
• 由数据包驱动的标志配置
• 区域边界可视化
• 定义你自己的区域组，以更细粒度地管理区域（LuckPerms）
• 更细粒度的权限系统（结合更细粒度的组功能）
• 区域模板，以更方便地管理具有不同空间属性的相同区域
• 进入/离开区域的区域触发器（用于显示消息、执行命令等）*
• 不同形状的区域（Cylinder、Prism、3DPolygon）*
• \