1. 项目概述当游戏语言成为一堵墙作为一名玩了十几年日系、欧美独立游戏的“老油条”我太懂那种面对一款心仪已久、画风玩法都戳中G点的游戏却因为语言不通而望而却步的痛了。尤其是那些基于Unity引擎开发的、体量不大但内容精良的作品往往因为受众问题官方汉化遥遥无期。以前我们要么硬啃生肉要么苦等民间汉化组过程被动且煎熬。直到我遇到了XUnity.AutoTranslator下文简称XUA它彻底改变了我的游戏体验。这不仅仅是一个“翻译插件”它是一个完整的、运行在游戏进程内的实时翻译与文本替换框架。简单来说它能在游戏运行时拦截屏幕上出现的任何文本对话、UI、物品描述调用你配置的翻译服务如谷歌、百度、DeepL进行翻译并将结果无缝替换到游戏界面上。更强大的是它支持手动翻译文件的创建、管理和缓存实现“一次翻译永久生效”还能替换游戏内的图片资源比如日文路牌换成中文。网络上关于XUA的讨论很多但信息零散官方文档虽然详尽却过于技术化让很多新手望而却步。今天我就结合自己多年的使用和折腾经验为你带来一份从零开始、保姆级、覆盖从安装配置到高阶定制的完整指南。无论你是想无障碍畅玩某款特定游戏还是想为整个游戏库搭建一个通用的翻译环境这篇文章都能帮你搞定。2. 核心原理与架构拆解它到底是怎么工作的在深入实操之前理解XUA的工作原理至关重要这能帮你后续排查各种诡异问题。你可以把它想象成一个安装在游戏内部的“智能代理”。2.1 核心工作流程它的工作流程可以概括为“拦截-查询-替换”三部曲文本拦截HookingXUA通过BepInEx、IPA等插件框架注入到游戏进程。它利用Harmony或MonoMod等技术在游戏引擎Unity渲染文本到屏幕的关键函数上“打钩子”Hook。当游戏调用这些函数显示“こんにちは”你好时XUA能第一时间截获这个原始字符串。翻译查询Translation Lookup截获文本后XUA首先检查本地翻译缓存位于Translation文件夹下的_AutoGeneratedTranslations.txt等文件。如果找到了该原文对应的翻译直接使用。如果没找到则根据你的配置将原文发送给指定的在线翻译服务Endpoint如Google Translate获取翻译结果并自动将原文-译文对保存到本地缓存文件。这就是“自动翻译”的由来。实时替换Replacement拿到翻译文本无论是缓存还是在线获取的后XUA会修改游戏即将渲染的文本内容将“こんにちは”替换成“你好”并显示在屏幕上。整个过程是实时的延迟通常极低用户感知不到。2.2 关键组件与目录结构安装XUA后你的游戏目录下通常会生成一个BepInEx文件夹核心内容在BepInEx\plugins\XUnity.AutoTranslator里。理解这个结构对后续配置和问题排查很有帮助BepInEx/ └── plugins/ └── XUnity.AutoTranslator/ ├── Config.ini # 核心配置文件所有行为由此定义 ├── Translation/ # 翻译相关文件核心目录 │ ├── en/ # 目标语言目录如en代表翻译成英文 │ │ └── Text/ │ │ ├── _AutoGeneratedTranslations.txt # 自动生成的翻译缓存 │ │ ├── _Substitutions.txt # 文本替换规则如人名、专有名词 │ │ └── 其他手动创建的翻译文件.txt │ └── Texture/ # 图片翻译替换目录 └── translators/ # 可选放置自定义翻译器DLL的目录Config.ini这是插件的大脑。所有功能开关、翻译服务配置、性能调优、路径设置都在这里。我们后续的绝大部分操作都是围绕修改这个文件。Translation/{Lang}/Text/这是翻译文本的仓库。_AutoGeneratedTranslations.txt是插件自动填充的严禁手动修改因为会被覆盖。你可以创建新的.txt文件如MyManualTranslations.txt来放置精心校对过的翻译它们的优先级高于自动生成的文件。Texture/用于存放替换游戏内图片如UI图标、带文字的图片的资源。2.3 支持的翻译服务EndpointXUA的强大之处在于其可扩展的翻译后端支持。默认或通过额外配置它可以接入多种服务GoogleTranslate (默认)免费无需API Key但可能受网络环境影响。这是最常用的选择。GoogleTranslateLegitimate使用官方Google Cloud Translation API需要付费API Key稳定且配额高。BaiduTranslate百度翻译API国内访问速度快需要申请App ID和密钥。DeepL翻译质量公认较高尤其是欧洲语言需要API Key有免费额度。BingTranslateLegitimate微软Azure翻译服务需要API Key。Yandex.Translate俄罗斯的翻译服务对小语种支持可能不错。Custom自定义端点允许开发者接入任何符合其API规范的翻译服务。对于绝大多数个人用户GoogleTranslate免费版或BaiduTranslate国内用户已经足够。选择哪个主要取决于你的网络环境和对翻译质量的偏好。3. 从零开始安装与基础配置实战理论说再多不如动手做一遍。下面我们以最流行的插件框架BepInEx为例演示完整的安装配置流程。3.1 环境准备与插件安装第一步确认游戏与框架兼容性首先你的游戏必须是基于Unity引擎开发的。通常游戏根目录下会有UnityPlayer.dll或GameAssembly.dllIL2CPP编译等文件。其次游戏需要能运行BepInEx。大多数Unity游戏都支持尤其是单机游戏。第二步安装BepInEx前往BepInEx的GitHub发布页下载对应你游戏架构x86或x64的版本。通常下载BepInEx_x64_5.4.22.0.zip这样的文件。将压缩包内所有文件解压到游戏的根目录即和游戏主.exe文件同一层。首次运行游戏BepInEx会自动完成初始化并在根目录生成完整的BepInEx文件夹结构。第三步安装XUnity.AutoTranslator前往XUA的GitHub发布页下载XUnity.AutoTranslator-BepInEx-5.x-{VERSION}.zip确保版本与BepInEx 5兼容。将压缩包内的plugins文件夹合并到游戏目录的BepInEx\plugins里。通常你会得到BepInEx\plugins\XUnity.AutoTranslator这个目录。再次运行游戏如果安装成功游戏启动时在命令行窗口或游戏内按F1/F2等快捷键调出的控制台应该能看到[XUnity.AutoTranslator]相关的加载日志。注意如果游戏没有控制台窗口你可能需要额外安装BepInEx的BepInEx.Console或BepInEx.Debug插件来启用日志输出这对于初期调试至关重要。3.2 核心配置文件Config.ini详解与调优安装完成后打开BepInEx\plugins\XUnity.AutoTranslator\Config.ini。这个文件看起来参数很多但新手只需关注几个关键区块。[Behaviour] 区块 - 核心行为[Behaviour] # 翻译服务默认为GoogleTranslate。如果想用百度改为BaiduTranslate EndpointGoogleTranslate # 源语言游戏原始语言插件通常能自动检测如ja(日语) Languageja # 目标语言你想翻译成的语言如zh-CN(简体中文) DestinationLanguagezh-CN # 是否启用自动翻译。如果只想用本地翻译文件可以设为False EnableTranslationTrue # 输出自动翻译文件的路径 OutputFileTranslation\{Lang}\Text\_AutoGeneratedTranslations.txtLanguage和DestinationLanguage必须使用标准的语言代码。常见的有ja(日),en(英),zh-CN(简中),zh-TW(繁中),ko(韩),ru(俄)。[Text] 区块 - 文本处理[Text] # 最大翻译字符数超过的文本不会被翻译。防止翻译超长文本如代码拖慢游戏。 MaxCharactersPerTranslation1000 # 是否启用文本批量处理将多个短句合并为一个请求发送提高效率。 EnableBatchingTrueMaxCharactersPerTranslation非常重要有些游戏会把整个脚本文件当做一个文本加载如果不设上限插件会试图翻译几万字符的“文本”导致卡死或翻译API报错。保持默认的1000或更低如400是安全的选择。[UI] 区块 - 字体与显示[UI] # 是否启用UI自动重设大小。翻译后文本可能更长这个选项会尝试调整文本框大小以防文字溢出。 EnableUIResizingTrue # 强制所有UI组件重设大小更激进但可能引起布局错乱。 ForceUIResizingFalse # 覆盖字体针对UGUI。当游戏原字体不支持目标语言字符如中文时指定一个系统字体或自定义字体文件。 OverrideFont # 后备字体针对TextMeshPro。解决TMP字体缺字问题优先级最高。 FallbackFontTextMeshPro中文用户最常遇到的问题是“口口口”乱码这通常是因为游戏字体不含中文字形。FallbackFontTextMeshPro是解决TMP UI乱码的利器。你可以将其设置为一个包含中文的TMP字体资源名例如Fonts Materials/LiberationSans SDF Fallback如果游戏自带或者自己制作并导入字体AssetBundle。配置翻译服务API以百度翻译为例如果你想使用需要认证的翻译服务如百度翻译需要在Config.ini中配置API信息。前往百度翻译开放平台注册并创建通用翻译API应用获取App ID和密钥。在Config.ini中找到[Baidu]区块如果没有可以手动添加[Baidu] BaiduAppId你的App ID BaiduAppSecret你的密钥将[Behaviour]区块中的Endpoint改为BaiduTranslate。保存文件重启游戏。3.3 首次运行与基础验证完成基础配置后启动游戏。进入一个有大量文本的场景如开始菜单、对话。观察控制台日志你应该能看到类似[Info] XUnity.AutoTranslator: Initialized successfully.和[Info] XUnity.AutoTranslator: Endpoint: GoogleTranslate的日志。当游戏文本出现时会有[Info] Translating: [原文] - [译文]的日志。使用热键测试ALT0打开翻译端点选择菜单。你可以在这里实时切换不同的翻译服务如果配置了多个。ALTT全局切换翻译的开启/关闭。这是最常用的热键用于快速对比翻译前后的效果。ALTR重新加载所有翻译文件。当你手动修改了Translation目录下的.txt文件后按此键无需重启游戏即可生效。检查缓存文件玩几分钟后退出游戏。打开Translation\{目标语言}\Text\_AutoGeneratedTranslations.txt你应该能看到插件自动记录下来的原文和译文对。这个文件会随着游戏进程不断增长。至此一个基础的、可用的实时游戏翻译环境就已经搭建完成了。你已经可以无障碍游玩大部分文本驱动的游戏了。4. 进阶实战精细化配置与问题排查基础功能能用但想用得爽、用得稳就需要深入一些进阶配置和问题处理技巧。4.1 解决中文乱码与字体问题“口口口”问题是中文用户的第一大敌。其根本原因是游戏使用的字体Font Asset不包含中文字符集。解决方案A使用后备字体TextMeshPro - 推荐对于使用TextMeshProTMP的现代Unity游戏FallbackFontTextMeshPro是最优雅的解决方案。寻找字体资源有些游戏模组作者会制作好包含中文的TMP字体AssetBundle。你可以在游戏社区或模组网站搜索“游戏名 字体补丁”或“TMP Chinese font”。下载后将.assets或.bundle文件放入游戏根目录。配置在Config.ini的[UI]区块设置FallbackFontTextMeshPro为字体资源的名称不含路径和扩展名。例如如果你下载的文件叫chinese_font.assets就设置为chinese_font。如果字体资源在AssetBundle内可能需要指定内部路径如customfonts/chinese。重启游戏测试。解决方案B覆盖字体传统UGUI对于使用传统UGUI Text的游戏可以使用OverrideFont。使用系统字体你可以直接指定一个系统中已安装的、包含中文的字体名如Microsoft YaHei微软雅黑。但这种方式不稳定并非所有游戏环境都能成功加载系统字体。使用自定义字体AssetBundle和TMP类似需要找到或制作UGUI字体AssetBundle然后指定其名称。实操心得如果游戏同时使用了TMP和UGUI优先配置FallbackFontTextMeshPro它对TMP的兼容性最好。对于UGUI如果OverrideFont无效可以尝试在游戏社区寻找专门的“外挂字体”Mod它们通常通过更底层的方式注入字体。4.2 管理翻译缓存与制作手动翻译包自动翻译虽然方便但质量参差不齐尤其是专有名词、角色名、技能名等。我们可以利用XUA的翻译文件优先级系统创建高质量的手动翻译。翻译文件优先级与创建XUA会读取Translation\{Lang}\Text\目录下所有.txt文件包括子目录。优先级规则是后加载的文件优先级高于先加载的手动创建的文件优先级高于自动生成的文件(_开头的文件)。_AutoGeneratedTranslations.txt总是最后加载优先级最低。因此最佳实践是永不直接修改_AutoGeneratedTranslations.txt因为游戏运行时它会被插件重写。创建你自己的翻译文件例如Manual_GameTerms.txt、Character_Names.txt。文件格式每行一条翻译格式为原文译文。例如魔王Demon King 勇者Hero 回復薬Healing Potion将你的文件放在Translation\zh-CN\Text\目录下。插件启动时会加载它们并且你的手动翻译会覆盖自动生成的或缓存中的低质量翻译。使用正则表达式Regex处理复杂文本游戏有时会将变量和文本拼接在一起例如獲得 金幣 x 100。直接翻译“獲得 金幣 x 100”很难覆盖“獲得 金幣 x 50”等情况。这时可以用正则表达式。在翻译文件中不要放在_AutoGeneratedTranslations.txt里使用r:前缀定义正则翻译r:^獲得 金幣 x ([0-9])$获得金币 x $1这个规则会将“獲得 金幣 x 100”翻译为“获得金币 x 100”其中的([0-9])匹配数字$1在译文中引用这个数字。使用替换文件Substitutions进行预处理对于经常被翻译服务误翻的固定词汇可以在翻译前进行替换。编辑Translation\{Lang}\Text\_Substitutions.txt如果不存在就创建莉雅莉娅 聖劍圣剑这样在发送给在线翻译前“莉雅”会被替换成“莉娅”避免翻译成“利亚”等奇怪译名。4.3 性能优化与高级配置游戏翻译可能会带来性能开销尤其是在配置不当或翻译大量文本时。关键性能配置项[Behaviour] # 启用批处理将多个短文本合并为一个请求大幅减少网络请求次数。 EnableBatchingTrue # 使用静态翻译表。插件内置了一个小型英日词典对于常见简单词汇直接本地查询不请求网络。 UseStaticTranslationsTrue [Text] # 如前所述限制单次翻译文本长度避免翻译整本小说。 MaxCharactersPerTranslation400 # 对于在线免费API建议设为400以下以防被封 # 延迟时间毫秒在发送翻译请求前等待。给UI一点喘息时间避免卡顿。 DelayAfterTranslation0 [Http] # 用户代理某些API可能需要特定的User-Agent。 UserAgentMozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36EnableBatching是提升流畅度的最关键设置务必开启。将MaxCharactersPerTranslation设为400是一个安全且高效的值既能处理长对话又不会触发翻译服务的限流。处理翻译服务限流与错误免费翻译API通常有调用频率限制。如果遇到翻译失败或游戏卡顿检查日志中是否有大量Failed to translate或网络超时错误。尝试增加[Behaviour]区块下的MaxConcurrency最大并发数默认可能较高或调整[Text]下的DelayAfterTranslation增加等待时间如50毫秒。考虑切换更稳定的翻译服务或者配置付费API如Google Cloud或DeepL它们有更高的配额和更稳定的服务质量。4.4 常见问题排查实录FAQ与解决方案即使配置正确在实际使用中也可能遇到各种问题。下面是我踩过坑后总结的排查清单。问题1插件安装后游戏无法启动或立刻闪退。可能原因BepInEx版本与游戏不兼容或XUA插件版本与BepInEx版本不匹配。解决方案确认游戏是否支持BepInEx。查看游戏社区是否有其他Mod成功运行。尝试使用更旧或更新的BepInEx版本。确保下载的XUA插件包与你的BepInEx主版本匹配BepInEx 5.x 用-BepInEx-5.x-的包。查看BepInEx\LogOutput.log或Windows事件查看器寻找崩溃前的错误信息。问题2游戏文本没有变化按ALTT也没反应。可能原因A插件未成功加载或翻译服务未配置。排查检查游戏启动时控制台是否有XUA加载成功的日志。按ALT0看是否能调出端点选择菜单。可能原因B游戏使用IL2CPP编译且文本钩子不完整。排查查看日志中是否有[Warning] Text hook may not be complete for IL2CPP...之类的警告。解决方案尝试使用XUnity.AutoTranslator发布页提供的AutoTranslator.IL2CPP.BruteForceFix辅助插件。将其DLL文件同样放入BepInEx\plugins目录。问题3翻译出现了但是“口口口”乱码。可能原因字体缺失如上文所述。排查步骤确认游戏UI是UGUI还是TextMeshPro。可以通过观察字体边缘是否特别清晰TMP通常更锐利来判断或查看游戏文件。在Config.ini中正确配置FallbackFontTextMeshPro或OverrideFont。寻找该游戏专用的中文字体Mod。问题4翻译延迟很高文字先显示原文过一会儿才变成译文。可能原因网络延迟或翻译服务响应慢。解决方案开启EnableBatching。适当增加DelayAfterTranslation但这治标不治本。考虑使用本地翻译缓存。多玩一会儿让插件积累缓存下次遇到相同文本会瞬间显示。切换更快的翻译节点或服务如从Google国际版切换到Baidu。问题5某些UI元素如其他Mod的窗口没有被翻译。可能原因IMGUIImmediate Mode GUI翻译默认被禁用。解决方案在Config.ini中设置[Behaviour]下的EnableIMGUITrue。注意这可能会轻微影响性能并可能与其他IMGUI Mod产生冲突。问题6自动生成的翻译文件_AutoGeneratedTranslations.txt变得巨大影响加载速度。解决方案定期清理。你可以安全地删除这个文件插件会重新生成。更好的做法是将确认无误的翻译行剪切到你自己的手动翻译文件中如Manual_Good.txt然后删除_AutoGeneratedTranslations.txt中对应的行或直接清空整个文件。插件会优先使用你手动文件中的翻译。5. 高阶应用图片翻译、资源重定向与开发者接口对于追求完美体验的玩家或Mod开发者XUA还提供了更底层的功能。5.1 图片翻译纹理替换这个功能允许你用翻译好的图片替换游戏内的原版图片比如菜单按钮、带文字的图标。启用功能在Config.ini中设置[Texture]区块下的EnableTextureTranslationTrue和EnableTextureDumpingTrue。启动游戏进入有目标图片的场景。插件会将游戏加载的纹理图片自动导出到Translation\Texture目录文件名包含哈希值用于标识如button_start [ABCD1234-EF567890].png。编辑图片用图像处理软件如Photoshop、GIMP打开导出的图片将上面的外文修改为目标语言保持图片尺寸和格式不变保存。替换将修改后的图片放回原目录可以修改文件名但必须保留[哈希值]部分。重启游戏对应的游戏内图片就应该被替换了。重要提示完成图片替换后务必将EnableTextureDumping改回False否则每次运行游戏都会重新导出所有纹理严重拖慢加载速度并占用磁盘空间。5.2 资源重定向Resource Redirector简介这是XUA依赖的一个强大底层库XUnity.ResourceRedirector.dll。它允许Mod在游戏加载资源如图片、音频、文本资产时动态修改或替换它们。XUA的文本和图片翻译功能都是基于此实现的。对于高级用户或Mod制作者你可以利用这个API为游戏制作更复杂的Mod例如替换游戏内的音频文件。修改3D模型或材质。动态修改游戏脚本TextAsset。这需要一定的C#和Unity Mod开发知识。你可以参考官方文档的“Implementing a Resource Redirector”部分通过注册钩子Hook来拦截和修改加载流程中的资源。5.3 为其他Mod提供翻译支持如果你在开发自己的游戏Mod并且希望它的UI也能被XUA翻译有两种方法自动支持只要你的Mod使用标准的Unity UIUGUI或TMP并且没有特殊处理XUA在启用IMGUI翻译后通常能自动捕获文本。主动集成在你的Mod代码中可以主动调用XUA提供的AutoTranslator.Default.TranslateAsyncAPI来查询翻译实现更可控的翻译效果。避免干扰如果你的Mod不希望被XUA翻译可以给你包含文本的GameObject命名为包含XUAIGNORE的字符串这样XUA就会忽略它。6. 维护、备份与社区资源最后分享一些长期使用的心得。翻译文件的维护与备份你的Translation目录下的手动翻译文件是宝贵的劳动成果。定期将其备份到云盘或其他位置。当游戏更新或重装系统后只需将备份的Translation文件夹复制回原位即可恢复所有精心校对的翻译。利用社区资源许多热门游戏都有玩家社区维护的XUA翻译包。你可以在GitHub、游戏论坛或Mod发布站如Nexus Mods搜索“游戏名 XUnity AutoTranslator Patch”。这些翻译包通常包含了大量高质量的手动翻译和可能需要的字体文件能极大提升开箱即用的体验。下载后将其内容合并到你自己的Translation目录即可。保持插件更新关注XUA的GitHub发布页新版本可能会修复bug、增加对新游戏或新Unity版本的支持、或提供新的功能。更新时注意阅读更新日志有时配置文件的格式会有变动。经过以上从原理到实战从安装到排错的全流程梳理相信你已经从“游戏语言障碍”的困扰中彻底解放出来了。XUnity.AutoTranslator就像一把万能钥匙为你打开了无数非母语游戏的大门。剩下的就是享受游戏的乐趣了。如果在使用中遇到任何本文未覆盖的奇特问题不妨去项目的GitHub Issues页面看看或者在有经验的玩家社区提问那里通常有热心的朋友愿意帮忙。
