迷你聊天格式化器

一个简单的 Hytale 聊天格式插件。

功能

• 支持 MiniMessage 格式化标签，例如 <red>hello!</red> 或 <#ff5555>hello!</#ff5555>。
• 支持传统类 Minecraft 格式化代码，例如 &cThis is red text。
• 支持 PlaceholderAPI 占位符，例如 %player_world%。
• 支持 LuckPerms 前缀、后缀和元数据，例如 <prefix> 或 <suffix>。

示例

该格式设计得简单易用。

格式: <yellow><username></yellow>: <message>

格式: <prefix><username><suffix>: <message>

格式: <#aaaaaa>(%player_biome%)</#aaaaaa> <prefix><username><suffix>: <message>

配置

有一个配置属性："Format"。此属性定义了所有聊天消息所使用的格式。

您可以使用 /minichatformatter reload 命令来应用格式更改，而无需重启服务器（更多详情请参见下方的“命令”章节）。

格式示例

格式	示例	描述
<username>: <message>	lucko: hello!	默认格式，与 Hytale 默认行为一致。
<bold><username></bold>: <message>	lucko: hello!	为所有玩家的用户名添加粗体。
<prefix><username><suffix>: <message>	[ADMIN] lucko: hello!	(LuckPerms) 使用前缀和后缀。
<prefix><username><suffix>: <meta:chat_color><message>	[ADMIN] lucko: hello!	(LuckPerms) 使用前缀、后缀和元数据。
(%player_world%) <username>: <message>	(world) lucko: hello	(PlaceholderAPI) 在玩家名称前显示其所在世界。

占位符

内置标签

• <username> - 玩家的用户名。
• <message> - 玩家发送的聊天消息。

MiniMessage 标签

• <red> - 将文本设为红色。
• <bold> - 将文本设为粗体。
• <#FF0000> - 将文本设为自定义颜色（此例中为亮红色）。

……还有更多！请参阅 MiniMessage 文档 以获取所有支持标签的完整列表。

LuckPerms 标签

• <prefix> - 玩家的 LuckPerms 前缀。
• <suffix> - 玩家的 LuckPerms 后缀。
• <meta:key> - 玩家指定 LuckPerms 元数据键的值。

前缀、后缀和元数据值本身可以包含 MiniMessage 标签，因此您可以根据玩家的 LuckPerms 数据为其赋予自定义颜色或样式。例如，您可以将玩家的前缀设置为 <red>[ADMIN]</red>，使其在聊天中名称前显示红色的 "[ADMIN]" 标签。

PlaceholderAPI 占位符

您可以在格式中使用任何符合 %placeholder_name% 格式的 PlaceholderAPI 占位符。

请参阅 PlaceholderAPI 文档 以获取所有可用占位符的完整列表。

占位符值本身也可以包含 MiniMessage 标签。例如，如果一个占位符返回 <red>hello</red>，那么“hello”这个词在聊天中会以红色显示。

命令

/minichatformatter reload

• 重新加载配置文件。
• 无需重启服务器即可应用格式更改。
• 需要权限 minichatformatter.reload。

适用范围

本插件故意保持简单和基础。

我们会通过 GitHub 考虑功能请求，但我们不太可能将以下功能添加到 mini-chat-formatter 中：

• 频道（按世界、按组等）
• 多服务器（跨多台服务器发送消息）
• 私信
• 范围 / 聊天半径
• 自定义 UI
• 允许玩家设置自己的聊天格式（通过占位符的方式除外）
• 管理功能（脏话过滤器等）

如果您需要其他或更高级的功能，以下是一些替代方案：

• HeroChat - 也支持 PlaceholderAPI，具有各种附加功能和选项。
• EliteEssentials 或 EssentialsPlus - 也支持使用 PlaceholderAPI 格式化聊天，并包含其他各种“基础”功能。
• 可能还有很多！在 CurseForge 上搜索一下吧 :)