1. 项目概述为什么我们需要自动翻译器如果你是一个喜欢玩独立游戏或者小众Unity游戏的玩家肯定遇到过这样的烦恼一款游戏玩法精妙、美术独特但偏偏没有中文。看着满屏的英文、日文或者其他语言游玩体验大打折扣。手动汉化那意味着要反编译游戏、定位文本资源、翻译、再打包过程繁琐且需要极高的技术门槛对绝大多数玩家来说无异于天方夜谭。这正是“XUnity.AutoTranslator”后文简称XAT这类工具存在的意义。它本质上是一个运行时的“文本拦截与替换”插件。简单来说它像是一个安插在游戏进程里的“同声传译”当游戏引擎Unity要显示某一段文本时XAT会先“听到”这段原文然后立刻调用在线的翻译API如谷歌翻译、百度翻译、DeepL等将其转换成目标语言比如中文再“告诉”游戏引擎显示翻译后的结果。整个过程对游戏本身几乎零修改实现了“即开即用”的实时汉化效果。这个项目标题“轻松实现Unity游戏汉化”中的“轻松”二字正是其核心价值所在。它极大地降低了非官方汉化的技术门槛让普通玩家通过简单的几步配置就能享受到母语游戏的乐趣。无论是视觉小说、RPG、模拟经营还是其他类型的Unity游戏只要其文本是通过Unity标准的UI系统如uGUI、TextMeshPro渲染的XAT都有很高的成功率进行拦截和翻译。2. 核心原理与架构拆解XUnity.AutoTranslator如何工作要理解如何使用XAT首先得明白它背后的工作原理。这能帮助你在遇到问题时知道该从哪个环节入手排查。2.1 运行时Hook与文本拦截Unity游戏在运行时所有需要显示的文本最终都会通过特定的方法调用传递给渲染引擎。XAT的核心技术是使用一种叫做“Harmony”的库通常与BepInEx框架配合对Unity引擎内部处理文本的方法进行“钩子Hook”操作。想象一下游戏引擎里有一条传送带文本渲染管线文字就像包裹一样在上面传送。XAT的工作就是在传送带的某个关键节点安装一个智能分拣机器人Hook。当带有“Hello World”标签的包裹经过时机器人会将其截停扫描标签然后根据你的指令迅速从仓库翻译服务里找到一个写着“你好世界”的新标签贴上去再把包裹放回传送带。游戏本身只知道收到了一个要显示的包裹并不知道内容已经被替换了。具体到技术层面XAT主要Hook的是Text、TextMeshProUGUI等组件的text属性setter方法。当游戏代码尝试设置UI文本时XAT的代码会先一步被执行拿到原始字符串进行后续的翻译流程。2.2 翻译流程与缓存机制一次完整的翻译并非每次显示都触发那样效率太低且可能触发翻译API的频次限制。XAT采用了一套智能的流程文本捕获Hook到游戏设置的文本内容。哈希比对为原始文本生成一个唯一的哈希值如MD5作为该文本的“身份证”。缓存查询在本地查找是否存在这个“身份证”对应的翻译记录。这个缓存通常是一个名为Translation.txt的文本文件。命中缓存如果找到直接使用缓存中的翻译文本瞬间返回给游戏显示。这是最快、最理想的路径。未命中缓存如果没找到则进入在线翻译流程。在线翻译将原始文本发送到你配置的翻译服务如Google Translate。结果接收与缓存收到翻译结果后一方面立即返回给游戏显示另一方面将“原文-译文”对连同其哈希值追加写入本地的Translation.txt缓存文件。后续显示之后游戏再次显示同一段文本时就会直接走“缓存查询-命中”的快速路径。这个机制带来了两个巨大好处一是首次游玩时虽然需要联网并等待翻译接口返回但之后再次遇到相同文本如NPC的重复对话、菜单项将是瞬时的二是生成了Translation.txt这个文件它实际上就是你这个游戏的汉化补丁。你可以分享这个文件给其他玩家他们只需要放入指定目录即使离线也能享受完整的汉化效果。2.3 插件生态与依赖关系XAT通常不是独立运行的。在Windows平台最常见的部署方式是作为“BepInEx”插件。BepInEx是一个Unity游戏的模组加载框架它提供了游戏启动时的注入能力和插件管理功能。XAT作为BepInEx的一个插件由BepInEx在游戏启动时自动加载从而完成对Unity引擎的Hook。所以一个典型的汉化环境栈是这样的底层目标Unity游戏框架层BepInEx提供插件运行环境插件层XUnity.AutoTranslator实现翻译逻辑辅助层可能需要的其他插件如用于修复字体显示问题的“XUnity.ResourceRedirector”理解这个层次关系很重要。当你发现汉化不生效时你需要逐层排查BepInEx安装对了吗XAT插件放对位置了吗游戏版本和BepInEx/XAT版本兼容吗3. 实战部署一步步安装与配置汉化环境理论讲完我们进入实战环节。这里以最常见的Windows平台、通过BepInEx部署为例展示从零开始汉化一个Unity游戏的全过程。3.1 环境准备与工具下载在开始前你需要准备好以下东西目标游戏确保你拥有一个你想汉化的Unity游戏。建议先备份整个游戏文件夹以防操作失误。BepInEx前往BepInEx的GitHub发布页下载对应你游戏架构的版本。大多数Unity游戏是x86_6464位因此下载BepInEx_x64_*.zip版本。XUnity.AutoTranslator前往其GitHub发布页下载最新版本的BepInEx兼容插件包通常是一个名为XUnity.AutoTranslator-BepInEx-*.zip的文件。文本编辑器推荐使用VS Code、Notepad或Sublime Text用于后续修改配置文件。系统自带的记事本可能因编码问题导致配置出错。注意下载任何工具时请务必从GitHub等官方发布页面或可信的模组网站获取避免下载到被恶意篡改的软件。3.2 安装BepInEx框架安装BepInEx是整个流程的基石步骤必须准确解压你下载的BepInEx_x64_*.zip文件。将解压后得到的所有文件和文件夹通常包括BepInEx文件夹、winhttp.dll、doorstop_config.ini等复制到你的游戏根目录。游戏根目录是指包含游戏主执行文件.exe的文件夹。例如对于游戏MyGame.exe就复制到这个MyGame.exe所在的文件夹里。首次运行游戏。双击游戏主程序启动。此时BepInEx会进行初始化可能会有一个黑框控制台闪现游戏启动时间可能比平时稍长。游戏运行一次后正常关闭。此时回到游戏根目录你会发现新生成了一个名为BepInEx的文件夹其内部结构已经完善包含plugins、config等子文件夹。这表明BepInEx安装成功。3.3 安装XUnity.AutoTranslator插件BepInEx框架就绪后就可以安装翻译插件了解压你下载的XUnity.AutoTranslator-BepInEx-*.zip文件。将解压得到的plugins文件夹内的所有内容通常是XUnity.AutoTranslator文件夹复制到游戏根目录下的BepInEx\plugins\文件夹内。最终路径应该类似于你的游戏\BepInEx\plugins\XUnity.AutoTranslator\XUnity.AutoTranslator.dll再次启动游戏。如果安装正确游戏运行时会在屏幕左上角默认位置看到XAT的绿色状态文字显示“AutoTranslator”和版本号。这表明插件已成功加载。3.4 核心配置文件详解插件安装后汉化行为全靠配置文件驱动。配置文件位于BepInEx\config\AutoTranslatorConfig.ini。用文本编辑器打开它你会看到很多选项。以下是几个最关键的配置项[General] ; 是否启用插件 Enabledtrue ; 目标语言代码简体中文是zh-CN繁体中文是zh-TW Languagezh-CN ; 翻译缓存文件路径 TranslationFilePath.\Translation\zh-CN.txt [Service] ; 选择翻译服务0GoogleTranslate, 1BaiduTranslate, 2DeepL等 Service0 ; 如果选择百度翻译需要填写下面的AppId和SecretKey ;BaiduTranslateAppId ;BaiduTranslateSecretKey [Behaviour] ; 是否在游戏启动时自动翻译所有文本可能卡顿 AutoTranslateOnStartupfalse ; 是否在文本首次出现时自动翻译 AutoTranslateLiveTexttrue ; 是否跳过已翻译文本的重复翻译 SkipAlreadyTranslatedTexttrue配置要点解析Language必须正确设置。zh-CN和zh-TW是不同的设置错误可能导致翻译服务返回非预期的语言结果。Service0代表谷歌翻译。这是最通用、最方便的选择无需注册账号但需要你的网络能够访问谷歌服务。如果无法使用可以考虑百度翻译需注册百度云开发者账号获取免费额度或配置本地离线翻译引擎如用Service9并配置LibreTranslate。AutoTranslateOnStartup建议设为false。如果设为true游戏启动时会尝试翻译所有已加载的界面文本可能导致游戏卡住几十秒甚至更久体验很差。AutoTranslateLiveText建议设为true。这样当游戏动态生成或加载新文本时XAT会自动尝试翻译。一个常见的“踩坑点”是编码问题。如果游戏内翻译结果显示为乱码如“”很可能是因为编码不匹配。可以尝试在[General]部分添加或修改; 尝试UTF-8编码 Encodingutf-8 ; 或者尝试系统的默认编码 ;Encoding4. 高级技巧与疑难杂症排查基础配置能让大部分游戏跑起来但要想获得完美的汉化体验或者解决一些棘手问题就需要一些进阶知识和排查技巧了。4.1 字体缺失与显示异常处理Unity游戏尤其是使用TextMeshProTMP的游戏对中文字体的支持可能不完整。即使文本被成功翻译成中文游戏也可能因为找不到对应的字体而显示为方框“□□□”或直接不显示。解决方案字体重定向或补丁安装字体重定向插件下载并安装XUnity.ResourceRedirector插件。它的安装方式和XAT类似放入BepInEx\plugins目录即可。这个插件可以拦截游戏加载字体资源的请求并将其替换为你指定的、包含中文字符的字体文件。准备中文字体找一个你喜欢的、版权允许的中文字体文件.ttf或.otf例如“思源黑体”、“方正准圆”等。将其复制到游戏目录下例如放在BepInEx文件夹内。配置字体重定向在BepInEx\config目录下找到或创建XUnity.ResourceRedirector.cfg配置文件。添加如下配置路径需根据实际情况修改[Font Redirect] enabledtrue sourcearial.ttf ; 游戏原字体名可通过日志查看 target.\BepInEx\SourceHanSansCN-Regular.otf ; 你准备的中文字体路径如何知道source字体名你需要开启XAT或ResourceRedirector的调试日志在游戏尝试加载字体时查看日志输出。实操心得对于TMP游戏有时需要替换的是TMP字体资产.asset文件而不是系统字体。这需要更复杂的方法比如使用专门的TMP字体生成工具创建包含中文的TMP字体资产再通过资源重定向进行替换。这个过程比较繁琐建议普通玩家在社区寻找现成的字体补丁。4.2 翻译缓存的管理与分享Translation.txt文件是你的宝贵财富。合理管理它能提升体验离线游玩一旦一个游戏的Translation.txt文件内容充实你就可以完全离线游玩汉化版。只需确保配置中Service指向一个不可用的服务或设为NoneXAT就会完全依赖缓存文件工作。分享与获取很多游戏社区会有玩家分享自己积累的Translation.txt文件。你可以下载他人分享的缓存文件重命名为配置中指定的名字如zh-CN.txt放入Translation文件夹即可瞬间获得大量已翻译文本节省大量在线翻译的时间和配额。编辑与修正你可以直接用文本编辑器打开Translation.txt。它的格式通常是原文|译文。如果你发现某句机器翻译生硬或有误可以手动修改对应的译文行保存后重启游戏即可生效。这是实现“精翻”的基础。4.3 常见问题排查指南当汉化不生效时不要慌张按照以下步骤排查问题现象可能原因排查步骤与解决方案游戏左上角没有绿色状态文字1. BepInEx未正确安装2. XAT插件未正确放置3. 游戏版本与插件不兼容1. 检查游戏根目录是否有winhttp.dll和doorstop_config.ini运行游戏后是否生成BepInEx文件夹。2. 检查BepInEx\plugins\下是否有XUnity.AutoTranslator文件夹及dll文件。3. 查看BepInEx启动时控制台可配置开启的报错信息或检查BepInEx\LogOutput.log日志文件。有状态文字但游戏内文本无变化1. 目标语言未设置2. 翻译服务不可用3. 文本未被Hook到1. 检查AutoTranslatorConfig.ini中Language是否正确。2. 检查网络如果使用谷歌翻译且无法访问可尝试切换为百度翻译。3. 游戏可能使用了非标准UI组件或动态生成文本的方式XAT默认Hook可能不覆盖。尝试在配置中启用实验性选项如[Behaviour]下的EnableUGUI、EnableTextMeshPro等。翻译结果为乱码或“???”1. 编码问题2. 字体缺失1. 在配置文件中[General]部分添加Encodingutf-8。2. 检查游戏内字体是否支持中文参考4.1节安装字体补丁。游戏启动崩溃或闪退1. BepInEx/插件版本与游戏不兼容2. 配置文件语法错误1. 尝试更换BepInEx或XAT的版本如尝试更旧或更新的版本。2. 检查AutoTranslatorConfig.ini文件确保没有多余的空格或错误的节Section名称。最简单的排查方法是暂时重命名此配置文件让插件生成一份新的默认配置。翻译速度慢游戏卡顿1. 首次翻译量大2. 在线翻译API延迟高或限流1. 首次游玩正常耐心等待缓存建立。可将AutoTranslateOnStartup设为false。2. 考虑更换翻译服务或使用他人分享的成熟缓存文件。在[Service]中可调整RequestInterval请求间隔来降低频率。一个关键的调试手段是查看日志。在AutoTranslatorConfig.ini中将[General]下的EnableDebugLogging设为true然后启动游戏。之后在BepInEx\LogOutput.log文件中你会看到XAT详细的运行日志包括它Hook到了哪些文本、发送了什么翻译请求、收到了什么结果。这对于排查“文本未被翻译”这类问题至关重要。5. 超越基础定制化与优化策略当你熟练使用基本功能后可以尝试一些定制化操作来提升汉化质量。5.1 正则表达式与文本过滤游戏里并非所有文本都需要翻译比如版本号、代码标识符、玩家输入的名字等。XAT支持通过正则表达式来过滤掉不需要翻译的文本。在AutoTranslatorConfig.ini的[Regex]节可以进行配置[Regex] ; 匹配纯数字不翻译 Exclude^\d$ ; 匹配单个字母不翻译 Exclude^[a-zA-Z]$ ; 匹配常见的文件路径格式不翻译 Exclude.*[\\\/].*\..*合理设置排除规则可以减少无效的翻译请求让翻译结果更干净也节省了翻译API的调用次数。5.2 分句与上下文翻译优化机器翻译在处理长段落时可能会因为断句不当而失去上下文导致翻译生硬。XAT内置了分句功能可以将长文本按标点符号拆分成短句再分别翻译效果有时更好。相关配置在[Behaviour]节[Behaviour] ; 启用分句翻译 SplitIntoSentencestrue ; 分句时使用的标点符号 SentenceEndings.!?。你可以根据游戏文本的特点英文多用.日文多用。来调整SentenceEndings。5.3 处理特殊游戏与引擎特性一些游戏使用了特殊的UI框架或文本渲染方式可能需要额外配置UGUI vs TextMeshPro现代Unity游戏大量使用TextMeshProTMP来渲染高质量文本。XAT默认支持TMP但确保[Behaviour]下的EnableTextMeshProtrue。如果TMP文本未翻译可以尝试开启EnableTextMeshProFallback选项。动态文本与脚本注入有些游戏的文本是通过脚本动态拼接的如“你获得了 5 个金币”。XAT可能只能捕获到“你获得了”、“个金币”这样的片段。对于这种情况除了期待游戏更新或插件增强支持外手动在Translation.txt中添加完整的句子翻译也是一种补救措施。纹理中的文字XAT只能处理代码设置的文本对于直接做在图片纹理里的文字如图标上的字、手写字体标语是无能为力的。这类“图片文字”的汉化属于美术资源修改需要更复杂的反编译和PS工作超出了运行时翻译插件的范畴。从我个人的实际经验来看XUnity.AutoTranslator的成功率对于使用标准Unity UI组件的游戏非常高能达到90%以上。它的真正威力在于其“无侵入性”和“可积累性”。你不需要懂编程不需要解包游戏资源只需要一次配置就能为无数个Unity游戏打开母语世界的大门。而过程中生成的Translation.txt不仅是你的游戏记录也可以成为帮助其他玩家的社区财富。当然它并非万能对于字体、图片文字、极端特殊的UI框架仍需额外处理。但无论如何它已经将Unity游戏汉化的门槛从“专业技术人员”降低到了“会操作电脑的普通玩家”这本身就是一件极具价值的事情。最后一个小建议在折腾汉化前不妨先到相关的游戏社区或论坛搜一下很可能已经有前辈整理好了针对该游戏的配置文件、字体补丁甚至完整的翻译缓存这能让你事半功倍。