猹件开发组

Appearance

On this page

版本兼容性 ​

ChaUI 由服务端插件与客户端 Mod 配合运行。当前服务端 ChaUI 与全部受支持的 ChaUIMod 客户端版本统一为 2.0.4，通信协议版本为 25。服务端使用同一个插件文件，玩家安装配套且与自己 Minecraft 版本和加载器对应的 ChaUIMod。

同一个服务端插件覆盖 1.16.5、1.20.1、现有 1.21.x、26.1.2 与 26.2。协议 25 客户端必须配合协议 25 服务端使用。更新时请同时替换配套插件与 Mod；仅 Minecraft 版本相同并不代表 ChaUI 协议兼容。提示协议不匹配时，按编辑器无法打开的排查步骤处理。

协议 25 包含文字组件的多色颜色列表与渐变配置。只更新服务端或只更新客户端时，旧协议会在就绪检查阶段被拒绝。

玩家原版名字显隐还要求服务端与观看者客户端都包含本次独立 API 更新。同一版本号、同一协议号的较早构建可能没有该能力，更新时请核对交付记录中的文件摘要。接口与脚本写法见显隐 API和名称显隐脚本。

旧页面可以继续加载。文字自动尺寸更新会改变文本的排版方式：旧 layout.width/height 不再控制文字尺寸，换行使用 textLineLength/textLineWidth，整段居中使用自动宽度公式。升级到包含该改动的构建前，请按文本组件核对依赖固定文本宽高的页面。

文字自动尺寸的适用构建

2026-10-05 重新构建的 2.0.3 混淆包已包含文字自动尺寸。当天较早提供的同版本包没有这项后续改动；请使用交付说明中注明“文字自动尺寸更新”的配套文件，并按随包的 release-manifest.json 或 SHA256SUMS.txt 核对。

服务端兼容性 ​

Minecraft 版本SpigotPaperYouer
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.4.jar。Paper 按相同 Minecraft 版本的 Spigot 兼容范围提供支持；其他服务端核心需要根据其实现差异单独评估。

客户端兼容性 ​

Minecraft 版本NeoForgeForgeFabric
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.1.2 与 26.2 使用 Java 25。ChaUI 服务端正式发布 Jar 兼容 Java 11 及以上，但实际启动时仍需满足 Minecraft 服务端核心和其他插件的 Java 要求。