Skip to main content

๐Ÿ“— Introduction

Sparrow Sync keeps player progress together across Minecraft servers. Inventories, experience, advancements, and other player data follow the player, while saved snapshots give administrators a way to inspect or restore an earlier state.

What travels with the playerโ€‹

Choose which data types to share: inventories, ender chests, experience, health, hunger, potion effects, advancements, statistics, attributes, location, and more. Each type has its own configuration switch.

๐Ÿ”„ Smooth transfers

Most incoming data is prepared before the player joins, so they do not have to wait through a freeze after appearing in the world.

๐Ÿ“ฆ Saved snapshots

Player data is stored as snapshots. Browse what was saved, inspect the contents, and restore an earlier record when needed.

๐Ÿ—บ๏ธ Shared maps

Map data can travel between servers too, with configurable synchronization modes and interaction controls.

Sparrow Sync uses Redis to coordinate player sessions across servers. For persistent snapshots, choose MongoDB, MySQL, MariaDB, or PostgreSQL. Player state is captured on the appropriate server thread; encoding and storage happen asynchronously, and work for the same player stays in order.

See it in actionโ€‹

Click an animation to see the details.

A player switches servers and enters the world without a post-join freeze
โœจ Join without the pauseMost of the incoming player state is ready before the join completes.
A map remains available after moving to another server
๐Ÿ—บ๏ธ Take maps across serversShare map content across the network when map synchronization is enabled.
Browsing and managing player snapshots in the in-game menu
๐Ÿ–ฅ๏ธ Manage snapshots in gameBrowse records, inspect their contents, restore, pin, or export them.
Browsing player snapshots through the chat text panel
๐Ÿ’ฌ Work from the text panelView snapshot records and their actions in chat.
Detailed log entries for login, data application, saving, and session locks
๐Ÿงพ Follow the sync processDedicated logs show what happened during login, data application, saving, and session coordination.

Tools for administratorsโ€‹

Snapshots use Sparrow NBT and can be stored with Zstd or Deflate compression, or without compression. If something goes wrong, local exception archives and snapshot import, export, and bulk archive commands help you inspect and manage the data. You can also migrate existing data from HuskSync or InvSync with a command. See the command reference for the available tools.

Getting helpโ€‹

  • Paid users can complete verification via the Discord bot to access the exclusive support channel.
  • Developers of public projects can get free development support in the #api-help channel.
  • You can also submit an Issue on GitHub to receive low-priority support.