文本和翻译

Minecraft 不论何时在游戏内显示文本，都是使用 Component 对象定义的。 使用这种自定义的类型而非 String，是为了允许更多高级的格式化，包括颜色、加粗、混淆和点击事件。 这样还能够容易地访问翻译系统，使得将任何 UI 元素翻译成不同语言都变得容易。

如果以前有做过数据包和函数，应该看到用于displayName、书、告示牌等内容的就是用的 json 文本格式。 不难猜到，这就是 Component 对象的 json 呈现，可以使用 Component.Serializer 互相转换。

制作模组时，最好直接在代码中构造你的 Component 对象，并随时利用翻译。

字面文本组件

创建 Component 对象最简单的方法是创建一个字面值。 字面值就是一个普通的字符串，默认情况下会按原样显示，没有任何格式。

可以通过 Component.nullToEmpty 或 Component.literal 方法创建，这两个方法略有不同。 Component.nullToEmpty 接受空值作为输入，并返回一个 Component 实例。 而 Component.literal 则不能接受空值作为输入，它会返回一个 MutableComponent 对象，它是 Component 的子类，可以轻松地进行样式设置和字符串拼接。 稍后会详细介绍。

Component literal = Component.nullToEmpty("Hello, world!");
MutableComponent mutable = Component.literal("Hello, world!");
// Keep in mind that a MutableComponent can be used as a Component, making this valid:
Component mutableAsText = mutable;

可翻译文本组件

给相同的文本字符串提供多个翻译时，可以使用 Component.translatable 方法，引用语言文件中的任意翻译键。 如果翻译键不存在，则字面转换翻译键。 如果翻译键不存在，则字面转换翻译键。

Component translatable = Component.translatable("example-mod.text.hello");

// Similarly to literals, translatable text can be easily made mutable.
MutableComponent mutable = Component.translatable("example-mod.text.bye");

语言文件 en_us.json（简体中文为 zh_cn.json），看上去应该像这样：

{
  "example-mod.text.hello": "Hello!",
  "example-mod.text.bye": "Goodbye :("
}

如果想在翻译中使用变量（类似于在死亡消息中可以在翻译中使用涉及的玩家和物品），可以将这些变量作为参数添加进去。 想添加多少参数都可以。

Component translatable = Component.translatable("example-mod.text.hello", player.getDisplayName());

在翻译中，可以像这样引用这些变量：

{
  "example-mod.text.hello": "%1$s said hello!"
}

在游戏中，%1$s 会被替换为你在代码中引用的玩家的名字。 使用 player.getDisplayName() 会使用鼠标悬停在聊天消息中的名字上时，以提示框形式出现实体的额外信息，相比之下使用 player.getName() 只会得到名字但不显示额外细节。 对物品堆叠也是类似，使用 stack.getDisplayName()。

至于 %1$s 到底是什么意思，你只需要知道那个数字对应的是你正准备调用的第几个变量就行了。 打个比方，假设你现在有三个正在使用的变量。

Component translatable = Component.translatable("example-mod.text.whack.item", victim.getDisplayName(), attacker.getDisplayName(), itemStack.toHoverableText());

如果你想引用（在我们这个例子中）那个攻击者，应该使用 %2$s，因为这是我们传入的第二个变量。 类似地，%3$s 引用的是物品堆叠。 有这些额外参数的翻译可能会像这样：

{
  "example-mod.text.whack.item": "%1$s was whacked by %2$s using %3$s"
}

序列化文本

前面提到过，可以使用 text codec 将文本序列化为 JSON。 更多关于 codec 的信息，请看 Codec 页面。

Gson gson = new Gson();
MutableComponent mutable = Component.translatable("example-mod.text.bye");
String json = gson.toJson(ComponentSerialization.CODEC.encodeStart(JsonOps.INSTANCE, mutable).getOrThrow());

这会产生可用于数据包、命令和其他接受 JSON 格式文本而非字面或可翻译文本的地方的 JSON。

反序列化文本

要将 JSON 文本对象反序列化为 Component 类，还是使用 codec。

String jsonString = "...";
Component deserialized = ComponentSerialization.CODEC
		.decode(JsonOps.INSTANCE, gson.fromJson(jsonString, JsonElement.class))
		.getOrThrow()
		.getFirst();

格式化文本

你应该熟悉 Minecraft 的格式化标准：

可以对 MutableComponent 类使用 ChatFormatting 枚举以应用这些格式样式：

MutableComponent result = Component.literal("Hello World!")
  .withStyle(ChatFormatting.AQUA, ChatFormatting.BOLD, ChatFormatting.UNDERLINE);

颜色	名称	聊天代码	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