mapsyncer-rebuild

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.