1. 项目概述为什么我们需要游戏翻译自动化做独立游戏或者接手海外项目的时候最头疼的问题之一可能就是本地化了。尤其是当你手上有一个用Unity引擎开发的、文本量巨大的游戏而你的目标市场是说中文的玩家时传统的本地化流程——导出文本、交给翻译、导入、测试——不仅周期长、成本高而且迭代起来极其繁琐。每次策划改一句台词整个流程就得重走一遍。更别提那些由爱好者社区制作的模组Mod或者早期测试版游戏官方可能根本不提供中文支持。这时候像XUnity Auto Translator这样的工具就成为了“救命稻草”。它不是一个官方的本地化工具而是一个运行时的“补丁”式翻译器。简单来说它能在游戏运行时动态拦截游戏原本要显示的文本比如UI上的按钮、对话字幕、物品描述然后用你预先准备好的翻译文本替换掉。对于玩家而言它实现了“游戏内实时汉化”对于开发者或汉化组而言它提供了一套绕过游戏原始资源、快速进行文本替换的框架。我最初接触它是因为一个非常小众的Unity游戏官方早已停止更新但社区热度不减。手动反编译、解包资源来汉化技术门槛高且容易出错。XUnity Auto Translator让我能在不触碰游戏原始代码和资源的情况下通过配置文本文件就完成了大部分界面的汉化效率提升了不止一个量级。它的核心价值在于“非侵入性”和“即时性”。你不需要重新编译游戏甚至不需要有游戏的源代码只要游戏是基于Unity引擎且版本在支持范围内就有很大的操作空间。当然它并非万能。它主要处理的是运行时内存中的字符串对于硬编码在纹理图片里的文字、或者通过特殊方式渲染的字体它就无能为力了这些情况需要配合其他工具如PS修改贴图来处理。但对于占本地化工作量80%以上的UI文本和对话文本它已经足够强大。接下来我将从工具原理到实战配置带你从零开始掌握这个利器。2. XUnity自动翻译器核心原理与工作流拆解要熟练使用一个工具必须先理解它是怎么工作的。XUnity Auto Translator下文简称XUAT本质上是一个运行在Unity游戏进程内的“中间人”Man-in-the-Middle代理。它的工作流程可以概括为“拦截-查询-替换-渲染”四步。2.1 核心拦截机制挂钩Unity的文本处理函数Unity游戏中的所有文本最终都要通过特定的UI组件如UnityEngine.UI.Text、TextMeshPro的text属性来设置和显示。XUAT的核心技术就是通过HarmonyLib这个强大的库对Unity引擎中这些关键方法进行“打补丁”Patching。具体来说它会在游戏启动时将一小段自己的代码“注入”到例如Text.set_text(string value)这个方法里。当游戏代码试图设置一个文本内容时控制权会先经过XUAT注入的代码。这段代码会做以下几件事接收原始文本拿到游戏想要显示的原始字符串比如“Play Game”。生成翻译键通常会对这个原始文本进行哈希计算如MD5生成一个唯一的ID或者直接使用原始文本作为键。查询翻译表在内存中维护的或从文件加载的翻译字典里用这个“键”查找对应的翻译值比如“开始游戏”。返回替换文本如果找到了翻译就把翻译后的文本返回给原始的set_text方法如果没找到则原样返回原始文本。这个过程对游戏本身是透明的游戏并不知道自己显示的文本已经被“调包”了。这种基于方法注入的方式使得XUAT能够覆盖绝大多数通过Unity标准UI系统显示的文本。注意这种“挂钩”方式高度依赖于Unity引擎的内部实现。如果游戏使用了极度自定义的文本渲染方式或者对UI系统进行了深度魔改XUAT可能会失效。这也是为什么它需要针对不同的Unity游戏版本和不同的游戏进行适配和测试。2.2 翻译数据的管理与加载流程知道了如何拦截下一步就是翻译数据从何而来。XUAT支持多种翻译源构成了一个灵活的数据管道。1. 静态翻译文件主流方式 这是最稳定、最常用的方式。翻译者事先准备好翻译文件放在游戏的特定目录下通常是BepInEx\Translation或游戏根目录下的Translations文件夹。文件格式支持.txt、.json、.po等。文件内容就是简单的键值对Play Game开始游戏 New Game新的游戏 Load Game加载游戏游戏启动时XUAT会加载这些文件到内存中的字典里。当拦截到文本时直接进行字典查找速度极快且不依赖网络。2. 在线翻译API辅助与备用 XUAT集成了如Google Translate、Bing Translator、DeepL等在线翻译服务的API。当在静态翻译文件中找不到某个文本的翻译时可以配置XUAT自动将文本发送到这些API进行实时翻译并将结果缓存下来甚至自动追加到本地翻译文件中。这对于快速实现“机翻”覆盖或者翻译那些动态生成的文本如随机事件描述非常有用。优点快速覆盖海量未知文本。缺点需要网络机翻质量参差不齐尤其对于游戏特有的术语、俚语翻译效果差可能有API调用次数限制或费用。3. 混合模式推荐的工作流 在实际的汉化项目中我强烈推荐采用混合模式。首先使用工具如XUAT自带的导出功能或第三方插件将游戏中的所有文本“抓取”出来导出为一个原始文本文件。然后汉化人员对这个文件进行精细翻译和校对生成高质量的静态翻译文件。最后在配置中仅启用静态文件翻译并关闭在线翻译。这样可以确保最终玩家看到的是经过校对的优质翻译避免了在线机翻的尴尬错误。在线翻译API仅在整个流程初期用于快速了解文本内容时使用。2.3 与游戏模组框架的集成绝大多数情况下XUAT是作为插件Plugin运行在游戏模组框架之上的。目前最主要的两个框架是BepInEx面向Unity游戏的通用框架和IPA主要用于Beat Saber等特定游戏。以BepInEx为例安装流程通常是在游戏目录安装BepInEx框架。将XUAT的插件文件通常是.dll和配置文件放入BepInEx\plugins目录。启动游戏BepInEx会自动加载XUAT。框架负责提供游戏启动时的注入环境、插件管理、配置系统和日志输出。XUAT则专注于翻译功能的实现。这种分工使得XUAT的维护者不需要关心不同游戏的具体启动方式只需要确保与BepInEx等框架的API兼容即可。3. 实战准备环境搭建与基础配置理论讲完了我们动手实操。假设我们要为一个名为MyUnityGame的虚构游戏添加汉化。请确保你拥有该游戏的法律许可副本。3.1 必要工具链安装工欲善其事必先利其器。你需要准备以下工具BepInEx访问 BepInEx 的 GitHub Releases 页面下载对应你游戏架构x86或x64的通用安装包。通常是一个压缩文件。XUnity Auto Translator访问 XUAT 的官方发布页如GitHub下载最新的稳定版。你会得到一个包含XUnity.AutoTranslator.Plugin.Core.dll等文件的压缩包。文本编辑器推荐使用Visual Studio Code或Notepad。用于编辑翻译文件比系统自带的记事本强大得多支持编码识别和正则表达式查找替换。游戏根目录找到你的MyUnityGame.exe所在的文件夹。安装步骤将 BepInEx 压缩包内的所有文件解压到游戏根目录。运行一次游戏此时会生成BepInEx文件夹及其子目录。关闭游戏。将 XUAT 压缩包中plugins文件夹下的所有内容复制到游戏根目录的BepInEx\plugins文件夹下。再次启动游戏。如果安装成功游戏启动时在命令行窗口或BepInEx的日志文件BepInEx\LogOutput.log中你应该能看到XUAT相关的加载信息。3.2 核心配置文件详解安装后在BepInEx\config目录下会生成一个AutoTranslatorConfig.ini文件。这个文件控制着XUAT的所有行为。用文本编辑器打开它我们重点关注以下几个部分[General] ; 是否启用翻译器 Enabledtrue ; 当翻译缺失时是否显示原始文本。设为false则可能显示空白。 FallbackToOriginalTexttrue [Service] ; 启用哪些翻译服务。‘0’代表禁用‘1’代表启用。 ; 这里我们优先使用离线文件所以把在线服务都关掉。 GoogleTranslateEnabled0 BaiduTranslateEnabled0 DeepLTranslateEnabled0 ; ... 其他服务 [TextFrameworks] ; 启用对哪些UI框架的支持。通常全开即可。 TextMeshProEnabledtrue UGUIEnabledtrue NGUIEnabledfalse ; 如果游戏很老用了NGUI才需要开启 [Translation] ; 翻译文件的语言代码简体中文是‘zh-CN’ Languagezh-CN ; 翻译文件的存放目录相对路径 TranslationDirectory.\Translation ; 自动导出未翻译的文本到文件用于汉化初期收集文本 EnableExportUntranslatedTexttrue ExportPath.\Translation\untranslated.txt关键配置心得Language字段必须与你的翻译文件后缀名匹配。如果你创建了一个zh-CN.txt的翻译文件这里就填zh-CN。如果填错翻译文件将不会被加载。在线服务在汉化初期你可以短暂开启GoogleTranslateEnabled1并配置好API密钥需要自行申请让游戏跑一遍快速生成一个机翻版本的翻译文件作为草稿。但最终发布前务必关闭所有在线服务并基于机翻草稿进行彻底的人工校对。导出未翻译文本EnableExportUntranslatedText这个功能极其有用。在游戏过程中所有被XUAT拦截到但未在翻译文件中找到的文本都会被追加到untranslated.txt里。你可以定期查看这个文件对其进行翻译然后将翻译行复制到主翻译文件中从而实现翻译覆盖率的渐进式提升。3.3 创建并管理你的第一个翻译文件在游戏根目录下或BepInEx\Translation目录下具体看你的配置创建一个新的文本文件命名为zh-CN.txt。注意编码格式强烈建议保存为 UTF-8 with BOM或UTF-8以避免中文乱码。翻译文件的格式非常简单每一行就是一个键值对等号分隔Start开始 Options选项 Exit退出 Save Game保存游戏 “Hello, World!”“你好世界”键Key可以是原始文本本身如Start也可以是原始文本的哈希值。XUAT默认使用文本本身作为键这样更直观。值Value翻译后的文本。引号如果原始文本或翻译文本中包含等号或分号;需要用英文双引号将整个键或值括起来。高效管理技巧分模块管理当文本量很大时不要全放在一个zh-CN.txt里。你可以按功能模块创建多个文件如zh-CN.UI.txt、zh-CN.Dialogue.txt、zh-CN.Items.txt。XUAT会加载目录下所有以zh-CN开头的.txt文件。使用注释在翻译文件中以#开头的行是注释。你可以用注释来标注某段文本的出处、上下文或翻译备注这在校对和团队协作时非常重要。# 主菜单界面 Start开始 Options选项 # 注意此Exit特指退出游戏而非退出菜单 Exit退出游戏正则表达式批量处理从untranslated.txt导出的文本可能是未经处理的。你可以使用文本编辑器的“正则表达式查找替换”功能快速将多行文本转换成keyvalue格式这能节省大量时间。4. 高级应用与疑难排错基础配置完成后你已经能让游戏显示中文了。但要做出一个高质量的汉化或者解决一些奇怪的问题还需要更深入的知识。4.1 处理特殊文本与动态文本不是所有文本都像“Play”这么简单。包含变量的文本游戏中的文本常常是模板比如“You have collected {0} gold.”。翻译时必须保留变量占位符{0}只翻译固定部分。正确的翻译是“你收集了 {0} 枚金币。”。绝对不要翻译或删除{0}否则游戏在尝试格式化字符串时会崩溃或显示错误。富文本标签Unity支持类似HTML的富文本标签如colorredWarning!/color。翻译时标签必须原封不动地保留或正确迁移。翻译应为colorred警告/color。你需要理解标签的嵌套关系确保翻译后标签仍然是闭合且有效的。多行文本与换行符翻译文件中的值可以包含换行符\n。如果一句英文对话很长翻译成中文可能也需要换行来保持UI美观你可以写成“This is a very long line of dialogue that might break the UI.”“这是一句非常长的对话\n如果不断行可能会破坏UI显示。”动态拼接的文本最棘手的情况是游戏通过代码将多个字符串碎片拼接成一个完整句子例如“You ” verb “ the ” itemName。XUAT拦截到的是碎片“You ”, “ the ”而不是完整句子。翻译这种文本需要一定的逆向工程能力可能需要通过修改XUAT的配置或编写补丁来拦截更上层的拼接方法或者对每个碎片进行有上下文提示的翻译这通常需要汉化者与游戏进行大量交互测试。4.2 字体显示与乱码问题解决“翻译找到了但显示出来是方框□□□或者乱码”这是中文汉化最常见的问题。原因Unity游戏默认使用的字体如Arial通常不包含完整的中文字形库。当游戏试图用这个字体渲染中文时因为找不到对应的字形就显示为方框。解决方案字体替换/补丁最根本的解决方式这是最推荐的方法。你需要找到一个包含完整中文字形的字体文件.ttf或.otf例如“思源黑体”、“方正准圆”等。然后使用专门的Unity游戏字体修改工具如UnityEX、AssetStudio或游戏特定的字体Mod工具将游戏资源包中的原始字体文件替换为你准备好的中文字体。这个过程需要解包游戏资源、替换文件、再重新打包有一定技术门槛但一劳永逸。使用XUAT的字体重定向功能如果游戏支持较新版本的XUAT支持通过配置将游戏对特定字体的请求重定向到另一个字体文件。你需要在配置文件中添加如下配置并将中文字体文件放在指定位置[Font] ; 启用字体替换 EnableFontReplacementtrue ; 将游戏默认字体重定向到你的中文字体文件 DefaultReplacementFontzh-CN.ttf然后将zh-CN.ttf字体文件放入BepInEx\Translation\zh-CN目录下。注意这个功能并非对所有游戏都有效它依赖于游戏是否使用XUAT能够挂钩的字体加载API。检查文件编码确保你的zh-CN.txt翻译文件是以UTF-8编码带BOM签名保存的。用Notepad打开点击“编码”菜单可以查看和转换。ANSI或UTF-8无BOM编码在部分环境下可能导致中文乱码。4.3 性能优化与翻译覆盖度提升随着翻译文件越来越大你可能会关心性能和如何查漏补缺。翻译缓存XUAT会在内存中缓存翻译结果。对于静态文本第一次查询后后续再出现相同文本会直接使用缓存速度极快。无需担心翻译文件大小对性能的显著影响。定期导出与校对始终开启EnableExportUntranslatedText功能。每次进行一段时间的游戏测试后检查untranslated.txt文件。使用文本编辑器的“排序”功能可以方便地合并重复行然后集中翻译。这是提高覆盖度最有效的方法。利用正则表达式进行批量翻译对于有规律的文本比如成百上千个物品名“Item_001”、“Item_002”如果它们都有对应的、有规律的可读名你可以编写一个简单的Python或PowerShell脚本通过正则表达式匹配和字典映射批量生成翻译条目然后粘贴到翻译文件中。处理“幽灵文本”有些文本只在特定条件下触发如稀有事件、错误提示或者被UI组件动态创建和销毁很难在常规游戏流程中捕捉到。对于这类文本可以尝试阅读游戏社区的讨论看其他玩家是否提到过这些英文文本。如果有条件尝试在游戏代码中搜索这些字符串使用dnSpy等反编译工具查看游戏程序集。在XUAT的配置中调高日志级别查看是否有拦截到但未翻译的文本记录。4.4 常见问题排查清单遇到问题可以按以下清单自查问题现象可能原因解决方案游戏启动崩溃或XUAT未加载1. BepInEx安装不正确。2. XUAT插件版本与游戏或BepInEx版本不兼容。3. 插件依赖的库文件缺失。1. 确认BepInEx日志 (BepInEx\LogOutput.log) 有无错误。2. 尝试更换BepInEx或XUAT的版本如稳定版而非测试版。3. 确保BepInEx\core和BepInEx\plugins下的所有依赖dll文件齐全。游戏能运行但无任何翻译效果1. 翻译功能未启用 (Enabledfalse)。2. 语言代码不匹配。3. 翻译文件放错了位置。1. 检查AutoTranslatorConfig.ini中的Enabled和Language设置。2. 确认翻译文件名如zh-CN.txt与配置中的Language完全一致。3. 确认翻译文件在TranslationDirectory指定的路径下。部分文本翻译了部分没有1. 未翻译的文本不在翻译文件中。2. 该文本通过非标准方式渲染XUAT未挂钩。1. 开启未翻译文本导出功能玩一遍游戏然后翻译导出的内容。2. 检查XUAT日志看是否拦截到了该文本。如果没有可能是技术限制。中文显示为方框□□□游戏字体不支持中文。1.首选寻找或制作该游戏的字体替换Mod。2.尝试配置XUAT的字体重定向功能并放入中文字体文件。3. 检查翻译文件编码是否为UTF-8 with BOM。翻译后游戏UI错位、文字溢出中英文字符长度和宽度不同。翻译时需考虑文本长度必要时精简措辞。对于固定宽度的UI如按钮可能需要在翻译后手动调整游戏UI的布局文件如果可能这通常涉及更高级的Mod制作。在线翻译不工作1. API未启用或密钥错误。2. 网络连接问题。3. API服务商限制。1. 检查配置文件中对应服务的Enabled和ApiKey。2. 确认网络通畅。3. 查看XUAT日志中的具体错误信息。对于最终发布建议禁用在线翻译。5. 从汉化到维护构建可持续的本地化流程完成初版汉化只是开始游戏可能会更新文本会增加或修改。建立一个可持续的维护流程至关重要。1. 版本控制你的翻译文件使用Git来管理你的翻译文件仓库。每次游戏大更新后你可以用新版本的游戏重新导出一次原始文本。使用对比工具如git diff或 Beyond Compare对比新旧原始文本快速定位新增、删除和修改的条目。将变更同步到你的翻译文件中并提交新的版本。这能让你清晰地追踪汉化进度和历史。2. 建立术语库和风格指南对于大型项目维护一个统一的术语库例如将“Mana”统一翻译为“法力”还是“魔力”“Critical Hit”是“暴击”还是“会心一击”和风格指南口语化还是书面化角色语言风格如何区分是保证翻译质量一致性的关键。可以将这些记录在一个独立的README或TERMS.md文件中。3. 社区协作如果你的汉化项目是开源的可以利用GitHub、Gitee等平台的Issues和Pull Request功能。让其他贡献者可以报告未翻译的文本、提出翻译建议、甚至直接提交修改。你需要制定清晰的贡献指南说明翻译文件的格式、术语标准以及如何测试。4. 自动化测试虽然不能完全自动化但可以建立一些简单的检查脚本例如检查翻译文件中是否有孤立的{0}、{1}占位符可能对应关系错误。检查是否有行尾多余的等号或缺失的翻译值。检查是否有因误操作导致的中文标点或术语不一致。5. 应对游戏更新游戏更新后如果汉化失效首先检查BepInEx和XUAT插件是否需要更新到兼容新游戏版本的版本。然后按照上述版本控制流程合并文本变更。有时游戏更新会改变代码结构导致XUAT的挂钩点失效这就需要等待XUAT的作者或社区更新插件或者自己有一定能力去分析新的游戏二进制文件。最后我想分享一个最深切的体会技术工具XUAT解决了“如何翻译”的问题但“翻译得好不好”始终是一个需要人文关怀和语言功底的创造性工作。尤其是在翻译游戏时角色的性格、世界观设定、文化梗的转化都需要译者深入理解游戏内容。工具让我们摆脱了繁琐的技术重复劳动从而能将更多精力投入到真正的“本地化”而不仅仅是“翻译”上。当你看到玩家因为你的汉化而能更好地沉浸在一个精彩的故事中时那种成就感远非技术实现本身所能比拟。所以不妨将XUAT看作是你的一支好笔用它写出更地道的“中文剧本”吧。