猹件开发组版本兼容性
ChaUI 由服务端插件与客户端 Mod 配合运行。服务端只需安装同一个 ChaUI 2.0.0 插件文件，玩家则必须安装与自己 Minecraft 版本和加载器对应的 ChaUIMod。当前通信协议版本为 18。此前的 1.4.0 页面仍可按原配置使用，升级 2.0.0 不要求修改既有页面。
同一个服务端插件覆盖 1.16.5、1.20.1、现有 1.21.x、26.1.2 与 26.2。协议 18 客户端必须配合协议 18 服务端使用，不能与旧协议客户端混用。
服务端兼容性
| Minecraft 版本 | Spigot | Paper | Youer |
|---|---|---|---|
| 1.16.5 | ✅ | ✅ | 未验证 |
| 1.20.1 | ✅ | ✅ | 未验证 |
| 1.21.1 | ✅ | ✅ | ✅ |
| 1.21.4 | ✅ | ✅ | 申请兼容 |
| 1.21.8 | ✅ | ✅ | 申请兼容 |
| 1.21.10 | ✅ | ✅ | 申请兼容 |
| 1.21.11 | ✅ | ✅ | 申请兼容 |
| 26.1.2 | ✅ | ✅ | 申请兼容 |
| 26.2 | ✅ | ✅ | 申请兼容 |
| 其他版本 | 待需求兼容 | 待需求兼容 | 待需求兼容 |
所有表中版本使用同一个 ChaUI-2.0.0.jar。Paper 按相同 Minecraft 版本的 Spigot 兼容范围提供支持；其他服务端核心需要根据其实现差异单独评估。
客户端兼容性
| Minecraft 版本 | NeoForge | Forge | Fabric |
|---|---|---|---|
| 1.16.5 | — | ✅ | 申请兼容 |
| 1.20.1 | — | ✅ | ✅ |
| 1.21.1 | ✅ | 申请兼容 | ✅ |
| 1.21.4 | ✅ | 申请兼容 | ✅ |
| 1.21.8 | ✅ | 申请兼容 | 申请兼容 |
| 1.21.10 | ✅ | 申请兼容 | 申请兼容 |
| 1.21.11 | ✅ | 申请兼容 | ✅ |
| 26.1.2 | — | 申请兼容 | ✅ |
| 26.2 | ✅ | 申请兼容 | 申请兼容 |
| 其他版本 | 待需求兼容 | 待需求兼容 | 待需求兼容 |
2.0.0 的 3D 功能范围
3D 场景编辑器、场景后处理、阴影编辑和视口交互已经随上表全部受支持的 ChaUIMod 客户端适配发布。页面要实际显示 ChaEngine 模型，还必须安装同版本、同加载器的 ChaEngineMod；当前模型 provider 支持 Forge 1.16.5、Forge 1.20.1 与 NeoForge 1.21.1、1.21.4、1.21.8、1.21.11。
26.2 首版仅支持 OpenGL
Minecraft 26.2 客户端必须选择 OpenGL 图形后端。使用 Vulkan 或无法识别的图形后端时，ChaUI 不会接管页面、编辑器或原版容器界面，游戏会继续保留原版界面。切换回 OpenGL 并重启客户端后即可使用 ChaUI。
Java 版本
Minecraft 1.16.5 的 Forge 客户端使用 Java 11，对应 Spigot/Paper 服务端使用 Java 17；Minecraft 1.20.1 客户端与服务端使用 Java 17，Minecraft 1.21.x 使用 Java 21，Minecraft 26.2 使用 Java 25。ChaUI 服务端插件本身以 Java 17 构建，因此同一个插件文件可以放入上述所有服务端。
如果你的服务器使用其他 Minecraft 版本、服务端核心或客户端加载器，可以联系我们申请兼容。我们会根据目标环境、实际需求与适配成本进行评估，最终支持范围以评估结果为准。