Skip to content

文本组件

文: GrassBlock2022


新的文本系统相比原先基于模板引擎的文字系统,拥有了更多的特性,例如点击执行,文字渐变等等。 旧的文本组件依然可用,它们将不会影响组件本身添加的动作等特性, 非常适合用来在一段动作组件中添加小样式。

基础组件格式

文本系统通过将文本序列转换为AdventureAPI的组件,并利用反序列化来创建更具扩展性的文字效果。 一个组件中通常遵循这样的格式:

{标签1;标签2}文字

如果您为同一个属性设置了不同的标签 {color(blue),color(aqua)} 则解析器默认使用最后一个标签。

标签

一个标签为文字定义了样式,动作等各种属性。 通常来说,标签会遵循这样的格式:

标签名(扩展值1,扩展值2)

有些标签不需要扩展值,例如underlinebold

颜色标签

颜色标签内部可以填写颜色的名称(参见mcwiki),或使用#开头的16进制数字码, 例如#114514。 如果填写多个扩展值,则组件系统将识别其为渐变组件并转换为minimessage处理, 这可能导致部分标签无法正常工作。

这里是一些可能的颜色:

参数描述示例值
black黑色§0
dark_blue深蓝色§1
dark_green深绿色§2
dark_aqua深青色§3
dark_red深红色§4
dark_purple深紫色§5
gold金色§6
gray灰色§7
dark_gray深灰色§8
blue蓝色§9
green亮绿色§a
aqua亮蓝色§b
red红色§c
pink粉色§d
yellow黄色§e
white白色§f

样式标签

样式标签可将其名称直接作为标签名使用,会对本组件内的文字进行效果叠加。 在参数前添加-可以取消当前装饰。

参数描述示例值
bold粗体§l
delete删除线§m
underline下划线§n
italic斜体§o
reset重置格式§r
return换行\n
none重置----

点击标签

点击标签定义了用户点击这段文本的时候会做什么。 其格式为:

click(动作,附加值)
参数描述示例值
command运行命令(原版的不行)click(command,/quark reload)
link打开链接click(link,https://tbstmc.xyz)
copy复制组件内容到剪贴板click(copy,114514)
suggest_cmd命令建议(自动在聊天栏填入命令)click(copy,/kill)

小示例:

{click(link,https://tbstmc.xyz);underline;color(aqua)}前往TBSTCraft官网
{click(command,/quark reload);color(#114514,1919810)}点我重载quark核心