简介XUnity.AutoTranslator 是一款面向 Unity 游戏汉化与本地化的高级翻译插件适合游戏翻译团队、Mod 开发者及需要快速对齐多语言内容的 Unity 使用者。它既能通过网络服务实现自动翻译也提供手动翻译工具便于人工校对与精翻3.0.0 起支持自定义转换器4.0.0 起内置资源重定向器可对游戏资源进行灵活重定向插件可独立安装也能作为 BepInEx、IPA、UnityInjector 的模块运行。资源包约 2.24MB压缩包体积轻量便于直接放置到 Unity 游戏目录使用。已有 6102 人学习下载说明该插件在实际项目中具有较高的参考和应用价值上手后可显著降低逐句修改文本的工作量并为后续扩展翻译管线提供清晰的框架。 玩 Unity 引擎游戏最让人急的往往不是操作而是文本。费半天劲找到一个冷门但口碑不错的作品进去之后满屏日文或英文等汉化组不知道要排到哪年。我试过不少偏方之后最后留下的是 XUnity.AutoTranslator 这套运行时自动翻译器。它能在不修改游戏本体文件的前提下把屏幕上的文本实时截获、翻译、再替换回去。换句话说你不需要等别人做汉化也不需要自己拆包改资源只要游戏是用常见 Unity UI 组件渲染的文本它基本都能接住。这篇文章我想把我实际折腾这套工具的过程写清楚它到底在你电脑里做了什么、怎么把它接进游戏、配置项该怎么调、以及我踩过的几个版本失效和翻译质量翻车的坑。适合两类人看一类是只想快速把外语游戏玩明白的普通玩家另一类是以后想做本地化或者维护自己词库的 Mod 爱好者。1. 不想等汉化补丁先弄清楚运行时翻译插件能帮你什么1.1 运行时翻译与传统汉化补丁的本质区别传统汉化补丁的思路是改文件把游戏里的文本文件提取出来、翻译好、再打包回去有时候还要重新封包、修改资源索引。这套流程在几十年前有效但在 Unity 游戏上越来越不好用了。游戏更新一次补丁几乎必然失效有些游戏窗体加密、资源哈希校验甚至反篡改机制汉化补丁一打进去游戏直接罢工。XUnity.AutoTranslator 的思路完全不同它不碰文件而是挂进程。游戏运行时文字已经被渲染到 UI 组件里它在那一步把原始字符串截下来送去翻译再把你看到的文本换成译文。整个过程中游戏自己的资源和数据文件都没被改动。这个特性有很强的实际意义游戏更新后只要组件和拦截规则没大变插件往往还能继续工作就算失效了需要调整的也只是插件配置而不是重新做一遍汉化。1.2 它的能力边界哪些文本能翻哪些不能翻先把丑话说在前面它不是万能的。我总结下来的适用边界非常明确。能翻的包括游戏剧情对话框、选项、任务文本这类由 Text、TextMeshPro、NGUI 组件渲染的文字。菜单界面、设置面板、物品描述等运行时加载进去的字符串。由变量拼接的文本比如金币 加数字只要规则配置得当也可以处理。不能翻或很难翻的包括静态图片里的字幕UI 美工直接做成贴图的文字插件看不到文字本身。Shader 特效渲染的文字或异形字体拦截不到传统文本组件。字库缺字翻译完成了但游戏字体不含中文字形会显示成方块这是字体问题不是翻译问题。所以拿到一个游戏先别急着上插件。如果你在设置菜单里能看到文本选择、能感觉到 UI 文字是系统字体渲染的那就值得试如果所有文字都是 CG 图里嵌的那这个方案帮不了你还是老实等汉化或自己 OCR 吧。2. XUnity.AutoTranslator 的工作链路拦截、递归翻译、缓存回填2.1 三层架构注入层、截获层、翻译层我第一次用的时候也好奇这插件怎么能凭空就能翻译屏幕上的字。拆开看它的工作链路并不神秘大概分三层。注入层插件需要先跑进 Unity 游戏进程。常见做法是通过 BepInEx 这个 Mod 加载器启动还有侧载模式可以直接挂在游戏目录下不一定非要完整加载器。插件依靠 Harmony 这类运行时补丁库对引擎渲染 UI 文本的关键方法做拦截。截获层游戏每次准备把一段文本绘制到 UI 组件上时插件先截住这个调用拿到字符串本身还有它所属的上下文。它匹配的是组件类型和文本特征不是简单的全文替换。翻译层截到的原始文本被送到翻译端点端点返回译文之后插件把译文回填给那个 UI 组件让游戏用它原本的排版逻辑把中文画出来最后再写进缓存。整个过程对玩家来说是无感的充其量会感觉文本出现时比原来慢一点点。2.2 递归翻译与上下文匹配规则光是一次性替换还远远不够。游戏里大量文本是带变量的拼接串比如 You obtained {0}!这个获得物品的模板和后面的物品名是分开处理的。这也解释了为什么很多自动翻译工具翻出来的句子结构怪它可能只翻模板变量没换或者把变量名也当文本翻了一遍。XUnity.AutoTranslator 的解决方案是递归翻译加上下文排除规则。插件能识别出哪些部分是固定句式、哪些部分是运行时的变量内容在翻译时对句式部分做全文翻译变量部分则做单独查表处理。你可以在配置里维护排除规则把不需要翻译的变量名、ID、装饰性符号全部列出避免它们被翻译成乱七八糟的东西。这个细节对质量影响极大很多人说自动翻译狗屁不通一半原因就是端点选得差另一半就是没配好上下文规则。2.3 缓存机制和手工翻译文件的优先级插件另外一个很实际的机制是缓存。同一句话第一次翻译完结果会存到本地。第二次再出现同一句话它直接读缓存不再请求翻译端点。对文字量很大的 RPG 来说这能省下大量请求也避免同一句话被反复翻译导致语义漂移。更重要的是这个缓存文件可以被你直接编辑。我实测下来的处理优先级大致是手工翻译文件最优先其次是缓存里已有的结果最后才是新发起的在线翻译。这个特性意味着你有机会对机器翻译的结果做人工订正在文件里把某句话改成你想要的标准翻译游戏里就永远按你的版本来。这才是这个工具真正有价值的地方——它不是一架纯翻译机器而是一套允许你持续积累术语的本地化工作台。3. 安装与首跑BepInEx 环境、文件部署和关键日志3.1 先搭好 BepInEx 基础环境大多数情况下我建议先装好 BepInEx再放插件。原因很简单BepInEx 承担了统一的环境管理、日志输出和依赖加载排查问题方便得多。安装本身没什么技术含量去官方更新源下载对应你游戏架构的 BepInEx 压缩包通常 64 位游戏选 x64 版本解压后把整个目录覆盖进游戏根目录。第一次启动游戏请保持耐心BepInEx 会在游戏目录下生成自己的目录结构包括 plugins、config、LogOutput.log 这些关键路径。看到这些目录出现说明基础环境已经能挂进进程了。如果游戏有反作弊或自身带了特殊的保护机制这一步就可能失败表现为 BepInEx 目录根本没生成或者游戏直接报错。这种游戏在安装前最好先确认社区有没有现成兼容方案别硬来。3.2 部署 XUnity.AutoTranslator 文件把 XUnity.AutoTranslator 发布包解压后你看到的通常是一个 Plugins 目录和若干依赖 DLL。操作很简单把整个 Plugins 目录里对应你游戏的插件文件放进 BepInEx 的 plugins 目录依赖 DLL 也一并放进去。这里有个细节容易忽略版本匹配。Unity 游戏的 Mono 版本、IL2CPP 版本会直接影响插件能否加载发布包一般会区分构建目标下载前务必看清你的游戏是 Mono 还是 IL2CPP 架构。装对了一次成功装错了要在日志里绕半天。首次启动游戏插件会在配置目录里生成一份设置文件一般是 Settings.ini也可能根据版本放在 AutoTranslator 子目录里。别急着改先启动一次让游戏正常跑到主界面确认日志里没有大红报错再退出改配置。3.3 用日志确认插件真的在工作我在群里帮别人排查过太多没反应问题最后九成都是倒在了日志这一步。启动游戏后打开 BepInEx 下的 LogOutput.log搜索插件名。如果看到插件初始化成功、拦截器注册完成的字样说明已经挂上了如果那一行是报错或者压根没搜到先回头查依赖 DLL 是否齐全、版本是否匹配。确认加载后最直接的验证方式是在设置界面或角色文本框里找一句比较固定的原文切到桌面改一下缓存文件再回游戏触发同一句话。这句话如果发生了变化说明完整的拦截-翻译-回填链路已经跑通。这个测试方法比盯着屏幕碰运气要靠谱得多。4. Settings.ini 里的关键旋钮翻译端点选型和词库体系4.1 翻译端点选型先用现成的或自己控制翻译端点可以理解成插件背后真正干活的那个翻译引擎。插件本身负责截文本但译文质量完全取决于你选哪个端点。官方端点列表里覆盖了常见的在线翻译服务有免费额度型、有需要密钥型、还有通过自定义 HTTP 地址接入自建服务的方式。选型的核心不是你见过哪个品牌而是看你的约束条件。如果只是想快速玩通一款游戏选一个免费额度够用、注册门槛低的在线端点即可发请求的频率别太猛。如果要做长期维护或对专有名词的准确性有要求我更推荐自己控制翻译链路搭一个自定义翻译端点把请求带过去服务端自己决定调用哪个模型、读哪本术语表、怎么处理长句。这样最灵活也最安全——原始文本不会落到你不可控的位置合规和数据隐私这块你自己说了算。无论选哪种方式都要遵守服务条款和配额限制这是基本常识。4.2 核心配置项快速对照下面这份对照表是配置时我常参考的不同的版本参数名会有细微差异但核心思路一致配置节关键参数作用与我的建议GeneralLanguage 与 FallbackLanguage目标语言和回退语言。回退语言要选一个置信度高的避免译文为空Behaviour递归翻译开关、排除规则列表控制拼接文本是否拆开处理排除变量、ID 等不参与翻译的内容Translator端点类型、密钥、请求间隔、超时决定翻译质量和请求节奏请求间隔设慢一点能显著降低被限流概率InjectionHook 方式一般保持默认或按社区兼容方案选改动前先看日志Cache缓存目录、是否启用建议开启且定期备份它就是你慢慢积累的词库这些参数不需要一开始就全改默认值跑起来之后再针对问题做减法比一上来就重写配置要稳妥。4.3 词库与手工翻译文件我最推荐的一步也是很多人忽略的手工翻译文件。游戏刚开始跑时完全是机器翻译结果地名、人名、梗都会很别扭。玩一段之后你会在缓存文件里看到这些句子。挑那些高频出现的角色名、物品名、技能名在手工翻译文件里写死你的翻译。之后游戏里再出现会优先用你写死的版本不会再被机翻乱改。文件本身通常就是按行组织的键值格式原始文本对应译文文本。整理词库时有个技巧把原文里带变量符号的模板句留到最后处理先解决硬地名和人名因为他们出现的频率最高、对阅读体验影响最大。自己维护上百条核心术语后这台自动翻译器实际已经变成了一个半自动本地化工具效果远超任何纯机翻。5. 翻译效果优化与高频坑的排查实战5.1 现象驱动的排查路径我在不同游戏上跑过这个插件也踩了不少坑下面这些现象和排查顺序基本可以拿来就用现象可能原因先查什么完全没有翻译插件没加载、Hook 方式不兼容日志里搜插件名确认初始化行只有部分文本被翻译文本类型不被支持、拼接格式复杂确认那些文本是 Text 组件还是贴图看排除规则是否误伤一段小作文被砍断或漏翻端点对长文本有限制、请求频率太高被限流查看端点日志把文本分段/调低频率翻译结果显示方块游戏字库没有中文字形这是字体问题换 TMP 字体资产或打字体补丁缓存文件写了但游戏没变化缓存路径不对、文件编码错误确认文件编码为 UTF-8重启游戏这些排查逻辑的核心是先判断问题出在没拦截还是没翻译。没拦截去查注入和文本类型没翻译去查端点和限额。别一上来就重装插件。5.2 游戏版本更新和反作弊环境的额外风险游戏更新后插件失效是正常现象不是插件坏了。Unity 游戏更新时经常会把 UI 的文本组件类型、方法签名甚至整个渲染管线升级一遍拦截点自然就失效了。处理方式有两种一是看插件有没有同步更新新版发布通常会兼容新版引擎二是修改配置里的拦截范围尝试用更宽松的规则重新匹配。过程有点看运气但至少你不需要重新做一遍完整汉化。另外要提醒一下带有反作弊保护的游戏尤其是多人联机作品运行时注入很容易触发拦截或封禁风险。这类游戏建议直接放弃运行时翻译方案除非你有明确证据证明它和反作弊系统兼容。单机游戏通常没有这个问题这也是它最舒服的适用场景。5.3 我维护翻译文件的一套习惯我用这个插件玩过几个文字量巨大的日式 RPG慢慢形成了自己的维护套路。第一次进入游戏前先配好一个稳妥的在线端点把请求间隔调慢一点避免刚开玩就被限流。头几十个小时主要是跑量让插件把所有高频文本都缓存一遍。等发现某些专有名词的翻译实在受不了就停下来在手工翻译文件里把它们全部锁定集中修一遍词表。之后再玩游戏时这些术语就再也不会变了。我会每隔一段时间把翻译缓存和手工词库压缩备份一次。这个文件集就是你花时间积累出来的本地化财富换电脑、丢游戏都不可怕备份在你在词库就在。还有一个小技巧如果你觉得某个角色说的话翻译质量整体很差不妨把它的台词在游戏里先后触发两次确认每次结果都一致再决定是否手工修改避免误改一句只是临时抽风的条目。XUnity.AutoTranslator 的价值往往不在第一次跑通的那几分钟而在你持续维护词库之后。它不是用来替代认真汉化的完美工具但对付那些想玩却没人做汉化的 Unity 游戏它是我手上最可靠的一套方案。如果你的目标游戏刚好也是 Unity 引擎、文字量又大我建议你今天花十分钟把整套流程走一遍哪怕最后只是导出了一份完整的文本清单对你理解这个游戏的本地化结构也已经值回票价了。本文还有配套的精品资源点击获取