跳到主要内容

颜色代码

改变你服务器中信息的颜色!

格式化代码

格式化代码 (Formatting code),又称颜色代码 (Color code),能使在游戏中加入含颜色和格式信息。

在 Minecraft 中,可以以分节符号 (§) 产生带色文字。

你也可以用 颜色代码生成器 来生成它。

备注

通常在游戏客户端中,你不能打出 § 这个符号。需要使用 \u00A7 或者 \u00a7

在配置文件中,你可以直接复制粘贴这个符号而不用自己输入。

你也可以在按住 Alt 键的同时,小键盘 按顺序 输入 167 以输出 § 符号

(注意:image 使用新版时字符对应错误,请使用旧版)

提示

为了方便,多数插件的配置中支持使用 & 来代表 §

比如下面这个 TrMenu 菜单例子:

plugins/TrMenu/menus/example.yml
Icons:
test:
display:
material: stone
lore:
- '&11 &22 &33'
- '&aa &bb &cc'

如果你想要更绚丽的颜色和更丰富的功能 (比如点击文本执行命令)。

可以去看 MiniMessage 部分。

MiniMessage

MiniMessage 旨在用简单字符串表示聊天组件,便于用户学习和开发人员扩展。

MiniMessage 的实质是一个叫 Adventure 的库,这是它的 文档

支持列表

目前,一些平台已经支持原生使用 Adventure 来扩展字符串,以下是内置此库的列表:

支持平台支持版本备注
SpongeSponge 8 (1.16.5)/
Velocity1.1.0 build 158仅支持消息、操作栏标题、boss 栏和标题
Paper1.16.5 build 473/
MinestomBuild 7494725内容有点杂,详见minestom wiki
Fabricadventure-platform-fabric 5.3.0*虽然不是一个东西 (?),但是体验是一样的

详情可以参阅 Adventure 原生支持

备注

平台原生支持 ≠ 使用此平台开发的模组/插件支持!!!

举个例子,仔细观察上述列表,你会发现 bukkit 并没有支持 MiniMessage,所以你会发现大部分基于 Bukkit 开发的插件没有 MiniMessage 这一功能 (如 EssentialsX), 除非他们自身引入了 Adventure 库 (如 PlaceholderAPI)。

而基于 Paper 开发的大部分插件都引入了这一功能,所以不要发现一个新奇玩意就到处瞎套。

提示

有些插件只是需要 RGB 颜色,引入 Adventure 库可能会让插件变的非常臃肿,所以有相当部分的插件会使用其他库或自行实现

然后在插件介绍页写“支持 MiniMessage”,其实只是使用与 MiniMessage 一样的语法,代码层面并不是 Adventure 库。

如何使用

注意

本篇不讲述诸如 TAB 等插件或模组自行实现的类似 MiniMessage 效果的使用。

在线编辑

用一个 TrMenu 菜单配置展示下:

plugins/TrMenu/menus/example.yml
Icons:
test:
display:
material: stone
lore:
- '<rainbow>Hello world'

记住 MiniMessage 语言使用标签,也就是说你所做的一切都将使用标签进行定义。

对于 MiniMessage,你必须要有一个开始标签 <yellow>,在非严格模式下,你可以省略结束标签 </yellow> ,如下:

<yellow>Hello <blue>World</blue>!

在非严格模式下,所有标记名称都不区分大小写,以减少冲突的可能性 (懒癌晚期患者狂喜),但美观和符合规定起见,请使用小写字母编写以便减少被他人嘲讽的几率:

<YelLOw>Hello World!

此外,这里有一个测试网站,他可以使得你无需启动 Minecraft 便可以预览实际效果。

关于实际使用格式详见 标准标签

行内复合文本

TabooLib Components,当你使用 TabooLib 框架的插件时,可以使用此写法

可以更方便的编写 json 文本信息,而不只是局限于颜色

https://plugins.ptms.ink/category/行内复合文本
https://taboo.8aka.org/components/

[||||||||||||||||||||](gradient=#f6d365,#fda085)

更多用法见上方链接

MineDown

MineDown 为 Minecraft 引入了 Markdown 风格的文本格式化语法,让用户能够轻松编写样式丰富的文本组件。它兼容 Paper 和 Velocity 等原生使用 Kyori Adventure 库的现代服务端,同时也支持传统 Spigot 与 BungeeCord 的聊天 API。

语法示例

[||||||||||||||||||||](color=#f6d365-#fda085) 

更多语法可以参考下面的链接

https://wiki.phoenix616.dev/library/minedown/syntax

参考