XUnity AutoTranslator 安装与配置指南：把日文 Unity 游戏自动翻译成中文

XUnity AutoTranslator 安装与配置指南：把日文 Unity 游戏自动翻译成中文

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

打开一款日文视觉小说，菜单、对话、物品说明全是日文，只能靠猜着玩。XUnity AutoTranslator 是一款面向 Unity 游戏引擎的翻译插件，它会在游戏运行时实时钩住文本渲染，调用在线翻译服务把画面自动翻译成中文，同时提供完整的手动翻译工具，让你能逐条修正翻译结果。

🧩 这个插件是什么，不是什么

XUnity AutoTranslator 是一个 mod 插件，不是独立的翻译软件。它要放进游戏目录、由模组加载器注入游戏进程才生效；自动翻译依赖联网，文本会发送到在线翻译服务。如果你介意把游戏文本交给第三方，可以只用它的手动翻译与缓存功能。

先用下面这张表判断它是否适合你：

📋 安装前先确认这几件事

把下面 6 项过一遍，能避免装完再返工：

• ✅ 游戏是 Unity 引擎制作——插件只钩 Unity 的文本渲染管线
• ✅ 确定模组加载器——BepInEx（官方推荐）、MelonLoader、IPA、UnityInjector，或都不装则用 ReiPatcher 独立包
• ✅ 有可用网络——自动翻译要把文本发到在线服务，游戏文本会出机器
• ✅ 知道游戏源语言——配置里要显式填写 FromLanguage，不建议用 auto
• ✅ 游戏目录可写——安装会向游戏目录写入多个 dll 和 Translation 目录
• ✅ IL2CPP 游戏先知道限制——IMGUI 翻译、TextGetter 兼容模式均不支持

📦 安装流程：从下载到出中文

以 BepInEx 为例，按顺序做 5 件事：

1. 下载与你加载器对应的安装包，命名形如 XUnity.AutoTranslator-BepInEx-{版本}.zip
2. 直接解压到游戏目录，dll 会落到 BepInEx/plugins/XUnity.AutoTranslator/，翻译服务放在其 Translators 子目录
3. 启动一次游戏，插件自动生成配置文件 BepInEx/config/AutoTranslatorConfig.ini
4. 按下面 4 项做最小修改：

[Service] Endpoint=GoogleTranslate ; 翻译引擎，置空即关闭自动翻译 [General] Language=zh-CN ; 目标语言：简体中文 FromLanguage=ja ; 源语言：日语，明确指定 [Behaviour] EnableUIResizing=True ; 自动调整文本框，防止中文溢出

5. 验证：进游戏按 ALT+0 打开插件面板确认引擎，再按 ALT+T 在原文与译文间切换，画面能在日文和中文之间来回切就说明生效了

常用热键（均带 ALT 前缀）：0 打开面板，1 打开多引擎翻译窗口，R 重新加载翻译文件，U 手动抓取文本（部分文本没被钩住时用），Q 重启已停机的插件。

🎚️ 按需求调参

默认配置直接能玩，出现具体需求时只改对应项：

• 译文质量不够高 → 把 Endpoint 换成 DeepLTranslate，或改用需 API Key 的 DeepLTranslateLegitimate
• 担心免费引擎失效 → 给 FallbackEndpoint 填一个备用引擎，失败时自动切换
• 中文显示为方框 → 用 OverrideFont 或 FallbackFontTextMeshPro 指定一个中文字体
• 个别术语翻错 → 在 Translation{Lang}\Text_Substitutions.txt 里加"原文=译文"替换规则
• 想修正某条译文 → 直接编辑同目录的 _AutoGeneratedTranslations.txt，按 ALT+R 立即生效
• 其他 mod 的界面没被翻译 → 在 [TextFrameworks] 段把 EnableIMGUI 设为 True
• 想进一步减少请求量 → 保持 UseStaticTranslations=True 与 EnableBatching=True，内置约 2000 条词表会跳过常见短语

🔧 排障手册

以下 5 个高频问题，按"现象 / 可能原因 / 处理办法"三条记录：

游戏启用翻译后卡死或崩溃

• 现象：翻译生效后，进入特定场景时游戏卡住或闪退
• 可能原因：游戏用"屏幕上显示的文字"决定逻辑，译文改变了它的判断
• 处理办法：[Behaviour] 段设置 TextGetterCompatibilityMode=True

部分文本没被翻译

• 现象：主对话是中文，菜单、浮动文字仍是原文
• 可能原因：对应文本框架默认关闭（IMGUI、TextMesh 默认都是 False）
• 处理办法：打开配置文件，在 [TextFrameworks] 段启用对应项

插件运行一段时间后停止工作

• 现象：翻译突然停更，新文本不再被处理
• 可能原因：触发自我保护（连续 5 次无结果、积压 4000 条请求等），插件自动停机
• 处理办法：修复网络后按 ALT+Q 重启插件

不再想要自动翻译，但保留已有译文

• 现象：不想再发网络请求，希望继续用已缓存的翻译
• 可能原因：配置里启用着自动翻译引擎
• 处理办法：在 ALT+0 面板选择空引擎，或把 Endpoint= 置空

译文断行奇怪、质量一般

• 现象：一句话被拆成几段，译文不通顺
• 可能原因：文本里的换行符被原样送进了翻译服务
• 处理办法：保持 IgnoreWhitespaceInDialogue=True，必要时把 MinDialogueChars 从 20 调小

⚖️ 常用翻译引擎怎么选

官方内置十几种翻译服务，挑 5 个最常用的对比：

一句话结论：

• GoogleTranslate：零配置，默认选择
• DeepLTranslate：质量最高，通道不稳
• BingTranslate：适合当备用
• BaiduTranslate：认证后额度更大
• DeepLTranslateLegitimate：付费订阅更稳

👣 下一步

1. 按加载器选对应安装包，解压到游戏目录
2. 启动一次游戏，生成配置文件
3. 填好 Endpoint、Language、FromLanguage 三项
4. 进游戏按 ALT+0 确认引擎状态
5. 玩一段时间后打开 _AutoGeneratedTranslations.txt，手动修正不满意的译文

需要克隆源码自行编译的话，仓库地址：git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator

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