SuperAPI AI 工具集

wow-api-escape-sequences

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:本技能整理《魔兽世界》插件开发中 UI 文本渲染器支持的转义序列。许多显示文本的 UI 元素支持以 |(竖线)开头的特殊序列,可在普通 Lua 字符串内实现内联着色、贴图/图集渲染、语法变形与换行提示等。资料以 warcraft.wiki.gg 的 UI escape sequences 为准,截至 Patch 12.0.0(仅正式服)。

主要能力:颜色方面支持 |cAARRGGBBtext|r(AA 当前被忽略,恒用 FF;|r 自 9.0.1 起按嵌套顺序弹出上一颜色)、命名全局颜色 |cnCOLOR_NAME:text|r(10.0.0 加入)、物品品质颜色 |cnIQn:text|r(11.1.5 加入)。贴图方面支持内联贴图 |Tpath:height[:width...]|t(path 可为文件路径或 FileDataID,含尺寸规则、偏移、源尺寸、裁剪与 RGB 染色参数)以及图集 |A:atlas:height:width[...]|a(注意 |A 后有冒号)。Kstring |Kq1|k 用于防止插件解析受保护文本,前缀 q/r/u/v 分别对应 Battle.net 账号名、组队查找器名称与备注、社区消息、社区频道聊天(4.0.1 加入)。语法/本地化序列包括 |1 韩语助词、|2 法语介词、|3-id(text) 俄语名词变格、|4 与 |7 复数形式、|5 不定冠词、|6 小写。另有 |Wtext|w 换行提示(5.4.1 加入)、|n 换行、|| 字面竖线。

使用方式:Lua 源码中可直接写 |,如 print("|cFFFF0000Red text|r normal");聊天窗口或游戏内文本编辑器中需用 \124 转义,如 /run print("\124cFFFF0000Red text\124r normal")。FrameXML 辅助函数可生成标记:WrapTextInColorCode、CreateTextureMarkup、CreateSimpleTextureMarkup、CreateAtlasMarkup。

适用场景:在聊天消息、提示框或 FontString 中嵌入颜色、图标与本地化语法;处理受保护文本时使用 Kstring。

限制:资料仅覆盖正式服 Patch 12.0.0;无效的 |X 按原样显示,属未定义行为;|W 提示在文本仍过宽时可能被忽略;Kstring 无法被插件读取为明文。