泽罗地图区域

✦ 使用方法

在专用服务器和每个需要查看或管理区域的客户端上安装 Xaero Regions 和 Kotlin for Forge。客户端需要安装 Xaero 的世界地图模组。没有安装客户端模组的玩家将无法看到地图覆盖层。

打开 Xaero 的世界地图并使用区域控制功能：

• R：当玩家在创造模式且是管理员时，在 Xaero 地图界面上打开区域绘制工作流程。
• P 或 鼠标中键点击：添加一个多边形顶点。
• 鼠标右键点击 或 Enter：完成多边形绘制并打开区域编辑器。
• Backspace 或 Delete：在绘制过程中移除最后一个顶点。
• E：编辑光标下的可管理区域。
• T：编辑光标下的可管理区域，或当光标下没有区域时打开区域管理器。
• Shift + R：直接打开区域管理器。

显示偏好设置存储在本地 config/xaeroregions-client.properties 文件中。可用选项包括区域名称、图标、重叠区域精简、屏幕上最小标记尺寸以及最大渲染距离。默认渲染距离为 8192 格；使用 0 表示不限距离。

✦ 服务器权限

服务器权限在 config/xaeroregions-server.properties 文件中配置：

operatorPermissionLevel=2
allowNonOperatorRegionCreation=false

使用默认值（false）时，只有管理员可以创建、编辑、删除区域或上传自定义图标。管理员可以在生存模式或创造模式下执行这些操作。

当 allowNonOperatorRegionCreation=true 时，所有玩家都可以创建区域和上传新图标。非管理员只能编辑或删除自己创建的区域；管理员可以管理所有区域。服务器会分配并保留创建者的 UUID，因此修改过的客户端无法伪造所有权。

管理员的 /region 命令始终仅限管理员使用，无论此设置如何。不需要创造模式。

对某位玩家隐藏区域

/region hide <player> <region>

再次显示隐藏的区域

/region visible <player> <region>

创建点标记

/region createpoint <player> <mode> <iconname> <label> <x> <y> <z>

参数说明：

• <player>：目标玩家，该玩家将看到此标记。
• <mode>：标记的持续时间模式。
• <iconname>：预定义的像素图标。输入时命令会提示可用的图标名称。
• <label>：标记下方显示的文本。标签中包含空格时请使用引号。
• <x> <y> <z>：标记的方块坐标。

模式说明：

• waitenter：当目标玩家进入标记所在的区块时，标记消失。
• waitcommand：标记一直保留，直到使用 /region delpoint 命令移除。

删除点标记

/region delpoint <player> <x> <y> <z>

✦ 功能特性

• 直接在 Xaero 的世界地图上绘制自由形式的多边形区域。
• 支持名称、ARGB 颜色、透明度、分类、预定义像素图标和自定义 PNG 图标。
• 使用 SavedData 将区域存储在服务器上，并同步到连接的客户端。
• 对每个修改数据包在服务器端再次执行创建和所有权权限检查。
• 尊重每个玩家的 Xaero 已探索地图数据，并在约 1.5 秒内淡入新揭示的部分。
• 渲染固定大小的标签，不再随地图缩放而增大，自动抑制过小或重叠的标签，并提供每个玩家的名称显示开关。
• 标签隐藏时保留彩色填充和可见轮廓。
• 针对大型地图进行优化，包括可见窗口剔除、可配置渲染距离、随缩放变化的战争迷雾细节级别、缓存的 Xaero 反射查找、缓存的多边形三角剖分、扫描线区块覆盖、合并可见区块矩形以及批量 GPU 填充。
• 玩家进入区域时显示标题。仅通过反射支持 Traveler's Titles 模组；如果该模组不存在，则使用内置的标题覆盖层。

✦ 依赖项

在发布模组和构建服务器整合包时，请使用以下依赖项。

NeoForge              |      21.1.220 或更新版本。

Kotlin for Forge       |      已测试版本：5.12.0 — 服务器和客户端均需要。

Xaero 的世界地图  |      1.44.2 或更新版本 — 客户端需要。

XaeroLib                  |      已测试版本：1.1.15

Traveler's Titles         |      可选 — 仅通过反射测试 | 如果不存在，Xaero Regions 将使用其内置的标题覆盖层。

请勿将 xaeroworldmap-neoforge-1.21.1-1.44.2.jar 重新分发到 Xaero Regions 的 jar 文件或仓库发布产物中。Xaero 的世界地图是外部依赖项，拥有自己的许可证。