Unity游戏啃生肉太痛苦?XUnity.AutoTranslator快速上手教程,5步搞定自动翻译
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
XUnity.AutoTranslator是一款开源的Unity游戏自动翻译插件,它能在游戏运行的同时实时抓取并翻译屏幕上的文本,把没有官方中文的Unity游戏变成"看得懂"的游戏。无论你是被外语界面劝退的普通玩家,还是想给游戏做汉化补丁的爱好者,这篇教程都会用一条清晰的路径,带你从零开始把它跑起来。
这些场景,是不是每一句都在说你?
先对号入座一下,看看你有没有经历过下面这些时刻:
- 在某个独立游戏展看到一款美术惊艳的日式RPG,兴冲冲下载完,打开全是假名和汉字,连选项都看不懂
- 想玩韩国的MMO或视觉小说,汉化组迟迟不出补丁,讨论版里天天有人问"汉化进度到哪了"
- 游戏更新太频繁,汉化补丁跟不上版本,每次更新都要重新等
- 试着用手机对着屏幕拍照翻译,翻完一段剧情要花好几分钟,游戏体验碎成渣
传统的解决办法无非三条路:等官方出多语言、等汉化组接手、或者自己边查词典边玩。前两条路靠别人,第三条路靠毅力,体验都不太好。
而XUnity.AutoTranslator走的是另一条路:它直接在游戏运行时接管文本显示。游戏界面里冒出来的对话、菜单、物品描述,它会自动读取、送去翻译、再塞回屏幕,整个过程不需要你手动操作,也不需要修改游戏本体文件。
什么人适合用XUnity.AutoTranslator,什么人可以先绕道
这个项目适用的人群比想象中更广,我帮你分成了四类:
| 使用人群 | 典型需求 | 推荐用法 |
|---|---|---|
| 普通玩家 | 想立刻看懂外语游戏 | 用预编译插件包 + 免费翻译端点 |
| Mod玩家 | 玩的游戏是IL2CPP编译 | 配合BepInEx 6或MelonLoader使用 |
| 汉化爱好者 | 想给游戏制作汉化补丁 | 手动翻译文件 + 资源重定向 |
| 开发者 | 想接入特定翻译服务 | 自己写翻译端点,参考现有实现 |
那谁不适合呢?有两种情况要提前说明:第一,这个插件必须联网才能获得自动翻译,需要完全离线运行的人请绕道;第二,如果你对"完全免费、永久稳定"有执念,也要放平心态——免费的在线翻译端点(比如GoogleTranslate)随时可能因为对方调整接口而失效,这类问题不是插件本身能控制的。
快速上手:5步完成安装与基础配置
第1步:确认环境
你只需要满足三个条件:一台Windows电脑、一个基于Unity 5.0以上版本开发的游戏、以及一个游戏进程管理器。管理器四选一即可:BepInEx(最推荐)、MelonLoader、IPA、UnityInjector。如果游戏没装任何管理器,也可以用项目自带的独立安装模式,两条路我们都讲。
第2步:获取插件本体
两种方式任选其一:
git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator或者直接从项目发布页下载对应版本的预编译压缩包(推荐普通用户选这个,省去编译步骤)。下载时注意按你的管理器选包:BepInEx、MelonMod、IPA、ReiPatcher等都有独立打包。
第3步:按游戏类型选择安装路线
路线A:BepInEx(最常见,Mono游戏首选)
先把BepInEx按官方说明装进游戏根目录,然后把插件压缩包解压到游戏目录,让里面的dll自动落到BepInEx/plugins/等对应位置,最后启动游戏一次。插件会在首次运行时自动生成配置文件。
路线B:独立安装(游戏没装任何管理器)
把XUnity.AutoTranslator-ReiPatcher-*.zip解压到游戏根目录,运行SetupReiPatcherAndAutoTranslator.exe完成初始化,之后通过生成的快捷方式启动游戏即可。这种"两下点完"的方式能覆盖绝大多数Unity游戏,但注意:如果游戏已经装了上面提到的管理器,就别再用这个方式,两者会打架。
路线C:IL2CPP游戏(BepInEx 6 / MelonLoader)
IL2CPP编译的游戏要用对应的专属插件包,比如BepInEx-IL2CPP版本配合BepInEx 6的be版本使用。这里要提醒一句:项目对IL2CPP的支持目前还不算完整,部分文本挂钩可能漏掉,翻译效果不如Mono游戏理想。
第4步:修改配置文件
游戏启动一次后,找到生成的配置文件(BepInEx路径下通常是BepInEx/config/XUnity.AutoTranslator.cfg),把核心几项改成你想要的语言和翻译端点:
[Service] Endpoint=GoogleTranslate FallbackEndpoint= [General] Language=zh-CN FromLanguage=ja [TextFrameworks] EnableUGUI=True EnableTextMeshPro=True EnableNGUI=True EnableIMGUI=False EnableTextMesh=False [Behaviour] MinDialogueChars=20 EnableUIResizing=True MaxCharactersPerTranslation=200简单解释一下这几个字段的含义:
Endpoint:翻译服务的名称,免费党通常从GoogleTranslate、BingTranslate、DeepLTranslate、PapagoTranslate里选Language/FromLanguage:分别表示"翻译成什么语言"和"游戏原文是什么语言",日文游戏配ja,中文输出配zh-CN,拿不准原文语言时可以试autoTextFrameworks:决定哪些类型的游戏文本要被挂钩,UGUI、TextMeshPro、NGUI默认开启;IMGUI和TextMesh默认关闭,是因为它们容易引发额外开销和误报
第5步:启动验证
保存配置,启动游戏。进入游戏后看到界面文本开始变成中文,就说明成功了。记住这几个快捷键,排查问题时非常有用:
- ALT + 0:打开/关闭插件设置面板
- ALT + T:在原文本和译文之间来回切换(验证翻译是否生效最快的方式)
- ALT + R:立即重新加载翻译文件(改完翻译文件不用重启游戏)
- ALT + U:手动触发一次文本挂钩,自动挂钩漏掉的文本可以靠它补救
新手最容易踩的3个配置坑(以及避坑方法)
坑1:翻译出来了,但全是方块和乱码
中文和日文字符很多游戏默认字体根本不包含,屏幕上一片"□□□"是最常见的新手事故。解决办法是给插件指定一个能显示目标文字的字体:
[Behaviour] FallbackFontTextMeshPro=Fonts & Materials/LiberationSans SDFUGUI界面则用OverrideFont指定字体文件。如果你在翻译成中文时遇到了缺字问题,优先怀疑这里。
坑2:开了插件后游戏卡死、闪退或逻辑错乱
部分游戏会用"当前显示的文本"来决定游戏逻辑(比如根据界面文字内容做判断),译文一上去逻辑就崩了。这时候在配置里打开:
[Behaviour] TextGetterCompatibilityMode=True这个模式会"骗"游戏,让它以为屏幕上显示的还是原文,游戏逻辑就不会被译文干扰。怎么判断是不是这个问题?很简单:按ALT+T切回原文如果一切正常,切到译文就出问题,那多半就是它。
坑3:明明装了插件,某些文本就是不翻译
大多数时候是文本框架没开对:比如Mod菜单用的是IMGUI(默认关闭),3D世界里的漂浮文字用的是TextMesh(默认关闭)。对应开启EnableIMGUI=True或EnableTextMesh=True即可。另外,视觉小说类游戏如果文本是"逐字滚动"出现的,可能需要打开GeneratePartialTranslations=True,否则插件会误以为文本还没稳定下来,一直不发翻译请求。
进阶玩法:手动翻译、字体修复与资源替换
把自动翻译升级成"半人工"翻译
插件的自动翻译会按语言对保存到Translation\{Lang}\Text目录里,自动生成的译文写进_AutoGeneratedTranslations.txt。这个文件的优先级是最低的——你完全可以把它里面的条目剪出来,放进自己的文本文件里改成人工精修版,游戏会优先用你的版本。
固定术语处理也有专门入口:_Substitutions.txt可以写替换规则,把游戏里的专有名词(人名、地名、技能名)固定成你想要的译法,避免每次都被翻译得五花八门。
给中文文本配置一套好用的字体
中文显示效果不佳时,除了前面说的FallbackFont,还可以在插件设置面板(ALT+0)里微调UI缩放和行间距。EnableUIResizing=True默认开启,它会在译文比原文长的时候自动调整文本框的溢出方式,防止文字被截断。如果某些UI还是显示不全,可以试试ResizeUILineSpacingScale微调行距。
进阶:图片与资源替换
如果游戏里的文字有一部分是"画"在图片上的,纯文本翻译覆盖不到。这时可以开启纹理翻译:先打开EnableTextureDumping=True把游戏图片导出,用图像工具在图片上加上译文后放回对应目录,再开启EnableTextureTranslation=True让插件在游戏里替换图片。这套流程配合资源重定向(EnableTextAssetRedirector),基本就是做完整汉化补丁的完整工作流了。
如果你有代码基础,还可以参考src/Translators/目录下的实现自己写翻译端点,或者接第三方的LLM翻译服务,自由度很高。
写在最后:现在就开始你的第一局翻译
整篇教程的核心其实就一句话:下载插件包 → 按游戏类型选安装路线 → 改三行配置 → 启动游戏。整个流程熟练之后十分钟内就能完成,剩下的就是享受游戏本身。
动手前最后提醒三点:第一,翻译端点优先选免费且够用的,等熟悉了再考虑付费服务;第二,翻译结果会缓存在本地,翻译过的内容不会重复请求,放心用;第三,真遇到搞不定的问题,别慌——先看日志(BepInEx的日志在BepInEx/LogOutput.log),再按ALT+T和ALT+U做基础排查,多数问题都能靠这两招定位到原因,剩下的也可以在项目讨论区找到同类案例。
选一款你一直想玩但被语言劝退的游戏,照着教程走一遍。当你看到熟悉的界面第一次以中文呈现时,那种感觉值得你花上这十分钟。
【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考