1. 项目概述为什么我们需要XUnity自动翻译器如果你是一个喜欢玩独立游戏或者某些特定类型PC游戏的玩家肯定遇到过这种情况一款游戏玩法、美术都深得你心但偏偏没有中文。开发者可能来自一个非英语国家游戏文本是日语、韩语、俄语甚至是小众的东欧语言。对着满屏的天书再好的游戏体验也大打折扣。手动截图、丢进翻译软件、再对照着玩这种体验太割裂了几分钟就会让人放弃。XUnity AutoTranslator后文简称XUAT就是为了解决这个痛点而生的。它不是一个独立的软件而是一个运行在游戏进程内的插件。它的核心工作流程非常直接实时拦截游戏引擎主要是Unity在屏幕上绘制文本的调用将获取到的原始文本发送到你指定的翻译服务如谷歌翻译、百度翻译、DeepL等然后将翻译结果“覆盖”绘制在原文本的位置。对你而言你看到的就是即时翻译后的中文或其他目标语言文本仿佛游戏原生支持一样。这个工具的价值远不止于“玩游戏更方便”。对于游戏社区汉化组、内容创作者、甚至是希望学习某语言但想借助游戏环境的用户它都提供了一个低成本、高效率的解决方案。它绕过了传统汉化需要解包、分析资源、修改文本再封包的复杂流程实现了“即插即用”的动态翻译。当然它并非万能其翻译质量依赖于后端引擎且对图片形式的UI文字无能为力。但无论如何对于文本驱动的叙事类、策略类或RPG游戏它无疑是打开语言壁垒的一把利器。2. 核心原理与架构拆解它如何实现“无痕”翻译要理解XUAT首先得明白Unity游戏是如何显示文字的。简单来说当游戏需要显示一段对话“Hello World”时代码会调用Unity的UI系统可能是UGUI、NGUI或更老的OnGUI的文本渲染组件传入字符串“Hello World”和屏幕坐标等信息。显卡最终将这些信息渲染成像素呈现在你眼前。XUAT的介入就发生在这个“传入字符串”的环节。它利用了Unity游戏一个常见的技术框架——BepInEx。BepInEx是一个Unity游戏的插件加载器和修改框架它允许我们在游戏运行时向游戏代码中注入我们自己的逻辑即“插件”。XUAT作为一个BepInEx插件主要做了以下几件事2.1 文本钩取Hooking这是最核心的技术。XUAT会寻找Unity引擎中负责最终文本渲染的几个关键方法。例如对于UGUI它可能会钩住UnityEngine.UI.Text组件的set_text属性对于传统的OnGUI则会钩住GUI.Label,GUI.Button等方法。通过钩子Hook当游戏调用这些方法准备显示文本时控制权会先转移到XUAT的代码里。2.2 文本缓存与翻译XUAT拿到原始文本后不会立刻放行。它首先检查自己的本地缓存文件通常是一个Translation.txt或类似文件。这个文件里存储着“原文-译文”的映射对。如果找到了匹配项就直接使用缓存译文速度极快。如果没找到它就会启动翻译流程将原文发送到配置好的在线翻译API获取译文然后将这对映射存入缓存文件以备下次使用。这个过程可以是同步的导致游戏卡顿一下也可以是异步的译文稍后显示取决于配置。2.3 文本替换与渲染获取到译文后XUAT会修改原本要传递给Unity渲染方法的参数将原文替换成译文。然后游戏引擎照常渲染但画在屏幕上的就已经是翻译后的文字了。由于替换发生在渲染链的最上游游戏本身的逻辑、字体样式、位置布局都不会被破坏实现了视觉上的“无痕”整合。2.4 配置与扩展性XUAT的强大之处在于其高度的可配置性。通过修改配置文件BepInEx/config/AutoTranslatorConfig.ini你可以选择翻译引擎支持Google Translate、Baidu Translate、DeepL、Yandex等甚至支持自定义URL用于调用一些本地部署的AI翻译API。管理缓存可以导出/导入缓存文件方便分享汉化补丁。你也可以手动编辑这个文本文件对机器翻译的结果进行人工润色和修正实现“半自动”精翻。设置触发方式可以设置为按快捷键如F2翻译当前屏幕文本或全自动翻译。过滤与排除可以设置正则表达式排除不需要翻译的文本如版本号、代码、专有名词。这种架构决定了XUAT是一个“通用型”解决方案。只要游戏使用Unity引擎并且文本是通过Unity的标准API渲染的理论上XUAT都能生效。这也是为什么它在独立游戏和GalGame社区如此流行的原因。3. 完整实操指南从零开始汉化你的第一款游戏理论讲完我们动手。假设我们要汉化一款名为“MyUnityGame”的独立游戏。请确保你已拥有游戏的本体文件。3.1 环境准备安装BepInExXUAT依赖于BepInEx运行所以第一步是为目标游戏安装BepInEx框架。确定游戏架构打开游戏根目录查看是否存在MyUnityGame_Data/Managed/Assembly-CSharp.dll文件。大多数Unity游戏都有这个文件这意味着它是基于Mono或IL2CPP但兼容Mono构建的。BepInEx 5.x 版本对此支持良好。下载BepInEx前往BepInEx的GitHub发布页下载对应你操作系统通常是x64的“BepInEx Unity IL2CPP”或“BepInEx Unity Mono”版本。如果不确定下载IL2CPP版本通常兼容性更广。安装将下载的ZIP包全部解压到游戏根目录即MyUnityGame.exe所在的文件夹。解压后目录里会多出BepInEx、doorstop_config.ini、winhttp.dll等文件和文件夹。首次运行启动一次游戏。如果安装成功游戏根目录下会生成BepInEx/plugins和BepInEx/config等文件夹。关闭游戏。注意有些游戏有反作弊或独特的启动器可能会干扰BepInEx注入。如果游戏无法启动需要查阅该游戏特定的Mod社区是否有兼容性补丁或特殊的安装方法。3.2 安装XUnity AutoTranslator插件下载插件从GitHub或可靠的Mod发布站如Nexus Mods下载XUnity AutoTranslator的最新版本。通常是一个名为XUnity.AutoTranslator-BepInEx-5.x.x.x.zip的文件。安装插件将压缩包内的内容解压。你会看到类似这样的结构BepInEx/ ├── plugins/ │ └── XUnity.AutoTranslator/ │ ├── AutoTranslator.dll (核心插件) │ └── (其他依赖dll) └── patchers/ (可能包含)将BepInEx文件夹整体复制到你的游戏根目录选择合并覆盖。验证安装再次启动游戏。如果一切正常游戏启动时在命令行窗口如果有或BepInEx的日志文件BepInEx/LogOutput.log中应该能看到AutoTranslator加载成功的日志信息。3.3 关键配置详解安装成功后最重要的步骤是配置。配置文件位于BepInEx/config/AutoTranslatorConfig.ini。用记事本或任何文本编辑器打开它。基础设置[General] ; 目标语言zh-CN 表示简体中文 Languagezh-CN ; 是否启用插件 Enabledtrue翻译服务设置这是核心。以谷歌翻译为例请注意谷歌翻译免费API可能不稳定[Service] ; 指定使用的服务端点 EndpointGoogleTranslate如果你使用百度翻译需要先去百度翻译开放平台申请免费的API每月有字符限额[Service] EndpointBaiduTranslate ; 在百度翻译控制台获取 BaiduAppId你的AppId BaiduAppSecret你的密钥缓存与行为[General] ; 缓存文件路径所有翻译过的文本会保存在这里 TranslationFilePath.\Translation\zh-CN.txt ; 是否在游戏启动时自动翻译所有文本可能卡顿 AutoTranslateOnStartupfalse ; 手动翻译的快捷键默认为F2 ManualTranslationHotkeyF2文本处理[TextProcessing] ; 正则表达式匹配到的文本不会被翻译用于排除代码、版本号等 RegexExclusionPatterns^v\d\.\d$, ^[A-Z0-9_]$ ; 是否拆分长文本再翻译有助于提升某些API的翻译质量 SplitLongTexttrue配置完成后保存文件。启动游戏尝试与NPC对话或打开菜单理论上你应该能看到文本被自动翻译成了中文。第一次翻译某个句子时会有网络请求的延迟之后就会瞬间显示。3.4 高级技巧人工润色与词典管理机器翻译生硬是通病。XUAT的缓存文件 (Translation\zh-CN.txt) 正是用来解决这个问题的。这个文件格式很简单原文1译文1 原文2译文2你可以直接用记事本打开这个文件搜索你觉得翻译别扭的句子将等号右边的译文修改得更符合语境、更口语化或者修正专有名词。例如机器可能把角色名“Raven”翻译成“乌鸦”你可以手动改成“雷文”。修改并保存后重启游戏或重新加载场景修改就会立即生效。你可以把这个润色过的缓存文件分享给其他玩家他们只需要放到自己的Translation文件夹下就能获得和你一样的精翻体验。这实际上构成了一个轻量级的、社区协作的汉化补丁制作流程。4. 实战问题排查与优化心得在实际使用中你几乎一定会遇到各种问题。下面是我踩过坑后总结的常见问题与解决方案。4.1 游戏启动失败或插件未加载症状游戏闪退或启动后无翻译效果日志文件中没有AutoTranslator相关记录。排查检查BepInEx版本兼容性确认下载的BepInEx版本与游戏匹配。对于较新的Unity 2020游戏务必使用BepInEx 5.4.x或更高版本。可以尝试使用专为某游戏打包的BepInEx整合包。检查依赖确保BepInEx/plugins/XUnity.AutoTranslator文件夹下不仅有AutoTranslator.dll还有XUnity.Common.dll,XUnity.ResourceRedirector.dll等依赖文件。缺一不可。关闭杀毒软件某些杀毒软件可能会误杀注入式的DLL文件将游戏目录添加到白名单。查看日志仔细阅读BepInEx/LogOutput.log错误信息通常会明确指出是哪个环节出了问题。4.2 翻译不生效或部分文本未翻译症状游戏能运行但文字还是原文。排查确认配置检查AutoTranslatorConfig.ini中的Enabled是否设为trueLanguage是否正确。检查翻译服务如果使用了需要密钥的服务如百度检查AppId和Secret是否正确是否已超过月度限额。可以临时切换到GoogleTranslate或BingTranslate如果支持来测试是否是服务端问题。文本渲染方式XUAT主要钩取标准UI组件的文本。如果游戏使用TextMeshProTMP渲染文字需要额外的兼容性支持。检查插件包内是否有针对TMP的补丁文件或需要下载单独的XUnity.AutoTranslator-TMP支持插件。图片文字游戏中的文字如果是直接做在图片纹理里的如图片按钮、美术字XUAT无法翻译。这是其原理限制。手动触发按一下配置的快捷键默认F2看能否触发翻译。如果能说明插件在工作可能是自动翻译的触发条件未满足。4.3 翻译延迟、卡顿或乱码症状文字出现慢翻译时游戏卡顿或译文显示为问号“???”或方框“□”。排查与优化网络延迟在线翻译API的响应速度直接影响体验。可以尝试更换更稳定的翻译源或者使用支持离线翻译的引擎如配置本地部署的翻译服务。启用缓存确保缓存功能开启。第一次翻译后译文就被保存在本地后续读取速度是毫秒级的。字体问题乱码或方框通常是游戏字体不支持中文字符集。XUAT有一个强大的功能——字体重定向。你可以在配置文件中指定一个包含中文的字体文件如微软雅黑让游戏使用该字体渲染翻译文本。[Font] ; 启用字体替换 EnableFontPatchtrue ; 指定字体文件路径可以是系统字体或自定义字体文件 FontNamesMicrosoft YaHei UI你需要将字体文件通常是.ttf放到游戏目录下并确保路径正确。这个功能能解决99%的乱码问题。异步翻译在配置中开启异步翻译模式这样游戏不会等待翻译API返回就继续运行译文会在稍后“填充”进来。[General] ; 启用异步翻译避免卡顿 EnableAsyncTranslationtrue4.4 缓存文件的管理与分享问题缓存文件越来越大或者想分享自己的精翻成果。心得定期清理缓存文件只增不减。你可以用文本编辑器打开删除那些不再需要的、翻译质量很差的条目或者将文件拆分如按游戏章节。分享规范分享你的zh-CN.txt文件时最好附带一个简单的说明注明对应的游戏版本和XUAT插件版本避免兼容性问题。合并词典如果有多个人在共同润色可以使用文本比较与合并工具如Beyond Compare来合并不同的翻译文件避免冲突。5. 进阶应用与生态扩展掌握了基础用法后XUAT还能玩出更多花样并与整个Unity游戏Mod生态结合。5.1 对接本地AI翻译引擎随着大语言模型LLM的普及本地部署一个翻译质量更高的AI模型成为可能。XUAT支持“Custom”端点允许你指向一个本地HTTP API。例如你可以在本地用Ollama运行一个轻量化的翻译模型如Qwen2.5-Coder或专门训练的翻译模型并提供一个简单的HTTP服务。然后在配置中[Service] EndpointCustom CustomUrlhttp://localhost:11434/api/translate ; 根据你的API格式可能需要调整请求体和解析逻辑 CustomRequestTemplate{model: qwen2.5-coder, prompt: 将以下英文翻译成地道的中文{0}, stream: false} CustomResponseParserJSON:response这需要你具备一定的API接口开发和调试能力但能获得远超通用翻译引擎的上下文理解和专业术语翻译质量尤其适合科幻、奇幻或专业术语多的游戏。5.2 与Resource Redirector配合实现深度汉化XUAT的作者还开发了另一个强大的插件Resource Redirector。它可以重定向游戏加载的任何资源包括纹理、音频、甚至脚本。结合使用可以实现图片UI汉化对于XUAT无法处理的图片文字你可以用PS等工具制作中文版图片然后利用Resource Redirector在游戏加载原图片时替换成你的中文版图片。字体统一替换更彻底地替换游戏内所有字体确保中文显示完美。修改游戏内文档有些游戏的教程、手册是图片或特定的文本资产可以将其提取、翻译、制作成新资源后再重定向回去。这相当于从“实时文本替换”进入了“静态资源修改”的领域是完整汉化组的常用技术路线。5.3 针对特定游戏引擎变体的适配虽然主要面向Unity但基于Unity的游戏也有不同变体如使用Ren‘Py视觉小说常用但底层是Unity的游戏或使用Unity WebGL在浏览器中运行的游戏。对于这些变体Unity WebGL由于运行在浏览器沙盒中BepInEx无法直接注入。通常需要借助浏览器的用户脚本如Tampermonkey或特定的浏览器扩展来拦截和修改网络请求或内存数据实现类似翻译功能但技术路径完全不同更为复杂。其他框架对于非Unity游戏如RPG Maker、Ren‘Py原生、吉里吉里等各有其成熟的专用翻译工具如Translator、VNR等XUAT并不适用。选择工具前确定游戏的真实引擎是关键的第一步。可以通过查看游戏文件目录结构、使用工具如“Detect It Easy”来分析游戏主程序。6. 性能影响与使用伦理考量最后谈谈使用这类工具时需要注意的两个方面。性能影响XUAT本身非常轻量其性能开销主要来自两方面。一是钩子Hook引入的微小函数调用开销这在现代CPU上几乎可忽略不计。二是网络请求如果大量文本首次翻译且网络不佳会导致卡顿。因此最佳实践是在第一次游玩时耐心等待所有文本被翻译并存入缓存之后游玩体验就和原生游戏无异了。开启EnableAsyncTranslation也能极大改善首次游玩的体验。使用伦理XUAT是一个强大的工具但使用时需遵守一些不成文的社区规则尊重开发者主要用于个人游玩体验提升。不应将大量机器翻译的文本打包并作为“汉化补丁”进行大规模分发尤其是用于商业目的或损害原开发者利益。支持正版该工具旨在为已购买游戏的玩家解决语言问题不应成为玩盗版游戏的借口。谨慎分享缓存分享自己精心润色过的缓存文件是社区贡献但直接分享包含大量未授权翻译文本的缓存可能涉及版权灰色地带。许多汉化组会选择与开发者沟通获取非官方的翻译许可。用于学习对于想通过游戏学习外语的用户可以配置双向翻译或者保留原文与译文对照这是一个非常有趣的应用场景。我个人在长期使用XUAT的过程中最大的体会是它极大地拓展了游戏的可玩边界。它不仅仅是一个翻译工具更是一个桥梁连接了不同语言的玩家和优秀的游戏作品。从技术角度看它也是理解运行时修改Runtime Patching、钩子技术和缓存设计的一个绝佳案例。当你成功配置好一切看着原本陌生的世界逐渐用你能理解的语言讲述故事时那种成就感本身就是一种乐趣。
1. 项目概述为什么我们需要XUnity自动翻译器如果你是一个喜欢玩独立游戏或者某些特定类型PC游戏的玩家肯定遇到过这种情况一款游戏玩法、美术都深得你心但偏偏没有中文。开发者可能来自一个非英语国家游戏文本是日语、韩语、俄语甚至是小众的东欧语言。对着满屏的天书再好的游戏体验也大打折扣。手动截图、丢进翻译软件、再对照着玩这种体验太割裂了几分钟就会让人放弃。XUnity AutoTranslator后文简称XUAT就是为了解决这个痛点而生的。它不是一个独立的软件而是一个运行在游戏进程内的插件。它的核心工作流程非常直接实时拦截游戏引擎主要是Unity在屏幕上绘制文本的调用将获取到的原始文本发送到你指定的翻译服务如谷歌翻译、百度翻译、DeepL等然后将翻译结果“覆盖”绘制在原文本的位置。对你而言你看到的就是即时翻译后的中文或其他目标语言文本仿佛游戏原生支持一样。这个工具的价值远不止于“玩游戏更方便”。对于游戏社区汉化组、内容创作者、甚至是希望学习某语言但想借助游戏环境的用户它都提供了一个低成本、高效率的解决方案。它绕过了传统汉化需要解包、分析资源、修改文本再封包的复杂流程实现了“即插即用”的动态翻译。当然它并非万能其翻译质量依赖于后端引擎且对图片形式的UI文字无能为力。但无论如何对于文本驱动的叙事类、策略类或RPG游戏它无疑是打开语言壁垒的一把利器。2. 核心原理与架构拆解它如何实现“无痕”翻译要理解XUAT首先得明白Unity游戏是如何显示文字的。简单来说当游戏需要显示一段对话“Hello World”时代码会调用Unity的UI系统可能是UGUI、NGUI或更老的OnGUI的文本渲染组件传入字符串“Hello World”和屏幕坐标等信息。显卡最终将这些信息渲染成像素呈现在你眼前。XUAT的介入就发生在这个“传入字符串”的环节。它利用了Unity游戏一个常见的技术框架——BepInEx。BepInEx是一个Unity游戏的插件加载器和修改框架它允许我们在游戏运行时向游戏代码中注入我们自己的逻辑即“插件”。XUAT作为一个BepInEx插件主要做了以下几件事2.1 文本钩取Hooking这是最核心的技术。XUAT会寻找Unity引擎中负责最终文本渲染的几个关键方法。例如对于UGUI它可能会钩住UnityEngine.UI.Text组件的set_text属性对于传统的OnGUI则会钩住GUI.Label,GUI.Button等方法。通过钩子Hook当游戏调用这些方法准备显示文本时控制权会先转移到XUAT的代码里。2.2 文本缓存与翻译XUAT拿到原始文本后不会立刻放行。它首先检查自己的本地缓存文件通常是一个Translation.txt或类似文件。这个文件里存储着“原文-译文”的映射对。如果找到了匹配项就直接使用缓存译文速度极快。如果没找到它就会启动翻译流程将原文发送到配置好的在线翻译API获取译文然后将这对映射存入缓存文件以备下次使用。这个过程可以是同步的导致游戏卡顿一下也可以是异步的译文稍后显示取决于配置。2.3 文本替换与渲染获取到译文后XUAT会修改原本要传递给Unity渲染方法的参数将原文替换成译文。然后游戏引擎照常渲染但画在屏幕上的就已经是翻译后的文字了。由于替换发生在渲染链的最上游游戏本身的逻辑、字体样式、位置布局都不会被破坏实现了视觉上的“无痕”整合。2.4 配置与扩展性XUAT的强大之处在于其高度的可配置性。通过修改配置文件BepInEx/config/AutoTranslatorConfig.ini你可以选择翻译引擎支持Google Translate、Baidu Translate、DeepL、Yandex等甚至支持自定义URL用于调用一些本地部署的AI翻译API。管理缓存可以导出/导入缓存文件方便分享汉化补丁。你也可以手动编辑这个文本文件对机器翻译的结果进行人工润色和修正实现“半自动”精翻。设置触发方式可以设置为按快捷键如F2翻译当前屏幕文本或全自动翻译。过滤与排除可以设置正则表达式排除不需要翻译的文本如版本号、代码、专有名词。这种架构决定了XUAT是一个“通用型”解决方案。只要游戏使用Unity引擎并且文本是通过Unity的标准API渲染的理论上XUAT都能生效。这也是为什么它在独立游戏和GalGame社区如此流行的原因。3. 完整实操指南从零开始汉化你的第一款游戏理论讲完我们动手。假设我们要汉化一款名为“MyUnityGame”的独立游戏。请确保你已拥有游戏的本体文件。3.1 环境准备安装BepInExXUAT依赖于BepInEx运行所以第一步是为目标游戏安装BepInEx框架。确定游戏架构打开游戏根目录查看是否存在MyUnityGame_Data/Managed/Assembly-CSharp.dll文件。大多数Unity游戏都有这个文件这意味着它是基于Mono或IL2CPP但兼容Mono构建的。BepInEx 5.x 版本对此支持良好。下载BepInEx前往BepInEx的GitHub发布页下载对应你操作系统通常是x64的“BepInEx Unity IL2CPP”或“BepInEx Unity Mono”版本。如果不确定下载IL2CPP版本通常兼容性更广。安装将下载的ZIP包全部解压到游戏根目录即MyUnityGame.exe所在的文件夹。解压后目录里会多出BepInEx、doorstop_config.ini、winhttp.dll等文件和文件夹。首次运行启动一次游戏。如果安装成功游戏根目录下会生成BepInEx/plugins和BepInEx/config等文件夹。关闭游戏。注意有些游戏有反作弊或独特的启动器可能会干扰BepInEx注入。如果游戏无法启动需要查阅该游戏特定的Mod社区是否有兼容性补丁或特殊的安装方法。3.2 安装XUnity AutoTranslator插件下载插件从GitHub或可靠的Mod发布站如Nexus Mods下载XUnity AutoTranslator的最新版本。通常是一个名为XUnity.AutoTranslator-BepInEx-5.x.x.x.zip的文件。安装插件将压缩包内的内容解压。你会看到类似这样的结构BepInEx/ ├── plugins/ │ └── XUnity.AutoTranslator/ │ ├── AutoTranslator.dll (核心插件) │ └── (其他依赖dll) └── patchers/ (可能包含)将BepInEx文件夹整体复制到你的游戏根目录选择合并覆盖。验证安装再次启动游戏。如果一切正常游戏启动时在命令行窗口如果有或BepInEx的日志文件BepInEx/LogOutput.log中应该能看到AutoTranslator加载成功的日志信息。3.3 关键配置详解安装成功后最重要的步骤是配置。配置文件位于BepInEx/config/AutoTranslatorConfig.ini。用记事本或任何文本编辑器打开它。基础设置[General] ; 目标语言zh-CN 表示简体中文 Languagezh-CN ; 是否启用插件 Enabledtrue翻译服务设置这是核心。以谷歌翻译为例请注意谷歌翻译免费API可能不稳定[Service] ; 指定使用的服务端点 EndpointGoogleTranslate如果你使用百度翻译需要先去百度翻译开放平台申请免费的API每月有字符限额[Service] EndpointBaiduTranslate ; 在百度翻译控制台获取 BaiduAppId你的AppId BaiduAppSecret你的密钥缓存与行为[General] ; 缓存文件路径所有翻译过的文本会保存在这里 TranslationFilePath.\Translation\zh-CN.txt ; 是否在游戏启动时自动翻译所有文本可能卡顿 AutoTranslateOnStartupfalse ; 手动翻译的快捷键默认为F2 ManualTranslationHotkeyF2文本处理[TextProcessing] ; 正则表达式匹配到的文本不会被翻译用于排除代码、版本号等 RegexExclusionPatterns^v\d\.\d$, ^[A-Z0-9_]$ ; 是否拆分长文本再翻译有助于提升某些API的翻译质量 SplitLongTexttrue配置完成后保存文件。启动游戏尝试与NPC对话或打开菜单理论上你应该能看到文本被自动翻译成了中文。第一次翻译某个句子时会有网络请求的延迟之后就会瞬间显示。3.4 高级技巧人工润色与词典管理机器翻译生硬是通病。XUAT的缓存文件 (Translation\zh-CN.txt) 正是用来解决这个问题的。这个文件格式很简单原文1译文1 原文2译文2你可以直接用记事本打开这个文件搜索你觉得翻译别扭的句子将等号右边的译文修改得更符合语境、更口语化或者修正专有名词。例如机器可能把角色名“Raven”翻译成“乌鸦”你可以手动改成“雷文”。修改并保存后重启游戏或重新加载场景修改就会立即生效。你可以把这个润色过的缓存文件分享给其他玩家他们只需要放到自己的Translation文件夹下就能获得和你一样的精翻体验。这实际上构成了一个轻量级的、社区协作的汉化补丁制作流程。4. 实战问题排查与优化心得在实际使用中你几乎一定会遇到各种问题。下面是我踩过坑后总结的常见问题与解决方案。4.1 游戏启动失败或插件未加载症状游戏闪退或启动后无翻译效果日志文件中没有AutoTranslator相关记录。排查检查BepInEx版本兼容性确认下载的BepInEx版本与游戏匹配。对于较新的Unity 2020游戏务必使用BepInEx 5.4.x或更高版本。可以尝试使用专为某游戏打包的BepInEx整合包。检查依赖确保BepInEx/plugins/XUnity.AutoTranslator文件夹下不仅有AutoTranslator.dll还有XUnity.Common.dll,XUnity.ResourceRedirector.dll等依赖文件。缺一不可。关闭杀毒软件某些杀毒软件可能会误杀注入式的DLL文件将游戏目录添加到白名单。查看日志仔细阅读BepInEx/LogOutput.log错误信息通常会明确指出是哪个环节出了问题。4.2 翻译不生效或部分文本未翻译症状游戏能运行但文字还是原文。排查确认配置检查AutoTranslatorConfig.ini中的Enabled是否设为trueLanguage是否正确。检查翻译服务如果使用了需要密钥的服务如百度检查AppId和Secret是否正确是否已超过月度限额。可以临时切换到GoogleTranslate或BingTranslate如果支持来测试是否是服务端问题。文本渲染方式XUAT主要钩取标准UI组件的文本。如果游戏使用TextMeshProTMP渲染文字需要额外的兼容性支持。检查插件包内是否有针对TMP的补丁文件或需要下载单独的XUnity.AutoTranslator-TMP支持插件。图片文字游戏中的文字如果是直接做在图片纹理里的如图片按钮、美术字XUAT无法翻译。这是其原理限制。手动触发按一下配置的快捷键默认F2看能否触发翻译。如果能说明插件在工作可能是自动翻译的触发条件未满足。4.3 翻译延迟、卡顿或乱码症状文字出现慢翻译时游戏卡顿或译文显示为问号“???”或方框“□”。排查与优化网络延迟在线翻译API的响应速度直接影响体验。可以尝试更换更稳定的翻译源或者使用支持离线翻译的引擎如配置本地部署的翻译服务。启用缓存确保缓存功能开启。第一次翻译后译文就被保存在本地后续读取速度是毫秒级的。字体问题乱码或方框通常是游戏字体不支持中文字符集。XUAT有一个强大的功能——字体重定向。你可以在配置文件中指定一个包含中文的字体文件如微软雅黑让游戏使用该字体渲染翻译文本。[Font] ; 启用字体替换 EnableFontPatchtrue ; 指定字体文件路径可以是系统字体或自定义字体文件 FontNamesMicrosoft YaHei UI你需要将字体文件通常是.ttf放到游戏目录下并确保路径正确。这个功能能解决99%的乱码问题。异步翻译在配置中开启异步翻译模式这样游戏不会等待翻译API返回就继续运行译文会在稍后“填充”进来。[General] ; 启用异步翻译避免卡顿 EnableAsyncTranslationtrue4.4 缓存文件的管理与分享问题缓存文件越来越大或者想分享自己的精翻成果。心得定期清理缓存文件只增不减。你可以用文本编辑器打开删除那些不再需要的、翻译质量很差的条目或者将文件拆分如按游戏章节。分享规范分享你的zh-CN.txt文件时最好附带一个简单的说明注明对应的游戏版本和XUAT插件版本避免兼容性问题。合并词典如果有多个人在共同润色可以使用文本比较与合并工具如Beyond Compare来合并不同的翻译文件避免冲突。5. 进阶应用与生态扩展掌握了基础用法后XUAT还能玩出更多花样并与整个Unity游戏Mod生态结合。5.1 对接本地AI翻译引擎随着大语言模型LLM的普及本地部署一个翻译质量更高的AI模型成为可能。XUAT支持“Custom”端点允许你指向一个本地HTTP API。例如你可以在本地用Ollama运行一个轻量化的翻译模型如Qwen2.5-Coder或专门训练的翻译模型并提供一个简单的HTTP服务。然后在配置中[Service] EndpointCustom CustomUrlhttp://localhost:11434/api/translate ; 根据你的API格式可能需要调整请求体和解析逻辑 CustomRequestTemplate{model: qwen2.5-coder, prompt: 将以下英文翻译成地道的中文{0}, stream: false} CustomResponseParserJSON:response这需要你具备一定的API接口开发和调试能力但能获得远超通用翻译引擎的上下文理解和专业术语翻译质量尤其适合科幻、奇幻或专业术语多的游戏。5.2 与Resource Redirector配合实现深度汉化XUAT的作者还开发了另一个强大的插件Resource Redirector。它可以重定向游戏加载的任何资源包括纹理、音频、甚至脚本。结合使用可以实现图片UI汉化对于XUAT无法处理的图片文字你可以用PS等工具制作中文版图片然后利用Resource Redirector在游戏加载原图片时替换成你的中文版图片。字体统一替换更彻底地替换游戏内所有字体确保中文显示完美。修改游戏内文档有些游戏的教程、手册是图片或特定的文本资产可以将其提取、翻译、制作成新资源后再重定向回去。这相当于从“实时文本替换”进入了“静态资源修改”的领域是完整汉化组的常用技术路线。5.3 针对特定游戏引擎变体的适配虽然主要面向Unity但基于Unity的游戏也有不同变体如使用Ren‘Py视觉小说常用但底层是Unity的游戏或使用Unity WebGL在浏览器中运行的游戏。对于这些变体Unity WebGL由于运行在浏览器沙盒中BepInEx无法直接注入。通常需要借助浏览器的用户脚本如Tampermonkey或特定的浏览器扩展来拦截和修改网络请求或内存数据实现类似翻译功能但技术路径完全不同更为复杂。其他框架对于非Unity游戏如RPG Maker、Ren‘Py原生、吉里吉里等各有其成熟的专用翻译工具如Translator、VNR等XUAT并不适用。选择工具前确定游戏的真实引擎是关键的第一步。可以通过查看游戏文件目录结构、使用工具如“Detect It Easy”来分析游戏主程序。6. 性能影响与使用伦理考量最后谈谈使用这类工具时需要注意的两个方面。性能影响XUAT本身非常轻量其性能开销主要来自两方面。一是钩子Hook引入的微小函数调用开销这在现代CPU上几乎可忽略不计。二是网络请求如果大量文本首次翻译且网络不佳会导致卡顿。因此最佳实践是在第一次游玩时耐心等待所有文本被翻译并存入缓存之后游玩体验就和原生游戏无异了。开启EnableAsyncTranslation也能极大改善首次游玩的体验。使用伦理XUAT是一个强大的工具但使用时需遵守一些不成文的社区规则尊重开发者主要用于个人游玩体验提升。不应将大量机器翻译的文本打包并作为“汉化补丁”进行大规模分发尤其是用于商业目的或损害原开发者利益。支持正版该工具旨在为已购买游戏的玩家解决语言问题不应成为玩盗版游戏的借口。谨慎分享缓存分享自己精心润色过的缓存文件是社区贡献但直接分享包含大量未授权翻译文本的缓存可能涉及版权灰色地带。许多汉化组会选择与开发者沟通获取非官方的翻译许可。用于学习对于想通过游戏学习外语的用户可以配置双向翻译或者保留原文与译文对照这是一个非常有趣的应用场景。我个人在长期使用XUAT的过程中最大的体会是它极大地拓展了游戏的可玩边界。它不仅仅是一个翻译工具更是一个桥梁连接了不同语言的玩家和优秀的游戏作品。从技术角度看它也是理解运行时修改Runtime Patching、钩子技术和缓存设计的一个绝佳案例。当你成功配置好一切看着原本陌生的世界逐渐用你能理解的语言讲述故事时那种成就感本身就是一种乐趣。
原理与实践：彻底消除函数返回时的拷贝开销)
![【Bug已解决】[modular] ensure branch-specific input defaults 解决方案](http://pic.xiahunao.cn/yaotu/【Bug已解决】[modular] ensure branch-specific input defaults 解决方案)
