XUnity.AutoTranslator完整上手指南：如何让Unity游戏对话实时翻译成中文
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
深夜，你兴冲冲打开一款口碑爆棚的日系RPG，画面精美、音乐动人——直到屏幕上跳出满屏的片假名。你盯着对话看了半分钟，只认出零星几个汉字，兴致瞬间凉了一半。别急着删游戏。今天要介绍的XUnity.AutoTranslator，就是专门为这个瞬间而生的开源Unity游戏翻译插件：它能在游戏运行的同时，实时翻译界面和对话，让你不用退出游戏，就能读懂每一个字。
第一幕 初体验：它像是住进游戏里的同声传译
你可以把它想象成一位住进游戏里的同声传译：你按一下手柄，它替你"听"懂日语；你打开菜单，它立刻把选项翻译好贴回去。整个过程不需要你手动复制粘贴，也不用切换窗口查词典。
和传统汉化补丁相比，它最大的不同在于"动态"。传统汉化需要作者针对某个游戏版本逐一提取文本、翻译、打包，游戏一更新就可能失效。而XUnity.AutoTranslator是在游戏运行时实时读取文本并翻译，你换任何Unity游戏都能用同一套流程，几乎不用等谁更新。这就像随身带了个万能翻译器，而不是靠别人事先录好的语音包。
那么，它到底是怎么做到的？跟着走一遍，你就明白了。
第二幕 实战上手：十分钟跑通第一次完整翻译
先做个小准备：请确保游戏已经安装好BepInEx（最常用的Unity游戏插件管理器，也是本插件官方推荐的搭档）。如果你用的是MelonLoader、IPA或UnityInjector，流程也大同小异，只是安装包不同。
然后按下面五步走：
- 获取插件：从项目仓库克隆或下载对应版本，例如命令行执行
git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator获取源码，或直接下载BepInEx安装包。 - 解压：把内容解压到游戏根目录，让插件dll落入
BepInEx/plugins/下的对应文件夹。 - 启动游戏：插件第一次运行时会自动生成配置文件，什么都不用手动建。
- 改配置：打开游戏根目录下
BepInEx/config/XUnity.AutoTranslator.ini，这是整个插件的中枢。 - 重启游戏：让配置生效，然后随便进入一个对话场景——奇迹出现了，原文被实时替换成了中文。
配置文件里，最核心的就是翻译引擎的选择。内置了十余种，各有各的性格：
| 翻译引擎 | 是否需要密钥 | 特点 |
|---|---|---|
| GoogleTranslate | 否 | 免费免配置，开箱即用，但偶尔不稳定 |
| DeepLTranslate | 否 | 翻译质量公认出色，适合追求译文品质 |
| BaiduTranslate | 是（AppId/AppSecret） | 中文翻译效果好，国内访问顺畅 |
| BingTranslate | 否 | 微软系，稳定性不错 |
| CustomTranslate | 自定义URL | 可对接你自己搭建的翻译服务 |
新手建议先用Endpoint=GoogleTranslate跑通全流程，同时把Language=zh、FromLanguage=ja（按游戏实际语言调整）配好。所有翻译引擎的实现都在项目源码src/Translators/目录下，想研究原理随时可以翻阅。
第三幕 进阶玩法：让翻译更懂你的四个技巧
跑通基础功能只是开始，下面这几个技巧能让你从"能看懂"进阶到"看得舒服"。
技巧一：按 ALT+T，随时对照原文。自动翻译偶尔会词不达意，按下这个快捷键就能在原译文之间切换，判断是不是引擎翻歪了。再配合ALT+R热重载翻译文件，你手动修改的内容不用重启游戏就能立即生效。
技巧二：亲手改翻译，插件会优先听你的。所有自动翻译结果都会写入Translation/zh/Text/_AutoGeneratedTranslations.txt。你直接编辑这个文件，把某句对话改成自己满意的译法，下次显示时插件会优先采用你的版本——这相当于给游戏建了一本你自己的词典。
技巧三：用正则处理规律文本。游戏里大量重复文本（如"物品 +12"这种格式）适合用一行正则搞定：r:"^アイテム ([0-9]+)$"=物品 $1。它对新手稍微有点门槛，但学会后处理批量文本的效率会大幅提升。
技巧四：开启纹理翻译。有些游戏的图片里也带文字。把配置中的EnableTextureTranslation和EnableTextureDumping设为 True，插件就能把游戏里的图片导出，你在Translation/zh/Texture目录下替换加工后的图片，游戏内就会自动加载新版。这个功能适合追求完整汉化的玩家。
第四幕 避坑指南：过来人踩过的三个坑
坑一：中文全变成了方块或问号。别慌，这不是翻译坏了，而是游戏自带字体不支持中文字符。解决办法是在配置里指定一个支持中文的字体：UGUI界面用OverrideFont，TextMeshPro文本用FallbackFontTextMeshPro。这是汉化中文游戏最常见的坎，配置好字体基本就通了。
坑二：启用翻译后游戏卡死或报错。有些游戏会用"显示文本"参与内部逻辑判断，翻译反而打乱了它的流程。把TextGetterCompatibilityMode=True打开，让游戏以为显示的还是原文，问题通常就解决了。
坑三：部分文本死活不翻译。很多文本框架默认是关闭的（比如EnableIMGUI、EnableTextMesh），如果你的游戏涉及这类界面，手动把它们设为 True 即可。实在不行，按ALT+U手动触发一次文本挂钩，往往能补上漏网之鱼。
写在最后：语言不该是游戏的边界
XUnity.AutoTranslator真正的价值，是把"看不懂"这个障碍从你与好游戏之间彻底搬走。它免费、开源、社区活跃，支持主流的插件框架和十余种翻译引擎，还能按你的口味精调译文。整个过程不需要懂编程，跟着本文走一遍就能上手。
所以，别再让语言劝退你和一款好游戏的缘分了。去项目仓库看看，选一个你常玩的Unity游戏试一次——当第一句日文对话变成你熟悉的中文时，你会发现，世界一下子大了很多。
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
