兼容性
HuskSync 支持下列版本的 Minecraft。自 v3.7 后，你需要在服务器上安装最新版的 HuskSync。
| Minecraft | 最高 HuskSync 版本 | Java 版本 | 平台 | 支持截止日期 |
|---|---|---|---|---|
| 1.21.4 | 最新 | 21 | Paper、Fabric | ✅ 当前支持 |
| 1.21.3 | 3.7.1 | 21 | Paper、Fabric | 🗃️ 已归档（2024 年 12 月） |
| 1.21.1 | 最新 | 21 | Paper、Fabric | ✅ 2025 年 12 月（长期支持） |
| 1.20.6 | 3.6.8 | 17 | Paper | ❌ 已归档（2024 年 10 月） |
| 1.20.4 | 3.6.8 | 17 | Paper | ❌ 已归档（2024 年 7 月） |
| 1.20.1 | 最新 | 17 | Paper、Fabric | ✅ 2025 年 11 月（长期支持） |
| 1.17.1 - 1.19.4 | 3.6.8 | 17 | Paper | ❌ 已归档 |
| 1.16.5 | 3.2.1 | 16 | Paper | ❌ 已归档 |
HuskSync 主要基于最新版进行开发。老版本 Minecraft 会在支持频道里基于使用情况与管理员更新，如：
- 长期支持（LTS）- 最长支持维护 12-18 个月
- 非长期支持（Non-LTS）- 最长支持维护 3-6 个月
不兼容版本
本插件不支持下列种类的核心或 Minecraft 版本。若你试图使用这些版本，插件将不会启动。对此造成的不便深感抱歉。
| Minecraft 版本 | 服务器核心 | 备注 |
|---|---|---|
| 1.19.4 | 仅 Purpur、Pufferfish† | 不支持旧版构建的 Paper |
| 1.19.3 | 仅 Paper、Purpur、Pufferfish | 升级至 1.19.4 或使用 Spigot |
| 1.16.5 | 所有 | 请使用低于 3.3.1（含）的版本 |
| 低于 1.16.5 | 所有 | 请至少使用 1.16.5 版本的 Minecraft |
† 其他基于这些核心的分支也会受到影响
不兼容插件/模组
需要注意的是如下这些插件/模组会与 HuskSync 出现兼容性问题：
- 不支持重启插件/模组。这会导致服务器重启后玩家数据同步出错的情况，因为这些插件使用了 bash 脚本。需要注意的是，这些重启插件并非真正重启了服务器，而是触发了某些（通常不稳定的）进程清除脚本逻辑达到重启的目的。
- 战斗记录类插件/模组暂不支持。部分对 HuskSync 预先支持的插件应当可以正常工作，但对于其他的插件，你可能需要修改事件优先级