Releases
—
Setup (Upstream Docs)
—
Issues
Warning
This is an unofficial fork of HuskSync by William278. It is not affiliated with or endorsed by the original author. Use at your own risk. Always back up your player data before installing or upgrading.
HuskSync is a modern, cross-server player data synchronization system that enables the comprehensive synchronization of your user's data across multiple proxied servers. It does this by making use of Redis and a MySQL/Mongo/PostgreSQL to optimally cache data while players change servers.
This fork adds support for Paper 26.1.x (Minecraft's new versioning scheme), which is not yet supported by the official release. All existing 1.21.x support is preserved.
Changes from upstream (v3.8.8):
- ✅ Added Paper 26.1.2 support
- 🔧 Updated NBT-API
2.15.5→2.15.7(fixes startup failure on Paper 26.1.x version strings) - 🔧 Updated Triumph-GUI
3.1.12→3.1.13(improved 1.21.7+ inventory support) - 🏗️ Added Gradle Java Toolchain support for auto-provisioning JDK 25
⭐ Seamless synchronization — Utilises optimised Redis caching when players change server to sync player data super quickly for a seamless experience.
⭐ Complete player synchronization — Sync inventories, Ender Chests, health, hunger, effects, advancements, statistics, locked maps & more—no data left behind!
⭐ Backup, restore & rotate — Something gone wrong? Restore players back to a previous data state. Rotate and manage data snapshots in-game!
⭐ Import existing data — Import your MySQLPlayerDataBridge data—or from your existing world data! No server reset needed!
⭐ Works great with Plan — Stay in touch with your community through HuskSync analytics on your Plan web panel.
You must download the correct JAR for your server's Minecraft version. Each JAR only loads on its target version.
| Minecraft | Java Version | Platforms | Support Status |
|---|---|---|---|
| 26.1.2 | 25 | Paper | ✅ This fork |
| 1.21.11 | 21 | Paper | ✅ Upstream active release |
| 1.21.10 | 21 | Paper | ✅ Upstream active release |
| 1.21.7/8 | 21 | Paper, Fabric | ✅ Upstream active release |
| 1.21.5 | 21 | Paper, Fabric | ✅ Upstream active release |
| 1.21.4 | 21 | Paper, Fabric | ✅ Upstream active release |
| 1.21.1 | 21 | Paper, Fabric | ✅ Upstream active release |
Paper 26.1.2 requires Java 25. Ensure your server JVM is Java 25 or newer.
Requires a MySQL/MariaDB/Mongo/PostgreSQL database, a Redis (v5.0+) server and a network of compatible Paper servers.
- Back up your existing player data before installing or upgrading.
- Download the correct JAR for your server version from Releases.
- Place the JAR in the
/pluginsdirectory of each server. - Start, then stop every server to let HuskSync generate config files.
- Fill in your database and Redis credentials in
config.ymlon each server. - Start every server again — synchronization will begin.
Building requires Java 25 (for the 26.1.2 module; Gradle will auto-provision it via Foojay if not installed). Builds are output to /target:
./gradlew clean buildHuskSync uses essential-multi-version (Fabric) and preprocessor (Bukkit) to target multiple Minecraft versions from a single codebase.
This fork is licensed under the Apache 2.0 license, the same as the upstream project.
⚠️ This fork is community-maintained and unsupported by William278. For issues specific to Paper 26.1.x support in this fork, please open an issue here.For general HuskSync support, please refer to the official project (purchase required for Discord support).
- Upstream HuskSync — Original project by William278
- Docs — Official plugin documentation
- Issues (this fork) — Report fork-specific bugs
Fork maintained by MrPippi. Based on HuskSync © William278, 2025. Licensed under the Apache-2.0 License.