Skip to content
All work

tool

MineSync

Synchronizes a Minecraft server folder, vanilla or modded (Forge, NeoForge, Fabric, Quilt), across the PCs of a group on a private ZeroTier network. A self-hosted hub stores every world with its full history; the client takes an exclusive lock, downloads only the files that changed, runs the server and uploads a new version every five minutes.

GitHub stars
0
The MineSync client hosting a session, with the server console, the players online and the address to join

Background

A shared Minecraft world needs a host. A dedicated server adds cost and maintenance, and when the host is one member’s PC, the world is only available while that PC is on. MineSync lets any member of the group host: the world lives on a hub, and each session starts from its latest version.

Hosting a session

The client lists the servers on the hub. Starting one takes the lock, so only one member hosts at a time, then downloads the files that changed since the last session, selects a compatible Java runtime and starts the server with an embedded console. Every five minutes it saves the world and uploads a new version; stopping the server uploads the final state and releases the lock.

  • Exclusive lock: kept alive by a heartbeat and released after 90 seconds if the host crashes.
  • Local changes are preserved: changes that never reached the hub are uploaded first when that is safe, or kept in a backup if someone else has hosted since.
  • Unattended operation: the server stops after 30 minutes with nobody online and restarts automatically after a crash, up to twice.
  • Fixed address: the hub can serve DNS for zerotier.<server>.internal, which resolves to the current host, so players keep one address in Minecraft.
Client: servers and recent activityClient: a server's status, local copy and historyClient: every version of a server

The hub

A single static Go binary, deployed as a Docker container on an always-on machine such as a NAS. Storage is content-addressed (SHA-256, with region files split into chunks), so each version stores only what changed. Any version can be restored, as a whole world or a single file, or exported as a ZIP. Automatic retention never removes the last 24 hours and keeps one version per day for a week.

The web interface shows the current host and the address to join, world details, players, mods and the full history. The hub can also check that the host’s game port is reachable and post to Telegram when a server opens or closes.

Web interface: servers, current hosts and live activity
Web interface: a hosted server, with its address and world detailsWeb interface: history with restore and downloadWeb interface: players and their statisticsWeb interface: mods with details

Access and security

MineSync has no passwords or tokens of its own. The hub runs inside the ZeroTier container’s network and identifies each request through ZTNET, so access follows network membership: adding a player means authorizing them in ZTNET. The hub only coordinates sessions; game traffic goes directly between players and the host.

Clients update from the hub. Each download is verified against SHA-256 checksums and, optionally, an ed25519 signature, and downgrades are refused. The client, the web interface and the Telegram bot are available in English and Italian.

Next project

mpv_audio_kit

Audio engine for Flutter and Dart, built on mpv 0.41.