文本写法
区分物品文字、窗口标题、占位符与两套聊天富文本的适用范围。
使用位置
| 位置 | 推荐写法 | 解析范围 |
|---|---|---|
图标 name、lore | 颜色代码与占位符，如 &a确认、{{&status}} | 支持 TabooLib 复合文本的文字与颜色样式，但不会保留聊天点击、悬停等交互 |
menu.title | 颜色代码与占位符 | 是窗口标题，不是聊天消息；不要用聊天点击标签控制菜单 |
fmsg 聊天消息 | [文字](属性=值) | 保留 TabooLib 复合文本的样式、点击与悬停 |
mmsg 聊天消息 | <标签>文字</标签> | 保留 MiniMessage 的样式、点击与悬停 |
broadcast（bc） | 常规格式化文字 | 向在线玩家发送普通文本，不等同于广播一条可点击的 fmsg 或 mmsg |
菜单图标的点击动作写在 action 中。聊天中的点击与悬停属性只作用于发送后的聊天消息，不能代替图标动作，也不能给 Lore 再套一个游戏内悬浮窗。
1.17+ 的物品名称与 Lore 还可使用 MiniMessage 的非交互样式标签；旧版物品文字不提供同等显示效果。窗口标题对富文本的支持取决于窗口方式与标题设置，不要直接套用聊天示例；普通标题优先使用颜色代码，相关开关见主配置。
占位符与颜色的处理顺序
物品名称与 Lore 先计算 {{语句}}，再替换 %PlaceholderAPI%，然后处理颜色、间距标记与 TabooLib 文字样式。因此占位符返回的颜色代码可以继续上色，但 PlaceholderAPI 的返回值不会再启动第二轮内联计算。
首次打开的 menu.title 使用内联语句、占位符、颜色和间距处理，不保证解析方括号复合文本；静态标题使用颜色代码与占位符。后续 menu title set/update 和动画帧的常规文本格式化另见复合文本的范围，不能把两个阶段的显示效果混为一谈。
fmsg 先计算内联语句与 PlaceholderAPI，再处理颜色和方括号属性；mmsg 先计算内联语句与 PlaceholderAPI，再处理 MiniMessage。两者的格式不能互换。直接发送的 fmsg / mmsg 不提供常规标题的 {+数字} 间距标记替换。
消息入口与开关
fmsg 的别名为 fluentmessage、fmessage；mmsg 的别名为 minimessage、mmessage。它们接收一段消息文字并发送给当前玩家：
action: "mmsg '<green>欢迎回来，{{player name}}</green>'"这些消息动作使用主配置 plugins/Invero/config.yml 中默认开启的 Kether.auto-placeholder-translate。关闭该项后，不能继续假设这些 Invero 消息入口和格式化广播仍可用；重新启用后重启以加载入口。此开关不负责关闭图标名称、Lore 和标题本身的占位符解析。
颜色与样式
变量与占位符
TabooLib 复合文本
MiniMessage
物品说明换行
lore 列表每项一行，多行文字可使用 YAML 的 |-。当节点或占位符返回的是文字形式的 \n 时，在同一显示配置中开启 enhancedLore；真正的换行不依赖此开关。
三种写法见物品属性，完整可下载菜单与修改步骤见制作按钮外观。聊天悬停使用的换行方式则分别查阅 fmsg 与 mmsg，不要用 enhancedLore 控制聊天内容。
Last updated on