Custom Server Messages

模组

· 作者 arvitus

一款 Minecraft 模组,可自定义任意服务器消息,支持文本格式化和占位符。

0 本站下载 0 关注 更新于 4 个月前

需要前置:Fabric API

最新 1.1.1 · 26.3 · Fabric

一键开服(送7天)

Server Messages

一款 Minecraft 模组,用于自定义任何服务器消息,支持文本格式化和占位符。


它能做什么?

此模组允许你按照喜好修改任何[1] 服务器消息。你可以替换消息本身、添加或更改 格式,甚至使用 占位符。其格式与语言文件使用的 翻译文本格式 完全兼容。

常见用例包括更改“你已被封禁”等消息的颜色、在“你不在白名单中”的消息中添加信息,或自定义踢出通知。你甚至可以利用此模组在玩家加入或离开服务器时显示一些统计数据,或者让死亡消息以彩虹色显示。可能性是无限的!

badge
对于任何与聊天相关的内容,我建议使用 Styled Chat。 如果你使用了它,本模组中所有相关消息将被禁用以防止冲突。 然后你可以使用 Styled Chat 来更改它们。

如何使用?

要修改一条消息,只需将对应的 翻译键 添加到配置文件中,并将其值更改为你喜欢的内容。文本格式基于 翻译文本格式, 并支持用于文本格式化的 QuickText 格式 以及全局 占位符。 你可以使用 /reload 命令重新加载配置文件。

占位符的格式为 ${placeholder},对于大多数消息,你只能使用不依赖特定玩家/实体的占位符!因此,${server:tps} 和 ${world:name}(主世界)是完全没问题的,但 ${player:name} 并不总是有效。
更多信息,请参阅 占位符上下文。

配置文件的格式与 Minecraft 语言文件格式兼容。因此,你可以简单地将配置文件替换为语言文件(强烈不建议这样做),它也能正常工作。请注意,这不会覆盖玩家的本地语言设置!作为参考,你可以在 这里 找到当前可用的所有语言文件列表。

如果你手动使用翻译键 (QuickText / STF 或 文本组件),例如在聊天消息或其他模组中, 它们也会受到此模组的影响,从而使用配置文件中指定的相同格式。 如果你不希望这样,你可以将 r 或 raw 附加到 QuickText / STF 翻译标签 (<lang ...> -> <rlang ...>),或者在翻译参数中添加 #raw 作为最后一个参数。
例如,<rawlang ...> 等同于 <lang ... #raw>,这将防止消息被修改。 对于 文本组件,其形式如下: {"translate": "...", "with": [..., "#raw"]}。

badge
任何其他修改服务器消息的模组(例如 BanHammer),很可能 会优先于本模组所做的更改生效。

示例配置

{
  // 仅更改格式
  "multiplayer.disconnect.not_whitelisted": "<red><bold><lang multiplayer.disconnect.not_whitelisted></bold></red>",
  // 替换消息;使用占位符
  "multiplayer.disconnect.server_shutdown": "<green>We'll be right back!</green>\n<gray><underline>Uptime: </>${server:uptime}</gray>",
  // 添加文本;使用嵌套翻译参数
  "multiplayer.player.joined": "<yellow><lang multiplayer.player.joined '%s'>. Good to see you!</yellow>",
  // 替换消息;使用翻译参数
  "multiplayer.player.left": "<yellow>See you soon, <bold>%s</bold>!</yellow>",
  // 自定义翻译键;在踢出消息中添加原因
  "multiplayer.disconnect.kicked.reason": "<lang multiplayer.disconnect.kicked>\n<yellow>%s</yellow>"
}

badge
不要直接复制此内容!配置文件使用的是 JSON 格式,而 JSON 不支持 注释。示例中的注释仅用于澄清说明。请勿复制注释!

支持的翻译键

理论上,只要显式使用(例如在 翻译标签中),每个翻译键都受支持。 但在原生情况下,服务器仅使用少量翻译。 所有在服务器上解析的翻译键均受支持。这包括你在服务器上游玩时能看到的大多数消息。

如需更详细的受支持按键列表,请参见 此处。

badge
此列表中的信息可能不准确!
虽然它能帮助你快速了解概况,但它仅基于我的发现以及大量假设。

占位符上下文

上下文是允许不同占位符生效的附加信息。例如,AfkPlus 等模组需要 player 上下文才能使其占位符正常工作。这并非在所有消息中都可获得,因此请在下方的列表中查看你所需消息的附加上下文。

所有消息均支持基本上下文,即 服务器 和 主世界,但不包括 玩家。

翻译键(Translation Key) 上下文 添加版本
chat.type.advancement.* player 1.0
commands.ban.success player 1.1
commands.banip.success player 1.1
commands.deop.success player 1.1
commands.kick.success player 1.0
commands.op.success player 1.1
commands.pardon.success player 1.1
death.* player 1.0
multiplayer.disconnect.* player:如果玩家在断开连接前已在服务器上;否则为 profile。

例外情况(非详尽列表)
.transfers_disabled, .outdated_client, .incompatible
这些仅具有默认上下文(server)。
1.1(部分 1.0)
multiplayer.player.joined player 1.0
multiplayer.player.joined.renamed player 1.0
multiplayer.player.left player 1.0

如果你希望添加特定上下文,请 提交 Issue 或 在 Discord 上告诉我。

附加翻译键

本模组还添加了若干用于配置的附加翻译键。 它们将允许你自定义一些通常无法更改的消息。

badge
这些翻译键并非由 Minecraft 本身提供,且仅在模组配置中指定时生效。

Translation Key Context Notes Default Version Added
multiplayer.disconnect.kicked.reason player 发送给被踢出的玩家(如果有指定原因)。

原因是唯一的参数(%s)。
参见 multiplayer.disconnect.banned.reason。
%s 1.1

为什么需要它?

几乎原版服务器发送给玩家的所有文本消息都使用翻译键来显示相应的消息。因此,它发送的不是实际的文本(例如 <Player> joined the game),而是类似 translate[multiplayer.player.joined] 的内容。客户端随后会根据玩家选择的语言将其转换为实际文本。这样游戏可以确保每位玩家都能以他们偏好的语言查看消息。虽然这非常有用,但有时这可能不是你想要的行为,因为你无法在不强制玩家使用自定义资源包的情况下更改这些消息的格式。这就是这个模组存在的原因。

通常,这些消息显示为普通的白色纯文本,相当枯燥。为了增加趣味性,你需要能够全局更改这些消息。例如,你可以将“不在白名单上”的消息更改为给新玩家提供更多额外信息。你也可以更改“你已被封禁”消息的颜色使其更加醒目。有很多这类服务器消息你可能想要自定义,所以试试看吧!

它是如何工作的?

此模组会在文本发送给玩家之前,用你在配置中指定的文本替换翻译键。这样玩家接收到的就是你的自定义消息而不是默认消息。这并不一定影响消息的翻译。因此,你可以在不丢失自动翻译功能的情况下为消息添加格式(参见示例配置)。

为了防止无限递归,你自定义消息中使用的所有翻译键都将使用其默认值和格式,而非你提供的值。


[ 1 ]: 由于 Minecraft 处理某些消息的方式,存在一些特殊情况可能无法按预期工作。 如果你遇到这种情况,请提交 Issue, 我会看看能否让它们也正常工作。
玩家聊天消息(包括 /me 等)不幸的是不被此模组支持。 请改用 Styled Chat。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源