XUnity AutoTranslator 实时汉化教程:4 步安装,改 4 个键让 Unity 游戏出中文
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
XUnity AutoTranslator 是一款面向 Unity 游戏的开源免费翻译插件,运行时抓取游戏内的菜单、对话与道具说明,请求在线翻译服务后替换显示。本文带你从环境自查、安装、首次配置,走到进阶手动汉化与故障排查,全程无需编程基础。
安装前先用 2 个条件自查你的 Unity 游戏
两分钟做完这两条判断,能帮你避开"装了也不出中文"的局面。
- 游戏是否 Unity 引擎制作:打开安装目录,看有没有
{游戏名}_Data文件夹,有就是 Unity 游戏。虚幻引擎或自研引擎的作品不在支持范围内,去对应游戏的翻译社区找方案。 - 能否连通免费在线翻译服务:插件会把抓到的文本发给第三方服务换回译文。如果你介意文本外发,或网络连不上所选服务,建议先跳过本项目。
⚠️ IL2CPP(Unity 的另一种脚本编译方式)编译的游戏,文本抓取支持不完整,部分文字要靠手动补抓,能跑但成功率低,装之前心里有数。
4 步完成 XUnity AutoTranslator 独立安装
主推"独立安装"路线:不依赖任何已有 Mod,新手最稳。
- 从仓库 releases 页面下载 ReiPatcher 独立安装包,解压到游戏根目录,让
SetupReiPatcherAndAutoTranslator.exe与游戏主 exe 同级。看到两个 exe 在同一个文件夹,这步就成了。 - 双击运行
SetupReiPatcherAndAutoTranslator.exe,它自动完成补丁注入。看到游戏目录里多出一个名字带 "(Patch and Run)" 的快捷方式,这步就成了。 - 用这个快捷方式启动游戏,首次运行会生成配置文件。看到
AutoTranslatorConfig.ini出现在游戏根目录、且游戏正常进了主界面,这步就成了。 - 进游戏后按
ALT+0呼出插件悬浮窗,随便打开一个菜单观察。看到菜单文字变成中文,这步就成了。
备选路线一句话带过:若游戏已装 BepInEx、MelonLoader、IPA 或 UnityInjector,改下载对应插件包,把 dll 解到加载器目录再启动即可,各加载器的详细步骤见仓库 README 的 Installation 章节。
⚠️ 两条路线二选一。游戏已装 BepInEx 就不要再跑 Setup 独立安装,两者会互相冲突。
首次启用:改 4 个配置键让翻译生效
默认生成的AutoTranslatorConfig.ini用记事本就能改。
[General]段的Language→ 从默认的en改成zh-CN→ 它决定游戏文本最终被翻成什么语言。[General]段的FromLanguage→ 从默认的ja改成游戏原语言,日文游戏保持ja,英文游戏填en→ 它决定翻译服务按哪种源语言处理文本。[Service]段的Endpoint→ 默认GoogleTranslate免配置;连不上 Google 就换BaiduTranslate,并在[Baidu]段补BaiduAppId与BaiduAppSecret→ 它决定每次翻译请求发给哪家服务。[TextFrameworks]段开关→ 默认只开 UGUI、UIElements、NGUI、TextMeshPro;3D 漂浮文字或老式菜单没反应时,把EnableTextMesh、EnableIMGUI改成True→ 它决定抓取哪几类文本组件。
其余键全部保持默认,遇到具体问题再回来逐项调。
用 3 个进阶技巧把手动汉化做干净 🔧
单独改一条机翻。场景:某条道具说明机翻得生硬,只想动这一条。 操作:把该条原文=译文从Translation\{Lang}\Text\_AutoGeneratedTranslations.txt剪出来,放进Translation\{Lang}\Text\目录下的一个新 txt。 效果:手动词条优先级高于自动文件,保存后按ALT+R热重载,不用重启游戏。
统一专有名词。场景:同一个 NPC 的名字被翻得一次一个样。 操作:在Translation\{Lang}\Text\_Substitutions.txt里写一行原名=中文名。 效果:替换发生在翻译之前,该名字全游戏从此统一。
手动补抓与原文对比。场景:怀疑某句只出现一次的对话没被插件抓到。 操作:按ALT+U触发手动抓取,再按ALT+T在原文与译文间切换。 效果:不动任何配置就能确认哪条文本漏网。
这三招解决不了新问题时,往下看排查清单。
排查 5 个高频翻译故障 🔍
只有部分文本被翻译症状:菜单有中文,角色头顶 3D 文字或左下角老式菜单没动。 原因:对应文本框架开关默认关闭。 处理:在[TextFrameworks]段把EnableTextMesh或EnableIMGUI改成True,重启游戏。
译文整片变方块字症状:翻译后的中文显示为一排小方块。 原因:游戏自带字体不含中文字形,缺字符只能画方块。 处理:在[Behaviour]段用OverrideFont(UGUI)或FallbackFontTextMeshPro(TextMeshPro)指向中文字体文件,按ALT+F切换验证。
某功能开启翻译后失效症状:某个按钮或对话逻辑异常,按ALT+T关掉翻译又正常。 原因:游戏拿"显示文本"做内部判断,译文打乱了逻辑。 处理:把[Behaviour]段的TextGetterCompatibilityMode设为True。
翻译进行一段后停摆症状:起初逐条变中文,之后新文本不再翻译。 原因:连续翻译失败触发内置保护,插件自动停机。 处理:修好网络或把Endpoint换成能连通的服务,再按ALT+Q重启插件。
长段文本整条跳过症状:长描述一律不翻译,短句正常。 原因:文本长度超过MaxCharactersPerTranslation(默认 200)。 处理:把该值调大,配置上限 2500;或接受超长文本不翻译。
5 条都没对上时,回仓库 README 的 Frequently Asked Questions 章节按关键词对照,分支更细。
6 条清单自查安装是否到位 ✅
- ReiPatcher 独立包已解压到游戏根目录,
SetupReiPatcherAndAutoTranslator.exe已运行 AutoTranslatorConfig.ini已生成,Language、FromLanguage、Endpoint已按需修改- 按
ALT+0呼出悬浮窗,确认首屏已出现译文 - 有漏译时已检查
[TextFrameworks]开关 - 记住 3 个快捷键:
ALT+R重载、ALT+U手动补抓、ALT+T原文译文切换 - (可选)想看源码或自行编译:
git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
把想改的词一条条攒进手动词条文件,剩下的交给你的游戏时长。
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考