XUnity.AutoTranslator 完整上手指南：如何让 Unity 游戏 30 分钟拥有实时翻译
XUnity.AutoTranslator 完整上手指南：如何让 Unity 游戏 30 分钟拥有实时翻译
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
深夜 11 点，朋友发来消息："刚买了个日文 RPG，菜单全靠截图翻译，玩一小时眼睛快瞎了。" 这种痛苦，玩过生肉游戏的我们都懂。而 XUnity.AutoTranslator 正是解决这个问题的开源工具——一款针对 Unity 游戏的实时翻译插件，能自动捕获游戏画面中的文本、调用翻译引擎即时替换，装好后界面直接变成你读得懂的语言。这篇指南不聊源码，只讲怎么装、怎么配、会踩哪些坑。
它到底怎么帮你？一个场景就够了
想象游戏里的每一句对话、每一个菜单项，在你眼前"刷"一下变成中文或英文。XUnity.AutoTranslator 做的就是这件事：它像你的随身翻译官，潜伏在游戏运行时里，发现文本变化就出手翻译，再把结果写回屏幕。更贴心的是，翻译结果会自动缓存，同一句话第二次出现时零延迟，不再重复请求。
从下载到首屏翻译，最短路径怎么走
整个过程比你想象中快，核心就四步：
- 先确认框架：看看游戏平时用哪种插件管理器（BepInEx、MelonLoader、IPA 或 UnityInjector）。完全没概念的话，选独立安装包（ReiPatcher）最省心，对多数 Unity 游戏都能一键搞定。
- 再拿代码：执行
git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator获取完整源码和各版本安装包。 - 然后部署：把对应压缩包解压进游戏根目录。用 BepInEx 版时记得确认 dll 落在了
BepInEx/plugins下。 - 最后验证：直接启动游戏，插件会自动生成
AutoTranslatorConfig.ini，改好下面这份最小配置，重启游戏看效果：
[Service] Endpoint=GoogleTranslate FallbackEndpoint=DeepLTranslate [General] Language=zh FromLanguage=ja就这么简单。改完启动，游戏里的日语就该变成中文了。
它能做什么、不能做什么：一张表看懂边界
| ✅ 能做到 | ❌ 做不到 |
|---|---|
| 自动捕获 UGUI、NGUI、TextMeshPro 等主流 UI 文本 | 识别图片内嵌的文字（但可以整张替换纹理） |
| 内置 Google、DeepL、百度、Bing 等翻译引擎 | 离线翻译，必须联网使用 |
| 缓存翻译结果，重复文本秒出 | 保证翻译质量，那取决于你选的引擎 |
| 自定义术语替换、正则预处理、后处理 | 保证所有冷门游戏一次配置到位 |
| 字体覆盖与 UI 自适应调整 | 在没装插件框架时独立运行（需 ReiPatcher 方案） |
这张表多读两遍，能帮你省掉大量排查时间——很多"翻译没生效"其实是期望超出了工具的能力边界。
新手最容易踩的 5 个坑与对策
- 坑一：插件框架打架。已经装了 BepInEx 又用独立安装包，两者会冲突导致启动失败。对策：只选一种安装方式。
- 坑二：装好了却一个字都不翻。很多游戏默认只开了部分文本框架，
[TextFrameworks]里的EnableTextMeshPro、EnableNGUI可能需要手动打开。对策：逐项开启后重启游戏。 - 坑三：中文变成方块/乱码。多半是 TextMeshPro 缺字体。对策：配置
FallbackFontTextMeshPro指向支持中文的字体资源。 - 坑四：翻译一会儿就失效或请求被限流。对策：调低
MaxCharactersPerTranslation、开启EnableBatching，再给FallbackEndpoint配个备用引擎。 - 坑五：源语言乱猜。
FromLanguage别图省事写auto，明确写ja或en更稳定，识别错误率低很多。
给老手的进阶问答
Q：游戏里的专有名词总被翻得离谱，能固定吗？A：能。用替换文件（_Substitutions.txt）给指定原文固定译文，比如"スライム=史莱姆"，比任何后处理都直接。
Q：想接自己公司的翻译接口怎么办？A：项目预留了 CustomTranslate 和 ExtProtocol 两种扩展协议，参考src/Translators/目录下的现有实现，照着写一个端点类即可，不用改核心代码。
Q：翻译后文字太长，UI 挤成一团？A：打开EnableUIResizing，再配合ResizeUILineSpacingScale微调行距，插件会做"尽力而为"的排版。
Q：有些对话死活捕获不到？A：按 ALT+U 手动触发文本捕获，把漏掉的组件补上；还不行就开EnableTextPathLogging看日志定位。
Q：想把自己做的汉化分享给朋友？A：把Translation目录打包给朋友，配合手动翻译文件即可分发，社区里很多汉化包就是这么来的。
下一步，轮到你上场了
说真的，装上 XUnity.AutoTranslator 之后，玩生肉游戏的心态会完全不一样——看不懂就等翻译，有歧义就切原文（ALT+T 一键对比）。如果你在配置过程中遇到任何奇怪的问题，或者想让某个游戏适配得更好，欢迎把反馈带到项目社区；会写代码的朋友，新增翻译服务、优化游戏适配，都是很有价值的贡献。语言不该是享受好游戏的障碍，花 30 分钟配置，换一整年的畅玩体验，这笔账怎么算都划算。
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考