1. 项目概述为什么你需要XUnity.AutoTranslator如果你是一个喜欢玩独立游戏或者某些特定类型Unity游戏的玩家肯定遇到过这种情况一款游戏玩法、美术都深得你心但偏偏没有官方中文满屏的英文、日文或者其他语言让你玩起来磕磕绊绊查词典查得头大。找汉化补丁吧要么版本对不上要么汉化质量参差不齐甚至可能夹带私货。这时候一个能实时、自动翻译游戏内文本的工具就成了刚需。XUnity.AutoTranslator下文简称XUA就是为解决这个问题而生的神器。它不是一个简单的“翻译器”而是一个功能极其强大的Unity游戏文本钩取与替换插件。简单来说它能在游戏运行时“监听”到游戏UI上显示的任何文本然后调用你指定的翻译服务比如谷歌翻译、百度翻译、DeepL等将翻译结果实时替换上去让你几乎“无缝”地玩上中文版游戏。更厉害的是它支持手动修正翻译、自定义字体、甚至替换游戏内的图片比如带文字的UI图功能深度远超一个普通翻译插件。我接触这个插件已经好几年了从它早期版本用到现在处理过各种稀奇古怪的Unity游戏从视觉小说到RPG从2D像素风到3D大作。可以说只要游戏是基于Unity引擎开发的XUA就有很大概率能搞定它的文本翻译。今天这篇指南我就把我这些年积累的经验浓缩成最核心的3个步骤带你从零开始让任何Unity游戏“秒变”中文版。无论你是纯新手还是有一定Mod安装经验的玩家跟着做都能成功。2. 核心思路与准备工作理解XUA的工作原理在动手之前我们先花几分钟搞清楚XUA到底是怎么工作的。这能帮你理解后续每一步操作的意义遇到问题时也知道该往哪个方向排查。2.1 XUA的三大核心模块XUA本质上是一个运行在游戏进程内的“中间人”。它通过BepInEx、IPA或ReiPatcher等Unity Mod框架注入到游戏中然后主要干三件事文本钩取与拦截这是核心。XUA会“钩住”HookUnity引擎中用于显示文本的函数比如TextMeshPro、UGUI Text、NGUI Label等组件的文本设置方法。当游戏调用这些函数显示文字时XUA会先一步拿到原始的、未翻译的文本字符串。翻译与替换拿到原始文本后XUA会先在本地翻译缓存文件_AutoGeneratedTranslations.txt里查找是否已经有手动添加或之前自动翻译好的对应译文。如果没有它就会根据你的配置调用在线的翻译API如Google Translate进行实时翻译并将结果缓存下来。最后它把翻译好的文本“塞回”给游戏引擎替换掉原本要显示的内容。资源重定向这是高级功能。除了文本XUA还能通过其附带的XUnity.ResourceRedirector库拦截游戏加载图片、音频等资源文件的请求。这意味着你可以把游戏里带外文的UI图片、图标等资源文件替换成自己准备好的中文版本实现真正完整的“汉化”。2.2 你需要准备什么开始三步走之前请确保你手头有这几样东西目标游戏一个你想汉化的、基于Unity引擎的PC游戏。通常你可以在游戏根目录下看到UnityPlayer.dll、GameAssembly.dllIL2CPP编译或Mono相关DLL文件。Mod加载器绝大多数情况下我们使用BepInEx。它是一个通用、稳定且社区支持最广的Unity游戏Mod框架。你需要下载与游戏架构x86或x64匹配的BepInEx版本。对于现代游戏通常选择BepInEx 5.x或6.x的x64版本。XUnity.AutoTranslator插件包去GitHub的bbepis/XUnity.AutoTranslator项目页面下载最新的XUnity.AutoTranslator-BepInEx-{VERSION}.zip文件。注意一定要下载带BepInEx字样的版本这是为BepInEx框架预配置好的。一个可用的翻译API可选但强烈推荐虽然XUA内置了免费的谷歌翻译端点但由于网络限制在国内直接使用可能不稳定或无法连接。我强烈建议你准备一个备用方案百度翻译API免费申请有每月一定额度的免费字符数对于个人游戏翻译完全够用。你需要申请App ID和密钥。彩云小译API同样有免费额度翻译质量不错。自建代理如果你有技术能力可以为谷歌翻译配置代理服务地址。实操心得对于新手我首推百度翻译API。申请过程简单国内访问速度快且稳定。虽然翻译某些游戏术语尤其是奇幻、科幻类可能不如DeepL精准但结合XUA的本地缓存和手动修正功能完全能获得优秀的体验。千万不要在公开分享的汉化补丁里配置你自己的付费API密钥3. 第一步基础环境搭建与插件安装这是最基础也最关键的一步。如果这一步出错后面所有工作都无法进行。3.1 安装BepInEx Mod加载器解压BepInEx将下载的BepInEx压缩包例如BepInEx_x64_5.4.23.0.zip解压。放置文件将解压后得到的所有文件和文件夹主要是winhttp.dll、doorstop_config.ini、BepInEx文件夹等直接复制到你的游戏根目录。游戏根目录就是包含游戏主程序.exe文件的那个文件夹。首次运行双击运行游戏主程序.exe。游戏可能会黑屏或卡顿一会儿这是BepInEx在初始化。运行一次后正常关闭游戏。验证安装回到游戏根目录你应该能看到新生成了一个BepInEx文件夹并且里面有了plugins、config等子文件夹。同时根目录下会多出一个LogOutput.log文件BepInEx的日志。这说明BepInEx安装成功。注意事项有些游戏有反作弊或特殊的启动器可能会干扰BepInEx。如果游戏无法启动或启动后没有生成BepInEx文件夹你需要查阅该游戏特定的Mod安装教程可能需要使用特殊的启动参数或兼容层。3.2 安装XUnity.AutoTranslator插件解压XUA解压你下载的XUnity.AutoTranslator-BepInEx-{VERSION}.zip文件。放置核心文件将解压得到的plugins文件夹下的XUnity.AutoTranslator文件夹整个复制到游戏目录的BepInEx\plugins\路径下。最终路径应该类似于你的游戏目录\BepInEx\plugins\XUnity.AutoTranslator\。放置依赖库检查XUA压缩包内是否有core、patchers等文件夹按照压缩包内的结构将它们复制到游戏目录的BepInEx文件夹下与现有的plugins、config文件夹同级。通常BepInEx版本的XUA包已经包含了所有必要依赖直接整体覆盖即可。首次运行生成配置再次启动游戏。等待游戏进入主菜单或可以看见文字的地方然后正常关闭游戏。这一步是为了让XUA生成默认的配置文件。3.3 验证插件是否生效打开游戏目录下的BepInEx\plugins\XUnity.AutoTranslator文件夹。你应该能看到一个名为Translation的文件夹以及一个Config.ini文件。Translation文件夹里会根据你的游戏语言设置生成子文件夹如zh-CN。打开BepInEx\LogOutput.log文件搜索XUnity.AutoTranslator。如果能看到类似[Info :XUnity.AutoTranslator] Initializing XUnity.AutoTranslator...和[Info :XUnity.AutoTranslator] Plugin initialization complete!的日志说明插件加载成功。如果到这里一切顺利恭喜你XUA已经成功“住”进了你的游戏里。但它现在还是个“哑巴”因为我们还没告诉它怎么翻译、翻译成什么语言。4. 第二步核心配置与翻译引擎设置现在我们来“激活”XUA让它开始为我们工作。所有配置都在Config.ini文件中完成。用记事本或其他文本编辑器推荐VSCode、Notepad打开它。4.1 基础语言与翻译端点配置找到[General]部分这是最重要的配置区。[General] Languagezh-CN SourceLanguageja ;SourceLanguageen ;SourceLanguageko EndpointGoogleTranslate ;EndpointBaiduTranslate ;EndpointLanguage: 这是目标语言即你想把游戏翻译成什么语言。设置为zh-CN简体中文。如果你想翻译成繁体中文则用zh-TW。SourceLanguage: 这是源语言即游戏原本使用的语言。你需要根据游戏实际情况设置。常见的有ja- 日语en- 英语ko- 韩语如果游戏是英文但你想用日文作为中转翻译成中文有时对ACG术语更友好可以设置SourceLanguageja但需要确保你的翻译端点支持日转中。用;注释掉不用的行。确保只有你需要的源语言那一行没有;。Endpoint:翻译服务提供商这是核心。默认是GoogleTranslate谷歌翻译。如果你在国内无法使用就需要更改。如果你想使用百度翻译将其改为EndpointBaiduTranslate并取消注释下面[Baidu]部分的配置。如果你想完全禁用自动翻译仅使用手动翻译的缓存文件将其设为空Endpoint。4.2 配置百度翻译API国内用户首选如果你选择了BaiduTranslate需要配置API信息。申请API前往百度翻译开放平台官网注册开发者账号创建一个“通用翻译API”应用。成功后你会获得App ID和密钥。填写配置在Config.ini中找到[Baidu]部分[Baidu] BaiduAppId你的百度翻译App ID BaiduAppSecret你的百度翻译密钥将你的百度翻译App ID和你的百度翻译密钥替换成你申请到的实际内容。务必保管好你的密钥不要泄露或在公开补丁中分享。4.3 其他关键配置项解析[Behaviour]部分:EnableTranslationAggregatorTrue启用翻译聚合器窗口按Alt0呼出可以同时显示多个翻译引擎的结果方便对比选择。建议开启。MaxCharactersPerTranslation400单次翻译的最大字符数。超过此长度的文本如大段剧情会被跳过。重要如果你要打包分享汉化补丁请务必确保此值不超过400并尽可能填充本地翻译文件以减少对在线API的调用。OutputUntranslatableTextFalse是否输出无法翻译的文本到日志。调试时可开正常使用建议关闭否则日志文件会暴涨。[Texture]部分图片翻译:EnableTextureTranslationFalse默认关闭。如果你需要替换游戏内的图片如带文字的按钮、菜单图可以设置为True并配合TextureDirectory路径放置替换后的图片。EnableTextureDumpingFalse切勿在公开发布的补丁中开启此选项它会将游戏内所有检测到的纹理图片导出可能导致性能问题并产生巨大文件。4.4 字体配置解决中文显示方块问题很多游戏的默认字体不包含中文字符集导致翻译出来的中文显示为“□□□”。XUA提供了字体覆盖功能。获取中文字体文件你需要一个包含中文的.ttf或.otf字体文件例如“思源黑体”、“方正准圆”等。注意版权确保用于个人用途。对于UGUI旧版Unity UI: 在[Behaviour]部分设置OverrideFont字体文件路径例如如果你将SourceHanSansCN-Normal.ttf字体文件放在游戏根目录可以写OverrideFontSourceHanSansCN-Normal.ttf。更可靠的方式是将字体制作成Unity AssetBundle但这需要一定的Unity编辑器操作对新手较复杂。对于TextMeshProTMP新版Unity UI: 这是更常见的情况。XUA支持为TMP添加后备字体。FallbackFontTextMeshPro字体资源名例如可以使用TMP自带的Fonts Materials/LiberationSans SDF作为后备如果它包含中文。更佳做法是使用社区制作好的TMP字体AssetBundle。你可以在XUA的GitHub Release页面找到TMP_Font_AssetBundles.zip解压后将其中的.assets文件放入游戏目录并在此处配置文件名不含扩展名。配置完成后保存Config.ini文件。再次启动游戏如果一切配置正确你应该能看到游戏内的文本开始被自动翻译成中文了首次运行会边玩边生成翻译缓存后续再玩时已翻译过的文本会直接从本地缓存读取速度飞快。5. 第三步高级调校与手动优化自动翻译只是第一步机器翻译的生硬、错误在所难免。第三步就是让你从“能玩”升级到“玩得舒服”的关键。5.1 使用翻译聚合器进行实时校对在游戏中按Alt0可以呼出翻译聚合器窗口。这个窗口会显示当前鼠标悬停或选中的文本并同时调用你配置的多个翻译引擎需要在[TranslationAggregator]中启用进行翻译对比。如何使用遇到翻译生硬或错误的地方将鼠标悬停在那个文本上或按AltC复制文本到剪贴板。查看聚合器窗口中各个引擎的翻译结果。选择一个你认为最准确的翻译或者综合几个翻译自己组织一句更通顺的。按AltR可以强制重新加载翻译文件让你修改后立即生效。5.2 编辑本地翻译文件实现精准汉化所有自动翻译和手动添加的翻译最终都保存在Translation\zh-CN\Text\_AutoGeneratedTranslations.txt文件中。这个文件是纯文本格式每一行就是一个翻译对原文译文手动优化流程玩游戏遇到翻译不对劲的地方。切出游戏打开_AutoGeneratedTranslations.txt文件。使用文本编辑器的搜索功能CtrlF查找那段有问题的原文。将等号右边的自动翻译结果修改为你认为更准确、更符合语境、更“信达雅”的译文。保存文件。回到游戏按AltR热键重载翻译。刚才修改的文本就会立即更新为你手动翻译的内容。高级技巧——使用正则表达式 对于有规律变化的文本比如道具名“生命药水 I”、“生命药水 II”可以用正则表达式批量处理r:^生命药水 ([IVXLCDM])$Health Potion $1这行配置会将所有罗马数字等级的生命药水都统一翻译。正则表达式功能强大但需谨慎使用不当使用可能导致性能问题或翻译错乱。5.3 处理特殊场景与疑难杂症翻译不生效或部分文本不翻译检查Config.ini中的SourceLanguage是否设置正确。检查游戏文本是否是图片形式而非文字。如果是图片需要开启EnableTextureTranslation并制作替换图。某些游戏使用自定义的文本渲染方式可能需要调整TextGetterCompatibilityModeTrue试试。按AltT可以临时开关翻译检查是否是翻译导致了显示问题。游戏崩溃或闪退首先检查BepInEx的日志文件LogOutput.log看是否有红色错误信息。尝试在Config.ini中设置[Behaviour]下的EnableSilentModeTrue减少插件输出。如果是IL2CPP编译的游戏有GameAssembly.dllXUA的支持可能不完整可以尝试使用AutoTranslator.IL2CPP.BruteForceFix这个辅助插件。翻译后文字显示不全或重叠开启UI自动重设大小功能[Behaviour]下设置EnableUIResizingTrue。如果还不行可以手动创建resizer.txt文件来调整特定UI元素的字体大小和布局。这需要借助Runtime Unity Editor等工具来获取UI元素的路径。为其他Mod提供翻译如果游戏有其他Mod它们的UI可能也需要翻译。你可以在Translation\zh-CN\Text\目录下创建Plugins文件夹再在里面为每个Mod的DLL创建同名文件夹放入翻译文件即可。6. 常见问题排查与实战技巧实录这里记录了我踩过的一些坑和对应的解决方案希望能帮你节省大量折腾的时间。6.1 问题速查表问题现象可能原因解决方案游戏启动后无任何翻译效果Translation文件夹为空1. BepInEx未正确安装。2. XUA插件文件放置位置错误。3. 游戏是IL2CPP版本且未使用BruteForceFix。1. 检查BepInEx\LogOutput.log确认XUA插件已加载。2. 确保文件路径为BepInEx\plugins\XUnity.AutoTranslator。3. 对于IL2CPP游戏尝试使用辅助插件。翻译结果为英文或非目标语言Config.ini中的Language设置错误。检查并确保Languagezh-CN或其他目标语言代码。翻译API频繁报错或翻译慢1. 网络连接问题。2. 免费API额度用尽或频率限制。3. 使用了不稳定的公共端点。1. 检查网络尝试切换翻译端点如从GoogleTranslate换到BaiduTranslate。2. 申请自己的API密钥并配置。3. 在[Http]部分尝试配置ServiceUrl使用可访问的代理仅限有相关资源和技术能力的用户。中文显示为方块“□□□”游戏字体不支持中文。配置FallbackFontTextMeshPro或OverrideFont使用包含中文字符的字体。按Alt0无反应翻译聚合器不显示翻译聚合器未启用或热键冲突。检查Config.ini中[Behaviour]下的EnableTranslationAggregator是否为True。尝试更改游戏内热键或XUA的热键配置需修改代码较复杂。修改_AutoGeneratedTranslations.txt后按AltR不生效1. 文件编码不是UTF-8 without BOM。2. 文件正在被其他程序占用。3. 修改了错误的文件检查语言目录是否正确。1. 用Notepad等编辑器将文件转为“UTF-8 无BOM”编码格式保存。2. 关闭可能占用文件的编辑器。3. 确认路径是Translation\{Lang}\Text\_AutoGeneratedTranslations.txt。游戏特定场景或Mod的UI不翻译1. 该UI使用IMGUI绘制且默认被禁用。2. 文本路径特殊未被钩取。1. 尝试在Config.ini中设置[Behaviour]下的EnableIMGUITrue可能影响性能。2. 开启EnableTextPathLoggingTrue在日志中查看文本路径尝试手动添加翻译或调整钩取策略。6.2 独家避坑技巧翻译缓存是王道第一次玩一个新游戏耐心点让它跑一遍自动翻译。之后将生成的_AutoGeneratedTranslations.txt文件备份。重装游戏或分享给朋友时直接放入这个文件就能获得一个“基础汉化版”体验大幅提升。分而治之管理翻译不要把所有手动翻译都堆在_AutoGeneratedTranslations.txt里。可以按章节、系统或Mod创建新的.txt文件放在Translation\zh-CN\Text\目录下。XUA会读取所有.txt文件并且_AutoGeneratedTranslations.txt优先级最低方便你管理和覆盖。活用“替换”功能在Translation\zh-CN\Text\目录下可以创建_Substitutions.txt文件。这里定义的替换规则会在翻译之前生效。比如游戏里角色名“John”总被翻译成“约翰”但你希望保留原文就可以添加JohnJohn。这样翻译引擎就不会处理它了。性能与稳定性权衡如果你感觉游戏变卡了尤其是场景切换时可以尝试关闭一些高级功能EnableTextureScanOnSceneLoadFalseEnableSpriteRendererHookingFalseCacheTexturesInMemoryFalse如果用了图片翻译。这些功能会消耗更多资源。制作可分享的汉化补丁如果你想把自己的劳动成果打包分享请务必清理_AutoGeneratedTranslations.txt删除所有未修改的、质量差的机器翻译行只保留你精心校对过的内容。将Config.ini中的Endpoint设为空Endpoint强制用户使用本地翻译文件避免他们因API问题无法使用。将MaxCharactersPerTranslation设置为400或更低。绝对不要包含EnableTextureDumpingTrue、EnableTextureTogglingTrue、OutputUntranslatableTextTrue等会产生大量文件或日志的配置。提供一个清晰的Readme.txt说明安装步骤和配置方法。经过以上三步——安装、配置、优化——你基本上就能征服绝大多数Unity游戏的汉化了。XUnity.AutoTranslator的强大之处在于它的高度可定制性和自动化潜力。一开始你可能只是用它来解燃眉之急但随着你深入使用手动修正越来越多的文本最终甚至能产出一份质量不亚于专业汉化组的补丁。这个过程本身也是深入了解游戏结构和语言之美的有趣经历。