使用 Tooltip 编辑器 ​

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

/chaui tooltipeditor

Tooltip 编辑器专门管理服务器全局 plugins/ChaUI/tooltip-styles.yml，使用与页面编辑器相同的深色工具面板。

• 顶部：保存、撤销、重做、预览、外置和返回。
• 左侧：切换“样式”和“规则”，选择条目，并进行新增、复制、删除与规则排序。列表支持滚轮和拖动滚动条。
• 中央：实时查看提示效果，下方显示命中规则或回退原因。空间较小时，可点击顶部“预览”查看完整效果。
• 右侧：编辑当前条目的属性。每项参数单独一行，分区标题可以折叠，长面板支持滚轮和拖动滚动条。
• 底部：查看未保存状态、输入问题、保存结果和当前已发布版本。

内置与外置编辑器共用当前草稿和撤销记录。切换界面不会发布修改，只有点击“保存”才会更新服务器配置。

独占编辑 ​

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

编辑器关闭、玩家断线、权限失效或租约超时后，服务端释放锁。保存成功不会释放锁，可以继续修改。租约失效时禁止继续修改或保存，当前草稿仍可查看。

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

编辑流程 ​

1. 在左侧“样式”页签点击“新增”，或选中已有样式后点击“复制”。
2. 在右侧填写图片路径、GIF 循环方式与次数、源图选区、四边切片、绘制方式、内边距和尺寸限制。图片支持 PNG、JPG、JPEG 和 GIF；循环次数为 0 时无限循环。样式 ID 只能包含小写字母、数字、下划线和连字符，长度为 1～64。
3. 在“规则”页签新增规则，选择“显式文本”或“物品”来源、要使用的样式，并填写匹配条件和优先级。条件 true 表示匹配该来源的全部提示。
4. 优先级越大越先匹配；同优先级按列表顺序匹配，使用“上移/下移”调整。复制规则后请按用途修改条件或优先级。
5. 点击左下角“预览设置”，选择样例与预览方式。确认规则能命中后，点击顶部“保存”。

合法输入会实时更新预览；离开字段、切换条目、按 Enter 或保存时，会提交当前输入，不需要再单独点击“应用”。保存包含尚未离开输入框的最新内容。

非法数字、重复 ID 或尚未写完的条件会保留在输入框中，并标出有问题的字段。此时不能保存或切换到其他条目；可以继续修正，或点击“还原未完成输入”。这不会把半成品写入配置。

样式重命名会同步更新所有规则引用，并作为一次撤销操作。被规则引用的样式不能直接删除。数值字段还可以在标签上左右拖动，一次拖动只产生一条撤销记录。

样式属性 ​

源图宽高必须为正数，两侧切片之和必须小于对应的源图尺寸。最大宽度还需要容纳切片、内边距和最小宽度。输入不符合这些要求时，编辑器会提示具体字段。

预览与规则诊断 ​

“预览设置”中有两种方式：

• 当前样式：直接查看选中的样式，方便新增样式时调整皮肤，无需先建立规则。
• 规则匹配：使用草稿中的完整规则列表，查看哪个规则实际命中。编辑器会显示来源不同、条件为假、被更靠前规则匹配或条件求值失败等原因。

切换到“样式”页签会查看当前样式；切换到“规则”页签会测试规则匹配。预览设置只影响当前编辑过程，不写入 tooltip-styles.yml。

样例包括短文本、长文本换行、普通物品、多行 Lore 物品、当前主手和指定背包槽位。背包槽位可以选择第 1～36 格；主手或所选槽位为空时，会提示没有可显示的内容，不会用其他物品代替。预览不修改玩家真实物品。

页面上下文可以选择客户端当前已缓存的真实页面，再选择该页面中的组件。规则会使用所选页面和组件的 ID、类型、页面默认变量，以及当前可用的玩家常量和 PAPI 常量。这里用于检查匹配条件，不会执行页面脚本或模拟页面运行后的变量变化。尚未缓存的页面不会出现在选择列表中。

即使规则命中，图片缺失、源图选区超出实际图片、切片无法绘制或可用空间不足时，也可能回退原版提示；中央诊断会提示检查这些配置。图片仍需放到客户端可访问的资源位置，编辑器保存不会上传图片。

点击顶部“预览”可以隐藏工具面板，移动鼠标检查提示在屏幕边缘的定位。按 Esc 或点击“退出预览”返回编辑。

外置编辑与保存退出 ​

点击“外置”后，游戏窗口只显示提示预览，外置窗口提供样式、规则和属性编辑，使用与页面编辑器相同的深色控件。外置窗口保持顶置；点击“返回内置”或关闭窗口，会回到游戏内编辑器并保留当前内容。

快捷键为 Ctrl+S 保存、Ctrl+Z 撤销、Ctrl+Y 重做。内置编辑器也支持 Ctrl+Shift+Z 重做。当前字段仍有未提交输入时，撤销会先还原这次输入。

保存期间不能继续修改。服务器确认保存并发布后，底部更新结果；校验失败或连接异常时保留草稿，可修正后重试。

点击“返回”或按 Esc 退出编辑器时，若有未保存修改，会显示“保存并退出 / 放弃修改 / 取消”。选择保存后，只有成功收到保存与发布确认才退出；失败时继续保留编辑器。外置窗口的关闭按钮只负责返回内置编辑器。

页面编辑器中的预览 ​

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

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

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