1. 项目概述：为什么我们需要游戏汉化工具？

如果你是一个喜欢玩独立游戏或者小众外文游戏的玩家，肯定遇到过这样的困境：游戏本身质量上乘，玩法独特，但偏偏没有官方中文。面对满屏的英文、日文或者其他语言，即便查着词典硬啃，也难免会错过剧情细节、任务提示或者关键的装备描述，游戏体验大打折扣。对于Unity引擎开发的游戏来说，由于其资源结构和脚本逻辑相对统一，催生出了一批强大的社区汉化工具，而XUnity.AutoTranslator（以下简称AutoTranslator）无疑是其中的佼佼者。

简单来说，AutoTranslator是一个运行时的文本钩取与翻译插件。它不像传统的汉化补丁那样需要解包、修改游戏资源文件再重新打包，而是“动态”地工作。当游戏运行时，它会拦截游戏引擎（主要是Unity）向屏幕绘制文本的调用，将获取到的外文文本实时发送到你指定的翻译服务（如谷歌翻译、百度翻译、DeepL等），然后将翻译结果“覆盖”绘制在原文本的位置上。整个过程对游戏原始文件是“只读”的，无需修改，因此兼容性极佳，也避免了因游戏更新导致汉化补丁失效的麻烦。

这个工具的核心价值在于其“通用性”和“即时性”。只要游戏是基于Unity引擎（包括使用IL2CPP后端编译的），理论上都可以尝试用它进行汉化。它解决的正是玩家“想玩”与“语言不通”之间的核心矛盾。本教程将从一个实际使用者的角度，带你完整走通使用AutoTranslator汉化一款Unity游戏的全过程，并深入讲解其中的原理、配置细节以及我踩过的各种坑，目标是让你看完就能自己动手，让心仪的外文游戏秒变中文。

2. 核心思路与工具选型背后的考量

在动手之前，理解AutoTranslator的工作原理和不同配置方案的优劣至关重要。这能帮助你在遇到问题时快速定位，也能让你明白每一步操作的意义，而不是机械地照搬步骤。

2.1 运行时钩取 vs 静态资源修改

传统的汉化方式是“静态”的。汉化组需要破解游戏包体，找到存储文本的资源文件（可能是.asset、.json、.txt或嵌入在代码中的字符串），人工翻译后替换原文件，再重新打包。这种方式优点是一劳永逸，玩家下载补丁覆盖即可。但缺点非常明显：技术门槛高（需要逆向工程）、工作量大（需完整翻译）、更新维护难（游戏每次更新，补丁可能失效）。

AutoTranslator走的是“运行时”路线。它利用BepInEx（一个Unity游戏的插件框架）注入到游戏进程，并挂钩（Hook）Unity引擎内部处理UI文本的核心函数，例如Text组件的set_text属性或TextMeshPro的相关方法。当游戏设置文本时，钩子函数会先捕获到原始字符串，然后将其送入一个翻译流程，最后将翻译后的文本设置回去。这个过程对游戏本身是透明的。

为什么选择这种方式？最大的优势是敏捷和通用。你不需要等待完整的汉化补丁，甚至可以自己边玩边翻译。对于更新频繁的抢先体验（Early Access）游戏尤其友好。同时，只要Unity引擎渲染文本的底层机制不变，同一个AutoTranslator插件就能适配海量游戏，实现了“一把钥匙开多把锁”。

2.2 翻译引擎的选择：免费、质量与稳定性

AutoTranslator本身不提供翻译能力，它只是一个“调度中心”。真正的翻译工作交给了外部的翻译API。你需要根据实际情况选择：

1. 谷歌翻译（Google Translate）：最经典的选择，支持语言多，质量相对稳定。但需要解决网络访问问题。对于有能力的用户，可以通过配置代理或使用某些地区可直连的API端点来使用。注意：直接使用其免费网页接口可能存在频率限制。
2. 百度翻译API：国内用户最方便的选择，有官方API，需要申请免费（有额度）或付费的appid和密钥。优点是稳定、速度快，符合国内网络环境。
3. DeepL：以翻译质量高著称，尤其适合欧洲语言。同样需要API密钥，并且是付费服务，但提供免费试用额度。
4. 内置离线引擎（如GoogleTranslate.Offline）：AutoTranslator社区提供了一些离线翻译插件，它们会下载预训练的翻译模型在本地运行。优点是完全离线、无网络延迟；缺点是翻译质量通常不如在线API，且模型文件较大，占用硬盘空间。

我的选型建议：

• 国内普通玩家：首选百度翻译API。去百度翻译开放平台注册一下，获取免费的月度字符额度（标准版每月100万字符），对于游戏汉化完全够用。配置简单，速度最快。
• 追求翻译质量且不介意付费：选择DeepL。它的译文在语境和自然度上往往更胜一筹。
• 有特殊网络环境或想离线使用：研究离线翻译插件。适合网络不便，或游戏文本量不大、对质量要求不极致的场景。
• 谷歌翻译：作为一个备选，在某些特定情况下可能有用。

在本教程中，我将以百度翻译API为例进行配置，因为它对大多数国内用户来说是最可行的方案。理解了这一点，后续的配置文件填写就不再是“黑盒”了。

2.3 BepInEx：不可或缺的基石

几乎所有的Unity游戏Mod，包括AutoTranslator，都依赖于BepInEx这个注入器。它的作用是在游戏启动时，将自定义的插件代码（DLL文件）加载到游戏进程的内存中，并允许这些插件修改游戏的行为。你可以把它想象成一个“游戏模组加载器”。

为什么必须是BepInEx？因为现代游戏，尤其是使用IL2CPP编译的Unity游戏，代码被编译成了本地机器码，传统的Assembly-CSharp修改方式已失效。BepInEx提供了强大的底层Hook能力和插件管理框架，使得像AutoTranslator这样需要深度介入引擎行为的插件得以运行。安装BepInEx是第一步，也是基础中的基础。

3. 三步实操详解：从零到汉化成功

接下来，我们进入核心的实操环节。请准备好你想要汉化的Unity游戏（以Windows平台为例）、网络连接，以及一点点耐心。

3.1 第一步：部署BepInEx框架

这一步的目标是在游戏目录中搭建起能让插件运行的环境。

1. 定位游戏根目录：在Steam库中右键游戏 -> “管理” -> “浏览本地文件”。这就是游戏的根目录，路径中应包含游戏的.exe可执行文件。
2. 下载BepInEx：前往BepInEx的GitHub发布页，下载对应你游戏架构的版本。大多数Unity游戏是x86_64（64位）。你需要下载BepInEx_x64_版本号.zip这样的包。
3. 解压与安装：将压缩包内的所有文件和文件夹（主要是BepInEx文件夹、doorstop_config.ini、winhttp.dll等）解压到游戏根目录。如果提示文件重复，选择覆盖。
4. 首次运行以生成配置：双击游戏的可执行文件（.exe）启动游戏。此时游戏可能会黑屏一段时间（BepInEx正在初始化），这是正常的。进入游戏主菜单后，直接关闭游戏。
5. 验证安装：回到游戏根目录，你应该能看到新生成了一个BepInEx文件夹，并且其内部有plugins、config等子文件夹。BepInEx/LogOutput.log文件里记录了启动日志，没有大量红色错误即表示安装成功。

注意：有些使用新版Unity或特殊反作弊的游戏可能无法直接使用BepInEx。如果游戏完全无法启动，或启动后无BepInEx文件夹生成，可能需要寻找针对该游戏的特定BepInEx版本或安装方法，这超出了本通用教程的范围。

3.2 第二步：安装与配置XUnity.AutoTranslator

现在，我们要把翻译插件“放”到BepInEx的插件目录里。

1. 下载AutoTranslator：前往AutoTranslator的GitHub发布页（或可靠的Mod发布站），下载最新的XUnity.AutoTranslator-BepInEx-版本号.zip。
2. 安装插件：将压缩包内的Translation文件夹和XUnity.AutoTranslator.dll等文件，复制到游戏根目录的BepInEx/plugins文件夹内。通常，直接解压整个压缩包到BepInEx/plugins目录即可，保持其内部结构。
3. 准备翻译引擎插件：AutoTranslator主插件只负责调度，我们还需要具体的“翻译工人”。以百度翻译为例，你需要下载XUnity.AutoTranslator.Plugin.Extras.BaiduTranslate这个额外的插件DLL文件。将其同样放入BepInEx/plugins文件夹。
4. 首次运行生成配置文件：再次启动游戏，然后退出。此时会在BepInEx/config文件夹下生成AutoTranslatorConfig.ini这个关键的配置文件。

3.3 第三步：精细配置与实现翻译

这是最关键的一步，配置文件决定了翻译如何工作。

1. 打开配置文件：用记事本或任何文本编辑器（推荐VSCode、Notepad++）打开BepInEx/config/AutoTranslatorConfig.ini。
2. 核心配置项详解：
   • [General]部分
     • Language：目标语言。设置为zh（简体中文）或zh-CN。
     • FromLanguage：源语言。如果游戏是多语言可选，可以设为auto（自动检测）。如果确定是英文游戏，设为en可以提高一点效率和准确性。
   • [Service]部分
     • Endpoint：翻译服务提供商。使用百度翻译时，这里填写BaiduTranslate（注意大小写）。
   • [BaiduTranslate]部分（这是使用百度翻译插件后才出现的）
     • AppId和SecretKey：这是你的凭证。需要去百度翻译开放平台（api.fanyi.baidu.com）注册开发者，创建通用翻译服务，即可获得。请妥善保管，不要泄露。
3. 配置百度翻译：
   • 登录百度翻译开放平台，在“管理控制台”创建应用，选择“通用翻译”服务。
   • 获取系统分配的AppID和密钥（Secret Key）。
   • 将这两个字符串分别填入配置文件的AppId和SecretKey项。
4. 其他实用配置：
   • DelaySeconds：翻译请求的延迟秒数。为了避免短时间内大量文本导致API限流，可以设为0.5或1。
   • MaxCharactersPerTranslation：单次翻译的最大字符数。百度API免费版上限是6000，保持默认即可。
   • OverrideTranslation：本地词典覆盖。可以创建Translation/zh/Text文件夹，在里面放.txt文件（格式：原文=译文），用于自定义或修正某些翻译。这对于翻译游戏内专有名词（如技能名、地名）特别有用。
5. 保存并测试：保存配置文件，重新启动游戏。此时，游戏内的文本应该会逐渐（因为有个翻译延迟）被替换成中文。你可以打开游戏内的日志（默认按F12键，具体快捷键可能在配置文件中[General]部分的ShowErrorPopup等设置）查看翻译状态。

4. 高级技巧与深度优化配置

完成基础三步，游戏应该已经能显示中文了。但要让汉化体验更完美，还需要一些“打磨”。

4.1 处理未翻译文本与乱码

有时你会发现某些UI元素还是原文，或者翻译后出现了乱码（□□□）。这通常有几个原因：

1. 文本提取方式：AutoTranslator默认钩取主要的UI文本组件。但有些游戏可能使用自定义的文本渲染、或文本存储在非标准位置（如图片纹理）。这时需要调整[General]下的EnableUGUI、EnableNGUI、EnableTextMeshPro等选项，尝试开启所有可能的钩子。
2. 字体缺失：翻译后的中文需要游戏字体支持。如果游戏自带的字体不包含中文字符，就会显示方框。AutoTranslator有一个强大的功能是字体重定向。
   • 在BepInEx/config/AutoTranslatorConfig.ini中，找到[Font]部分。
   • 设置FontReplacements，例如：Arial=Microsoft YaHei。这会将游戏内所有使用“Arial”字体的地方，强制替换为系统自带的“微软雅黑”字体来显示。
   • 你需要知道游戏原字体名（可通过日志或Unity Explorer等工具查看）和一个包含中文的备用字体名（如Microsoft YaHei,SimHei,KaiTi）。可以将多个字体替换规则用分号隔开。
3. 缓存与更新：翻译过的文本会保存在Translation/zh/Cache文件夹下，下次遇到相同原文直接使用，节省API调用。如果你修改了本地词典或发现某句翻译错了，可以删除对应的缓存文件，或者清空整个Cache文件夹，强制重新翻译。

4.2 性能调优与稳定性提升

翻译过程涉及网络请求和文本处理，不当配置可能引起游戏卡顿或崩溃。

• 批处理与延迟：DelaySeconds不宜过小（如0.1），否则密集的API请求可能被服务商限制，也增加游戏卡顿风险。0.5到1秒是一个比较安全的范围。
• 排除特定UI：有些频繁更新的UI（如血量数字、计时器）不需要翻译。可以通过配置[General]下的ExcludedUINames，使用正则表达式排除包含特定名称的GameObject。例如，排除所有名字里带“HUD”、“Timer”、“Score”的UI。
• 内存监控：长时间游戏后，翻译缓存可能会增长。如果感到游戏变慢，可以定期手动清理Translation/zh/Cache文件夹。一些社区插件提供了内存管理功能。

4.3 创建与维护本地词典

这是提升汉化质量的终极手段。当你发现机翻的某些句子生硬、专有名词翻译不准时，就可以动用本地词典。

1. 创建词典文件：在BepInEx/plugins/Translation/zh/Text文件夹下（如果没有就新建），创建一个文本文件，例如CustomTranslations.txt。
2. 编写词典规则：每行一条规则，格式为原文=译文。例如：

   Potion of Healing=治疗药水 Critical Hit!=会心一击！ Welcome, %s.=欢迎你，%s。

   注意保留原文中的格式化符号（如%s、{0}）。
3. 优先级：本地词典的优先级高于在线翻译和缓存。游戏会优先使用这里定义的译文。
4. 词典管理：对于大型游戏，可以按功能模块分多个文件管理，如Items.txt、Skills.txt、Dialogue.txt等。AutoTranslator会读取该目录下所有的.txt文件。

5. 实战问题排查与经验心得

即便按照教程操作，你也可能会遇到一些棘手的情况。下面是我在汉化多款游戏中积累的常见问题排查清单和心得。

5.1 常见问题速查表

5.2 来自实战的几点心得

1. 测试顺序很重要：安装完BepInEx后，先不装任何插件，确保游戏能正常启动并生成完整文件夹结构。然后再安装AutoTranslator，最后配置翻译服务。分步测试能有效隔离问题。
2. 善用日志文件：BepInEx/LogOutput.log是你的第一诊断工具。任何插件加载失败、配置错误、API调用异常都会在这里留下记录。遇到问题先看日志。
3. “从简到繁”配置：初次配置时，不要在AutoTranslatorConfig.ini里修改太多选项。只设置最核心的Language、Endpoint和API密钥。等基础翻译工作后，再逐步尝试字体替换、排除UI等高级功能。
4. 缓存是你的朋友也是敌人：缓存能极大提升二次加载的速度和节省API额度。但当你调试本地词典或怀疑某句翻译有误时，记得清除缓存，否则修改不会生效。
5. 管理期望值：AutoTranslator是机翻工具，它的翻译质量取决于后端引擎（谷歌、百度等）。对于文学性、双关语多的文本，翻译效果可能不尽如人意。它的核心价值是提供“可理解的”游戏内容，而非“信达雅”的文学翻译。对于真正热爱的游戏，结合本地词典手动润色，才能达到最佳效果。
6. 社区是宝库：很多热门游戏已经有玩家分享配置好的AutoTranslator插件包、字体文件甚至完整的本地词典。在游戏相关的论坛、贴吧或Mod站（如Nexus Mods）搜索“AutoTranslator”或“XUnity”，往往能省去大量配置时间，直接获得优化过的体验。

最后，这套流程的核心思想是“动态拦截与替换”，它为我们提供了一种轻量、通用、可即时生效的游戏文本本地化方案。虽然它无法处理美术资源中的文字，也无法完美解决所有语境下的翻译问题，但对于让广大玩家无障碍地体验更多优秀的Unity游戏，XUnity.AutoTranslator无疑打开了一扇非常实用的大门。掌握它，你的游戏库利用率可能会直接翻上一番。