XUnity Auto Translator：Unity 游戏翻译插件四步快速上手指南
XUnity Auto Translator：Unity 游戏翻译插件四步快速上手指南
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
XUnity Auto Translator 是一款 Unity 游戏翻译插件，实时把游戏内的文本与图片文字翻译成你指定的语言，免去你手动对照词典的麻烦。
一分钟看懂：这个插件能做什么
它挂在游戏进程中，拦截文字渲染的入口，把原文送去翻译再贴回原位，全程不需要你改游戏文件。核心能力包括：
- 多翻译引擎切换：内置 Google、Bing、DeepL、百度、Yandex、Watson 等服务端点，另有带认证的 GoogleTranslateLegitimate、DeepLTranslateLegitimate 等正式 API 端点，主端点失败可切备用端点
- 本地翻译缓存：已译文本与纹理翻译结果落盘保存，再次出现时直接取用，不再重复发网络请求
- 多文本框架兼容：支持 IMGUI、UGUI、NGUI（老牌 UI 框架）、TextMeshPro 等常见渲染文本的方案，可按游戏逐框架开关
- 纹理翻译：文字被烧进图片时，通过纹理比对找出对应图并替换成译版
- 界面自适应：可选自动缩放，应对译文比原文更长导致的 UI 溢出
快速上手：四步跑通翻译
- 检查运行环境：游戏必须已有插件管理器。BepInEx 是 Unity 游戏最常见的 Mod 加载框架，如果你的游戏目录里有 BepInEx 文件夹，走方案 A；部分游戏（如部分 Illusion 游戏）使用 ReiPatcher，游戏里带 Rei 插件管理器则走方案 B。
- 下载并放置插件：
- 方案 A（BepInEx）：下载 BepInEx 版本，解压到游戏目录的
BepInEx/plugins/下 - 方案 B（ReiPatcher）：下载对应版本，运行其自带的图形化安装程序，由它完成部署
- 方案 A（BepInEx）：下载 BepInEx 版本，解压到游戏目录的
- 启动游戏：首次启动会自动初始化并生成
AutoTranslatorConfig.ini配置文件。 - 验证翻译生效：按
ALT+0唤出插件主窗口，确认状态；若文字没变，按ALT+T切换一次翻译开关，再按ALT+R重载翻译数据。
核心功能详解
多引擎切换它做什么：各翻译服务各自实现为一个端点，插件按配置依次尝试，某个端点连续失败会自动改用备用端点。 什么时候用得上：某免费服务限流或停用时，把备用端点换成另一家即可继续翻译，不用重装插件。各服务的实现代码放在src/Translators/目录，支持扩展协议接入第三方服务。
本地翻译缓存它做什么：每条译文连同原文键写入本地缓存文件，纹理翻译也有独立的纹理缓存。 什么时候用得上：回到旧存档、重进同一段剧情时，文字瞬间显示，不产生额外请求，网络不好时旧内容照常可读。
多框架兼容它做什么：配置里为 IMGUI、UGUI、NGUI、TextMeshPro、TextMesh、FairyGUI 各自提供开关，插件只挂钩游戏实际使用的框架。 什么时候用得上：不同游戏用的 UI 方案不同，按游戏实际情况开关，减少无关挂钩带来的风险。
纹理翻译它做什么：对以图片形式出现的文字，插件按纹理比对查找已登记的翻译纹理并替换显示。 什么时候用得上：封面、立绘、菜单里烧死的文字，普通文本翻译管不到，靠这个功能补上。
配置实践：真正要紧的参数
配置集中在AutoTranslatorConfig.ini，大多数场景调下面几项就够：
| 参数 | 作用 | 建议值 |
|---|---|---|
| ServiceEndpoint | 使用的翻译引擎 | GoogleTranslate |
| FallbackServiceEndpoint | 主引擎失败后的备用引擎 | 留空或填另一引擎 |
| Language | 目标语言 | zh |
| FromLanguage | 游戏原文语言 | ja |
| MaxCharactersPerTranslation | 单条请求的最大字符数，过大会被拆分 | 200 |
| EnableUIResizing | 译文溢出时自动缩放 UI | True |
最小可运行的配置片段：
[Behaviour] ServiceEndpoint=GoogleTranslate Language=zh FromLanguage=ja MaxCharactersPerTranslation=200常见问题速查
翻译不生效先按ALT+T确认翻译处于开启状态，再按ALT+R重载；仍无效时打开游戏日志，查看是哪个端点在报错。
插件加载失败确认管理器版本与插件版本匹配（BepInEx 5/6 或 MelonLoader 各有对应包），检查 dll 是否放在 plugins 目录，然后读游戏日志定位具体错误。
翻译后文字超出按钮把EnableUIResizing设为 True；对个别仍溢出的区域，可调整ResizeUILineSpacingScale或降低字号。
想固定某些文本的译法在UseStaticTranslations指定的翻译文件里写"原文=译文"条目，这些文本会跳过引擎直接使用。
快捷键速查：
| 快捷键 | 功能 |
|---|---|
| ALT+0 | 显示/隐藏插件主窗口 |
| ALT+T | 开/关实时翻译 |
| ALT+R | 重载翻译文件与缓存 |
| ALT+U | 手动挂钩当前未识别的文本组件 |
进阶技巧
- 高频固定台词（如菜单项）写进静态翻译文件，比走引擎更稳更快，也不受服务波动影响。
- 长对话频繁被拆分时，把
MaxCharactersPerTranslation调大一些，减少请求次数；批量请求默认开启，一般无需干预。 - 需要把译文导出或存档时，用
TranslationsPath、TexturesPath把文本与纹理缓存指到自定义目录，方便备份和手动校对。
总结：装对目录、开对开关、调好端点，这套 Unity 游戏翻译插件就能把绝大多数界面和对话文字翻成你的语言。项目源码可从仓库获取：
git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考