XUnity.AutoTranslator 实战通关指南：让Unity游戏文本无障碍说中文

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

面对满屏日文、英文的游戏界面，你是不是也经历过"剧情全靠猜、菜单全靠蒙"的崩溃时刻？今天要介绍的XUnity.AutoTranslator，正是解决这个问题的 Unity 游戏自动翻译插件。它能在游戏运行时实时翻译界面与对话文本，还支持手动精修、图片替换和资源重定向，让你从"玩不懂"直接跳到"玩得懂"。这份通关指南会带你从安装一路走到进阶定制，每一步都有具体动作，照着做就行。

第一关：先承认你遇到的语言之墙

喜欢游戏的人多半都有过这种体验：心仪已久的作品终于发售，打开却是陌生的语言。翻译插件的价值不只是"看懂几个字"，而是三件套需求一起解决：

• 剧情体验断层：对话再精彩，读不懂就等于没剧情
• 操作入口迷茫：设置、背包、技能树全是生词，寸步难行
• 攻略分享受阻：想和网友交流心得，连装备名字都叫不上来

XUnity.AutoTranslator 的思路很简单：它像一台装在游戏里的"同声传译"，在文本显示前拦截、翻译、再放回去。你看到的依然是原汁原味的游戏，只是文字变成了你熟悉的语言。

第二关：开工前先看清它能给你什么

先别急着动手装，花一分钟搞清楚这套工具到底能干什么，后面配置时才不会一头雾水。它本质上由三层构成：

• 文本钩子层：负责抓住游戏里的每一条文本。支持 UGUI、NGUI、TextMeshPro、IMGUI、TextMesh 等主流 UI 框架
• 翻译服务层：把抓到的文本交给翻译端点（Endpoint），也就是 Google、DeepL、Bing 这类翻译服务
• 缓存与文件层：所有翻译结果都会写入磁盘缓存，重复文本只翻译一次

翻译完成后，你会得到一套自动生成的翻译文件目录，通常长这样：

AutoTranslator/ └── Translation/ └── zh-CN/ ├── Text/ # 文本翻译缓存与手动翻译 └── RedirectedResources/ # 重定向的游戏资源

为什么重要：看懂这个目录，你就理解了整款工具的工作流——自动翻译只是起点，文件才是你精修汉化的主战场。这一点在第八关会展开讲。

第三关：选一条适合自己的安装路线

安装方式决定了你后面的使用体验，这里提供两条主流路线，按你的"折腾指数"选。

路线 A：零基础省心流——ReiPatcher 独立安装

如果你不想碰任何插件管理器，这是最快的一条路。

1. 下载 XUnity.AutoTranslator-ReiPatcher 版本压缩包
2. 解压到游戏根目录，确保 SetupReiPatcherAndAutoTranslator.exe 和其他 exe 放在同一层
3. 运行该 exe，它会自动帮你完成补丁初始化
4. 用生成的"（Patch and Run）.lnk"快捷方式启动游戏

为什么重要：整个过程不需要装任何前置依赖，ReiPatcher 本身就随包提供，对技术小白极度友好。

路线 B：模组玩家规整流——BepInEx 插件式安装

如果你已经在用 BepInEx 管理其他模组，强烈建议走这条路，避免两套注入机制互相打架。

1. 先装好 BepInEx 插件管理器
2. 下载 XUnity.AutoTranslator-BepInEx 版本，解压进游戏目录
3. 把压缩包里的 dll 按目录结构放入 BepInEx/plugins，启动游戏即可

游戏第一次启动后，配置文件和翻译目录会自动生成。你只需要找到 Config.ini 开始改造，这就是第四关的内容。

其他备选路线速览

第四关：改对配置文件，翻译就成功了一半

打开自动生成的 Config.ini，核心就三个区域。第一组是语言三件套：

[Service] Endpoint=GoogleTranslate FallbackEndpoint= [General] Language=zh-CN FromLanguage=ja

• Endpoint：翻译服务端点，决定文本交给谁翻译
• Language：目标语言，写你想看到的语言，比如 zh-CN
• FromLanguage：源语言，即游戏原始语言；部分端点支持 auto 但通常不建议，明确指定更准

为什么重要：这三行是整套工具的"大脑设置"，多数"翻得不对"的问题都出在语言方向写反了。

翻译服务怎么选：免费与付费的取舍

为什么重要：免费端点不需要任何密钥，适合先跑通流程；一旦你要长期使用或做正式汉化，付费端点更稳，也更容易通过防滥用机制。无论选哪个，记得别把 API 密钥分享给任何人。

文本框架开关：不是越多越好

[TextFrameworks] EnableUGUI=True EnableNGUI=True EnableTextMeshPro=True EnableTextMesh=False EnableIMGUI=False

为什么重要：插件默认只开启常用框架，是有意为之的——TextMesh 常用于 3D 漂浮文字，IMGUI 多用于编辑器类界面，开启后既费性能又容易抓到垃圾文本。只开游戏实际用到的框架，翻译精准度和游戏流畅度都会更好。

让译文不乱跑：UI 缩放与字体

翻译后文字变长、超出对话框是最常见的"翻完反而更难看了"问题。这两个参数专门收拾它：

[Behaviour] EnableUIResizing=True ResizeUILineSpacingScale=0.80 OverrideFont=YourFont.ttf

为什么重要：翻译成中文等非 ASCII 语言时，游戏自带字体常缺字。OverrideFont 让你指定自定义字体兜底；UIResizing 则在文字溢出时自动调整显示方式。记住：宁可先开 UIResizing，也别一上来就全量换字体。

第五关：游戏里的快捷键速查表

装好配好之后，把这些快捷键抄在便利贴上，随时救急：

💡实用技巧：翻译不生效时，先按 ALT + U 手动抓一次文本，再按 ALT + R 重载文件，能解决大半"没反应"的怪病。

第六关：实战三连，遇到问题别慌

案例一：装好了，但游戏里一个字都没翻

现象：启动游戏后界面依旧是原语言。

原因排查：大概率是文本框架没开全，或语言方向写反。

解决步骤：

1. 打开 Config.ini，确认 FromLanguage 和 Language 方向正确
2. 把游戏实际使用的文本框架全部设为 True
3. 进游戏按 ALT + U 手动钩子试一次
4. 还不行就查游戏日志，确认插件是否成功加载

案例二：翻是翻了，但句子读不通

现象：翻译结果语法混乱，人名地名错得离谱。

解决步骤：

1. 先换端点对比，比如从 GoogleTranslate 切到 DeepLTranslate 看质量差异
2. 检查源语言是否写死为游戏真实语言
3. 用 _Substitutions.txt 把高频错译的名词固定下来
4. 重要文本直接走手动翻译，一劳永逸

案例三：装上插件后游戏明显变卡

现象：帧数下降，界面响应迟钝。

解决步骤：

1. 关掉不需要的文本框架（尤其 IMGUI、TextMesh）
2. 把 MaxCharactersPerTranslation 从默认 200 往下调，过滤长文本
3. 确认 EnableBatching 为 True，减少请求次数
4. 清理翻译目录里的历史缓存文件

第七关：避坑清单，帮你少走弯路

❌错误做法：把所有文本框架全部打开，觉得"全开才不漏翻" ✅正确做法：只开游戏用到的框架，漏翻靠 ALT + U 补抓

❌错误做法：MaxCharactersPerTranslation 拉到 1000，怕长句被截 ✅正确做法：200 左右最平衡，超长句拆开处理更精准

❌错误做法：一上来就开全部高级功能，重定向、纹理、批处理全开 ✅正确做法：按需启用、逐个验证，先跑通基础翻译再加功能

❌错误做法：看到官方有离线缓存就以为"不联网也能翻" ✅正确做法：记住自动翻译必须联网，不放心就在安装前想清楚

第八关：进阶玩法，把翻译变成你的专属汉化包

基础功能上手后，这些玩法能让你的翻译质量直接"越级"。

正则表达式：一条规则搞定一类文本

游戏里的物品、称号常带编号，比如"简约戒指 I、简约戒指 II"。逐个手翻太蠢，用正则一行搞定：

r:"^シンプルリング ([0-9]+)$"=简约戒指 $1

识别规则是以 r: 开头的行。更进一步，用分拆正则 sr: 可以把"01 シンプルリング"这类组合文本拆开翻译再拼回：

sr:"^([0-9]{2}) ([\S\s]+)$"=$1 $2

⚠️提醒：正则很强大，但请克制使用——它能放进除自动生成文件外的任何翻译文件，滥用会影响性能。

手动翻译文件：你的私人汉化库

自动生成的 _AutoGeneratedTranslations.txt 优先级最低，手动翻译优先。你可以把它当素材库：把里面的条目剪出来，归入自己的分类文件，比如 UI.txt、Dialogues.txt。

还可以为单个模组提供专属翻译：在 Text 目录下建 Plugins 文件夹，再建一个以该模组 dll 命名的子目录，把翻译放进去；在文件里加一行#enable fallback，就能在专属翻译缺失时回退到通用翻译。

资源重定向与图片替换

想改游戏里的文本资源甚至图片？开启资源重定向：

[ResourceRedirector] PreferredStoragePath=Translation\{Lang}\RedirectedResources EnableTextAssetRedirector=True EnableDumping=True

开启后，游戏加载的 TextAsset 会被导出到上述目录，你改哪个文件，游戏就加载哪个文件。纹理替换同理，在 [Texture] 区把 EnableTextureDumping 和 EnableTextureTranslation 设为 True，游戏内的图片就能导出、修改、再替换回去。

自定义翻译端点：接上你自己的翻译服务

想用公司内网、离线或自研的翻译服务？配置 CustomTranslate：

[Service] Endpoint=CustomTranslate [Custom] Url=http://your-translation-service.com/translate

插件会向该地址发起 GET 请求，带上 from、to、text 参数，并把响应正文当作译文。这是开发者向的高级玩法，建议先把官方端点跑熟再碰。

第九关：故障排查速查手册

为什么重要：XUnity.AutoTranslator 内置了一套防滥用保护——同一文本变化一秒内不发请求、同时只发一个请求、单次会话最多 8000 次翻译。这些机制防止了把免费端点刷爆，但也意味着"连着失败就自动停工"。遇到停止工作，先确认网络和端点正常，再按 ALT + Q 恢复。

第十关：下一步，从玩家到汉化贡献者

新手路线：用 ReiPatcher 装好 → 默认配置跑通 → 掌握 ALT 快捷键 → 在自动生成文件里改几条翻译练手。

进阶路线：吃透 Config.ini 每个分区 → 用正则和分拆正则处理动态文本 → 用资源重定向改游戏资源 → 为喜欢的模组做专属翻译包。

开发者路线：如果想从源码构建，可以克隆仓库https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator，研究 Translators 目录下的端点实现，甚至写一个属于自己的翻译端点插件。想贡献汉化，整理好的翻译文件本身就是给社区最好的礼物——分享时记得带上自动生成的翻译缓存，能帮其他玩家省下大量在线请求。

终章：把今天的收获串起来

回顾一下你现在的技能树：

• ✅ 选对了适合自己的安装方式，翻译随游戏启动
• ✅ 配好了语言三件套和文本框架，翻译又快又准
• ✅ 记住了七枚快捷键，遇到问题随时自救
• ✅ 学会了用正则和手动翻译打磨译文质量
• ✅ 掌握了资源重定向与自定义端点这类进阶手段

翻译从来不是一次到位的事，但只要你掌握了这套工具，就拥有了把任何 Unity 游戏"汉化"成自己语言的能力。现在，去找一款你一直想玩却看不懂的游戏，亲手装一次试试——这次，轮到语言障碍为你让路了。

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