XUnity自动翻译器使用指南让Unity游戏里的外语实时变成中文【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity自动翻译器XUnity.AutoTranslator是一款嵌入Unity游戏运行时、自动抓取并翻译游戏文本的开源插件支持UGUI、TextMeshPro、IMGUI等主流文字组件可对接Google、DeepL、百度等十余种翻译服务。这篇文章会带你用一个下午跑通整套流程并讲清楚它为什么值得信任。从啃生肉到被朋友安利半年前我下了一款评分很高的日式独立游戏像素美术很对味音乐也上头。但开场五分钟我就懵了——满屏日文选项看不懂剧情全靠猜。我试过截屏翻译玩半小时要切十几次窗口试过OCR划词长句翻得七零八落。三天后我把它从硬盘删了心里憋屈好游戏就是语言这道坎过不去。后来在群里看到朋友直播同一款游戏画面里的对话居然全是中文而且是一边玩一边变没有一丝卡顿。我以为是官方汉化结果他甩过来一句就是个翻译插件叫XUnity。这就是我和它的第一次见面。往后半年我陆续用它啃完了七八款生肉游戏也踩了不少坑。这篇就当作一份过来人笔记。十分钟验收从拿到文件到看到中文先别急着研究原理我们走一条最快的路。整个过程不到十分钟跑通之后你再决定要不要深入。第一步拿到项目文件。git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator这句话把整个项目的源码克隆到本地。如果你只想要现成的插件包去项目的发布页下载对应平台的压缩包即可二选一别都下。第二步装好BepInEx。XUnity翻译器本身是寄居在游戏里的需要一个宿主框架。新手无脑选BepInEx先下载BepInEx并按它自己的说明装进游戏目录这是游戏mod社区最常见的加载器兼容性最稳。第三步把插件放对位置。解压插件包后把文件按这个结构放进游戏根目录游戏根目录/ ├── BepInEx/ │ ├── plugins/ │ │ └── XUnity.AutoTranslator/ │ │ ├── XUnity.AutoTranslator.Plugin.Core.dll │ │ ├── XUnity.AutoTranslator.Plugin.BepInEx.dll │ │ └── Translators/ │ │ └── GoogleTranslate.dll │ └── config/ └── Translation/插件核心文件放在BepInEx/plugins/XUnity.AutoTranslator/下Translators/子目录放翻译服务Translation/目录第一次启动后会自动生成用来存翻译缓存。文件放错位置是后面所有没反应类问题的头号来源。第四步改三行配置。启动一次游戏BepInEx/config/下会生成AutoTranslatorConfig.ini。打开它改这三个值[Service] EndpointGoogleTranslate ; 用哪个翻译服务默认谷歌零配置 [General] FromLanguageja ; 游戏原文是日语 Languagezh-CN ; 翻译成简体中文Endpoint决定谁来翻译FromLanguage和Language是源语言和目标语言。日文游戏默认就是ja如果你的游戏是英文把ja改成en就行。第五步进游戏验收。启动游戏按ALT0是数字零不是字母O呼出翻译器界面随便触发几句对话等一两秒中文就该出现了。再按ALTT能在原文和译文之间来回切换——这个快捷键以后会经常用它是你判断这行字到底翻没翻的利器。看到中文那一刻验收就算通过。接下来我们聊聊它凭什么能做到这件事。它到底在幕后做了什么你可以把XUnity想象成三个角色在游戏里协同工作。第一个角色是潜伏在文字控件里的探子。Unity游戏里的对话、菜单、道具名本质上都是一个个文字组件。插件在启动时给这些组件装了窃听器术语叫hook任何文字被设置进组件它都能第一时间拿到原始内容。这就是为什么它不需要截图、不需要OCR——它直接读内存里的文本比任何外挂式翻译都干净。第二个角色是随身笔记本。每一句翻译成功的文本都会被写进Translation\zh-CN\Text\_AutoGeneratedTranslations.txt这个文件。下次再遇到同一句话直接查本子不再发网络请求。你甚至可以手动编辑这个文件把机翻改成你满意的措辞改完按ALTR热重载不用重启游戏。第三个角色是看门管家。它有一整套防刷机制这点很多同类工具没有。每看到新文本它会先等一秒确认这句话不再变化才发请求全程串行请求绝不并发单次会话最多发8000个请求。更绝的是如果它发现游戏里的文字在滚动出现、或者每帧都在排队翻译它会直接把插件关掉防止你的网络账号被翻译服务拉黑。这套逻辑写在src/XUnity.AutoTranslator.Plugin.Core/SpamChecker.cs里感兴趣可以翻一翻写得相当克制。一句话总结探子负责看笔记本负责记管家负责别闯祸。明白了这个后面所有配置项都能对号入座。决策地图你的游戏该走哪条路不是所有Unity游戏都适用同一套方案。先看框架你的情况推荐框架说明大多数普通Unity游戏BepInEx最主流教程最多新手首选游戏只支持MelonLoaderMelonLoader部分游戏社区指定用这个传统老游戏、无mod加载器ReiPatcher独立安装解压后跑一次安装器双击Patch and Run快捷方式启动IL2CPP打包的游戏BepInEx 6IL2CPP版需要对应版本插件包功能有阉割见后文再看翻译服务。内置端点有十几个不用都认识记住这三类场景推荐端点要不要密钥注意事项图省事、快速验证GoogleTranslate不需要免费但偶尔抽风属正常现象中日互译、中文质量优先BaiduTranslate需要AppId和密钥每月有免费额度适合中译场景剧情游戏、质量优先DeepLTranslate免费版不需要质量公认最好但请求速度较慢其余的像Bing、Papago、Yandex、彩云小译都是备选配置方式在src/Translators/目录下各有一个独立小项目想换就换。一个实用技巧在配置里给FallbackEndpoint填一个备用服务主力端点失效时自动顶上。三个真实翻车现场再顺的流程也会翻车。下面三个是我和身边朋友真实踩过的坑按频率排的。翻车一装上后一个字都没翻译。现象游戏正常启动插件也加载了但对话全是原文。根因十有八九是IMGUI没开。很多游戏的mod界面、旧式菜单用的是IMGUI文字框架而它默认是关闭的——插件开发者怕它误伤性能。另一个常见原因是插件文件没放进plugins/XUnity.AutoTranslator/这个正确目录。修复动作先在配置里把[TextFrameworks]下的EnableIMGUITrue保存后按ALTU手动挂接一次文本。如果还是没反应回去检查目录结构对照上面的树状图逐层核对。翻车二中文显示成口口口方块。现象翻译生效了但游戏里全是空心方框。根因游戏自带的字体文件里没有中文字形中文根本画不出来。这不是翻译的锅是显示层的锅。修复动作给游戏指定一个支持中文的字体。UGUI界面用OverrideFont指定字体文件路径TextMeshPro界面优先用FallbackFontTextMeshPro它只在缺字时才调用备用字体比整体替换更稳。社区里有人专门整理了适配不同Unity版本的字体包搜XUnity 字体就能找到解压后填路径即可。翻车三开了翻译后游戏逻辑错乱、甚至闪退。现象某些选项点击没反应或者走到特定剧情直接崩。根因少数游戏会把屏幕上显示的文字当成逻辑判断依据——比如剧情分支靠比对文本框内容来触发。翻译把显示文本改了游戏的大脑就找不到它认识的字符串了。修复动作在配置里打开TextGetterCompatibilityModeTrue。这个模式会骗游戏显示的是译文但游戏内部读取时看到的还是原文。注意它只对Mono环境有效IL2CPP游戏暂不支持遇到就只能等社区方案了。进阶彩蛋文档角落里藏着的好东西跑通基础后下面这几个功能是很多人用了半年都不知道的。正则拆分翻译。有些游戏喜欢把编号物品名拼成一行再显示比如01 シンプルリング你没法逐条存翻译。在翻译文件里写一行拆分正则sr:^([0-9]{2}) ([\S\s])$$1 $2这行正则把文本拆成编号和物品名两段分别翻译再拼回去。于是你只需要存一条シンプルリングSimple Ring所有编号变体全部命中。这就是所谓一处翻译处处生效。替换表与作用域。_Substitutions.txt可以在翻译前先把人名、专有名词替换成固定译法避免机翻把角色名翻得乱七八糟翻译文件里还能写#set level 1,2,3之类的指令让某些翻译只在指定场景生效避免不同场景的同文本互相打架。图片也能翻译。很多汉化组靠这个功能做完整汉化包打开[Texture]下的EnableTextureDumpingTrue游戏会把所有界面图片导出到Translation\zh-CN\Texture你用PS改好中文版放回去开启EnableTextureTranslation就能替换游戏内图片。注意这两个开关只在做图时开别随包分发。自己写翻译服务。如果你是个程序员src/Translators/Common.ExtProtocol/提供了扩展协议的标准实现写个独立进程对接任何在线翻译API比在游戏内调试舒服得多。连OpenAI这类LLM翻译都有社区做好的端点可以直接用。该轮到你动手了说回开头那款被我删掉的日式游戏——后来我用这套流程重新下回来一个晚上就通了主线。没有魔法就是装好、配好、跑通仅此而已。你现在硬盘里有没有一款因为语言被我这样的生肉劝退者搁置的游戏如果有按上面的路径走一遍十分钟后你就能看到中文。第一次看到译文在游戏里浮现的时候记得按一下ALTT来回切几次——那个瞬间你会明白语言这道坎原来真的可以绕过去。剩下的事就简单了玩然后按你的习惯把翻译越调越顺。最好的汉化从来不是别人替你做完的而是你亲手改出来的。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
