文本与本地化

Minecraft是一款在全球范围内拥有完全本地化文本的游戏。为了实现这一点，Minecraft采用了一种系统，其中内部翻译键根据每种语言分配值。Minecraft会为自定义实体、物品和区块生成翻译键，而我们需要在资源包中为它们分配本地化名称。

语言文件¶

语言文件通常放在资源包的“texts”文件夹中，文件扩展名为.lang。这些文件可以放在行为包中，但它所能更改的唯一可翻译文本是包清单的名称和描述。

<FolderView :paths="[ 'RP/texts/en_US.lang', 'RP/texts/languages.json', 'RP/manifest.json' ]"

目前，Minecraft支持29种语言，具体描述见§ 原版语言。

语言文件的格式相当简单。翻译以键值对的形式提供，用等号（=）分隔，键为翻译键，值为字符串。值中不能包含换行符。

wiki.example_translation.line_1=第一行！
wiki.example_translation.line_2=第一行之后的一些信息。

可以使用两个井号（##）添加注释，既可以作为行注释，也可以作为行内注释。所有在井号之后的文本都是注释，直到下一行。

警告

行内注释的尾随空格不会被修剪。如果想缩进注释，请使用Tab字符。

## 翻译者注：我觉得把这个放在这里会很有趣。
item.flint_and_steel.name=火石与史蒂夫	##[sic]

翻译可以包含文本的替代项。替代项可以是有序的（%1、%2等）或无序的（%s）。原版翻译的值由游戏填充，而玩家可以通过使用原始JSON文本格式的命令手动设置替代项的值，例如使用/tellraw。

commands.op.success=已提升权限：%s
immersive_reader.book_page_header=第%1页，共%2页

本地化几乎可以在任何可以使用文本的地方进行，包括（但不限于）：

然而，有些文本是无法翻译的，例如在铁砧中重命名的物品。

提示

为每种主要语言创建语言文件的副本是一种良好的实践。例如，为了支持完整的英语，应该分别创建en_US.lang和en_GB.lang文件，以覆盖美国和英国的英语。

在编辑语言文件时，还必须在texts文件夹中添加一个languages.json文件，包含一个数组，列出你计划更改的每种语言。这让Minecraft知道应该为这些语言应用本地化。

RP/texts/languages.json

[
  "en_US",
  "en_GB",
  "fr_FR"
]

通过全局资源包，可以通过languages.json和language_names.json文件引入自定义语言。一旦包被全局应用，语言可以在游戏设置的“语言”选项卡中更改。

在以下示例中，假设我们有两个功能齐全的语言文件，一个名为xx_XX.lang，另一个名为yy_YY.lang。

RP/texts/languages.json

[
  "xx_XX",
  "yy_YY"
]

language_names.json也是一个数组，但这次用于定义显示的语言名称。

RP/texts/language_names.json

[
  [ "xx_XX", "新语言（自定义语言#1）" ],
  [ "yy_YY", "维基语（自定义语言#2）" ]
]

警告

使用自定义语言时，请确保在禁用存储该语言的资源包之前，先卸下该语言，否则Minecraft将崩溃。

如果微软正在本地化你的.lang文件，则必须遵循特定的技术要求。

你可以使用免费的基于浏览器的LangUtil工具来帮助处理这些问题。

以下是Minecraft默认支持的29种语言的表格。