Mirage Sync
by MRNOBODY-ZST
Mirage Sync keeps dimension region files in step between a main Minecraft server and its mirror servers, so a mirror can take over the world when needed.
What it does
Synchronization is incremental and runs in real time over a persistent TCP connection. The main server acts as the TCP server, and a mirror starts each sync by pulling changes from it. Several mirrors can connect to one main server at the same time, and each mirror operates independently. Only world region files with the .mca extension are transferred.
Admin-level commands require permission level OPERATORS. The mod also works with BungeeCord and Velocity proxies, where it acts as a world synchronization tool and passes player connections and chat through the proxy. Both servers need the same build of Minecraft before a sync can start.
Mirage Sync is released under the MIT License and is open source. It is published for Fabric only, in the 1.2.0 build for 1.21.11, and the server is required while the client is optional.
Key features
Incremental region sync
Only changed dimension region files are pulled from the main server, so each sync moves less data than a full copy would.
Multiple mirrors
One main server can serve several mirror servers at once, and each mirror keeps running on its own.
Player handling during sync
Players on a mirror that is syncing a dimension are kicked with a message and can reconnect immediately, while the main server keeps running for everyone else.
Atomic file transfer
Files are written to a temporary file and then moved into place, so an interrupted transfer leaves the mirror's world in its previous consistent state.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Backup servers
A mirror kept in step with the main server can be started when the main server is lost or unreachable.
Proxy networks
Networks behind BungeeCord or Velocity can keep a mirror current for each world they host.
Who it’s for: Server owners who run a main server with one or more mirror servers and want region files kept in sync between them.
How it compares
2core is a server-side Fabric mod for 1.21.11 under the MIT License and is open source. QUIC-MC is a client-side Fabric mod for 1.21.2 – 1.21.11 under the GNU Affero General Public License v3.0 only, and it is also open source. Mirage Sync is server required with client optional, and it targets 1.21.11 alone.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Mirage Sync | Fabric | 1.21.11 | Server required, client optional | 2026-04-25 |
| 2core | Fabric | 1.21.11 | Server-side only | 2026-05-20 |
| QUIC-MC | Fabric | 1.21.2 – 1.21.11 | Client-side only | 2026-08-10 |
Questions
Does Mirage Sync have to be installed on both servers?
What happens to players when a sync runs?
What should be done after a network cut?
In the catalog
Mirage Sync is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 19,862 mods support Minecraft 1.21.11.
Similar mods
What the author says
A Minecraft Fabric mod for incremental, real-time dimension region synchronization between a main server and one or more mirror servers. The output jar is at build/libs/mirage-.jar.
Official listing
- Modrinth page
- modrinth.com/mod/mirage-sync
- Owner
- MRNOBODY-ZST
- Published
- 2026-04-05
- Updated on Modrinth
- 2026-04-25
- Facts verified
- 2026-10-15