mapsyncer-rebuild

Minecraft 版本： 26.1.2

平台： fabric

标签： management utility

Introduction
MapSyncer Rebuild is a map synchronization mod for Xaero's World Map.

Normally, Xaero's World Map stores map data locally on each player's client. This means that when a new player joins a server that has already been explored for a long time, their map is usually empty, and they need to explore the world again to reveal the terrain.

MapSyncer Rebuild solves this problem by allowing the server to send already generated or cached map regions to the player's client.

In short:

The server already has map data
↓
The player joins the server
↓
The player uses MapSyncer
↓
Xaero's World Map receives the existing server map
This is useful for survival servers, private servers, large worlds, exploration servers, building servers, and any server where players should be able to access existing map data more easily.

What Does This Mod Do?
Lets new players receive existing server map data without re-exploring everything.
Helps players restore map data after reinstalling the game or switching computers.
Allows the server to provide shared Xaero World Map cache data.
Supports syncing the current dimension, all dimensions, or a specific dimension.
Supports radius sync, which only syncs map data around the player.
Supports public waypoint sync.
Provides an in-game GUI.
Allows OPs to generate or refresh server-side map cache.
Optionally supports Voxy sync.
Requirements
Client
Players need:

Fabric Loader
Fabric API
MapSyncer Rebuild
Xaero's World Map
Xaero's World Map is required on the client to display the synchronized map data.

Server
Servers need:

Fabric Loader
Fabric API
MapSyncer Rebuild
The server does not need Xaero's World Map.

Optional
For Voxy sync, both the server and client should have:

Voxy
Voxy is optional. Normal Xaero map sync works without it.

How to Use as a Player
After joining a server with MapSyncer Rebuild installed, you can open the GUI with:

/mapsyncer gui
Or sync your current dimension directly with:

/mapsyncer sync
Sync all available dimensions:

/mapsyncer sync all
Sync nearby map regions only:

/mapsyncer sync radius
Example:

/mapsyncer sync radius 1000
Sync a specific dimension:

/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
Player Commands
/mapsyncer
Show help.

/mapsyncer help
Show help.

/mapsyncer gui
Open the MapSyncer GUI.

/mapsyncergui
Shortcut command for opening the GUI.

/mapsyncer sync
Sync the current dimension.

/mapsyncer sync all
Sync all available dimensions.

/mapsyncer sync radius
Sync map data within a radius in the current dimension.

/mapsyncer sync
Sync a specific dimension.

How to Use as a Server Admin
After installing the mod on a server for the first time, an OP should run:

/mapsyncer generate
This generates the initial server-side map cache.
After that, players can use /mapsyncer sync or the GUI to download the map data.

Useful OP commands:

/mapsyncer generate
Generate map cache for all dimensions.

/mapsyncer generate
Generate map cache for a specific dimension.

Example:

/mapsyncer generate minecraft:overworld
/mapsyncer generate force
Force rebuild the map cache for a specific dimension.

Example:

/mapsyncer generate minecraft:overworld force
/mapsyncer status
Check current cache generation and sync status.

/mapsyncer incremental run
Run an incremental refresh immediately.

/mapsyncer incremental tick
Enable automatic refresh by tick interval.

Example:

/mapsyncer incremental tick 200
/mapsyncer incremental scheduled
Enable scheduled daily refresh.

Example:

/mapsyncer incremental scheduled 4 30
This runs the refresh every day at 04:30.

GUI Features
Players can open the GUI with:

/mapsyncer gui
Regular players can:

Sync the current dimension
Sync all dimensions
Use radius sync
Sync public waypoints
Use Voxy sync if available
Change client-side auto-sync and HUD settings
OPs can also:

View server cache status
Trigger cache generation
Run incremental refresh
Force rebuild dimension cache
Configure radius sync policy
Import local Xaero waypoints as public server waypoints
Public Waypoints
MapSyncer Rebuild supports public waypoint sync.

Server admins can provide public waypoints such as:

Spawn
Towns
Teleport points
Public buildings
Resource world entrances
Event areas
Shops
Public waypoints are merged into Xaero's waypoint files.
MapSyncer only manages the public waypoint group and does not intentionally overwrite private player waypoints.

Voxy Sync
Voxy sync is optional.

If both the client and server have Voxy installed and enabled, MapSyncer can provide Voxy sync through the GUI.
If Voxy is not installed, normal Xaero World Map sync still works.

Notes
This mod must be installed on both the client and the server.
Xaero's World Map is required on the client.
Xaero's World Map is not required on the server.
The first sync on a large world may take some time.
Server admins should run /mapsyncer generate before players sync.
If the map does not refresh immediately after syncing, reopen Xaero's map or rejoin the server.
Public waypoints do not intentionally overwrite private player waypoints.
Voxy is optional and not required for normal map sync.