Skip to content
iPlugin

颜色与样式

查阅普通颜色、样式、扩展 RGB、渐变与文字间距的适用位置。

普通颜色

颜色代码可用于图标名称、Lore、窗口标题和 fmsg。文字使用引号,避免 YAML 将 & 当作其他语法:

显示属性片段
name: '&a确认'
lore:
  - '&7这是第一行'
  - '&e这是重要提醒'
代码颜色代码颜色
&0黑&8深灰
&1深蓝&9蓝
&2深绿&a绿
&3深青&b青
&4深红&c红
&5深紫&d浅紫
&6金&e黄
&7灰&f白

也能保留已有的 § 颜色代码。需要确定物品名称或某行 Lore 的颜色时,显式填写 &7(灰色)或 &f(白色),不依赖无色文字经过格式化后的默认样式。省略 name / lore 与填写无色文字不同:省略会保留来源物品原有内容。

文字样式

效果代码说明
随机字符&k混淆文字
粗体&l加粗
删除线&m文字中线
下划线&n文字下划线
斜体&o斜体显示
重置标记&r常规颜色处理中按白色处理,不能当作可靠的完整样式重置

样式代码放在颜色后,例如 &a&l确认。需要明确恢复样式时,TabooLib 复合文本使用 reset 属性,MiniMessage 使用 <reset>,不依赖 &r。

扩展颜色

以下写法用于常规物品文字、标题与 fmsg;是否显示真彩色取决于服务端与客户端的颜色支持,旧环境不会自动获得 RGB 显示能力。

写法示例范围
十六进制&{#47856e}六位 RRGGBB
逗号 RGB&{255,000,000}每组固定三位,数值 0~255
连字符 RGB&{255-000-000}每组固定三位,数值 0~255
英文颜色名&{DARK_GREEN}使用下表名称,不区分大小写
中文颜色名&{深绿}使用下表文字
显示属性片段
name: '&{#47856e}青绿色按钮'
lore:
  - '&{255,000,000}红色提醒'
  - '&{深绿}中文颜色名称'
英文名称中文名称英文名称中文名称
BLACK黑DARK_GRAY深灰
DARK_BLUE深蓝BLUE蓝
DARK_GREEN深绿GREEN绿
DARK_AQUA深青AQUA青
DARK_RED深红RED红
DARK_PURPLE深紫LIGHT_PURPLE浅紫
GOLD金YELLOW黄
GRAY灰WHITE白

RESET / 重置 也能被颜色名入口识别,但不应代替上面的显式样式重置。不要省略扩展颜色的花括号,也不要将六位格式误写成任意长度;RGB 数字不足三位或超出范围都不是可依赖的写法。

旧环境还存在 &#... 的兼容替换:仅在 1.13~1.19.3 的常规颜色处理中转成 §#...,用于特定客户端格式;这不是通用的原版 RGB 写法,不要用它替代 &{#RRGGBB}。

渐变

图标动作片段
action: "fmsg '[欢迎回来](gradient=#47856e,#2c89a0;b)'"

gradient(g)使用逗号分隔至少两种颜色。颜色可为十六进制、上表名称或连字符 RGB;渐变的逗号已经用于分隔颜色,不要再把逗号 RGB 当作一个渐变颜色。

mmsg 兼容普通的 &a、§a 颜色,但不使用常规文本的 &{#RRGGBB}、中文颜色名或固定三位 RGB 替换。推荐在 mmsg 中统一使用 <green>、<#47856e> 等标签。

间距标记

常规物品文字和窗口标题可用 {+数字}、{-数字} 或 {数字} 转换成正负间距字形,例如:

菜单顶层片段
menu:
  title: '&f{-8}功能菜单'

负数向左、正数向右;{0} 不增加间距。只有客户端资源包提供对应的间距字形时,才会得到预期像素效果,否则可能显示缺字。这不是格子坐标,不能移动按钮,也不是 {{语句}} 占位符。

该标记不在直接发送的 fmsg / mmsg 中自动展开;聊天需要的特殊字形应使用相应字体或已准备好的文字。enhancedLore 与间距、颜色均无关。

Last updated on