文本组件
文: GrassBlock2022
新的文本系统相比原先基于模板引擎的文字系统,拥有了更多的特性,例如点击执行,文字渐变等等。 旧的文本组件依然可用,它们将不会影响组件本身添加的动作等特性, 非常适合用来在一段动作组件中添加小样式。
基础组件格式
文本系统通过将文本序列转换为AdventureAPI的组件,并利用反序列化来创建更具扩展性的文字效果。 一个组件中通常遵循这样的格式:
{标签1;标签2}文字
如果您为同一个属性设置了不同的标签 {color(blue),color(aqua)}
则解析器默认使用最后一个标签。
标签
一个标签为文字定义了样式,动作等各种属性。 通常来说,标签会遵循这样的格式:
标签名(扩展值1,扩展值2)
有些标签不需要扩展值,例如underline
或bold
。
颜色标签
颜色标签内部可以填写颜色的名称(参见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核心