Unified Xaero Worldmap

作者：Navrelis

在多人服务器中共享并同步 Xaero的世界地图。玩家探索的区域会显示在所有人的地图上，包括洞穴和所有维度；玩家加入时也会同步地图进度。支持 Fabric、Forge、NeoForge，以及 1.16.5 至 26.3 版本。

模组 Fabric Forge NeoForge 地图与信息实用服务器工具

截图

介绍

介绍由机器翻译自 CurseForge 原页面，仅供参考。

Unified Xaero Worldmap 是一款模组，可在多人服务器的玩家之间同步 Xaero’s World Map。一个玩家探索过的所有区域都会实时显示在其他所有玩家的地图上，涵盖所有维度和洞穴层，因此服务器上的所有人都能共享同一张地图。支持 Fabric、Forge 和 NeoForge，适用于 Minecraft 1.16.5 至 26.3。

最后更新：2026年10月

Unified Xaero Worldmap. One shared Xaero's World Map for your whole server. For Fabric, Forge and NeoForge, Minecraft 1.16.5 to 26.3.

Animated recording from the real game at 2x speed, two map windows side by side. Player A on the left flies east and then south over new ground. The same ground appears on Player B's map on the right about 7 seconds later. Real game, two clients, default settings.

真实游戏画面，两个客户端，默认设置，以2倍速播放：左侧玩家进行探索，几秒后（实际约7秒），右侧另一位玩家的地图也随之填充。

Everyone's map, one map. Xaero's World Map is personal. On a server, this add-on turns it into one map the whole group fills in together. Two map pictures of the same player: without the mod, you only see what you walked yourself (a small patch of map). With it, what anyone explores shows on everyone's map (the map has grown along another player's route).

Xaero’s World Map 会将每位玩家探索过的地图保留给自己。使用 Unified Xaero Worldmap 后，任何玩家探索的区域都会加入一张所有玩家都能看到的共享地图，这样大家就不必一遍又一遍地重复探索同一片出生点区域。

You explore, everyone sees it. Three moments of one recording, each with Player A's map above Player B's map: A flies east, and B's map follows a few seconds behind. 5 s: live save interval (default). About 7 s: from one player's map to the next, measured. 0 commands or menus. Real game, two clients, default settings.

新探索的区域会在绘制完成约7秒后显示在另一位玩家的地图上。这是在真实游戏中使用两个客户端测得的。实时存档间隔默认为5秒，无需使用命令或菜单。

Away for a week? Your map is already filled in. Players who were offline catch up when they join. Two map pictures of a player who just joined: before, an empty map; a moment later, the whole shared map is filled in. A server map of 1000 regions reached a new player in about 7 minutes at the default rate, while the server kept up.

Animated recording from the real game in real time, two map windows side by side. On the left, the map Player A explored earlier. On the right, Player B has just joined: the map is empty at first and fills in on its own a few seconds later, until it matches Player A's. Real game, two clients, default settings.

真实游戏画面，两个客户端，默认设置，以正常速度播放：右侧玩家加入时地图是空的，随后共享地图会自动填充。

玩家加入时即使地图为空，也会自动填入共享地图。测试中，一名新玩家加入后6到10秒，地图上就显示了一条长840格的路线。按默认下载速率，包含1000个区域的服务器地图大约需要7分钟传输完成。

Every dimension, every cave layer. Nether, End and modded dimensions: discoveries in a dimension you are not in still arrive and wait for you there. Cave layers: cave maps sync like the surface does. Your old map counts: a map you had before installing is shared in the background. Nothing to set up: no web map, no file copying, no commands.

下界、末地和模组维度都会同步，洞穴层也一样。即使你不在某个维度中，该维度仍会接收新发现的区域，并保留这些内容，直到你前往那里。安装模组前已有的地图也会在后台共享，无需设置网页地图、复制文件或使用命令。

Fabric, Forge and NeoForge, 1.16.5 to 26.3. 38 builds for 14 Minecraft version families and 3 loaders. A table lists each supported Minecraft version from 1.16.2 to 26.3 with its loaders and Java version. Server and players use the same file.

该模组共有38个版本构建：Fabric 和 Forge 支持14个 Minecraft 版本系列，NeoForge 支持其中10个（1.20.4及更新版本）。服务器和每位玩家都使用同一个文件。

合并时只会添加或更新16×16格的区块，因此没人能清空共享地图，旧数据也只会填补空白。每位玩家都有上传量和处理量限制；整张地图的默认大小上限为4 GiB。如果 World Map 更新改动了本模组所依赖的内容，同步功能会自动关闭，并在聊天栏显示一条提示。

Install in three steps. 1, Server: put Xaero's World Map and this mod into the mods folder (plus Fabric API on Fabric, xaerolib on Forge and NeoForge). 2, Players: the same mods as the server. 3, Join. Syncing starts on its own. Needs Xaero's World Map 1.46.0 or newer on the server and on every client.

在服务器上安装 Xaero’s World Map 和本模组（Fabric 还需安装 Fabric API；Forge 和 NeoForge 还需安装 xaerolib），并让玩家安装相同的模组；玩家加入后便会开始同步。服务器和每位客户端都必须使用 Xaero’s World Map 1.46.0 或更高版本。

什么是 Unified Xaero Worldmap？

Unified Xaero Worldmap 是 Xaero’s World Map 的非官方附加模组，可将探索过的地图变为整个服务器共享的一张地图。只需在服务器和每位玩家的游戏中安装，无需进行其他设置。

通常情况下，Xaero’s World Map 会将每位玩家探索过的地图设为私有。你只能看到自己走过的区块，所以在有朋友一起玩的服务器上，每个人都会重复探索同一片出生点区域，也不知道其他人发现了什么。这个模组改变了这一点：

你探索过的地方，大家都能看到。 新区域会在几秒内出现在你朋友的地图上，无需重新加载、无需打开菜单、也无需输入命令。
离线一周后再上线。你的地图里已经填满了你不在时团队探索到的一切。
包括洞穴和维度。洞穴层会像地表一样同步，下界、末地以及服务器拥有的任何其他维度也是如此。即使你当前不在某个维度，该维度中的发现也会传过来并在那里等着你。
你现有的地图同样算数。在安装模组之前就已存在的地图会在后台与服务器共享，因此团队地图从一开始就包含所有人此前探索过的内容。
无需任何设置。没有网页地图，没有文件复制，也没有命令。在服务端和每位玩家的游戏中安装该模组即可。

共享地图是如何工作的？

玩家照常探索，模组会通过服务端将已探索的地图区块传递给其他所有人。新探索的区域会实时传输。玩家已有的地图则按定时器在后台传输。

实时更新。当至少有一名其他已同步玩家在线时，Xaero的世界地图会被要求每 5 秒保存一次地图区域，而不是每 60 秒。新的区块会发送到服务端，服务端将它们合并到共享地图中，再转发给其他在线玩家。
加入时补齐。当玩家加入时，服务端会分批发送共享地图。默认每秒 2 个地图区域，大约 200 到 600 KB/s，直到该玩家的地图完整为止。
现有地图。玩家在加入之前拥有的地图数据会在后台上传。每个客户端默认还会每 120 秒将自己的地图与服务端比对一次。正是通过这种比对，加入玩家的现有地图才能到达已经在线的玩家手中。
合并。共享地图按 16×16 方块的区块逐个合并。区块只会被添加或更新，永远不会被删除。
共享的内容。只有已探索的地图。路径点永远不会被共享，始终对每位玩家保持私密。
存储位置。共享地图及其配置存放在世界存档的 <world>/unified_xaero_worldmap/ 下，因此会与你的世界一起备份。

支持哪些 Minecraft 版本和模组加载器？

Unified Xaero Worldmap 在 Minecraft 1.16.5 到 26.3 上支持 Fabric、Forge 和 NeoForge。Fabric 和 Forge 覆盖 14 个 Minecraft 版本系列，NeoForge 覆盖其中 10 个（1.20.4 及更新版本），总计 38 个构建。它覆盖了 Xaero的世界地图 1.46 支持的所有 Minecraft 版本。

选择与你的 Minecraft 版本和模组加载器相匹配的文件。服务端和每位玩家都需要相同的文件，且 Minecraft 版本和加载器也必须相同。Java 列显示了该 Minecraft 版本对应的 Java 版本。

Minecraft	Fabric	Forge	NeoForge	Java
1.16.2 至 1.16.5	✅	✅	–	8
1.18.2	✅	✅	–	17
1.19.1 至 1.19.2	✅	✅	–	17
1.20 至 1.20.1	✅	✅	–	17
1.20.3 至 1.20.4	✅	✅	✅	17
1.21 至 1.21.1	✅	✅	✅	21
1.21.4	✅	✅	✅	21
1.21.5	✅	✅	✅	21
1.21.8	✅	✅	✅	21
1.21.10	✅	✅	✅	21
1.21.11	✅	✅	✅	21
26.1 至 26.1.2	✅	✅	✅	25
26.2	✅	✅	✅	25
26.3	✅	✅	✅	25

文件名格式如下unified-xaero-worldmap-<version>+1.21.1-neoforge.jar：模组版本，然后是 Minecraft 版本，最后是加载器。

以下这些介于其间的 Minecraft 版本不受支持，因为 Xaero’s World Map 1.46 没有为它们提供版本：1.17、1.19.3 和 1.19.4、1.20.2、1.20.5 和 1.20.6、1.21.2 和 1.21.3、1.21.6 和 1.21.7，以及 1.21.9。

我需要安装什么？

在服务端和每位玩家的游戏中，你都需要 Xaero’s World Map 1.46.0 或更新版本、本模组，以及一个支持库：Fabric 上为 Fabric API，Forge 和 NeoForge 上为 xaerolib。Xaero’s Minimap 为可选。

什么	版本
Xaero’s World Map	1.46.0 或更新版本，服务端和每个客户端都需要安装
仅 Fabric： Fabric Loader	0.18.4 或更新版本
仅 Fabric： Fabric API	适用于你的 Minecraft 版本的版本
仅 Forge / NeoForge： xaerolib	取决于你的 World Map 版本所需（CurseForge 和大多数启动器会自动将其作为 World Map 的依赖项安装）
Forge	适用于你的 Minecraft 版本的 Forge 版本（例如 1.20.1 用 47，1.21.1 用 52）
NeoForge	适用于你的 Minecraft 版本的 NeoForge 版本（例如 1.21.1 用 21.1）；在 26.3 上目前只有 NeoForge 测试版

Xaero’s Minimap 可与本模组配合使用，且仅在客户端需要。如果你使用它，请选择与 World Map 1.46 兼容的 Minimap 版本：26.4.0 或更新版本，已在 26.5.x 上测试。

如何在服务端安装？

安装你的加载器，将 Xaero’s World Map、本模组和支持库放入服务端的 mods 文件夹，然后启动服务端。玩家将相同的模组放入自己的游戏中。

在服务端：

为你的 Minecraft 版本安装加载器（Fabric、Forge 或 NeoForge）。
将以下内容放入服务端的 mods 文件夹：Xaero’s World Map、本模组，以及 Fabric API（Fabric 上）或 xaerolib（Forge 和 NeoForge 上）。
启动服务端。共享地图及其配置会自动创建在 <world>/unified_xaero_worldmap/ 中。

在每位玩家的游戏中： 与服务端相同的模组，放入游戏的 mods 文件夹。Xaero’s Minimap 为可选。

就这样。当玩家加入时，模组会检查双方是否匹配，同步会自动开始，无需其他操作。

谁可以加入使用它的服务端？

所有人都可以加入。该模组在双方均为可选，因此绝不会将玩家拒之门外。

未安装该模组的玩家会正常加入服务器，并使用自己未共享的 Xaero 地图进行游戏。
在未安装该模组的服务器上，安装了该模组的玩家也能正常游玩，只是没有可同步的内容。
使用不兼容模组版本的玩家会保持连接。其同步功能关闭，并会收到一条聊天消息，说明双方各自运行的版本。
通过 ViaVersion 等版本桥接代理加入、使用不同 Minecraft 版本的玩家：Xaero 的世界地图在某些 Minecraft 版本上存储地图的方式不同。如果格式不同，该玩家的同步会关闭，并显示一条清晰的聊天消息。使用服务器自身版本的玩家仍会正常同步。

共享地图在公共服务器上安全吗？

安全。Unified Xaero Worldmap 中的共享地图只会增长：合并会添加或更新区块，绝不会删除它们，而且服务器会限制每位玩家可发送的内容。

没有人能清空共享地图。合并是增量式的，每次处理一个 16×16 方块的区块。玩家发送的任何内容都无法意外或故意抹除或清空其他人已探索的内容。
新数据优先于旧数据，旧数据永远无法覆盖新数据。你刚探索的区块会更新共享地图。你加入前的旧地图数据只会填补空缺，绝不会覆盖其他玩家更近时间绘制的内容。
你自己的地图文件受到保护。传入的地图数据会按照 Xaero 自身的保存周期，谨慎地合并到你的地图中。模组无法安全读取的文件（例如来自旧版 Minecraft 的地图文件）会保持原样，绝不会被覆盖或删除。
专为公共服务器打造。服务器只接受属于其自身维度以及该维度中可能存在的洞穴层的地图数据，并会在数据到达任何人之前拒绝格式错误的数据。每位玩家都有上传速率限制，并且其占用的服务器后台工作份额也有上限。整个共享地图在磁盘上有大小上限，默认 4 GiB。玩家从未靠近过的位置的实时更新绝不会广播给其他人。
当 Xaero 更新时，它会安全失败。启动时，模组会检查它从 Xaero 的世界地图所需的一切是否仍然存在。如果未来的世界地图更新改变了某些内容，同步会自行关闭，并输出一行聊天信息和一行日志。你的游戏和地图会继续正常工作，模组不会崩溃。
单人游戏不受影响。单人世界永远不会同步。随时卸载该模组都会让 Xaero 的世界地图保持原样。

服务器配置

服务器首次启动时会写入带默认值的 <world>/unified_xaero_worldmap/config.json。更改在重启后生效。超出允许范围的值会被自动修正，损坏的配置文件会被备份并替换为默认值，而不是让服务器崩溃。默认值适合 5 到 20 名玩家的生存服务器。

设置	默认值	范围	作用
`syncEnabled`	`true`		总开关。`false`会为所有人关闭同步。
`liveSaveIntervalMillis`	`5000`	1000 至 60000	新探索的区域同步给其他在线玩家所需的时间（仅当至少有 2 名已同步玩家在线时生效）。数值越低，地图越新，但每个客户端的工作量也越大。如果玩家一起探索时感到卡顿，可以调高此值。
`reconcileIntervalSeconds`	`120`	10 至 86400	每个客户端与服务器核对地图的频率。它也决定了新加入玩家的现有地图同步给已在线玩家所需的时间。
`maxRegionsPerTick`	`2`	1 至 64	每轮发送给正在同步地图的玩家的地图区域数量（使用默认间隔时，每秒发送 2 个区域，约为 200 至 600 KB/s）。如果带宽充足，可调高此值以加快同步。
`syncIntervalTicks`	`20`	1 至 1200	两轮下载之间的刻数（20 表示每秒一次）。
`maxUploadsPerSecond`	`8`	1 至 256	每位玩家的上传速率上限。
`persistIntervalSeconds`	`30`	0 至 3600	合并后的地图数据写入磁盘的频率。`0`会在每次更改后立即写入。
`maxStoreBytes`	4 GiB	256 MiB 至 1 TiB	共享地图在磁盘上的总大小上限。达到上限后不会再添加新区域，但已绘制的区域仍会继续更新。探索充分的区域约占 100 至 200 KB，因此 4 GiB 大约可容纳 20000 至 40000 个区域。
`maxRegionsPerLayer`	`50000`	1 至 65536	每个维度和洞穴层存储的区域数量上限。
`maxIoMillisPerSecondPerPlayer`	`500`	50 至 1000	单个玩家可使用的服务器后台地图线程资源占比，避免某位玩家拥有超大地图时拖慢其他所有人。
`maxPayloadBytes`	1 MiB	64 KiB 至 1.5 MiB	单次地图上传或下载的最大数据量。
`maxInFlightBytesPerPlayer`	8 MiB	最高 64 MiB	单个玩家可排队等待处理的上传数据量上限。
`regionCacheSize`	`128`	8 至 4096	服务器保存在内存中的地图区域数量（默认约占 10 至 30 MB）。
`ioQueueCapacity`	`512`	16 至 65536	服务器后台工作队列的深度。

大多数服务器都无需更改任何设置。玩家通常会调整的是liveSaveIntervalMillis、maxRegionsPerTick和maxStoreBytes。若要在不卸载模组的情况下关闭它，请将syncEnabled设为false并重启。

性能

Unified Xaero Worldmap 对帧时间的影响很小，繁重的工作都在后台线程中运行。

独自在服务器上游玩：这个模组不会改变 Xaero 自身的行为或运行时机。
自身代码：每个客户端刻约 0.01 毫秒。所有地图解析、合并和磁盘操作都在后台线程中以最低优先级运行。
多人一起游玩：只要至少有一名其他已同步的玩家在线，Xaero 就会每 5 秒保存一次地图区域，而不是每 60 秒保存一次，让探索成果迅速同步给好友。在不限帧率的测试中，约 2000 FPS 时这项操作的开销约为 10%。在正常帧率下，你不会注意到它。服务器所有者可以调高 liveSaveIntervalMillis，以牺牲地图更新速度来进一步减少资源占用。
区域同步速度：在真实游戏中使用两名客户端和默认设置进行测试，新探索的区域在绘制到地图后约 7 秒就会出现在另一名玩家的地图上。一名加入时地图为空的玩家，在加入后 6 到 10 秒内，地图上就出现了一条长 840 格的路线。
同步大型地图：服务器上有 1000 个地图区域时，新加入的玩家在默认下载速率下约 7 分钟即可完成同步。发送地图数据时，服务器从未落后（出现“无法跟上”提示）。

已知限制

局域网世界：主机自己的地图不会同步，因为 Xaero 已经直接从存档绘制主机的世界地图。加入的访客会同步，此时主机充当服务器。
已有地图按定时任务传输，不会实时同步：玩家在加入前已有的地图数据会在后台上传，并在其他在线玩家下次定时检查时同步给他们（默认每 120 秒检查一次）。新探索的区域则会实时同步。
升级 Minecraft：在某些 Minecraft 版本中，Xaero’s World Map 使用不同的地图存储格式（1.16.5、1.18.2 至 1.21.4、1.21.5 至 26.2，以及 26.3 各自使用独立格式）。如果服务器升级到格式不同的版本，共享地图将从头开始，并根据玩家上传的内容重新构建。不会删除任何内容：旧服务器地图会保留在磁盘上的其他位置。每位玩家的旧地图会在 Xaero’s World Map 以新格式重写后重新同步；玩家重新探索相应区域时就会触发重写。
Xaero 的“完整”洞穴模式不会同步，普通洞穴图层则会同步。
你正在查看的地图区域会在其他玩家的地图区块同步到位时短暂重新加载。
混合加载器在同一服务器上（例如，Fabric 玩家加入 NeoForge 服务器）尚未经过测试。
大量人工负载（例如，每秒用脚本将多名玩家传送到尚未生成的地形中）可能会让原版世界生成不堪重负。这是原版的限制。该模组本身绝不会阻塞服务器线程。

常见问题

如何在服务器上与好友共享 Xaero’s World Map？

在服务器和每位好友的游戏中安装 Unified Xaero Worldmap，并搭配 Xaero’s World Map 1.46.0 或更高版本；请根据 Minecraft 版本和加载器选择对应文件。之后只需加入服务器即可：同步会自动开始，无需使用命令或菜单。任何玩家探索的区域都会显示在所有人的地图上，而路径点仍为私人信息。

它能和 Xaero’s Minimap 一起使用吗？

可以，Unified Xaero Worldmap 能与 Xaero’s Minimap 一起使用；小地图是可选的，只需安装在客户端上。请选择与 World Map 1.46 兼容的小地图版本，也就是 26.4.0 或更高版本；已使用 26.5.x 进行测试。该模组本身需要 Xaero’s World Map，而不需要小地图。

它支持 Fabric、Forge 和 NeoForge 吗？

支持，Unified Xaero Worldmap 为 14 个 Minecraft 版本系列提供 Fabric 和 Forge 版本，并为其中 10 个系列（1.20.4 及更高版本）提供 NeoForge 版本。服务器和每位玩家都必须使用相同的文件、Minecraft 版本和加载器。混合加载器的服务器（例如，Fabric 玩家加入 NeoForge 服务器）尚未经过测试。

这是像 Dynmap 或 BlueMap 那样的网页地图吗？

不，Unified Xaero Worldmap 不是网页地图。Dynmap 或 BlueMap 这类网页地图模组会在浏览器中显示服务器地图。这个模组则会填充每位玩家游戏内的 Xaero的世界地图，而且不需要网页服务器或开放端口。

Xaero的世界地图会自动在玩家之间共享已探索区域吗？

不会。单独使用 Xaero的世界地图时，每位玩家探索的地图仅对自己可见，也没有内置的区域共享功能。Unified Xaero Worldmap 会在多人服务器上添加共享功能，让每位玩家的地图都能显示整个团队探索过的区域。

新区域多久会显示在其他玩家的地图上？

在真实游戏中使用两名客户端和默认设置进行测试时，Unified Xaero Worldmap 会在某个区域被探索约 7 秒后，将其显示在另一名玩家的地图上。默认情况下，实时存档间隔为 5 秒，服务器所有者可以通过 liveSaveIntervalMillis 修改此设置。一名加入时地图为空的玩家，在加入后 6 到 10 秒就能看到一条长 840 格的路线。玩家加入前已有的地图默认每 120 秒同步一次。

服务器需要安装 Xaero的世界地图吗？

需要，服务器和每位玩家都必须安装。这样一来，即使你还没去过某个维度，新区域也能立即显示在你的地图上。

其他玩家能看到我的基地吗？

能，只要你探索过那里：任何人绘制的区域都会成为共享地图的一部分。这正是这个模组的用途，所以在有秘密基地的服务器上请留意这一点。路径点绝不会共享；每位玩家的路径点仍然仅自己可见。

路径点会同步吗？

不会。只有已探索的地图本身会同步。

恶意玩家能清空或篡改共享地图吗？

不能。合并操作只会添加或更新地图瓦片，玩家发送的任何内容都无法删除其他人探索过的区域；而且，玩家从未接近过的地点数据绝不会被广播。

它会同步我的单人游戏地图吗？

不会。单人游戏世界不会受到影响。通过局域网开放的世界只会与加入的访客同步，不会与主机同步。

没有安装这个模组的玩家会怎样？

他们可以正常加入和游玩，并使用自己的个人 Xaero 地图。

如果 Xaero的世界地图更新了会怎样？

这个模组会在启动时进行自检。如果所需内容发生变化，它会在聊天栏中提示一次，然后关闭同步并继续运行。游戏不会崩溃，你的地图也会继续正常使用。

不卸载模组也能关闭它吗？

可以：在服务器配置中将 syncEnabled 设为 false，然后重启服务器。

共享地图存储在哪里？

在世界存档的 <world>/unified_xaero_worldmap/ 目录下。它会随世界一起备份。

这是 Xaero 制作的吗？

不是。这是一个独立的非官方附加模组。请参阅鸣谢。

鸣谢

Unified Xaero Worldmap. Unofficial add-on for Xaero's World Map by Xaero96. Not affiliated with or endorsed by Xaero96. Xaero's World Map is required and is not included.