Skip to content
On this page

使用 Tooltip 编辑器

拥有 chaui.tooltipeditor 权限的在线管理员可以执行:

text
/chaui tooltipeditor

编辑器独立于普通页面编辑器,专门管理服务器全局 tooltip-styles.yml。左侧编辑样式和九宫格字段,右侧编辑规则的显式文本/物品来源、优先级、条件、样式引用与顺序,中间用正式渲染链显示实时预览。

独占编辑

Tooltip 注册表使用全局独占租约。同一时间只有一位管理员可以编辑,第二位管理员会看到占用者账号名,不能进入可编辑或只读副本。页面编辑器也按 pageId 独占;不同页面之间、页面与 Tooltip 注册表之间互不占用。

编辑器关闭、玩家断线、权限失效或租约超时后,服务端释放锁。保存成功不会释放锁,可以继续修改。租约失效时界面会冻结所有控件并保留草稿供查看。

存在任何页面或 Tooltip 编辑租约时,/chaui reload 会拒绝并列出占用目标,避免磁盘重载覆盖未保存草稿。

编辑流程

  1. 新增或复制样式,填写本地图片路径、源区、四边切片、内边距和尺寸限制。
  2. 新增规则,选择 explicit(显式文本)或 item(物品),设置条件、优先级和样式引用。
  3. 用“上移/下移”调整同优先级规则顺序。
  4. 切换短文本、长文本、普通物品、复杂 Lore、主手和只读背包样例。
  5. 确认预览后保存。服务端完整校验、原子替换文件并同步给全部已就绪客户端。

样式重命名会同时更新所有规则引用,并作为一次撤销操作。被规则引用的样式不能直接删除。编辑器支持独立撤销、重做;输入中的非法数字或半成品会保留在控件内,但不会进入合法草稿,也会阻止保存。

页面编辑器中的预览

普通页面编辑器进入预览模式后,会使用服务器已发布的全局注册表和正式 Tooltip 渲染链。它不会读取 Tooltip 编辑器的未保存草稿,因此两处预览不会因为另一编辑器的临时输入互相污染。

页面编辑模式本身只负责选择、拖动和属性编辑,不显示运行时 Tooltip。选择父布局组件时,黄色主框仍只标出父组件,全部有效可见的递归后代使用蓝色虚线关系框;隐藏后代不会绘制关系框。

配置字段、条件上下文和回退规则见全局 Tooltip 样式