Compatibility
HuskSync supports the following versions of Minecraft. Since v3.7, you must download the correct version of HuskSync for your server:
| Minecraft | Latest HuskSync | Java Version | Platforms | Support Status |
|---|---|---|---|---|
| 1.21.7/8 | latest | 21 | Paper | ✅ Active Release |
| 1.21.6 | 3.8.5 | 21 | Paper | 🗃️ Archived (July 2025) |
| 1.21.5 | latest | 21 | Paper | ✅ January 2026 (Non-LTS) |
| 1.21.4 | latest | 21 | Paper, Fabric | ✅ November 2025 (Non-LTS) |
| 1.21.3 | 3.7.1 | 21 | Paper, Fabric | 🗃️ Archived (December 2024) |
| 1.21.1 | latest | 21 | Paper, Fabric | ✅ November 2025 (LTS) |
| 1.20.6 | 3.6.8 | 17 | Paper | 🗃️ Archived (October 2024) |
| 1.20.4 | 3.6.8 | 17 | Paper | 🗃️ Archived (July 2024) |
| 1.20.1 | latest | 17 | Paper, Fabric | ✅ November 2025 (LTS) |
| 1.17.1 - 1.19.4 | 3.6.8 | 17 | Paper | 🗃️ Archived |
| 1.16.5 | 3.2.1 | 16 | Paper | 🗃️ Archived |
HuskSync is primarily developed against the latest release. Old Minecraft versions are allocated a support channel based on popularity, mod support, etc:
- Long Term Support (LTS) – Supported for up to 12-18 months
- Non-Long Term Support (Non-LTS) – Supported for 3-6 months
Incompatible versions
This plugin does not support the following software-Minecraft version combinations. The plugin will fail to load if you attempt to run it with these versions. Apologies for the inconvenience.
| Minecraft | Server Software | Notes |
|---|---|---|
| 1.19.4 | Only: Purpur, Pufferfish† | Older Paper builds also not supported. |
| 1.19.3 | Only: Paper, Purpur, Pufferfish† | Upgrade to 1.19.4 or use Spigot |
| 1.16.5 | All | Please use v3.3.1 or lower |
| below 1.16.5 | All | Upgrade to Minecraft 1.16.5 |
†Further downstream forks of this server software are also affected.
Incompatible plugins / mods
Please note the following plugins / mods can cause issues with HuskSync:
- Restart plugins / mods are not supported. These will cause player data to not save correctly when your server restarts due to the way these plugins utilise bash scripts. It's important to understand that restart plugins don't actually restart your server, they just trigger some (often unstable) process-killing scripting logic to occur!
- Combat logging plugins / mods are not supported. Some have built-in support for HuskSync and should work as expected, but for others you may wish to modify the [[Event Priorities]]