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.10     |    _latest_     |      21      | Paper         | ✅ **Active Release**          |
|    1.21.7/8     |    _latest_     |      21      | Paper, Fabric | ✅ **August 2026**             |
|     1.21.6      |      3.8.5      |      21      | Paper         | 🗃️ Archived (July 2025)      |
|     1.21.5      |    _latest_     |      21      | Paper         | ✅ **February 2026** (Non-LTS) |
|     1.21.4      |    _latest_     |      21      | Paper, Fabric | ✅ **February 2026** (Non-LTS) |
|     1.21.3      |      3.7.1      |      21      | Paper, Fabric | 🗃️ Archived (December 2024)  |
|     1.21.1      |    _latest_     |      21      | Paper, Fabric | ✅ **May 2026** (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      |      3.8.7      |      17      | Paper, Fabric | 🗃️ Archived (November 2024)  |
| 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](troubleshooting#issues-with-player-data-going-out-of-sync-during-a-server-restart) 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]]