猹のUI界面 v1.3.4 多版本兼容 ​

ChaUI 是一套面向高版本 Minecraft 的页面 UI 引擎与可视化编辑器。无需编写繁琐的界面代码，即可自由设计普通界面、常驻 HUD 与世界空间页面，并通过页面变量、事件脚本和开放接口连接服务器中的各种玩法。

本插件完全免费，在未来也没有转为付费插件的计划

🔗 加群获取最新插件

ChaUI 简介 ​

从简单的信息面板，到包含按钮、输入框、物品交互和实体展示的复杂功能界面，ChaUI 都能通过统一的页面配置完成。页面素材保存在客户端资源目录中，既方便统一管理，也为整合包、定制服务器与主题玩法留下了充足的设计空间。

ChaUI 自带可视化编辑器。你可以直接在游戏中添加组件、拖拽排版、调整尺寸和修改属性，并随时进入预览查看最终效果。编辑器预览与玩家实际打开的页面保持一致，让界面制作从反复修改配置，变成更加直观的设计过程。

页面不仅可以作为普通 GUI 打开，还能用于替换或补充原版 HUD，并以世界页面的形式展示在游戏场景中。无论是菜单、状态栏、任务面板、商店、交互装置，还是沉浸式场景提示，都能使用同一套编辑方式完成。

演示样例 ​

特性与亮点 ​

所见即所得的可视化编辑器 ​

编辑器采用清晰的工具型布局，提供组件库、页面组件树、画布、属性面板与状态栏。组件支持拖拽移动、边缘缩放、框选、多选、复制、删除、撤销与重做；网格和吸附能力则可以帮助你快速完成整齐、精确的排版。

页面组件以树形结构展示，布局层级一目了然。编辑过程中可以随时切换预览，隐藏所有编辑辅助区域，以玩家的实际视角检查页面效果。

游戏内编辑，也能外置编辑 ​

除了直接在游戏界面中编辑，ChaUI 还支持将编辑工具切换到独立的外置窗口。外置后，游戏窗口可以完整展示页面画布，编辑窗口则保持顶置，方便同时观察效果并调整组件与属性。

对于宽屏、多屏或需要频繁微调的制作场景，外置编辑器能够提供更开阔、更专注的工作空间；完成编辑后也可以随时返回游戏内嵌模式。

丰富组件与灵活布局 ​

首版提供图片、文本、按钮、矩形背景、输入框、物品槽、物品展示和实体渲染等常用组件，同时支持绝对布局、相对布局与网格布局。组件可以自由组合，也可以通过父子层级组织复杂页面。

位置与尺寸既能填写固定数值，也能根据窗口、父级容器和组件自身尺寸动态计算。页面在不同分辨率和界面缩放下仍能保持合理布局，适合制作响应式菜单和 HUD。

图片组件支持常见静态图片与 GIF 动图，可以选取素材中的指定区域进行显示；按钮和输入框还能分别设置悬浮、聚焦等状态效果，让页面反馈更加自然。

普通界面、HUD 与世界页面 ​

同一套页面系统覆盖三类展示方式：

• 普通界面：适合菜单、商店、任务、设置和交互面板。
• HUD 页面：适合状态栏、技能栏、提示信息，也可以替换指定的原版 HUD 区域。
• 世界页面：可以在游戏场景的指定位置显示，并支持创建多个独立实例。

不同模式共享组件、布局和事件能力，不需要为每一种展示场景重新学习一套配置方式。

页面变量与事件脚本 ​

ChaUI Script 让页面不再只是静态画面。点击、右键、中键和鼠标悬浮等操作都可以触发事件，用于修改页面变量、切换组件状态、播放本地音效、打开或关闭页面，以及与服务器中的其他功能联动。

脚本同时提供中文与英文写法，页面作者可以根据习惯选择。变量变化后，相关文字、显隐状态和布局能够及时刷新，适合制作状态切换、条件提示、分页内容与动态 HUD。

原版物品与实体表现 ​

物品槽支持永久槽位、临时槽位和玩家背包映射。槽位系统不强绑页面：不同页面、HUD 或世界页面使用相同模式与 bind 时会自动同步，同 bind 的不同模式则保持独立。物品展示组件可用于奖励预览、商店商品、任务需求等无需直接交互的场景。

实体组件使用游戏中的原版实体表现，可以展示玩家、世界中的实体或页面专用虚拟实体，并支持名称、角度、缩放、偏移和鼠标追踪等效果。其他资源或模型系统对实体外观的替换，也可以自然延续到页面展示中。

轻量流畅，兼顾性能与稳定性 ​

ChaUI 使用 Minecraft 原生界面能力完成页面显示，不依赖网页浏览器式界面环境。页面渲染、输入交互和游戏画面保持在统一体验中，减少额外运行负担，适合需要长期显示的 HUD 和包含大量元素的功能页面。

稳定性同样贯穿编辑、保存与运行过程。遇到缺失素材、无效布局、异常组件或无法创建的展示对象时，ChaUI 会尽可能安全跳过或使用占位效果，避免单个元素影响整个页面。编辑器还会在保存前检查页面内容，服务器会再次进行权限和结构校验。

服务端权威，更适合玩法界面 ​

物品交互与页面保存由服务器进行最终裁决，客户端只负责展示和提交操作意图。重复操作、过期状态、无效会话与伪造请求都会经过检查，降低物品不同步、重复提交和越权保存带来的风险。

临时槽位在玩家最后一个运行时页面关闭时，可以按用途选择返还、提交或丢弃策略；永久槽位可以在玩家打开任意同 bind 页面时恢复；背包映射槽位则始终与服务器中的真实物品状态保持一致。页面作者还可以配置“操作条件”，在本地条件不满足时提前阻止槽位操作发包。

开放扩展与跨模块联动 ​

ChaUI 提供页面、变量、组件状态、物品槽、展示物品、实体和自定义事件等扩展入口，方便其他插件或客户端模块接入。页面既可以独立使用，也可以成为任务、职业、战斗、商店、剧情等系统的统一交互层。

组件、脚本与版本适配均预留了扩展空间，后续可以继续加入更多展示组件、交互能力和页面效果，而不需要推翻已有页面结构。