文本和翻译

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

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

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

字面文本

这是创建 Text 对象最简单的方式，创建字面值。 这就是会照样显示的字符串，默认没有任何格式化。

这些是使用 Text.of 或 Text.literal 方法创建的，这两个行为有点不同。 Text.of 接受 null 输入，返回 Text 实例。 Text.literal 不同，不能有空输入，返回的是 MutableText，是 Text 的字类，可以轻易地格式化和连接。 这个后面会有更多。

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

可翻译文本

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

Text translatable = Text.translatable("my_mod.text.hello");

// Similarly to literals, translatable text can be easily made mutable.
MutableText mutable = Text.translatable("my_mod.text.bye");

语言文件，en_us.json，看上去应该像这样：

{
  "my_mod.text.hello": "Hello!",
  "my_mod.text.bye": "Goodbye :("
}

序列化文本

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

Gson gson = new Gson();
MutableText mutable = Text.translatable("my_mod.text.bye");
String json = gson.toJson(TextCodecs.CODEC.encodeStart(JsonOps.INSTANCE, mutable).getOrThrow());

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

反序列化文本

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

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

格式化文本

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

可以对 MutableText 类使用 Formatting 枚举以应用这些格式。

MutableText result = Text.literal("Hello World!")
  .formatted(Formatting.AQUA, Formatting.BOLD, Formatting.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