文本和翻译 1.21.1
Minecraft 处理格式化文本和翻译的全面文档。
WARNING
本页面适用于 1.21.1 版本。 针对旧版本的文档可能不完整。
Minecraft 在游戏内显示文本，不论何时，都是使用 Component 对象定义的。 使用这种自定义的类型而非 String，是为了允许更多高级的格式化，包括颜色、加粗、混淆和点击事件。 这样还能够容易地访问翻译系统，使得将任何 UI 元素翻译成不同语言都变得容易。
如果以前有做过数据包和函数，应该看到用于displayName、书、告示牌等内容的就是用的 json 文本格式。 不难猜到，这就是 Component 对象的 json 呈现，可以使用 Component.Serializer 互相转换。
制作模组时，最好直接在代码中构造你的 Component 对象，并随时利用翻译。
字面文本
这是创建 Component 对象最简单的方式，创建字面值。 这就是会照样显示的字符串，默认没有任何格式化。
这些是使用 Component.nullToEmpty 或 Component.literal 方法创建的，这两个行为有点不同。 Component.nullToEmpty 接受 null 输入，返回 Component 实例。 Component.literal 不同，不能有空输入，返回的是 MutableComponent，是 Component 的子类，可以轻易地格式化和连接。 这个后面会有更多。
java
Text literal = Component.nullToEmpty("Hello, world!");
MutableComponent mutable = Component.literal("Hello, world!");
// Keep in mind that a MutableComponent can be used as a Text, making this valid:
Text mutableAsText = mutable;1
2
3
4
2
3
4
可翻译文本
给相同的文本字符串提供多个翻译时，可以使用 Component.translatable 方法，引用语言文件中的任意翻译键。 如果翻译键不存在，则字面转换翻译键。
java
Text translatable = Component.translatable("my_mod.text.hello");
// Similarly to literals, translatable text can be easily made mutable.
MutableComponent mutable = Component.translatable("my_mod.text.bye");1
2
3
4
2
3
4
语言文件，en_us.json，看上去应该像这样：
json
{
"my_mod.text.hello": "Hello!",
"my_mod.text.bye": "Goodbye :("
}1
2
3
4
2
3
4
如果想在翻译中使用变量（类似于在死亡消息中可以在翻译中使用涉及的玩家和物品），可以将这些变量作为参数添加进去。 想添加多少参数都可以。
java
Text translatable = Component.translatable("my_mod.text.hello", player.getDisplayName());1
在翻译中，可以像这样引用这些变量：
json
{
"my_mod.text.hello": "%1$s said hello!"
}1
2
3
2
3
在游戏中，%1$s 会被替换为你在代码中引用的玩家的名字。 使用 player.getDisplayName() 会使用鼠标悬停在聊天消息中的名字上时，以提示框形式出现实体的额外信息，相比之下使用 player.getName() 只会得到名字但不显示额外细节。 对物品堆也是类似，使用 stack.toHoverableText()。
至于 %1$s 都是指什么，你要知道的就是数字对应的你尝试使用的哪个变量。 比如说你有使用三个变量。
java
Text translatable = Component.translatable("my_mod.text.whack.item", victim.getDisplayName(), attacker.getDisplayName(), itemStack.toHoverableText());1
如果要引用，比如在这里是引用谁是攻击者，应该使用 %2$s，因为这是我们传入的第二个变量。 类似地，%3$s 引用的是物品堆。 有这些额外参数的翻译可能会像这样：
json
{
"my_mod.text.whack.item": "%1$s was whacked by %2$s using %3$s"
}1
2
3
2
3
序列化文本
前面提到过，可以使用 text codec 将文本序列化为 JSON。 更多关于 codec 的信息，请看 Codec 页面。
java
Gson gson = new Gson();
MutableComponent mutable = Component.translatable("my_mod.text.bye");
String json = gson.toJson(ComponentSerialization.CODEC.encodeStart(JsonOps.INSTANCE, mutable).getOrThrow());1
2
3
2
3
这会产生可用于数据包、命令和其他接受 JSON 格式文本而非字面或可翻译文本的地方的 JSON。
反序列化文本
要将 JSON 文本对象反序列化为 Component 类，还是使用 codec。
java
String jsonString = "...";
Component deserialized = ComponentSerialization.CODEC
.decode(JsonOps.INSTANCE, gson.fromJson(jsonString, JsonElement.class))
.getOrThrow()
.getFirst();1
2
3
4
5
2
3
4
5
格式化文本
你应该熟悉 Minecraft 的格式化标准：
可以对 MutableComponent 类使用 ChatFormatting 枚举以应用这些格式。
java
MutableComponent result = Component.literal("Hello World!")
.withStyle(ChatFormatting.AQUA, ChatFormatting.BOLD, ChatFormatting.UNDERLINE);1
2
2
| 颜色 | 名称 | 聊天代码 | MOTD 代码 | 十六进制代码 |
|---|---|---|---|---|
| 黑色（black） | §0 | \u00A70 | #000000 | |
| 深蓝色（dark_blue） | §1 | \u00A71 | #0000AA | |
| 深绿色（dark_green） | §2 | \u00A72 | #00AA00 | |
| 深青色（dark_aqua） | §3 | \u00A73 | #00AAAA | |
| 深红色（dark_red） | §4 | \u00A74 | #AA0000 | |
| 深紫色（dark_purple） | §5 | \u00A75 | #AA00AA | |
| 金色（gold） | §6 | \u00A76 | #FFAA00 | |
| 灰色（gray） | §7 | \u00A77 | #AAAAAA | |
| 深灰色（dark_gray） | §8 | \u00A78 | #555555 | |
| 蓝色（blue） | §9 | \u00A79 | #5555FF | |
| 绿色（green） | §a | \u00A7a | #55FF55 | |
| 青色（aqua） | §b | \u00A7b | #55FFFF | |
| 红色（red） | §c | \u00A7c | #FF5555 | |
| 淡紫色（light_purple） | §d | \u00A7d | #FF55FF | |
| 黄色（yellow） | §e | \u00A7e | #FFFF55 | |
| 白色（white） | §f | \u00A7f | #FFFFFF | |
| 重置 | §r | |||
| 加粗 | §l | |||
| §m | ||||
| 下划线 | §n | |||
| 斜体 | §o | |||
| 混淆 | §k |