文本和翻译
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 |