Xaero's World Map - Xaero的世界地图

请勿将此模组与 XaeroPlus 一同使用！该模组与我无关，且会导致无法追踪的严重错误/崩溃。据称其与一个服务器破坏团体有关联，可能危及你的服务器建筑。

Xaero's World Map 模组为你的 Minecraft 客户端添加了一张自动绘制全屏地图。它可以作为独立模组运行，但与 Xaero's Minimap 搭配使用效果更佳。之所以提供独立版本，是为了保持 Xaero's Minimap 尽可能轻量。此模组主要为客户端模组。在服务器端安装是可选的，用于启用一些额外功能，如世界识别。

本模组仍在开发中！请报告你遇到的任何错误，否则它们可能无法得到修复。 

请确保你的世界已针对你游玩的 Minecraft 版本进行优化（单人游戏 - 编辑 - 优化世界）（每次 Minecraft 更新后重复此操作）。从未优化的世界存档生成单人游戏地图所需时间要长得多。

在 Mastodon（Twitter 替代品）上关注我？ mas.to/@xaero96

在 Patreon 上支持我？ 

patreon.com/xaero96

谢谢！

功能特性

• 一张自动绘制的世界地图（与手动纸质地图相对）。你可以在同一服务器地址上创建多张地图，并手动或自动在它们之间切换。

• 适用于单人游戏、多人游戏和 Realms。

• 直观的界面。按 M 键打开地图界面。用鼠标移动地图，使用鼠标滚轮缩放，类似于谷歌地图。所有相关控制都列在地图界面的工具提示中，并且你可以自定义其中许多控制。

• 可选的服务器端自动多世界检测。

• 带有游戏内 UI 界面的服务器端配置，可让你实时控制服务器上玩家如何使用该模组。你可以基于等级/权限（xaero.worldmap.enforcedserver_profile）进行设置。支持 FTB Ranks、Odyssey Roles、LuckPerms 和通用权限 API。

• 显示来自 Open Parties and Claims 模组的区块声明和盟友玩家。允许你直接从地图上声明或强制加载区块。

• 资源包支持。更改资源包会导致整个世界地图重新生成。

• 洞穴维度支持（例如下界）。

• 可选的经典地图模式，使世界地图看起来像原版纸质地图。

• 地形着色自定义。

• 显示你最近所走路径的“足迹”。

• 可在必要时帮助提高模组性能的设置。不过在大多数情况下，模组默认应该表现良好。

• Xaero's Minimap 集成。小地图模组将显示世界地图提供的区块。世界地图模组将显示来自 Xaero's Minimap 模组的路径点。也可与 Better PVP 模组配合使用。你可以创建、编辑和传送到路径点，而无需离开地图界面。

• 药水效果，用于控制服务器/地图上玩家对世界地图的使用。截至撰写本文时，存在以下药水效果： xaeroworldmap:noworldmap. 默认情况下，这些效果属于中性类型，但你也可以通过将 harmful 附加到效果 ID 末尾来指定有害类型，例如 xaeroworldmap:noworldmapharmful。

• 自模组版本 1.14.0 起，你可以通过点击地图界面右下角的图标打开地图路径点菜单。在路径点菜单中，你可以看到所有已渲染集合中的地图路径点列表，用鼠标光标与它们交互，在文本框中按名称过滤它们。该菜单还允许你切换禁用路径点的可见性、切换渲染所有集合以及更改当前路径点集合。将鼠标悬停在菜单中的路径点上也会像在地图上悬停一样：它们会在地图上高亮显示，你可以使用右键单击或悬停控制与它们交互。

• 将地图导出为 PNG 图像文件的选项。该模组会尝试导出整个地图，因此如果地图长达数百万格，可能无法工作。我计划在未来提供更多导出地图的选项！

• 通过将其绑定到需要放在快捷栏或装备的物品上来限制地图访问的选项。例如，在配置文件的任意位置添加 mapItemId:minecraft:compass 将其绑定到指南针物品。这样，除非你的快捷栏中装备有指南针，否则地图将无法工作。

获取 Xaero's Minimap

常见问题

如何在多人游戏中恢复 1.30 版本更新前的下界地图，使其以“完整”洞穴模式类型显示？

首先，退出服务器并找到你用于连接该服务器的 Minecraft 游戏目录。在游戏目录中，进入 xaero/world-map/Multiplayer_[服务器地址]/DIM-1/[地图文件夹]。在旧版本中，xaero/world-map 就是 XaeroWorldMap。如果尚不存在，创建一个名为“caves”的文件夹（不带引号），并进入其中。在 caves 文件夹内，创建一个名为“-2147483648”的文件夹（不带引号），如果尚不存在的话。返回到包含“caves”文件夹的目录，将所有“.zip”文件移动到 caves/-2147483648 文件夹中。你可以随意删除缓存文件夹，或者将它们与“.zip”文件一起移动。

如何设置洞穴模式，使其行为像引入洞穴模式之前的 1.30 版本那样？

只有使用普通版小地图或完全不使用小地图时，你才能完全实现这一点。公平竞技版小地图现在会禁用世界地图的下界洞穴模式，且你无法切换此设置，因此不会和以前完全一样。

如果你有 1.30 版本之前的下界地图数据，请首先按照本页“如何在多人游戏中恢复 1.30 版本更新前的下界地图，使其以‘完整’洞穴模式类型显示？”下的说明将其移动到正确的文件夹。

完成后，加入一个世界/服务器并打开世界地图设置。找到“默认洞穴模式类型”并将其设置为关闭，然后将“清晰洞穴地图”设置为开启。接下来，打开世界地图界面，点击屏幕左下角的洞穴图标。在打开的菜单中，将“洞穴模式顶部 Y 坐标”设置为任意数字。如果你在主世界，将“洞穴模式类型”设置为关闭。当你稍后进入下界时，将“洞穴模式类型”设置为完整。洞穴模式类型是按维度存储的，因此你可以为任何类似下界的维度将其设置为完整，并为其他维度保持关闭。你还可以通过切换来显示基岩层上方或下方。

为什么右键传送对我不起作用？

该模组发送聊天命令将你传送到特定坐标，默认是 /tp @s x y z，因此需要相应的权限。原版 /tp 命令需要 OP 状态（启用作弊），但在安装了某些插件的非原版服务器上，命令可能有单独的权限设置。使用的命令可以在世界地图设置中通过“地图传送命令”更改。非原版传送命令通常不支持像 @s 这样的选择器，因此你可能需要将其从配置的命令中移除。还有一个名为“玩家传送命令”的选项，用于右键点击追踪的玩家（例如来自 Open Parties and Claims 的队友）时使用。传送到路径点使用小地图模组中的独立设置。你可以在小地图描述页面的常见问题下阅读相关内容。

如何在不手动行走的情况下探索地图？

在单人游戏中，地图直接从世界存档加载。这意味着你可以使用任何你喜欢的工具预生成世界，重新登录并使用世界地图设置中的“重新加载区域”选项来修复地图缓存中的任何冲突。在多人游戏中，情况不那么简单。但是，如果你可以下载服务器世界存档并在单人游戏中进入该世界，那么你可以使用你选择的方法预生成世界，重新登录，然后使用世界地图设置中的“转换所有区域”将整个世界存档转换为多人游戏兼容的地图实例，保存到 xaero->world-map->World->null->cm$converted。在旧版本中，xaero/world-map 就是 XaeroWorldMap。你可以复制/移动该地图实例文件夹到你的服务器地图实例文件夹（位于 xaero/world-map 文件夹中）。

为什么同一服务器地址/IP 上的多个世界使用并写入同一张地图？

此模组允许你在同一服务器地址上拥有多张地图。你可以随时自由切换地图并创建新地图。通过为所游玩的服务器类型选择正确的“地图选择”模式，可以防止地图被覆盖。地图选择是通过点击世界地图界面左下角的图标（如果菜单默认未打开）在特殊菜单中完成的。在菜单中，你可以在手动、世界出生点和单一模式之间切换，并使用顶部中央的下拉菜单选择/创建地图。如果将鼠标悬停在地图选择选项上，你可以阅读关于每种地图选择模式所需了解的一切，包括服务器模式。世界出生点模式等同于 1.6 版本之前世界地图使用的模式。因此你无需降级模组即可继续使用它。服务器模式是大多数情况下的最佳选择，因为服务器会根据服务器端的世界 ID 自动控制你的地图选择。这需要在服务器端安装该模组。如果更改地图选择模式将你的地图切换为空地图，你始终可以通过从下拉菜单中选择并确认来重新绑定你想要使用的地图。 

为什么世界地图要求确认？

单个服务器地址可以有多个主世界、下界等。这可能是由于多个子服务器或多个世界存档，例如“大厅”世界和“游戏”世界。不同的世界在客户端没有唯一的标识符，这使得无法可靠地区分它们。因此，世界地图模组允许你在同一服务器地址上为每个维度拥有多个世界地图。在旧版模组中，默认情况下，地图选择是手动的，这意味着每次切换维度/世界/子服务器时，你都会被要求确认使用哪张地图。你也可以选择两种自动模式之一。地图选择是通过点击世界地图界面左下角的图标（如果菜单默认未打开）在特殊菜单中完成的。在菜单中，你可以在手动、世界出生点和单一模式之间切换，并使用顶部中央的下拉菜单选择/创建地图。如果将鼠标悬停在地图选择选项上，你可以阅读关于每种地图选择模式所需了解的一切，包括服务器模式。世界出生点模式等同于 1.6 版本之前世界地图使用的模式。因此你无需降级模组即可继续使用它。服务器模式是大多数情况下的最佳选择，因为服务器会根据服务器端的世界 ID 自动控制你的地图选择。这需要在服务器端安装该模组。如果更改地图选择模式将你的地图切换为空地图，你始终可以通过从下拉菜单中选择并确认来重新绑定你想要使用的地图。 

安装世界地图后，为什么我在服务器上看不到我的小地图路径点？

你当前确认的地图会影响小地图模组中哪个路径点子世界被视为自动。这允许每张创建的地图拥有独立的路径点数据。在任何时候，你都可以通过进入路径点菜单（按 U 键）并从右上角下拉菜单中选择来查看任何非自动的路径点子世界。你可以通过选择选项 -> 设子世界为自动来使任何子世界成为你当前确认地图的自动子世界。

为什么我的世界地图针对特定服务器“重置”了？

不要惊慌。它几乎肯定没有被实际删除。旧版世界地图使用基于世界出生点的系统将服务器划分为多张地图。这个系统经常因为服务器通过向你的游戏客户端发送虚假的世界出生点坐标来为原版指南针物品添加自定义功能而失效。 请确保将模组更新到最新版本。 现在有多种地图选择模式可供选择，手动模式是默认模式。你现在可以查看当前服务器地址上拥有的任何世界地图。点击世界地图左下角的图标打开地图选择菜单（如果默认未打开）。顶部中央的下拉菜单允许你选择现有的或创建新的世界地图。你可以将鼠标悬停在地图选择模式设置（左下角）上，阅读每种模式的工作原理。服务器模式是大多数情况下的最佳选择，因为服务器会根据服务器端的世界 ID 控制你的地图选择。这需要在服务器端安装该模组。 手动模式是最安全的替代方案，应该在其他所有服务器上都能工作。当服务器模式不可用时，还有另外两种自动地图选择模式。在设置的提示信息中阅读更多关于它们的内容。

旧地图不在地图菜单中？ 这可能意味着两种情况：服务器地址已更改或维度 ID 已更改。

让我们从维度 ID 更改开始。服务器上的每个维度在 游戏目录 -> xaero -> world-map  目录中都有一个单独的目录。在旧版本中，xaero/world-map 就是 XaeroWorldMap。 在开始处理任何文件之前，请备份 xaero/world-map 目录。 在旧版模组中，维度目录名称包含服务器地址和维度键，例如 XaeroWorldMap/Multiplayer127.0.0.1DIM1。在新版本中，维度目录是一个子目录，所以类似 xaero/world-map/Multiplayer127.0.0.1/DIM1。 出于兼容性原因，默认的 主世界、下界和末地 维度被命名为 null, DIM-1 和 DIM1。其他维度的名称应基于原始维度 ID，例如 Multiplayer127.0.0.1/minecraft$overworld_creative。在 1.16+ 版本中，你可以在 游戏内 F3 屏幕 上查看当前维度 ID，以确定哪个目录对应哪个维度（例如“minecraft:overworld”）。 请在编辑文件/目录前退出到游戏标题屏幕或关闭游戏。

每个维度目录包含子目录，每个子目录对应你在该维度中拥有的一张地图（例如 mw$default 或 mw-4,0,-4），以及一个名为 dimensionconfig.txt 的文件，其中包含地图的实际显示名称。你可以使用该文件来帮助你找到想要的具体地图目录。在地图目录之间移动/复制应该会在地图之间移动/复制它。你可以稍后在游戏中为其命名。 最常见的情况是将地图从 /null 移动到 /minecraft$overworldsurvival。当 1.16+ 服务器开始为每个子世界使用唯一的维度 ID 时，就需要这样做。

对于服务器地址更改，你首先需要删除 游戏目录 -> xaero -> world-map 中包含新服务器地址的所有目录。如果你使用的是最新版模组，通常只有一个这样的目录。 在操作之前，请备份整个 xaero/world-map 目录。同时，至少将游戏退出到标题屏幕。 然后，你需要将每个旧服务器地址目录（在 xaero/world-map 中）重命名为新地址，仅替换地址部分。

如有疑问，请给我留言或发表评论！