Unity游戏翻译插件XUnity.AutoTranslator完整上手指南：新手也能轻松给游戏汉化

Unity游戏翻译插件XUnity.AutoTranslator完整上手指南：新手也能轻松给游戏汉化

【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator

你是否也遇到过这样的场景：种草的游戏只有日语或英语版本，剧情全靠连蒙带猜，玩不了半小时就无奈退款？别急着放弃——有一款开源的Unity游戏翻译插件叫 XUnity.AutoTranslator，能像"同声传译"一样实时把游戏里的文字翻译成中文。读完这篇指南，你将能独立完成从安装、配置到汉化的全过程，还掌握让翻译又快又准的进阶技巧。

先花两分钟认识这个翻译神器

一句话说清楚：XUnity.AutoTranslator 是一款开源的 Unity 游戏实时翻译插件，它可以自动捕获游戏屏幕上的文字并调用在线翻译服务，把译文实时替换回游戏里；同时它也能读取手动翻译文件，方便汉化组做精翻。

• 适合谁：玩日语/英语/韩语等外语 Unity 游戏的玩家、想给自己的游戏做汉化补丁的汉化组、对游戏翻译技术感兴趣的开发者。
• 开源属性：基于 MIT 许可证，当前版本 5.6.1，完全免费。
• 技术亮点：支持 UGUI、NGUI、TextMeshPro、IMGUI、FairyGUI、Utage 等多种主流 UI 框架，兼容 BepInEx、MelonLoader、IPA 等常见 Mod 加载器，甚至还支持 IL2CPP 类型的游戏（Android 移植游戏常用）。

它的原理并不神秘：插件通过"钩子"监听游戏里的文本组件，一旦发现文字变化就进入翻译队列，调用你指定的翻译服务，再把结果写回屏幕。整个过程全自动，你唯一要做的，就是告诉它"翻译成什么语言、用什么服务"。

上手指南第一步：选对安装方式

XUnity.AutoTranslator 提供了多种安装包，本质区别在于"由谁来把插件加载进游戏"。第一次使用，建议按下面这张表对号入座：

小提示：如果你不确定游戏用哪种加载器，可以先去游戏社区看看大家用什么，或者直接查游戏目录里是否已存在BepInEx、Mods、Plugins等文件夹。确定不了就用独立安装版，绝大多数游戏都能跑起来。

如果你的游戏是 IL2CPP 编译的（判断方法：游戏目录里有GameAssembly.dll而没有完整的Managed文件夹），那就需要搭配 BepInEx 6 的 IL2CPP 版本，并选择插件包中标注BepInEx-IL2CPP的安装包。需要说明的是，IL2CPP 下的文本捕获能力目前还不算完整，个别文字可能需要手动刷新才会翻译。

三步完成环境搭建（以 BepInEx 为例）

第 1 步：装好 BepInEx。下载 BepInEx 5.x 压缩包，解压到游戏根目录（即和游戏 exe 同级的目录），然后先启动一次游戏再退出。这一步的目的是让 BepInEx 生成自己的目录结构（如BepInEx/plugins、BepInEx/config）。

第 2 步：部署插件。下载 XUnity.AutoTranslator 的 BepInEx 安装包，同样解压到游戏根目录。正确的结果是：XUnity.AutoTranslator.Plugin.Core.dll等文件出现在BepInEx/plugins下，翻译服务 DLL 出现在BepInEx/plugins/.../Translators文件夹中。

第 3 步：启动游戏生成配置。再次启动游戏，插件会在BepInEx/config/下自动生成AutoTranslatorConfig.ini。注意：这份配置文件不是我们手写的，而是插件根据当前游戏环境自动生成的，我们只需在它基础上修改。

跑通第一个翻译：从启动到看到中文

现在打开生成的AutoTranslatorConfig.ini，找到[Service]和[General]两个小节，改成下面这样：

[Service] Endpoint=GoogleTranslate ; 使用的翻译服务，冒号后是注释 [General] Language=zh ; 目标语言：中文 FromLanguage=ja ; 源语言：日语（不确定就写 auto）

改动一共就三行：Endpoint决定用哪个翻译服务，Language决定译成什么语言，FromLanguage告诉插件原文是什么语言。然后保存，重新启动游戏。

成功标志：游戏里的日文（或英文）文字变成中文；同时游戏目录下会出现Translation/zh/Text/_AutoGeneratedTranslations.txt文件，里面记录着插件自动翻译过的每一句文本。看到这个文件里开始积累内容，就说明整套流程已经跑通了。

如果你按了ALT+0，屏幕左上角会出现一个小界面，可以用它快速切换翻译服务的开关；ALT+T则可以在原文和译文之间来回切换，方便你对照验证翻译效果。

三个真实场景，把插件用到得心应手

场景一：日语游戏汉化（含中文显示不全的修复）

适用人群：RPG、视觉小说玩家。

配置要点：日语 → 中文，推荐用质量更高的 DeepL 服务：

[Service] Endpoint=DeepLTranslate [General] Language=zh FromLanguage=ja

容易踩的第一个坑是"中文变方块"。很多游戏自带的字体不含中文字形，翻译后中文显示不出来或显示成豆腐块。解决办法是给游戏指定一个中文字体，在配置里加上：

[Behaviour] OverrideFont=你的中文字体文件.ttf

这个选项只对 UGUI 生效；如果游戏用的是 TextMeshPro，则应该设置FallbackFontTextMeshPro为 TMP 字体资源名。

场景二：游戏术语精准翻译（汉化组必备）

适用人群：想给游戏做精翻、或手动修正机翻结果的用户。

自动翻译再智能，也难免把专有名词翻错。插件支持手动翻译文件，优先级高于自动翻译。操作很简单：

1. 打开上一步生成的_AutoGeneratedTranslations.txt；
2. 把想修正的原文=译文行复制到一个新文本文件里，改成你要的译文；
3. 新文件放回Translation/zh/Text/目录，按ALT+R热重载即可，不用重启游戏。

例如让"生命值"固定显示为 HP：

生命值=HP 魔法值=MP 经验值=EXP

对于名称会变化的情况，还支持正则，比如把"第N号戒指"统一翻译：

r:"^シンプルリング ([0-9]+)$"=Simple Ring $1

注意：正则只放在非下划线开头的翻译文件里，放在自动生成的_开头文件内是无效的。

场景三：给翻译做"体检"，让游戏更流畅

适用人群：翻译出现卡顿、或想减少网络请求的用户。

插件内置了相当严苛的防滥用机制：单次会话最多发 8000 个请求、同一时间只发一个请求、相同文本只翻译一次、结果自动缓存到内存和磁盘。这些机制保证了它不会把游戏拖垮，但如果你的网络较慢，还可以进一步调整：

[Behaviour] MaxCharactersPerTranslation=200 ; 超过这个长度的文本不翻译 EnableBatching=True ; 合并多条文本一次性请求 UseStaticTranslations=True ; 使用内置常用词静态翻译，减少请求

另外，如果你玩的是带 MOD 的游戏，MOD 的界面默认不翻译（IMGUI 默认关闭）。需要的话把配置里的EnableIMGUI=True打开，MOD 菜单文字也能一并翻译。

常见问题排查清单

翻译半天没反应，先按这个顺序查：

1. 配置文件的路径对吗？如果[Service]或[General]改错了，翻译会静默失败。检查文件是否在BepInEx/config/下。
2. 服务是否挂了？免密钥的在线翻译服务（Google、Bing、DeepL 网页版）本质上是"蹭"网页接口，随时可能失效。如果刚装好就没反应，大概率是接口变了，换一个 Endpoint 试试。
3. 是不是被防滥用机制关了？插件如果连续 5 次翻译没有返回结果，会自动关闭自我保护。此时按ALT+Q可重启插件（前提是你已经解决了网络问题，比如换了代理或节点）。
4. 游戏因为翻译"卡死"或行为异常？有些游戏会用屏幕上显示的文本做逻辑判断，翻译后文本变了，游戏逻辑就乱了。在配置里开启TextGetterCompatibilityMode=True即可解决。
5. 3D 世界里飘着的文字没翻译？那是 TextMesh 组件，默认关闭。把EnableTextMesh=True打开。

中文显示成乱码或方块？见场景一的字体覆盖方案——这是中文用户最常遇到的问题，本质是游戏字体缺字，不是翻译失败。

想完全关闭自动翻译？按ALT+0打开界面选择空端点，或把Endpoint=留空。

结语：你的游戏，也可以没有语言隔阂

从选择安装方式、三行配置跑通第一个翻译，到手动术语修正、性能调优，XUnity.AutoTranslator 把"给游戏汉化"这件事的门槛降到了几乎为零。更难得的是，它是一个完全开源的 MIT 项目，核心代码就摆在src/XUnity.AutoTranslator.Plugin.Core/（核心逻辑）、src/Translators/（各翻译服务实现）、src/XUnity.ResourceRedirector/（资源重定向）这些目录里，想深入了解随时可以读源码，想参与贡献也随时可以提交代码。

现在就可以动手了：用git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator把源码拉下来，或者直接下载对应安装包开始你的第一个汉化项目。相信我，当游戏里第一句日文变成你能读懂的中文时，那种"破译语言"的成就感，远比你想象的更让人上瘾。

【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator