颜色与样式
查阅普通颜色、样式、扩展 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