NitWikit/docs/sundry/MiniMessage.md

sidebar_position
9

MiniMessage

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

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

支持列表

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

支持平台	支持版本	备注
Sponge	Sponge 8 (1.16.5)	/
Velocity	1.1.0 build 158	仅支持消息、操作栏标题、boss栏和标题
Paper	1.16.5 build 473	/
Minestom	Build 7494725	内容有点杂，详见minestom wiki
Fabric	adventure-platform-fabric 5.3.0*	虽然不是一个东西(?)，但是体验是一样的

详情可以参阅Adventure 本机支持

:::note

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

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

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

:::

如何使用

此处仅讲述管理员如何使用，开发者不做讲解

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

和 格式化代码 篇一样，一个 TrMenu菜单 配置展示下

Icons:
  test:
    display:
      material: stone
      lore:
        - '<rainbow>Hello world'

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

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

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

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

<YelLOw>Hello World!

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

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

参考

• https://docs.advntr.dev/minimessage/format.html
• https://docs.advntr.dev/platform/native.html