Unity游戏翻译插件快速上手指南：XUnity Auto Translator安装配置与排错
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
想玩日服视觉小说或外服手游，进去才发现满屏日文，设置里又没有中文选项——这种劝退感是不是很熟悉？XUnity Auto Translator 是一个注入到 Unity 游戏里、自动翻译游戏内文本的插件，可以切换多种翻译服务，也能手工修正某一句的译法。下面从安装到日常使用，把这套流程一次讲清楚。
🎮 安装路线选型：4 种方案对号入座
不同游戏环境差别很大，先对照这张表找到自己的情况：
| 安装方案 | 适合谁 | 关键步骤 | 注意事项 |
|---|---|---|---|
| ReiPatcher 独立包 | 游戏没装任何插件管理器 | 解压到游戏根目录，运行 SetupReiPatcherAndAutoTranslator.exe，之后点它生成的 (Patch and Run) 快捷方式启动 | 已装 BepInEx 或 MelonLoader 的游戏别用此方案，两者会冲突 |
| BepInEx | 已装 BepInEx 的游戏（最常见） | 先装好 BepInEx 5，再把 -BepInEx 包解压到游戏根目录，启动游戏 | 插件文件要落在 BepInEx/plugins/XUnity.AutoTranslator/ 目录 |
| MelonLoader / IPA | 游戏跑在这两个管理器上 | 分别解压到 Mods+UserLibs 或 Plugins 目录 | 具体以对应管理器的安装说明为准 |
| -IL2CPP 专用包 | IL2CPP 编译的游戏 | 与 Mono 版步骤相同，但必须换 -IL2CPP 包 | 文本钩子能力有限，漏译时按 ALT+U 手动刷一下 |
装完不用动任何文件：插件首次启动游戏时会生成配置文件（一般叫 AutoTranslatorConfig.ini，BepInEx 下位于 BepInEx/config/ 里），用记事本打开就能改。
⚙️ 装完先配哪 4 个参数
| 参数（所在段） | 默认值 | 推荐值 | 改完后的效果 |
|---|---|---|---|
| Endpoint（[Service]） | GoogleTranslate | 按下方服务建议换 | 决定用哪家翻译服务 |
| Language / FromLanguage（[General]） | en / ja | zh-CN / ja | 目标语言与游戏原文语言，务必和实际语言对上 |
| MaxCharactersPerTranslation（[Behaviour]） | 200 | 200–500 | 单次请求翻译的字符上限，调大可让长台词整段翻（上限 2500） |
| EnableIMGUI（[TextFrameworks]） | False | True | 很多 Mod 菜单用的就是 IMGUI，打开后 Mod 界面也能被翻译 |
一份能跑通的最小配置长这样：
[Service] Endpoint=BingTranslate [General] Language=zh-CN FromLanguage=ja🗣️ 翻译服务怎么选，以及缓存如何省流量
先说缓存机制（即把已翻过的结果存下来，下次直接读取，不再请求网络）：所有翻译结果既存内存也写入磁盘（游戏目录下的 Translation 文件夹），同一句话第二次出现就命中缓存；请求一次只发一个，且文字在屏幕上稳定 1 秒后才发出，连续 5 次空结果会主动停机——这套策略既防刷接口，也保护你花钱的额度。
服务分三档：
- 免密钥：GoogleTranslate、BingTranslate、DeepLTranslate、PapagoTranslate。零成本，但走的是非官方接口，官方改版随时可能失效，适合轻度使用。
- 要密钥：GoogleTranslateLegitimate（Google 云新用户有 300 美元额度，约够 1500 万字符）、DeepLTranslateLegitimate（每月 50 万字符免费）、BingTranslateLegitimate（每月 200 万字符免费）。长期使用建议选这类，密钥别外传。
- 本地方案：LEC Power Translator、ezTrans XP，以及第三方 LLM 端点（可接本地 Ollama 模型），完全离线。
另外可把 FallbackEndpoint 指到另一家服务做备胎，主服务失效时自动切换；不想动配置文件的话，按 ALT+0 在游戏内 UI 里直接选端点也行，把端点清空就等于关闭自动翻译。
⌨️ 高频按键速查
| 按键 | 作用 |
|---|---|
| ALT+0 | 呼出/隐藏翻译设置 UI（是数字零，不是字母 O） |
| ALT+T | 全部文本在"已翻译/原文"之间切换，方便对照 |
| ALT+R | 重载翻译文件，手改的句子不重开游戏就生效 |
| ALT+U | 手动钩取文本组件，默认钩子漏抓时用它补 |
| ALT+F | 切换自定义字体（配置了 OverrideFont 时可用） |
| ALT+Q | 服务连续报错停机后，确认网络恢复再按它重启 |
🔧 故障排查：先对号这 3 种情况
现象：部分文字没被翻译可能原因：对应文本框架默认是关的（IMGUI 和 TextMesh 都默认 False），或默认钩子没覆盖到该组件。 处理：把配置里对应的 EnableIMGUI 或 EnableTextMesh 改成 True；仍不行就按 ALT+U 手动钩一次。
现象：翻译后游戏逻辑不对劲（比如某选项只在显示原文时有效） 可能原因：游戏内部用"屏幕上显示的文字"做分支判断。 处理：设 TextGetterCompatibilityMode=True，让游戏以为看到的还是原文。
现象：插件中途罢工可能原因：连续 5 次请求失败后服务自动停机，防止无意义请求。 处理：先确认网络连通；免费端点不稳定的话换密钥服务；确认恢复后按 ALT+Q 重启翻译服务。
🚀 再深入一点
- 贴图翻译：游戏 logo、立绘里的文字本质是图片。打开 EnableTextureTranslation 后，插件会用你放在贴图目录里的同名文件替换游戏内图片。
- 手动翻译：自动结果都写进 Translation{Lang}\Text\ 下的文本文件，直接改某一句，下次启动即生效，优先级高于自动翻译。
- 自行扩展：源码树里 src/Translators/ 目录就是各家端点的实现，照着写一个新翻译服务，丢进游戏的 Translators 目录即可加载。
📦 获取源码与开始
想读源码或自己构建，拉取仓库即可：
git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator装好、改完 Language 和 Endpoint 两行，基本就能玩起来了。祝游戏愉快。
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
