Unity游戏翻译插件从哪开始？XUnity.AutoTranslator新手上手路线图

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

想象一下：你终于下了一款口碑爆棚的 Unity 游戏，开场动画一过，满屏日文扑面而来，剧情、菜单、道具说明全都看不懂。卸载？舍不得。硬啃？太痛苦。别急着做选择——XUnity.AutoTranslator 这款 Unity 游戏翻译插件，就是为这种时刻准备的。

它的工作方式很容易理解：游戏要把一段文字显示到屏幕上之前，插件先"截住"这段文字，交给翻译服务处理，再把译文原样替换上去。整个过程中游戏本体一个字节都不会被改动，就像给游戏戴上了一副实时翻译眼镜。

最快跑通的办法：两种安装路线任选

好消息是，你不需要懂任何编程知识，两条路都能在几分钟内跑起来。

如果你还没装过任何模组管理器，选 ReiPatcher 独立版：下载 XUnity.AutoTranslator-ReiPatcher 压缩包，解压到游戏根目录，运行 SetupReiPatcherAndAutoTranslator.exe，之后用生成的"（Patch and Run）.lnk"启动游戏即可。如果你已经在用 BepInEx，就选 BepInEx 版本：把压缩包里的文件解压进游戏目录，让 DLL 落在 BepInEx/plugins 下，直接启动游戏。

第一次启动后，游戏目录下会自动出现 AutoTranslator 文件夹，里面躺着整个插件的"总控台"——Config.ini。绝大多数情况下，你只需要改两行：

[General] Language=zh-CN FromLanguage=ja

Language 是译成什么语言，FromLanguage 是游戏原文是什么语言。保存重启，游戏里应该已经能看到中文了。如果界面没反应，按 ALT+0 打开翻译面板确认插件在工作，再按 ALT+T 在原文与译文之间切换找找感觉。

🚀 到这一步，"能翻译"这个目标已经达成。剩下的，都是让它翻译得更好。

把"够用"调成"好用"的几个关键开关

跑起来只是开始。默认配置就像一辆没调校的新车，能开，但未必顺。想提升体验，下面几个开关值得逐个试试。

选对翻译服务。Config.ini 里的 Endpoint 决定用哪家翻译。新手建议先用默认的 GoogleTranslate、BingTranslate 或 DeepLTranslate 这类免费端点；如果发现经常失败，可以在 FallbackEndpoint 填一个备用服务，主端点挂了自动切换。追求稳定的老玩家，可以换成需要 API Key 的版本（比如 DeepLTranslateLegitimate），但记住：密钥是你的私人物品，别到处贴。

按需打开文本框架。游戏里的文字有多种"显示方式"，插件默认只开了常见的几种。如果发现某些文本死活不翻译，去 [TextFrameworks] 小节把对应的开关改成 True——比如用 IMGUI 做的模组菜单，就需要 EnableIMGUI=True。反过来，用不上的框架就别开，每多开一个都是性能开销。

善用两层缓存。💡 插件会把翻译结果先记在内存里，再落盘到 Translation 文件夹，相当于随身带了两本"便签本"：同一句话只翻译一次，重启游戏后也还记得。你甚至可以直接打开 Translation/zh-CN/Text/_AutoGeneratedTranslations.txt，把某句自动翻译改成自己满意的版本，保存后按 ALT+R 立即生效，不需要重启。

更进一步，翻译文件还支持正则表达式，能批量处理有规律的文本，比如把"道具 I、道具 II"这类编号物品统一替换。这些玩法不用急着学，先把手动修正用熟。

三个真实场景，照着做就行

光讲开关有点抽象，我们拿三个最常见的情况走一遍。

情况一：剧情翻译了，菜单还是原文。多半是菜单用了你没开启的文本框架。先到 [TextFrameworks] 看看哪些还是 False，逐个打开重进游戏试。还不行？按 ALT+U 手动触发一次文本捕获，它会主动去抓屏幕上漏掉的文字。

情况二：译文出来了，全是方块字。这不是翻译坏了，是游戏自带的字体里没有中文字形。在 [Behaviour] 里给 OverrideFont 指定一个中文字体文件，TextMeshPro 类文本则优先用 FallbackFontTextMeshPro 补充缺字。换个字体，乱码基本就消失了。

情况三：人名地名被翻得啼笑皆非。自动翻译没有上下文，专有名词翻错很正常。打开自动生成的翻译文件，找到那一行改成正确译名，存盘、ALT+R 刷新。手动内容的优先级最高，你的修改会稳稳压过自动结果。

新手最常问的问题，和最容易踩的坑

问：免费翻译服务会不会突然失效？有可能。不要求认证的在线端点，哪天服务方改了接口就不可用了，这是同类工具的共性。兜底办法是配好 FallbackEndpoint，或升级到带 API Key 的服务。

问：玩着玩着翻译停了，为什么？插件内置了防滥用保护：连续多次拿不到结果、请求积压过多，它会自动关闭自己，避免把游戏拖垮。先检查网络和端点是否正常，解决问题后按 ALT+Q 重启插件即可。

问：装这个会影响存档吗？不会。它只替换运行时显示的文字，存档数据原封不动。

新手最容易踩的坑，其实就三个：一上来把全部文本框架打开，游戏立刻变卡；把 MaxCharactersPerTranslation 调得很大，单次请求又慢又容易被拒绝（保持在 200 左右更稳妥）；把 API 密钥随手发出去。记住一句话：按需开启、够用就好。

下一步：从会用走向会玩

回头看看，XUnity.AutoTranslator 真正厉害的不是"自动翻译"这四个字，而是把翻译的主动权交到了你手里：它可以全自动，也可以半自动，还可以完全由你说了算——自动翻译打底、手动文件精修、正则批量兜底，三层配合，翻译质量就能一点点逼近"母语版"。

接下来怎么走？我的建议是：先用默认配置玩一局，感受它的存在感；然后靠 ALT+U、ALT+R 这两个快捷键，把漏翻和错翻修一遍；等你有余力了，再去研究资源重定向、自定义端点这些进阶功能，那又是另一个新世界。

翻译这件事，没有一次到位的魔法，但有越用越顺的路径。从第一句看得懂的对话开始，好好享受游戏吧。

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