本地化

此部分内容讲述什么是本地化，如果你已了解过相关内容，可直接跳过

本地化文件的结构

也许你听说过汉化国外模组，汉化国外整合包。而汉化中很重要的部分就是翻译资源（assets）中的语言（lang）文件，把其中的非中文内容翻译成属于我们的所熟悉的中文。

这个过程我们可以称作“本地化”。对应的语言文件我们可以称作“本地化文件”。

MC语言文本的本地化文件以“json”作为数据交换格式，因此文件以“.json”为结尾。以我的世界原版的en_us.json文件为例：

{

    ……（省略一堆内容）
    "item.minecraft.apple": "Apple",
    ……（省略一堆内容）
}

"item.minectaft:apple"是“翻译键”，表示苹果这个物品的显示名称。

后面的"Apple"是翻译键所对应的“值”，表示苹果这个物品在游戏中显示为“Apple”。

无论是翻译键还是值，它们都由英文双引号或者英文单引号包起来。 两个组合在一起，中间加个英文冒号我们称作“键值对”。

若干个键值对（包括那些被省略的内容）组合在一起，中间用英文逗号隔开，最外边用一对花括弧包起来，就构成了我们的语言文本的本地化文件。

本地化的原理

美式英语有他们的语言本地化文件，我们简体中文也有我们的语言本地化文件zh_cn.json。这是因为不同地区使用不同的语言，对应的文本就存储在名称不同的本地化文件中。

实际游戏中，系统会根据我们所选的语言，在与语言相匹配的本地化文件中寻找翻译键，然后将值显示出来。

如果找不到要显示的翻译键，就会选择美式英语en_us.json文件中翻译键所对的值来显示。

如果仍然找不到，就会显示直接显示翻译键。

这便是实现可翻译文本最核心的地方。

药剂环重铸模组的 美式英语本地化文件(左) 和 简体中文本地化文件(右)

资源包

此部分内容讲述如何用资源包实现汉化，如果你已了解过相关内容，可直接跳过

本地化资源包制作

现在已经了解什么叫本地化，那么我们可以开始尝试使用资源包来实现汉化。

资源包的结构以及制作流程在这里不会过多讲述。如果你想了解更多的细节，可以在模组百科、MCwiki、B站等上看，有很多优质的教程。这里给出MCwiki上的资源包制作教程。这里我们只讲述有关语言文本的部分。

首先，本地化文件应该放在这个地方：

<你的资源包> → assets(资源) → <命名空间>(例如minecraft，表示我的世界原版资源存放的地方) → lang(语言) → <本地化文件>（表示存储语言文本的文件）

本地化文件的名称我们就取作zh_cn.json，这就是我们简体中文的本地化文件。当然，以实现多语言为目的，意味着你应该创建多个语言对应的本地化文件。

你可以用你电脑自带的记事本进行编辑。里面可以写上：

{
    "item.minecraft.apple": "苹果物品的本地化示例"
}

这里只是一个例子，实际上，你应该写上那些还没翻译而只有英文的键值对。因为你是要实现汉化，而不是实现胡乱改物品显示名称，尽管确实可以实现。

然后把你的资源包放进你游戏版本文件夹的resourcepacks文件夹里面，接着重新加载资源包。

如果一切顺利，那么接下来苹果物品的名称就会显示为“苹果物品的本地化示例”。

翻译键的获取

那么如何在游戏中获取只有英文文本的翻译键呢？如果你装了JEI扩展模组，你可以尝试找到这个文件：

<游戏版本文件夹> → config(配置) → jeiintegration-client.toml（表示JEI扩展客户端配置）

JEI扩展客户端配置文件内容

同样可以用你电脑自带的记事本进行编辑，底下的有个translationKeyTooltipMode，等于号后面改成"enabled"。重启游戏之后物品上就会显示翻译键。

不过这只适于物品的汉化，其他部分最好选择找到对应的模组文件（以“.jar”结尾），以压缩包的形式打开，然后同样找到：

<模组文件> → assets → <模组命名空间> → lang → <本地化文件>

通过对比en_us.json和zh_cn.json两个文件，我们就可以知道哪些键值对是未汉化的。

许多模组其实是没有zh_cn.json文件的，这意味着如果你想要汉化，你就需要翻译en_us.json文件中所有的键值对，然后写进zh_cn.json文件中。

如果你嫌弃电脑自带的记事本不好用，你可以安装VS Code这一轻量的文本编辑器，可以提高汉化时的体验感。

CraftTweaker

有了前面的铺垫，我们总算可以开始开启今天真正的主题了

硬编码汉化

好吧，有些时候你也许会发现，即使你把en_us.json中所有能够翻译的键值对全部都翻译成了中文，装进了汉化资源包并且在游戏中启用了汉化资源包，也仍然会有一些物品的提示框还是英文的。

通常来说，这是因为这部分文字是被“硬编码”进了游戏中，而非通过翻译键进行显示。通俗地讲，就是文字被写死在程序里面了，因而而无法仅通过资源包来本地化。

这个时候怎么办呢？我们可以请出一位从MC1.6.4奋战到至今仍顽强不屈的资深修改模组——CraftTweaker（曾名MineTweaker）。它允许我们使用ZenScript（一种编程语言）来编写代码，从而修改游戏中物品的提示框（tooltip）。

不会敲代码也没关系，跟着本教程的步骤走，你也能学会。

例子：更多熔炉中的链接器汉化

这里以汉化更多熔炉中的熔炉配置链接器为例子，具体步骤如下：

1、安装CraftTweaker模组并启动游戏。

2、在游戏里面找到我们想要翻译的物品。

更多熔炉模组中，熔炉配置链接器提示框中的部分文本被硬编码为英文

3、然后在聊天框中输入命令/ct hand，接着鼠标点击复制来获取这个物品。

/ct hand

注意！看清楚你复制的，应该是物品，不是方块，也不是方块状态，更不是什么标签！

4、在游戏版本文件夹中的scripts（脚本）文件夹里面，新建文本文件，名字你随便取。

     最后要把文件末尾的“.txt”修改为“.zs”。

     用记事本（或者前面说的VSCode）打开。

5、在里面粘贴你复制到的<物品>，然后在它加上“.removeTooltip( "文字" );”。

     这样会删掉物品提示框包含“文字”的那一行文本。

     以图中的物品为例：

<item:ironfurnaces:item_copy>.removeTooltip("click");            //物品中，只要包含"click"，提示框中的那一行文本就会被删除
//不要漏掉点和引号，每一行的结尾都必须加上分号，并且所有标点符号都是英文的
//双斜杆后面的内容不属于代码，表示的是注释，因此不会被执行

6、再写几行代码“<物品>.addTooltip( "文字" );”。

     这样就可以为物品提示框添加新的文本。

     仍以图中的物品为例：

<item:ironfurnaces:item_copy>.addTooltip("右键来复制配置");       //物品提示框中，添加一行文本
<item:ironfurnaces:item_copy>.addTooltip("潜行&右键来应用配置");  //再添加一行文本，记得不要漏掉英文标点符号

7、保存.zs文件，然后在游戏中输入命令进行重载。

/reload

游戏重载后，熔炉配置链接器提示框中的文本变为了中文

8、这里有一个需要注意的点。如果这个物品是有耐久的，你需要在<物品>的后面再加上“ .anyDamage()”，表示忽略物品的耐久。

     不然物品稍微掉一点耐久，描述就又变回去了。

     你应该像这样做：

<item:minecraft:iron_pickaxe>.anyDamage().removeTooltip("挖掘");  //在铁镐中，删除包含"挖掘"的那一行提示框文本
//当然，原本铁镐没有额外的提示框文本，所以什么都不会删除
//这里只是拿铁镐举例子，实际上可以类推到所有带耐久的物品
<item:minecraft:iron_pickaxe>.anyDamage().addTooltip("镐击");        //在铁镐的提示框中，添加一行文本

游戏重载后，减少了耐久度的铁镐提示框被加上了文本

这个汉化方法参考至模组百科中的另一篇教程《关于模组武器道具描述的汉化》，里面讲的内容更多更详细。这里只展示出其中的核心，有很多细节在那篇教程中有讲，如果此教程你看不懂，也可以去看上面这个。

有细心的同学应该发现了，这提示框文本不还是写死在代码里面吗？

没错，我们刚才所做的，其实就是用硬编码的中文文本，强行替换了原本硬编码的英文文本，是在“用魔法打败魔法”。我们实际上并没有从根源上解决问题。

可翻译文本

彻底解决硬编码问题，关键在于把硬编码改成翻译键

警告：接下来的部分涉及到大量CraftTweaker的语法知识。如果你未接触过相关的知识，你会感到一头雾水。因此请尽量尝试理解教程中的知识，或是学习模组百科上的基础教程《可能最全！1.12.2 CrT 基础合集》。如果你有问题，可以留言进行提问。

尽管我们最终的结果仍然是硬编码中文，但我们确实有办法删除物品中硬编码的文本 。只是我们没有将硬编码文本替换成可以用资源包本地化的文本。

那我们有办法在CraftTweaker里用什么代码获取资源包的本地化文本吗？

有的兄弟，有的，办法就是我们在前文所学到的翻译键，把我们的硬编码中文换成翻译键就可以了。

听上去很简单，但实际上有个很大的问题。

不同版本的CraftTweaker模组，它所提供的“方法”不同。（也有一部分mojang的原因，他们也喜欢胡乱改原版数据或者资源的格式。）

编者很难教会大家所有版本的。因此编者只总结了目前主流版本的1.12.2、1.16.5、1.18.2、1.20.1。

例子：暮色森林的禁用拆解提示

下面先以编者所用的版本1.18.2为例子，讲解具体的代码实现，在结尾放上其他版本所使用的“方法”。

编者这边禁用了暮色森林的拆解台的拆解功能，想为拆解台提示框添加可以本地化的文本。

在拆解台界面中，查看拆解台物品，其提示框中没有额外的文本

1、我们先要在脚本文件（以.zs结尾的文件，可在旧文件中添加代码，或新建一个）的开头加上下面这句代码。

//导入可翻译组件类，里面包含了通过翻译键获取语言文本的“方法”
import crafttweaker.api.text.TranslatableComponent;

注释中提到的“类”（class）是CraftTweaker模组为我们提供的一个大类别。

类里面有很多有用的“方法”（Method）可以给我们使用。

前面所用到的“.addTooltip( "文字" )”就是<物品>类中所具有的方法。

而可翻译组件类的方法，需要我们在脚本(.zs)文件的开头进行“导入”（import），之后才可以使用。

2、接着我们加行代码，要用到“new TranslatableComponent("<翻译键>")”来获取翻译键。

//创建一个可翻译组件，存进comp变量中
var comp = new TranslatableComponent("container.uncrafting_table.disabled");

这段代码中，“var …… = …… ;”是一个定义变量的语句，它会创建一个叫做“变量”的东西。变量能帮我们存储数据。

等于号右边的……是变量存储的内容。

等于号左边的……是变量的名称。一般来说你可以随便取，保证它是一个用字母、数字、下划线组成的英文单词就行。

而“container.uncrafting_table.disabled”是暮色森林本地化文件中自带的一个翻译键，简体中文中对应的值是“拆解功能不可用！”。

你可以换成任何翻译键，包括你自己无中生有的翻译键，只要它存在于模组资源或者资源包中的本地化文件里。

“new TranslatableComponent("<翻译键>")”的这整个我们称作“构造函数”，其中“new”表示新的。

这整个语句就表示，根据指定的翻译键来创建一个新的可翻译组件。

3、最后我们再加几行代码，要用到“<可翻译文本组件>.getString()”方法。

     这里再次使用了定义变量。

     提示框文本的添加方式在前文也有讲过：

var text = comp.getString();                                                //把可翻译组件转换成文本，存进text变量中
<item:twilightforest:uncrafting_table>.addTooltip(text);                    //为拆解台提示框添加内容为text的文本

4、最后记得在游戏中输入命令/reload进行重载：

/reload

使用/reload进行重载之后，拆解台提示框中出现了额外的文本

5、如果你熟悉CraftTweaker的语法规则，你就会明白，变量是不必要的。它只是为了代码的可读性。

     如果你不理解变量是什么，你完全可以直接用上述提到的“方法”，替换所有出现的变量。

     这与上面的代码等价。就像这样：

import crafttweaker.api.text.TranslatableComponent; //可翻译组件类，包含通过翻译键获取语言文本的“方法”

<item:twilightforest:uncrafting_table>.addTooltip(  //为拆解台物品描述，添加的内容为括号里的东西
    new TranslatableComponent(                          //创建一个可翻译组件
        "container.uncrafting_table.disabled"               //用这个翻译键来创建可翻译组件
    ).getString()                                       //用“方法”把组件转换成文本并作为括号里的东西，然后添加进提示框
);

多版本总结

以上就是1.18.2版本，用CraftTweaker添加翻译键的办法来实现可翻译文本。

对于其他主流版本，会用到不同的类和及其构造函数、方法、属性。

（你可以将属性理解为类里面的变量，修改方式也和变量相同，前面也有提到，用等号加上要存储的内容）

它们叫法不同，用法不太相同，但是实现逻辑是差不多的。

这里我把可能会用到的内容以及链接都一起列在这里（只是可能，实际上可能用不到，或者会用到这里没有的。看你选择）：

如果到目前为止，你已经理解并成功在游戏中给物品提示框添加了文本。那么恭喜你，你已经学会了如何实现可翻译文本。

事实上，可翻译文本不仅可以用在提示框文本上。理论上说，游戏中那些物品、方块、实体、容器、进度、字幕、JEI物品管理器、WTHIT( 或Jade )高亮物品提示等等能出现文本的地方，你应该都可以用上可翻译文本。

链接总结

在这里再次列出所有引用过的教程，以及其他可能有用的教程。编者也是从这些教程一点点学习到的，希望对你有所帮助：

1. MCwiki上的资源包制作教程《教程:制作资源包》

2. MCwiki上的语言资源包教程《教程:制作资源包/语言和文本》

3. 模组百科上的硬编码汉化教程《关于模组武器道具描述的汉化》

4. 模组百科上的CraftTweaker基础语法教程《可能最全！1.12.2 CrT 基础合集》

5. CraftTweaker的1.12.2官方文档《Home - CraftTweaker Documentation》

6. CraftTweaker的1.18.2官方文档《Home - CraftTweaker Documentation》

可翻译文本的意义

有同学可能会问，可翻译文本有什么意义呢？我直接汉化不好吗？

直接汉化当然没问题。但如果在海内外发布整合包，一般来说，文本只有中文是不够的。

对于整合包作者而言，有时并非要实现硬编码汉化，而是要为某个物品、某个事件、某个进度添加额外的信息。但为多门语言写专门的代码，是非常消耗精力的。

对于国内外的本地化团队来说，将这些硬编码信息本地化，是比将物品名称本地化困难得多的，可能也要像同学们解决硬编码汉化一样。

如果在制作整合包的时候，我们就将硬编码文本改成可翻译的文本，就可以在后期省下非常多的力气。我们想要修改文本的话，也不用专门扒开代码来修改。对于不懂代码的本地化团队来说，也能较轻松地实现本地化，岂不两全其美？