Compatibility

HuskSync supports the following versions of Minecraft. Since v3.7, you must download the correct version of HuskSync for your server:

MinecraftLatest HuskSyncJava VersionPlatformsSupport Status
1.21.4latest21Paper, Fabric✅ Active Release
1.21.33.7.121Paper, Fabric🗃️ Archived (December 2024)
1.21.1latest21Paper, Fabric✅ November 2025 (LTS)
1.20.63.6.817Paper🗃️ Archived (October 2024)
1.20.43.6.817Paper🗃️ Archived (July 2024)
1.20.1latest17Paper, Fabric✅ November 2025 (LTS)
1.17.1 - 1.19.43.6.817Paper🗃️ Archived
1.16.53.2.116Paper🗃️ 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.

MinecraftServer SoftwareNotes
1.19.4Only: Purpur, Pufferfish†Older Paper builds also not supported.
1.19.3Only: Paper, Purpur, Pufferfish†Upgrade to 1.19.4 or use Spigot
1.16.5AllPlease use v3.3.1 or lower
below 1.16.5AllUpgrade 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 yur 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