1. 项目概述当Unity游戏遇上自动翻译如果你是一名Unity游戏开发者或者是一位热衷于体验全球独立游戏的玩家那么“语言不通”这个问题大概率是你绕不开的痛点。开发者可能苦于如何高效地将自己的作品推向不同语言的玩家群体而玩家则常常对着心仪却只有外文的游戏望而却步。手动汉化那意味着需要反编译、找文本、翻译、再打包过程繁琐且门槛极高。今天要聊的就是一个在Unity游戏社区里流传已久堪称“神器”级的解决方案——XUnity AutoTranslator也就是大家常说的XUnity自动翻译器。简单来说这是一个能够为Unity引擎开发的游戏包括PC、安卓等平台实现实时、自动文本翻译的插件。它的核心魅力在于“自动”二字你不需要是程序员也不需要动游戏的原始代码通过简单的配置它就能在游戏运行时拦截游戏引擎渲染的文本调用在线翻译API如谷歌、百度、DeepL等进行翻译并将翻译结果即时显示在游戏界面上。对于玩家这意味着可以几乎无门槛地“汉化”那些没有官方中文的游戏对于开发者这提供了一个快速验证多语言版本或制作非官方社区汉化补丁的强力工具。网络上关于“xunity翻译工具”、“unity游戏汉化”的搜索热度一直很高也侧面印证了社区对这类工具的强烈需求。但很多教程要么过于零散要么只讲操作不讲原理遇到问题就束手无策。在这篇分享里我将结合自己多次使用和调试XUnity AutoTranslator的经验不仅带你走通从零开始的完整配置流程更会深入拆解其工作原理、不同场景下的配置要点以及那些教程里不会写的“坑”和独家优化技巧。无论你是想为自己喜欢的游戏制作一个汉化补丁还是想研究Unity游戏的资源与文本加载机制这篇文章都能给你提供一份详实的参考。2. 核心原理与架构拆解文本如何被“劫持”与替换在开始动手之前理解XUnity AutoTranslator后文简称XUAT是如何工作的至关重要。这能帮助你在遇到各种奇怪问题时快速定位根源而不是盲目尝试。它的核心原理可以概括为“钩子Hook拦截 缓存翻译”。2.1 Unity的文本渲染流程与拦截点Unity游戏中的文本绝大多数是通过UnityEngine.UI.Text或TextMeshProTMP组件来显示的。游戏逻辑会设置这些组件的text属性然后由Unity的渲染系统将其绘制到屏幕上。XUAT的核心是一个运行在游戏进程内的“外挂”插件通常以BepInEx插件形式存在。它利用了Harmony这个强大的.NET库函数补丁库。Harmony允许在运行时修改已编译程序集的方法。XUAT使用Harmony在游戏启动时将“钩子”注入到关键的方法上例如Text.set_text或TMP_Text.set_text。当游戏代码试图设置一个文本内容时比如myTextComponent.text “Hello World”;这个调用并不会直接执行原始的逻辑而是先“拐个弯”流经XUAT注入的钩子代码。XUAT的钩子会检查这段文本之前翻译过吗翻译结果缓存了吗根据配置决定是立即翻译还是等待玩家触发最终钩子代码将翻译后的文本或决定保留的原文本设置回组件从而完成了一次“偷梁换柱”。2.2 核心工作流程与组件理解了拦截点我们来看一次完整的翻译请求是如何流转的文本拦截游戏尝试更新UI文本被XUAT的Harmony补丁拦截。文本预处理XUAT对原始文本进行清理比如移除富文本标签如colorred、处理特殊字符生成一个用于查询的“键”。缓存查询XUAT维护一个本地的翻译缓存文件通常是Translation.txt。它首先用这个“键”去缓存里查找是否已有翻译。如果有直接使用缓存结果跳至第6步。这是实现离线翻译和提升速度的关键。翻译请求如果缓存未命中且在线翻译功能已启用XUAT会根据配置将清理后的文本发送到指定的在线翻译服务API如Google Translate。结果处理与缓存收到翻译服务返回的结果后XUAT会进行后处理如重新添加回之前移除的富文本标签然后将“原始文本-翻译文本”这对映射关系保存到本地缓存文件中。这样下次再遇到相同文本就无需联网了。文本替换将最终处理好的文本设置回UI组件完成渲染。整个架构是典型的生产者-消费者模型并且高度可配置。你可以关闭在线翻译纯使用离线缓存文件这就是汉化补丁的形态也可以调整翻译触发方式如按快捷键翻译当前屏幕文本。注意这种基于运行时Hook的方式虽然强大但也带来一些固有局限。它无法翻译那些直接以纹理图片形式存在的文字比如游戏Logo、部分手写体提示也无法处理动态生成且不通过标准UI组件显示的文本。对于这些情况往往需要更底层的纹理替换或OCR方案这已超出了XUAT的能力范围。3. 环境准备与工具选型搭建你的汉化工作台工欲善其事必先利其器。使用XUAT前你需要根据目标游戏的环境准备好相应的“工作台”。这里主要分为两大类场景为已安装的游戏实时汉化以及制作可分发的独立汉化补丁。3.1 运行时汉化BepInEx 与 MelonLoader 之争XUAT需要一个“加载器”来将它注入到游戏进程。在Unity游戏Mod社区最主流的是BepInEx和MelonLoader。BepInEx老牌、稳定、兼容性极广是大多数Unity游戏Mod的首选框架。它的插件管理清晰日志系统完善。绝大多数情况下推荐使用BepInEx。你需要下载与游戏架构x86或x64匹配的BepInEx版本将其文件解压到游戏根目录即与GameName.exe同级的位置。MelonLoader较新的框架设计更现代对.NET Core/5的Unity游戏支持更好。如果你的目标游戏是较新版本Unity编译如使用了IL2CPP后端可能需要优先尝试MelonLoader。但它的配置相对BepInEx稍复杂一些。如何选择首先查看游戏社区如Nexus Mods, GitHub的讨论看其他Mod作者主要使用哪个框架。其次可以尝试一个简单的方法查看游戏根目录下是否有UnityPlayer.dll通常为Mono后端或GameAssembly.dll通常为IL2CPP后端。对于Mono游戏BepInEx是稳妥的选择对于IL2CPP游戏两者都可能但MelonLoader有时更具优势。3.2 XUnity.AutoTranslator 插件获取与放置XUAT本身是一个插件。你需要从GitHub的发布页面下载最新版本的XUnity.AutoTranslator-BepInEx-5.x.x.x.zip对应BepInEx 5或MelonLoader版本。将下载的zip文件解压。把解压后得到的BepInEx文件夹里面包含plugins目录整体合并到游戏根目录下已存在的BepInEx文件夹中。确保XUnity.AutoTranslator.dll最终位于游戏根目录\BepInEx\plugins\下。首次运行游戏BepInEx会完成初始化并生成完整的配置文件目录。关闭游戏后你会在BepInEx\config下找到AutoTranslatorConfig.ini这就是核心配置文件。3.3 翻译引擎的选择与配置XUAT支持多种翻译服务你需要选择一个并配置API密钥如果需要。谷歌翻译免费但不稳定XUAT内置了谷歌翻译的公共端点但该端点速率限制严格极易被屏蔽导致翻译失败。仅适合测试或极少量文本。百度翻译API推荐对于中文用户百度翻译是可靠的选择。你需要注册百度云账号开通“通用翻译API”服务获得AppID和密钥。在配置文件中指定服务商为BaiduTranslate并填入密钥即可。它有免费额度超出后费用也很低廉。DeepL API质量高但收费翻译质量公认最佳尤其是欧洲语言。需要付费订阅获取API密钥。离线引擎如内置的PretranslateFile完全不依赖网络直接从你准备好的Translation.txt缓存文件中读取翻译。这是制作最终汉化补丁的模式。配置示例百度翻译 在AutoTranslatorConfig.ini中修改以下关键字段[Service] ; 指定使用的翻译服务 ServiceBaduTranslate ; 百度翻译的端点一般无需修改 Endpoint [Badu] ; 填入你在百度云控制台获得的AppID AppId你的百度AppID ; 填入你的密钥 SecretKey你的百度SecretKey重要提示将API密钥直接写在配置文件中如果补丁要分发务必提醒用户自行申请和填写切勿泄露自己的密钥。4. 详细配置与实战调优从能用变到好用配置文件AutoTranslatorConfig.ini是XUAT的大脑默认配置可能并不适合所有游戏。下面针对几个关键部分进行调优解析。4.1 核心配置节详解[General]节Language目标语言填zh表示简体中文。注意某些服务可能需要zh-CN。MaxCharactersPerTranslation单次翻译请求的最大字符数。谷歌、百度都有单次请求长度限制如5000字符。如果游戏文本块很长需要调低此值但会增加请求次数。DelaySecondsAfterLoad游戏场景加载后等待多少秒再开始自动翻译。有些游戏UI是动态加载的设置一个1-3秒的延迟可以避免漏翻。[TextFraming]节这部分处理如何从游戏内存中“捕捉”文本。对于老旧或非标准UI的游戏可能需要启用EnableTextFraming并调整参数但通常默认即可。[Speech]节如果游戏有字幕Subtitles可以在这里配置是否翻译。注意语音Audio本身是无法翻译的。4.2 翻译触发模式自动、手动与混合这是影响用户体验的关键设置在[General]节中配置。TranslationDelay设置为0则是全自动模式。游戏内所有被拦截的文本会立即尝试翻译。优点是省心缺点是可能导致游戏初期因大量翻译请求而卡顿且可能翻译一些不需要的文本如代码标识符。TranslationDelay设置为一个较大的值如99999并配合EnableTranslationHotkeytrue则是纯手动模式。只有当你按下配置的热键如F8时当前屏幕上的文本才会被翻译。适合希望精细控制、或网络环境差的用户。推荐混合模式。设置TranslationDelay0.5半秒并启用热键。这样游戏运行后非紧急的文本会等待半秒再尝试翻译减少了初始冲击。对于漏翻或翻译不满意的文本你随时可以用热键强制重新翻译当前屏幕内容。这平衡了便利性和性能。4.3 缓存文件管理与汉化补丁制作Translation.txt文件是XUAT的翻译记忆库位于BepInEx\Translation\zh\Text目录下。它的格式很简单原始文本1 翻译文本1 原始文本2 翻译文本2 每对翻译由一个空行或符号分隔。如何制作汉化补丁自己从头玩一遍游戏让XUAT自动翻译并生成缓存。但这样会混杂很多不必要或翻译不佳的条目。专业做法使用XUAT提供的ResourceRedirector功能另一个配套插件。它可以导出游戏中的所有文本资源到一个文本文件。你拿到这个“原文全集”后可以用CAT计算机辅助翻译工具或找团队进行专业翻译、校对生成一个准确、干净的Translation.txt。将最终校对好的Translation.txt、AutoTranslatorConfig.ini配置中设置ServicePretranslateFile并关闭在线翻译以及必要的插件DLL文件打包。这就是一个可以分发的离线汉化补丁。用户只需将其放入自己的游戏BepInEx目录下无需配置API即可享受汉化。4.4 针对特殊游戏引擎的适配一些基于Unity但做了深度定制的游戏引擎如Ren‘Py的某些Unity移植版、RPG Maker MV的Unity版本其文本加载方式可能比较特殊。如果XUAT标准配置无效可以尝试在配置文件中启用[TextFraming]下的实验性选项如EnableAsyncCapturing。检查游戏是否使用了TextMeshPro。XUAT对TMP有原生支持但确保配置中相关选项已启用。查看BepInEx生成的LogOutput.log文件。如果XUAT成功注入日志里会有相关信息如果文本被拦截但未翻译日志可能会给出原因如服务不可用、文本被过滤。日志是你排查问题的第一手资料。5. 高级技巧与疑难排坑实录在实际使用中你肯定会遇到各种各样的问题。下面分享一些从实战中积累的经验和解决方案。5.1 常见问题速查表问题现象可能原因排查与解决思路游戏启动崩溃或BepInEx控制台一闪而过1. BepInEx版本与游戏不兼容如x86/x64错误。2. 游戏使用了反作弊或完整性校验。1. 确认游戏是32位还是64位下载对应版本的BepInEx。2. 尝试使用winhttp.dll代理方式的BepInEx安装。3. 查看游戏根目录下BepInEx\LogOutput.log的末尾错误信息。游戏能运行但没有任何文本被翻译1. XUAT插件未正确加载。2. 配置文件Language未设置或错误。3. 游戏文本渲染方式特殊未被钩住。1. 检查BepInEx\plugins\下是否有XUnity.AutoTranslator.dll。2. 检查AutoTranslatorConfig.ini中Language是否设为zh。3. 尝试在游戏中按默认热键F8手动触发翻译。4. 查看BepInEx\LogOutput.log搜索“AutoTranslator”看是否有加载和拦截日志。部分文本翻译了部分没翻译1. 文本是图片纹理。2. 文本在插件加载后才动态生成。3. 文本包含特殊字符或格式被过滤。1. 对于图片文字无解需其他纹理替换方案。2. 尝试增大[General]下的DelaySecondsAfterLoad值。3. 检查[TextFraming]过滤规则或尝试关闭EnableRegexFiltering。翻译速度慢游戏卡顿1. 在线翻译API响应慢或频繁被限流。2.MaxCharactersPerTranslation设置过高导致大文本块翻译超时。3. 全自动模式 (TranslationDelay0) 下初始翻译请求过多。1. 换用更稳定的翻译服务如百度或使用离线缓存模式。2. 将该值调低至1000或500。3. 采用“混合模式”设置TranslationDelay0.5~1。翻译结果质量差或错误1. 在线翻译引擎本身的问题。2. 游戏文本被截断上下文缺失。3. 富文本标签如颜色、大小破坏了句子结构。1. 换用DeepL等高质量引擎如需。2. XUAT会尽量保持上下文但动态拼接的句子翻译效果难以保证。3. XUAT会在翻译前剥离标签翻译后加回一般能正确处理。翻译缓存 (Translation.txt) 不生效1. 缓存文件不在正确路径或编码错误。2. 配置文件未设置ServicePretranslateFile。3. 原始文本有细微差别如多余空格。1. 确认文件在BepInEx\Translation\zh\Text\下编码为UTF-8。2. 在线模式下新文本会优先请求在线翻译并更新缓存。检查在线服务是否配置正确。3. 使用文本编辑器的“显示所有字符”功能比对缓存中的原文和游戏中的原文是否完全一致。5.2 性能优化与体验提升技巧预翻译与批量生成缓存如果你在制作汉化补丁可以在自己的机器上开启在线翻译完整地体验一遍游戏或使用自动点击工具遍历所有UI。这样能生成一个覆盖全面的Translation.txt。之后分发时让用户使用离线模式即可获得流畅的体验且不依赖网络和API限额。精细化过滤不需要的文本游戏里可能有很多你不希望翻译的文本比如内部ID、代码变量名、文件路径等。在AutoTranslatorConfig.ini的[General]节可以使用RegexFilter选项通过正则表达式来过滤掉这些文本。例如过滤掉纯数字和包含下划线的文本RegexFilter^\d$|.*_.*。这能减少不必要的翻译请求和缓存污染。处理特殊格式文本有些游戏文本带有类似{0}、{PLAYERNAME}的占位符。你需要确保翻译后的文本保留这些占位符且顺序正确。XUAT通常能自动处理但如果发现翻译后游戏崩溃或显示异常检查缓存文件中翻译文本的占位符是否完整。管理多个游戏的配置如果你经常为多个游戏使用XUAT每个游戏的配置和缓存都是独立的。建议为每个游戏建立一个独立的配置文件备份。XUAT也支持通过命令行参数指定配置文件路径对于高级用户可以编写启动脚本来自动化管理。5.3 从玩家到贡献者参与社区汉化XUAT最大的价值之一是降低了社区协作汉化的门槛。你不需要会编程只需要玩游戏就能为Translation.txt贡献翻译。纠错与改进在游戏过程中如果发现某句翻译生硬或有误你可以直接打开BepInEx\Translation\zh\Text\Translation.txt文件搜索原文修改其后的翻译文本。保存后重启游戏或重新加载场景就能看到效果。共享缓存将你校对、优化后的Translation.txt分享到游戏社区如贴吧、Nexus Mods可以帮助其他玩家。注意分享前请务必清除配置文件中的个人API密钥并注明翻译引擎和可能的注意事项。协作翻译对于大型游戏文本量巨大。社区可以组织多人使用支持导入导出Translation.txt格式的CAT工具如OmegaT进行分工翻译最后再合并成一个完整的文件效率远高于单人作战。6. 安全、伦理与法律边界探讨在使用和分发基于XUAT的汉化补丁时我们必须清醒地认识到其存在的灰色地带并尽量遵守社区规范。尊重知识产权XUAT和汉化补丁应仅用于个人学习、研究和体验游戏的目的。任何商业性使用、贩卖汉化补丁的行为都是明确侵权的。优秀的社区汉化组都会在补丁中明确标注“仅供学习交流请在下载后24小时内删除”等字样。不破坏多人游戏体验绝对不要在多人联机游戏中使用此类内存修改工具。这很可能违反游戏的服务条款被视为作弊行为导致封号。XUAT应只用于纯单人游戏体验。谨慎使用在线API使用谷歌、百度等翻译API时请遵守其服务条款。不要滥用公共免费接口合理控制请求频率避免因请求过多导致IP被禁。对于分发补丁强烈建议使用离线缓存模式避免将终端用户暴露在API密钥配置和网络请求的问题下。明确工具的局限性XUAT不是万能的对于图片文字、加密或混淆严重的文本、以及某些使用非常规渲染技术的游戏它可能完全无效。向其他玩家说明情况可以避免不必要的期待和抱怨。最后我想说的是XUnity AutoTranslator 代表的是一种“玩家驱动”的本地化精神。它绕过了官方支持的漫长等待让语言不再成为体验优秀作品的障碍。作为使用者我们享受了便利作为有能力者我们也可以通过贡献翻译、分享经验来回馈社区。技术的乐趣不仅在于使用更在于理解、改造和分享。希望这篇超详细的指南能帮你真正掌握这把“利器”无论是为了自己畅玩还是为社区添砖加瓦都能得心应手。如果在实际操作中遇到了上面没覆盖的奇怪问题别忘了BepInEx的日志文件和XUAT的GitHub Issues页面永远是你最好的老师。 Unity游戏实时汉化神器XUnity AutoTranslator：原理、配置与实战指南
1. 项目概述当Unity游戏遇上自动翻译如果你是一名Unity游戏开发者或者是一位热衷于体验全球独立游戏的玩家那么“语言不通”这个问题大概率是你绕不开的痛点。开发者可能苦于如何高效地将自己的作品推向不同语言的玩家群体而玩家则常常对着心仪却只有外文的游戏望而却步。手动汉化那意味着需要反编译、找文本、翻译、再打包过程繁琐且门槛极高。今天要聊的就是一个在Unity游戏社区里流传已久堪称“神器”级的解决方案——XUnity AutoTranslator也就是大家常说的XUnity自动翻译器。简单来说这是一个能够为Unity引擎开发的游戏包括PC、安卓等平台实现实时、自动文本翻译的插件。它的核心魅力在于“自动”二字你不需要是程序员也不需要动游戏的原始代码通过简单的配置它就能在游戏运行时拦截游戏引擎渲染的文本调用在线翻译API如谷歌、百度、DeepL等进行翻译并将翻译结果即时显示在游戏界面上。对于玩家这意味着可以几乎无门槛地“汉化”那些没有官方中文的游戏对于开发者这提供了一个快速验证多语言版本或制作非官方社区汉化补丁的强力工具。网络上关于“xunity翻译工具”、“unity游戏汉化”的搜索热度一直很高也侧面印证了社区对这类工具的强烈需求。但很多教程要么过于零散要么只讲操作不讲原理遇到问题就束手无策。在这篇分享里我将结合自己多次使用和调试XUnity AutoTranslator的经验不仅带你走通从零开始的完整配置流程更会深入拆解其工作原理、不同场景下的配置要点以及那些教程里不会写的“坑”和独家优化技巧。无论你是想为自己喜欢的游戏制作一个汉化补丁还是想研究Unity游戏的资源与文本加载机制这篇文章都能给你提供一份详实的参考。2. 核心原理与架构拆解文本如何被“劫持”与替换在开始动手之前理解XUnity AutoTranslator后文简称XUAT是如何工作的至关重要。这能帮助你在遇到各种奇怪问题时快速定位根源而不是盲目尝试。它的核心原理可以概括为“钩子Hook拦截 缓存翻译”。2.1 Unity的文本渲染流程与拦截点Unity游戏中的文本绝大多数是通过UnityEngine.UI.Text或TextMeshProTMP组件来显示的。游戏逻辑会设置这些组件的text属性然后由Unity的渲染系统将其绘制到屏幕上。XUAT的核心是一个运行在游戏进程内的“外挂”插件通常以BepInEx插件形式存在。它利用了Harmony这个强大的.NET库函数补丁库。Harmony允许在运行时修改已编译程序集的方法。XUAT使用Harmony在游戏启动时将“钩子”注入到关键的方法上例如Text.set_text或TMP_Text.set_text。当游戏代码试图设置一个文本内容时比如myTextComponent.text “Hello World”;这个调用并不会直接执行原始的逻辑而是先“拐个弯”流经XUAT注入的钩子代码。XUAT的钩子会检查这段文本之前翻译过吗翻译结果缓存了吗根据配置决定是立即翻译还是等待玩家触发最终钩子代码将翻译后的文本或决定保留的原文本设置回组件从而完成了一次“偷梁换柱”。2.2 核心工作流程与组件理解了拦截点我们来看一次完整的翻译请求是如何流转的文本拦截游戏尝试更新UI文本被XUAT的Harmony补丁拦截。文本预处理XUAT对原始文本进行清理比如移除富文本标签如colorred、处理特殊字符生成一个用于查询的“键”。缓存查询XUAT维护一个本地的翻译缓存文件通常是Translation.txt。它首先用这个“键”去缓存里查找是否已有翻译。如果有直接使用缓存结果跳至第6步。这是实现离线翻译和提升速度的关键。翻译请求如果缓存未命中且在线翻译功能已启用XUAT会根据配置将清理后的文本发送到指定的在线翻译服务API如Google Translate。结果处理与缓存收到翻译服务返回的结果后XUAT会进行后处理如重新添加回之前移除的富文本标签然后将“原始文本-翻译文本”这对映射关系保存到本地缓存文件中。这样下次再遇到相同文本就无需联网了。文本替换将最终处理好的文本设置回UI组件完成渲染。整个架构是典型的生产者-消费者模型并且高度可配置。你可以关闭在线翻译纯使用离线缓存文件这就是汉化补丁的形态也可以调整翻译触发方式如按快捷键翻译当前屏幕文本。注意这种基于运行时Hook的方式虽然强大但也带来一些固有局限。它无法翻译那些直接以纹理图片形式存在的文字比如游戏Logo、部分手写体提示也无法处理动态生成且不通过标准UI组件显示的文本。对于这些情况往往需要更底层的纹理替换或OCR方案这已超出了XUAT的能力范围。3. 环境准备与工具选型搭建你的汉化工作台工欲善其事必先利其器。使用XUAT前你需要根据目标游戏的环境准备好相应的“工作台”。这里主要分为两大类场景为已安装的游戏实时汉化以及制作可分发的独立汉化补丁。3.1 运行时汉化BepInEx 与 MelonLoader 之争XUAT需要一个“加载器”来将它注入到游戏进程。在Unity游戏Mod社区最主流的是BepInEx和MelonLoader。BepInEx老牌、稳定、兼容性极广是大多数Unity游戏Mod的首选框架。它的插件管理清晰日志系统完善。绝大多数情况下推荐使用BepInEx。你需要下载与游戏架构x86或x64匹配的BepInEx版本将其文件解压到游戏根目录即与GameName.exe同级的位置。MelonLoader较新的框架设计更现代对.NET Core/5的Unity游戏支持更好。如果你的目标游戏是较新版本Unity编译如使用了IL2CPP后端可能需要优先尝试MelonLoader。但它的配置相对BepInEx稍复杂一些。如何选择首先查看游戏社区如Nexus Mods, GitHub的讨论看其他Mod作者主要使用哪个框架。其次可以尝试一个简单的方法查看游戏根目录下是否有UnityPlayer.dll通常为Mono后端或GameAssembly.dll通常为IL2CPP后端。对于Mono游戏BepInEx是稳妥的选择对于IL2CPP游戏两者都可能但MelonLoader有时更具优势。3.2 XUnity.AutoTranslator 插件获取与放置XUAT本身是一个插件。你需要从GitHub的发布页面下载最新版本的XUnity.AutoTranslator-BepInEx-5.x.x.x.zip对应BepInEx 5或MelonLoader版本。将下载的zip文件解压。把解压后得到的BepInEx文件夹里面包含plugins目录整体合并到游戏根目录下已存在的BepInEx文件夹中。确保XUnity.AutoTranslator.dll最终位于游戏根目录\BepInEx\plugins\下。首次运行游戏BepInEx会完成初始化并生成完整的配置文件目录。关闭游戏后你会在BepInEx\config下找到AutoTranslatorConfig.ini这就是核心配置文件。3.3 翻译引擎的选择与配置XUAT支持多种翻译服务你需要选择一个并配置API密钥如果需要。谷歌翻译免费但不稳定XUAT内置了谷歌翻译的公共端点但该端点速率限制严格极易被屏蔽导致翻译失败。仅适合测试或极少量文本。百度翻译API推荐对于中文用户百度翻译是可靠的选择。你需要注册百度云账号开通“通用翻译API”服务获得AppID和密钥。在配置文件中指定服务商为BaiduTranslate并填入密钥即可。它有免费额度超出后费用也很低廉。DeepL API质量高但收费翻译质量公认最佳尤其是欧洲语言。需要付费订阅获取API密钥。离线引擎如内置的PretranslateFile完全不依赖网络直接从你准备好的Translation.txt缓存文件中读取翻译。这是制作最终汉化补丁的模式。配置示例百度翻译 在AutoTranslatorConfig.ini中修改以下关键字段[Service] ; 指定使用的翻译服务 ServiceBaduTranslate ; 百度翻译的端点一般无需修改 Endpoint [Badu] ; 填入你在百度云控制台获得的AppID AppId你的百度AppID ; 填入你的密钥 SecretKey你的百度SecretKey重要提示将API密钥直接写在配置文件中如果补丁要分发务必提醒用户自行申请和填写切勿泄露自己的密钥。4. 详细配置与实战调优从能用变到好用配置文件AutoTranslatorConfig.ini是XUAT的大脑默认配置可能并不适合所有游戏。下面针对几个关键部分进行调优解析。4.1 核心配置节详解[General]节Language目标语言填zh表示简体中文。注意某些服务可能需要zh-CN。MaxCharactersPerTranslation单次翻译请求的最大字符数。谷歌、百度都有单次请求长度限制如5000字符。如果游戏文本块很长需要调低此值但会增加请求次数。DelaySecondsAfterLoad游戏场景加载后等待多少秒再开始自动翻译。有些游戏UI是动态加载的设置一个1-3秒的延迟可以避免漏翻。[TextFraming]节这部分处理如何从游戏内存中“捕捉”文本。对于老旧或非标准UI的游戏可能需要启用EnableTextFraming并调整参数但通常默认即可。[Speech]节如果游戏有字幕Subtitles可以在这里配置是否翻译。注意语音Audio本身是无法翻译的。4.2 翻译触发模式自动、手动与混合这是影响用户体验的关键设置在[General]节中配置。TranslationDelay设置为0则是全自动模式。游戏内所有被拦截的文本会立即尝试翻译。优点是省心缺点是可能导致游戏初期因大量翻译请求而卡顿且可能翻译一些不需要的文本如代码标识符。TranslationDelay设置为一个较大的值如99999并配合EnableTranslationHotkeytrue则是纯手动模式。只有当你按下配置的热键如F8时当前屏幕上的文本才会被翻译。适合希望精细控制、或网络环境差的用户。推荐混合模式。设置TranslationDelay0.5半秒并启用热键。这样游戏运行后非紧急的文本会等待半秒再尝试翻译减少了初始冲击。对于漏翻或翻译不满意的文本你随时可以用热键强制重新翻译当前屏幕内容。这平衡了便利性和性能。4.3 缓存文件管理与汉化补丁制作Translation.txt文件是XUAT的翻译记忆库位于BepInEx\Translation\zh\Text目录下。它的格式很简单原始文本1 翻译文本1 原始文本2 翻译文本2 每对翻译由一个空行或符号分隔。如何制作汉化补丁自己从头玩一遍游戏让XUAT自动翻译并生成缓存。但这样会混杂很多不必要或翻译不佳的条目。专业做法使用XUAT提供的ResourceRedirector功能另一个配套插件。它可以导出游戏中的所有文本资源到一个文本文件。你拿到这个“原文全集”后可以用CAT计算机辅助翻译工具或找团队进行专业翻译、校对生成一个准确、干净的Translation.txt。将最终校对好的Translation.txt、AutoTranslatorConfig.ini配置中设置ServicePretranslateFile并关闭在线翻译以及必要的插件DLL文件打包。这就是一个可以分发的离线汉化补丁。用户只需将其放入自己的游戏BepInEx目录下无需配置API即可享受汉化。4.4 针对特殊游戏引擎的适配一些基于Unity但做了深度定制的游戏引擎如Ren‘Py的某些Unity移植版、RPG Maker MV的Unity版本其文本加载方式可能比较特殊。如果XUAT标准配置无效可以尝试在配置文件中启用[TextFraming]下的实验性选项如EnableAsyncCapturing。检查游戏是否使用了TextMeshPro。XUAT对TMP有原生支持但确保配置中相关选项已启用。查看BepInEx生成的LogOutput.log文件。如果XUAT成功注入日志里会有相关信息如果文本被拦截但未翻译日志可能会给出原因如服务不可用、文本被过滤。日志是你排查问题的第一手资料。5. 高级技巧与疑难排坑实录在实际使用中你肯定会遇到各种各样的问题。下面分享一些从实战中积累的经验和解决方案。5.1 常见问题速查表问题现象可能原因排查与解决思路游戏启动崩溃或BepInEx控制台一闪而过1. BepInEx版本与游戏不兼容如x86/x64错误。2. 游戏使用了反作弊或完整性校验。1. 确认游戏是32位还是64位下载对应版本的BepInEx。2. 尝试使用winhttp.dll代理方式的BepInEx安装。3. 查看游戏根目录下BepInEx\LogOutput.log的末尾错误信息。游戏能运行但没有任何文本被翻译1. XUAT插件未正确加载。2. 配置文件Language未设置或错误。3. 游戏文本渲染方式特殊未被钩住。1. 检查BepInEx\plugins\下是否有XUnity.AutoTranslator.dll。2. 检查AutoTranslatorConfig.ini中Language是否设为zh。3. 尝试在游戏中按默认热键F8手动触发翻译。4. 查看BepInEx\LogOutput.log搜索“AutoTranslator”看是否有加载和拦截日志。部分文本翻译了部分没翻译1. 文本是图片纹理。2. 文本在插件加载后才动态生成。3. 文本包含特殊字符或格式被过滤。1. 对于图片文字无解需其他纹理替换方案。2. 尝试增大[General]下的DelaySecondsAfterLoad值。3. 检查[TextFraming]过滤规则或尝试关闭EnableRegexFiltering。翻译速度慢游戏卡顿1. 在线翻译API响应慢或频繁被限流。2.MaxCharactersPerTranslation设置过高导致大文本块翻译超时。3. 全自动模式 (TranslationDelay0) 下初始翻译请求过多。1. 换用更稳定的翻译服务如百度或使用离线缓存模式。2. 将该值调低至1000或500。3. 采用“混合模式”设置TranslationDelay0.5~1。翻译结果质量差或错误1. 在线翻译引擎本身的问题。2. 游戏文本被截断上下文缺失。3. 富文本标签如颜色、大小破坏了句子结构。1. 换用DeepL等高质量引擎如需。2. XUAT会尽量保持上下文但动态拼接的句子翻译效果难以保证。3. XUAT会在翻译前剥离标签翻译后加回一般能正确处理。翻译缓存 (Translation.txt) 不生效1. 缓存文件不在正确路径或编码错误。2. 配置文件未设置ServicePretranslateFile。3. 原始文本有细微差别如多余空格。1. 确认文件在BepInEx\Translation\zh\Text\下编码为UTF-8。2. 在线模式下新文本会优先请求在线翻译并更新缓存。检查在线服务是否配置正确。3. 使用文本编辑器的“显示所有字符”功能比对缓存中的原文和游戏中的原文是否完全一致。5.2 性能优化与体验提升技巧预翻译与批量生成缓存如果你在制作汉化补丁可以在自己的机器上开启在线翻译完整地体验一遍游戏或使用自动点击工具遍历所有UI。这样能生成一个覆盖全面的Translation.txt。之后分发时让用户使用离线模式即可获得流畅的体验且不依赖网络和API限额。精细化过滤不需要的文本游戏里可能有很多你不希望翻译的文本比如内部ID、代码变量名、文件路径等。在AutoTranslatorConfig.ini的[General]节可以使用RegexFilter选项通过正则表达式来过滤掉这些文本。例如过滤掉纯数字和包含下划线的文本RegexFilter^\d$|.*_.*。这能减少不必要的翻译请求和缓存污染。处理特殊格式文本有些游戏文本带有类似{0}、{PLAYERNAME}的占位符。你需要确保翻译后的文本保留这些占位符且顺序正确。XUAT通常能自动处理但如果发现翻译后游戏崩溃或显示异常检查缓存文件中翻译文本的占位符是否完整。管理多个游戏的配置如果你经常为多个游戏使用XUAT每个游戏的配置和缓存都是独立的。建议为每个游戏建立一个独立的配置文件备份。XUAT也支持通过命令行参数指定配置文件路径对于高级用户可以编写启动脚本来自动化管理。5.3 从玩家到贡献者参与社区汉化XUAT最大的价值之一是降低了社区协作汉化的门槛。你不需要会编程只需要玩游戏就能为Translation.txt贡献翻译。纠错与改进在游戏过程中如果发现某句翻译生硬或有误你可以直接打开BepInEx\Translation\zh\Text\Translation.txt文件搜索原文修改其后的翻译文本。保存后重启游戏或重新加载场景就能看到效果。共享缓存将你校对、优化后的Translation.txt分享到游戏社区如贴吧、Nexus Mods可以帮助其他玩家。注意分享前请务必清除配置文件中的个人API密钥并注明翻译引擎和可能的注意事项。协作翻译对于大型游戏文本量巨大。社区可以组织多人使用支持导入导出Translation.txt格式的CAT工具如OmegaT进行分工翻译最后再合并成一个完整的文件效率远高于单人作战。6. 安全、伦理与法律边界探讨在使用和分发基于XUAT的汉化补丁时我们必须清醒地认识到其存在的灰色地带并尽量遵守社区规范。尊重知识产权XUAT和汉化补丁应仅用于个人学习、研究和体验游戏的目的。任何商业性使用、贩卖汉化补丁的行为都是明确侵权的。优秀的社区汉化组都会在补丁中明确标注“仅供学习交流请在下载后24小时内删除”等字样。不破坏多人游戏体验绝对不要在多人联机游戏中使用此类内存修改工具。这很可能违反游戏的服务条款被视为作弊行为导致封号。XUAT应只用于纯单人游戏体验。谨慎使用在线API使用谷歌、百度等翻译API时请遵守其服务条款。不要滥用公共免费接口合理控制请求频率避免因请求过多导致IP被禁。对于分发补丁强烈建议使用离线缓存模式避免将终端用户暴露在API密钥配置和网络请求的问题下。明确工具的局限性XUAT不是万能的对于图片文字、加密或混淆严重的文本、以及某些使用非常规渲染技术的游戏它可能完全无效。向其他玩家说明情况可以避免不必要的期待和抱怨。最后我想说的是XUnity AutoTranslator 代表的是一种“玩家驱动”的本地化精神。它绕过了官方支持的漫长等待让语言不再成为体验优秀作品的障碍。作为使用者我们享受了便利作为有能力者我们也可以通过贡献翻译、分享经验来回馈社区。技术的乐趣不仅在于使用更在于理解、改造和分享。希望这篇超详细的指南能帮你真正掌握这把“利器”无论是为了自己畅玩还是为社区添砖加瓦都能得心应手。如果在实际操作中遇到了上面没覆盖的奇怪问题别忘了BepInEx的日志文件和XUAT的GitHub Issues页面永远是你最好的老师。