mapsyncer-rebuild

mapsyncer-rebuild

一个针对Xaero的双向同步模组，包含脏区增量更新、后台迁移、Voxy支持和网络优化功能。

管理

简介

MapSyncer Rebuild 是一款用于 Xaero 小地图的世界地图同步模组。

通常情况下，Xaero 小地图将地图数据存储在每位玩家的客户端本地。这意味着，当新玩家加入一个已被探索许久的服务器时，他们的地图通常是空的，需要重新探索世界才能揭示地形。

MapSyncer Rebuild 通过允许服务器将已生成或缓存的地图区域发送到玩家客户端，解决了这一问题。

简单来说：

服务器已经拥有地图数据 ↓ 玩家加入服务器 ↓ 玩家使用 MapSyncer ↓ Xaero 小地图接收服务器已有的地图 这对于生存服务器、私人服务器、大型世界、探索服务器、建筑服务器以及任何希望玩家能更轻松获取现有地图数据的服务器都非常有用。

此模组的功能

  • 让新玩家无需重新探索即可接收现有的服务器地图数据。
  • 帮助玩家在重装游戏或更换电脑后恢复地图数据。
  • 允许服务器提供共享的 Xaero 小地图缓存数据。
  • 支持同步当前维度、所有维度或特定维度。
  • 支持半径同步，仅同步玩家周围的地图数据。
  • 支持公共航点同步。
  • 提供游戏内 GUI。
  • 允许管理员生成或刷新服务器端的地图缓存。
  • 可选择支持 Voxy 同步。

需求

客户端

玩家需要：

  • Fabric Loader
  • Fabric API
  • MapSyncer Rebuild
  • Xaero 小地图

客户端需要安装 Xaero 小地图来显示同步后的地图数据。

服务端

服务器需要：

  • Fabric Loader
  • Fabric API
  • MapSyncer Rebuild

服务器不需要安装 Xaero 小地图。

可选

对于 Voxy 同步，服务端和客户端都需要安装：

  • Voxy

Voxy 是可选的。没有它，普通的 Xaero 地图同步也能正常工作。

玩家使用指南

加入安装了 MapSyncer Rebuild 的服务器后，你可以使用以下命令打开 GUI：

/mapsyncer gui

或者直接同步当前维度：

/mapsyncer sync

同步所有可用维度：

/mapsyncer sync all

仅同步附近的地图区域：

/mapsyncer sync radius <范围>

示例：

/mapsyncer sync radius 1000

同步特定维度：

/mapsyncer sync overworld /mapsyncer sync the_nether /mapsyncer sync the_end /mapsyncer sync minecraft:overworld /mapsyncer sync minecraft:the_nether /mapsyncer sync minecraft:the_end

玩家命令

  • /mapsyncer 显示帮助信息。

  • /mapsyncer help 显示帮助信息。

  • /mapsyncer gui 打开 MapSyncer GUI。

  • /mapsyncergui 打开 GUI 的快捷命令。

  • /mapsyncer sync 同步当前维度。

  • /mapsyncer sync all 同步所有可用维度。

  • /mapsyncer sync radius <方块数> 在当前位置同步指定半径内的地图数据。

  • /mapsyncer sync <维度> 同步特定维度。

服务器管理员使用指南

首次在服务器上安装此模组后，管理员应运行：

/mapsyncer generate

这将生成初始的服务器端地图缓存。 之后，玩家就可以使用 /mapsyncer sync 或 GUI 来下载地图数据。

有用的管理员命令：

  • /mapsyncer generate 为所有维度生成地图缓存。

  • /mapsyncer generate <维度> 为特定维度生成地图缓存。

示例：

/mapsyncer generate minecraft:overworld

  • /mapsyncer generate <维度> force 强制重建特定维度的地图缓存。

示例：

/mapsyncer generate minecraft:overworld force

  • /mapsyncer status 检查当前的缓存生成和同步状态。

  • /mapsyncer incremental run 立即运行增量刷新。

  • /mapsyncer incremental tick <间隔> 按游戏刻间隔启用自动刷新。

示例：

/mapsyncer incremental tick 200

  • /mapsyncer incremental scheduled <小时> <分钟> 启用定时每日刷新。

示例：

/mapsyncer incremental scheduled 4 30 这将每天在 04:30 运行刷新。

GUI 功能

玩家可以使用以下命令打开 GUI：

/mapsyncer gui

普通玩家可以：

  • 同步当前维度
  • 同步所有维度
  • 使用半径同步
  • 同步公共航点
  • 使用 Voxy 同步（如果可用）
  • 更改客户端自动同步和 HUD 设置

管理员还可以：

  • 查看服务器缓存状态
  • 触发缓存生成
  • 运行增量刷新
  • 强制重建维度缓存
  • 配置半径同步策略
  • 将本地 Xaero 航点导入为服务器公共航点

公共航点

MapSyncer Rebuild 支持公共航点同步。

服务器管理员可以提供公共航点，例如：

  • 出生点
  • 城镇
  • 传送点
  • 公共建筑
  • 资源世界入口
  • 活动区域
  • 商店

公共航点会合并到 Xaero 的航点文件中。 MapSyncer 仅管理公共航点组，不会故意覆盖玩家的私人航点。

Voxy 同步

Voxy 同步是可选的。

如果客户端和服务器都安装并启用了 Voxy，MapSyncer 可以通过 GUI 提供 Voxy 同步。 如果未安装 Voxy，普通的 Xaero 小地图同步仍然可以工作。

注意事项

  • 此模组必须在客户端和服务端都安装。
  • 客户端需要安装 Xaero 小地图。
  • 服务端不需要安装 Xaero 小地图。
  • 首次同步大型世界可能需要一些时间。
  • 服务器管理员应在玩家同步之前运行 /mapsyncer generate。
  • 如果同步后地图没有立即刷新，请重新打开 Xaero 的地图或重新加入服务器。
  • 公共航点不会故意覆盖玩家的私人航点。
  • Voxy 是可选的，不是正常地图同步所必需的。