XUnity AutoTranslator 完整上手指南：10分钟让Unity游戏显示中文
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
如果你玩过几十款日系或欧美Unity游戏，大概都经历过同一个场景：看着满屏片假名和英文菜单，靠猜完成了剧情选择。XUnity AutoTranslator 就是为解决这个痛点而生的开源游戏翻译工具，它能在游戏运行时自动识别界面文本、对话、道具说明并实时替换成中文，全程不修改游戏原始文件。这篇文章以一个普通玩家的视角，把我从"完全不懂插件"到"顺利玩上中文版游戏"的完整过程原样记录下来，所有步骤都亲测可用。
装之前，先搞清楚它到底做了什么
很多人第一次接触这类工具会担心：会不会把游戏搞坏？会不会被当成外挂封号？实际用下来，它的工作原理比想象中温柔——它像一个"文字搬运工"，在游戏读取文本的那一刻截住内容，送去翻译服务，再把结果原样填回画面。游戏文件本身一个字节都不动，卸载插件后游戏恢复原样。
它支持 BepInEx、MelonLoader、IPA、UnityInjector 四类主流插件框架，以及 UGUI、NGUI、TextMeshPro、TextMesh、FairyGUI、Utage 等常见Unity文本框架。也就是说，无论游戏用的是新式UI还是老式文本组件，它基本都接得住。项目源码里也可以看到对应的框架代码，例如文本框架配置集中在 src/XUnity.AutoTranslator.Plugin.Core/Configuration/，翻译端点都放在 src/Translators/ 目录下。
第一步到底怎么做？跟着我装一遍
我的实际操作流程比想象中简单，全程大概十分钟：
- 确认游戏是基于Unity引擎开发的（大多数独立游戏和日式作品都是）。
- 从仓库克隆或下载对应插件框架的安装包。仓库地址是
https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator，注意要选BepInEx版本，因为BepInEx是目前兼容性最好、资料最多的框架。 - 把压缩包解压到游戏根目录，让插件文件夹和游戏主程序平级。装完后目录大概长这样：
{游戏目录}/BepInEx/plugins/XUnity.AutoTranslator/ XUnity.AutoTranslator.Plugin.Core.dll XUnity.AutoTranslator.Plugin.BepInEx.dll Translators/GoogleTranslate.dll {游戏目录}/BepInEx/Translation/- 直接启动游戏。第一次运行会自动生成配置文件
AutoTranslatorConfig.ini（在BepInEx的配置目录下），同时游戏左上角会出现一个工具窗口。
如果你发现启动后没反应，先别急着卸载，按顺序查三件事：游戏是不是真的Unity引擎、插件压缩包有没有解压进正确目录、杀毒软件有没有拦截。我第一回装的时候就是被安全软件把插件dll隔离了，放行后立刻正常。
这样配置，翻译延迟肉眼可见地下降
装好只是开始，真正影响体验的是配置。第一次启动后默认走Google免费接口，翻译质量尚可但偶尔不稳定。配置文件打开后重点改这几个位置：
[Service] Endpoint=BaiduTranslate ;主翻译引擎 FallbackEndpoint=GoogleTranslate ;主引擎挂了自动切换的备用引擎 [General] Language=zh-CN ;翻译成什么语言 FromLanguage=ja ;游戏原始语言新手最容易踩的坑是FromLanguage不填。我曾经把它留空用"auto"自动检测，结果游戏里数字和英文混排的文本被翻得乱七八糟，手动指定日语后立刻正常。另外，翻译引擎的选择直接决定体验：玩日系游戏用百度接口，中日互译又快又准；玩欧美游戏用DeepL，长句文学性明显更好；要求稳定性就选带API Key的付费接口，不容易抽风。
免费接口有个特性必须知道：它把每条文本送去翻译时，会先观察约1秒确认文本不再变化才发请求，而且同一时间只发一个请求，所有结果都会缓存在本地。这意味着翻过的句子第二次出现是零延迟的。想减少等待，可以把配置里的批量翻译开关打开，让多条文本合并成一次请求，实测对话密集的游戏体验提升很明显。
翻得不满意？两个小时也够学会手动微调
自动翻译再强也难免出错，尤其是专有名词和人名。好消息是，所有自动生成的结果都会写进一个文本文件，路径是Translation/zh-CN/Text/_AutoGeneratedTranslations.txt。我处理《星露谷物语》时就用了这个笨办法：玩两天，把翻错的词挑出来，手动改成"作物""温室"这类术语，保存后按ALT+R热键立刻重载，游戏里马上生效。
更省事的方式是建一个_Substitutions.txt替换文件，把常见误译提前写进去，格式就是一行原文一行译文：
Quest=任务 Dungeon=副本配置里还藏着几个提升体验的开关：EnableUIResizing控制翻译后自动调整文本框大小，防止中文太长溢出边框；OverrideFont和FallbackFontTextMeshPro负责字体替换，翻译成中文后如果游戏自带字体缺字，填一个中文字体路径就能解决，这是汉化中文最关键的开关。
常见问题自查：卡住的时候逐条对
我在贴吧和Discord看到新手问得最多的问题，基本就这几类，全部亲自验证过：
为什么只翻了一半文本？有些文本框架默认是关闭的，比如IMGUI（很多Mod的界面用它）。去配置文件的[TextFrameworks]区段把EnableIMGUI=True打开即可。如果还不行，按ALT+U手动挂钩试试。
游戏变卡了怎么办？大多是翻译请求太密集。把配置里的请求频率限制调低，或者干脆换一个响应更快的翻译接口，通常就能解决。
游戏功能突然不正常了？个别游戏会用显示的文本内容来判断逻辑，翻译后反而出错。把TextGetterCompatibilityMode设为True就能骗过游戏。判断方法很简单：按ALT+T在原文和译文间切换，如果切回原文就正常，那就是这个开关的事。
免费接口报错怎么办？免费翻译服务说挂就挂，这是插件作者在文档里反复强调的。此时有两个选择：在配置里加一个FallbackEndpoint备用引擎自动兜底，或者干脆换用带API Key的付费接口。按ALT+0可以打开界面手动切换端点，按ALT+Q可以在出错停机后重启插件。
从入门到精通：值得进阶的三件事
如果你已经能用它顺利玩游戏，下面这三个方向能让你彻底玩转：
给其他Mod做汉化。很多Mod的界面默认不会被翻译，除了开IMGUI开关，还可以用TranslationRegistry这个公开API把翻译文件内嵌进自己的Mod，实现"插件专属翻译"。这段代码在核心源码的 TranslationRegistry.cs 里，想给Mod作者贡献翻译的话很值得研究。
汉化游戏内的图片文字。插件不仅能翻文本，还能把游戏里的图片素材替换成汉化版。在配置里打开EnableTextureDumping，游戏运行时会自动把可翻译的图片导出到Translation/zh-CN/Texture/目录，你用PS改好中文后放回原位即可，游戏会按文件名自动匹配替换。
给特定游戏打包完整汉化。玩到深处你会发现，真正好用的汉化是"别人把术语表都配好"的那种。把翻译文件和替换规则整理好放进游戏目录，就能作为完整汉化包分享给同好。这也是这个项目最活跃的生态方向——社区里有大量游戏专属配置可以直接拿来用。
说到底，这个工具值不值得装，取决于你是不是真的想玩那款外语游戏。我个人的体会是：与其等官方汉化、等汉化组填坑，不如花十分钟装好工具，剩下的交给配置和缓存。第一次在游戏里看到完整的中文对话时，那种"原来我也可以直接玩"的感觉，就是它最大的价值。
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考