1. 项目概述打破语言壁垒的Unity游戏翻译利器如果你是一名热爱独立游戏、视觉小说或者日系RPG的玩家肯定遇到过这样的烦恼一款游戏玩法精妙、美术出色但偏偏没有官方中文满屏的外文让你望而却步。手动打汉化补丁版本对不上、安装复杂、还容易导致游戏崩溃。有没有一种方法能像浏览器插件翻译网页一样实时、无缝地翻译游戏内的文本呢XUnity.AutoTranslator以下简称XUA就是为此而生的终极解决方案。简单来说XUA是一个功能极其强大的Unity游戏实时翻译插件。它通过“钩子”Hook技术在游戏运行时拦截所有文本渲染调用将原始文本发送到你指定的翻译服务如谷歌翻译、百度翻译、DeepL等获取翻译结果后再动态替换回游戏界面。整个过程对游戏本身几乎无感你只需要安装好插件进入游戏按下快捷键就能看到熟悉的母语。它支持的不仅仅是简单的UI文本还包括NGUI、UGUI、TextMeshPro等多种文本组件甚至能处理图片资源的替换堪称Unity游戏“民间汉化”的瑞士军刀。这个工具的核心价值在于其“非侵入性”和“自动化”。你不需要去反编译游戏、修改资源文件也无需等待某个汉化组针对特定版本发布补丁。只要游戏基于Unity引擎XUA就有很大概率能工作。无论是Steam上的独立游戏还是一些“特定类型”的日系游戏它都能大显身手。接下来我将带你深入拆解这个工具从原理到配置从基础使用到高级调优让你彻底掌握这把利器。2. 核心原理与架构拆解翻译是如何发生的要理解XUA的强大首先得明白它在Unity游戏里做了什么。Unity游戏中的文本最终都是通过诸如Text、TextMeshProUGUI这类组件显示在屏幕上的。当游戏需要显示一句“こんにちは”时它会调用这些组件的set_text属性或类似的方法。2.1 钩子Hook技术拦截与替换XUA的核心技术是“方法钩子”。它通过Harmony或MonoMod等库在游戏运行时动态修改游戏程序集的内存将游戏原本调用set_text方法的指令重定向到XUA自己编写的方法上。这个过程可以形象地理解为在游戏代码和显示结果之间插入了一个“中间人”。当这个“中间人”即XUA的钩子函数被调用时它会做以下几件事捕获原文获取游戏试图设置的原始文本字符串。查询缓存检查本地翻译缓存文件_AutoGeneratedTranslations.txt中是否已有该原文的翻译。如果有直接使用缓存结果性能最佳。在线翻译如无缓存如果缓存中没有则将该文本发送到配置好的在线翻译API如Google Translate。应用翻译将得到的翻译文本设置回游戏的文本组件完成替换。记录缓存将“原文-译文”对保存到本地缓存文件下次遇到相同文本就无需再请求网络。这一切都发生在毫秒之间对于玩家而言感受到的就是文本从外文瞬间变成了中文。2.2 资源重定向Resource Redirector更底层的替换除了运行时拦截文本XUA还集成了一个更强大的模块Resource Redirector。这个模块允许你在游戏加载资源如图片、文本资产、音频等时进行拦截和替换。比如游戏里有一张写有日文“スタート”的按钮图片。传统汉化需要你找到这个图片文件用PS修改再打包回去过程繁琐且易出错。而利用Resource Redirector你可以启用纹理转储EnableTextureDumpingTrue让XUA在游戏运行时自动将所有纹理图片导出到指定文件夹。你用图片编辑软件修改导出的“スタート”图片改成“开始”并保持文件名不变。启用纹理翻译EnableTextureTranslationTrue下次游戏加载这张图片时XUA会优先从你的修改文件夹里读取“开始”图片从而替换掉游戏原图。这个功能实现了真正意义上的“资源级”汉化尤其对于大量使用图片作为UI的游戏来说是革命性的。2.3 插件架构模块化与可扩展性XUA的架构设计非常清晰主要分为以下几个部分核心翻译引擎负责文本捕获、缓存管理、翻译流程调度。端点Endpoint系统定义与各个翻译服务谷歌、百度、DeepL等通信的接口。这是一个可插拔的架构开发者可以很容易地为其添加新的翻译源。资源重定向器独立但被整合的库负责资源文件的拦截与替换。配置与文件系统管理所有配置文件、翻译缓存文件、替换资源目录等。这种模块化设计使得XUA不仅是一个工具更是一个平台。高级用户和开发者可以基于它提供的API实现自定义的翻译逻辑、创建针对特定游戏的优化补丁甚至开发全新的功能模块。3. 从零开始安装与基础配置实战理论讲完了我们上手实操。假设我们要为一款名为MyUnityGame.exe的游戏安装XUA进行汉化。3.1 环境准备与插件安装首先你需要确定游戏使用的插件框架。Unity游戏Mod社区主要使用以下几种框架来加载插件BepInEx目前最主流、最通用的Unity插件框架兼容性最好。IPA主要用于特定平台的游戏。ReiPatcher较老的注入工具。注意在安装任何插件前务必备份你的游戏存档和游戏原始文件。虽然XUA非常稳定但这是良好的操作习惯。以BepInEx 5.x为例安装步骤如下下载从XUA的GitHub发布页下载对应BepInEx 5的压缩包通常名为XUnity.AutoTranslator-BepInEx-5.x.x.x.zip。安装BepInEx如果你的游戏还没有安装BepInEx需要先安装。将BepInEx压缩包内的文件解压到游戏根目录即MyUnityGame.exe所在的文件夹。安装XUA将XUA压缩包内的内容解压。你会看到类似这样的结构BepInEx/ ├── plugins/ │ └── XUnity.AutoTranslator/ (这是XUA的主插件目录) └── patchers/ (可能包含Resource Redirector的补丁器)将XUnity.AutoTranslator整个文件夹复制到游戏目录的BepInEx\plugins\下。运行游戏启动游戏一次。BepInEx会自动初始化并在BepInEx\plugins\XUnity.AutoTranslator目录下生成配置文件。3.2 核心配置文件详解首次运行后在插件目录下会生成Config.ini文件。这是XUA的大脑所有行为都由它控制。我们用文本编辑器打开它重点看几个核心区块[General]区块 - 基础设置[General] Languagezh-CN ; 目标语言简体中文 SourceLanguageja ; 源语言假设游戏是日文 EndpointGoogleTranslate ; 翻译端点使用谷歌翻译Language设置为你需要的语言代码如zh-CN简体中文、en英文。SourceLanguage游戏文本的原始语言。如果不知道可以留空或设为auto让翻译服务自动检测但准确率可能稍低。Endpoint选择翻译服务。内置选项包括GoogleTranslate谷歌、BaiduTranslate百度、DeepLTranslateDeepL等。重要使用谷歌或DeepL等国外服务可能需要网络环境支持。[Behaviour]区块 - 插件行为[Behaviour] EnableTranslationTrue MaxCharactersPerTranslation400 EnableBatchingTrueEnableTranslation总开关。MaxCharactersPerTranslation单次发送翻译的最大字符数。切勿超过400这是为了防止滥用翻译API也是社区规范。长文本会被拆分。EnableBatching是否启用请求批处理。开启后插件会累积一小批文本再发送减少API调用次数强烈建议开启以提升效率和避免触发频率限制。[Texture]区块 - 图片翻译高级功能图片翻译功能默认关闭因为对性能有影响。除非你需要替换游戏内的图片文字否则保持默认即可。[Texture] EnableTextureTranslationFalse EnableTextureDumpingFalse ; 谨慎开启会导出大量图片文件 TextureHashGenerationStrategyFromImageName3.3 首次运行与热键操作配置保存后重启游戏。如果一切正常游戏应该能正常启动。进入游戏主界面后你可以尝试以下热键默认ALT0打开翻译端点选择窗口。你可以在这里切换不同的翻译服务或者选择“空”来临时关闭翻译。ALTT全局翻译开关。按一下关闭翻译显示原文再按一下开启。ALTR重新加载所有翻译文件。当你手动修改了_AutoGeneratedTranslations.txt文件后按此键无需重启游戏即可生效。如果游戏画面角落出现了[XUnity Auto Translator]的字样并且随着你浏览菜单文本逐渐从外文变成中文那么恭喜你安装成功了4. 高级调优与疑难排错指南基础能用只是第一步要想获得完美的翻译体验还需要进行精细调优。下面是我在实际使用中总结出的核心技巧和常见问题解决方案。4.1 提升翻译质量的五大关键配置机器翻译生硬、上下文错误是常见问题。通过调整配置可以大幅改善空格与换行处理日语、英语的换行习惯与中文不同不当的换行会导致翻译API将一行句子拆成多个短句翻译结果支离破碎。[Behaviour] IgnoreWhitespaceInDialogueTrue ; 对长文本对话忽略首尾空格 IgnoreWhitespaceInNGUITrue ; 对NGUI组件忽略空格很多老游戏用NGUI ForceSplitTextAfterCharacters0 ; 设置为0禁用强制换行让翻译结果自然换行设置后插件会在发送翻译前清理多余的空白字符让翻译引擎看到完整的句子。前后处理器用于修正翻译结果中的常见错误。例如谷歌翻译经常把日语人名“さくら”翻译成“樱花”但游戏中这是个角色名应该音译为“樱”或保留“Sakura”。 在Translation\zh-CN\Text目录下创建Preprocessors.txt翻译前处理和Postprocessors.txt翻译后处理。Preprocessors.txt在翻译前替换原文。例如さくらSakuraPostprocessors.txt在翻译后替换译文。例如修正谷歌翻译的奇怪用词我咱 ; 将某些游戏语境下不自然的“我”改为“咱” 你您 ; 根据角色关系调整敬语正则表达式翻译对付游戏里那些动态拼接的文本。比如游戏显示“获得了 10 金币”原文可能是“获得了 {0} 金币”。直接翻译“获得了”和“金币”容易出错。 在翻译文件中使用r:开头的行定义正则表达式r:获得了 (\d) 金币获得了 $1 金币这样无论数字是多少都能正确匹配和翻译。UI字体与自适应中文通常比英文、日文占用更多像素宽度可能导致文字溢出框外。启用UI自动重设大小[Behaviour] EnableUIResizingTrue如果自动调整效果不佳可以手动创建resizer.txt文件指定特定UI路径的字体缩放比例。自定义字体游戏原版字体可能不包含中文汉字导致翻译后显示为方框□□□。你需要指定一个中文字体。[Behaviour] OverrideFontTextMeshProFonts Materials/LiberationSans SDF Fallback你需要将包含中文字体的AssetBundle文件可从社区获取或自己制作放入游戏目录并在此指定其内部路径。4.2 常见问题与解决方案实录即使配置得当在实际使用中还是会遇到各种稀奇古怪的问题。下面这个表格是我踩过无数坑后整理的排错指南问题现象可能原因解决方案游戏启动崩溃或黑屏1. BepInEx版本与游戏不兼容。2. XUA插件版本与游戏Unity版本冲突。3. 与其他Mod冲突。1. 尝试更换BepInEx版本如从5.x换到6.x预览版或使用专为游戏打包的BepInEx。2. 检查游戏Unity版本尝试XUA的旧版本如4.x。3. 暂时移除其他所有Mod只保留XUA排查冲突。翻译完全不生效1. 热键冲突被游戏屏蔽。2. 文本组件类型不被支持如自定义Shader文本。3. IL2CPP编译的游戏支持不佳。1. 尝试修改Config.ini中的热键键位如ToggleTranslationKeyLeftControlT。2. 尝试开启EnableIMGUITrue如果游戏用旧版UI。对于特殊组件可能需要社区特殊补丁。3. 对于IL2CPP游戏尝试使用XUnity.AutoTranslator.IL2CPP.BruteForceFix这个辅助插件。翻译断断续续部分文本不翻译1. 文本缓存未命中且在线翻译API请求失败或超时。2. 文本被游戏以特殊方式如动态生成、图片形式呈现。3.MaxCharactersPerTranslation设置过小长文本被跳过。1. 检查网络连接。尝试切换翻译端点如从谷歌换到百度。查看BepInEx\LogOutput.log文件是否有错误信息。2. 对于动态文本尝试开启TextGetterCompatibilityModeTrue。对于图片文字需启用纹理翻译功能。3. 确保该值不大于400但也不要太小如50建议200-400。翻译后游戏逻辑出错游戏代码依赖界面显示的原始文本来做判断蹩脚的编程实践。开启TextGetterCompatibilityModeTrue。这个模式会“欺骗”游戏让它以为显示的仍是原文从而避免逻辑错误。翻译结果错乱或重复1. 翻译缓存文件_AutoGeneratedTranslations.txt混乱。2. 多个翻译文件包括手动添加的中存在冲突条目。1. 备份后删除该文件让插件重新生成。翻译优先级是手动翻译文件 自动生成文件。清理自动文件可以解决很多奇怪问题。2. 检查Translation目录下所有.txt文件删除或修正重复、错误的条目。性能显著下降游戏卡顿1. 启用了纹理翻译或纹理转储。2. 在线翻译API延迟高且未开启批处理。3. 正则表达式过于复杂或数量太多。1. 除非必要否则关闭[Texture]下的所有选项特别是EnableTextureDumping和EnableTextureScanOnSceneLoad。2. 确保EnableBatchingTrue。考虑使用离线翻译词典UseStaticTranslationsTrue或预先翻译好大量文本放入缓存。3. 精简正则表达式或将其移至独立文件避免插件每次启动都解析大量复杂正则。4.3 手动翻译与词库管理打造完美汉化依赖机器翻译终究不够完美尤其是专有名词、技能名称、特定梗。XUA的强大之处在于它完美支持手动翻译覆盖。操作流程进入游戏用ALTT开启翻译游玩一段时间。所有被翻译过的文本都会自动记录在BepInEx\plugins\XUnity.AutoTranslator\Translation\zh-CN\Text\_AutoGeneratedTranslations.txt中。用记事本或VS Code等编辑器打开这个文件。你会看到类似这样的内容こんにちはHello ありがとうThank you将机器翻译的结果修改为你想要的翻译。例如你知道“こんにちは”在这个游戏语境下是“您好”而不是“Hello”就改成こんにちは您好保存文件回到游戏按下ALTR。对应的文本会立刻更新为你的手动翻译。高级技巧创建独立词库你不应该直接修改庞大的_AutoGeneratedTranslations.txt文件因为游戏更新或重置缓存后它会被覆盖。最佳实践是在Translation\zh-CN\Text目录下新建一个Manual_GameTerms.txt。将你需要固定翻译的词条如角色名、技能名、物品名剪切进去。魔王Demon King 勇者Hero ヒールHealXUA会读取该目录下所有.txt文件且Manual_GameTerms.txt的优先级高于_AutoGeneratedTranslations.txt。这样即使自动缓存重置你的精心翻译也会保留。5. 开发者视角扩展插件与资源重定向对于Mod开发者或高级用户XUA提供了丰富的API允许你深度定制或开发基于它的新功能。5.1 实现一个自定义翻译端点假设你想接入一个冷门但好用的翻译API。你需要创建一个类库项目。引用添加对XUnity.AutoTranslator.Plugin.Core.dll的引用。实现接口创建一个类实现ITranslateEndpoint接口或继承自HttpEndpoint等基类。核心方法在Translate方法中编写调用你API的逻辑并将结果通过context.Complete(translatedText)返回。部署将编译好的DLL放入游戏的BepInEx\plugins\XUnity.AutoTranslator\Translators文件夹。一个极简的示例反转字符串的“翻译器”public class ReverserEndpoint : ITranslateEndpoint { public string Id Reverser; // 在配置中EndpointReverser public string FriendlyName Text Reverser; public int MaxConcurrency 10; public int MaxTranslationsPerRequest 1; public void Initialize(IInitializationContext context) { // 这里可以读取你的自定义配置比如API Key // var myKey context.GetOrCreateSetting(Reverser, ApiKey, ); } public IEnumerator Translate(ITranslationContext context) { // 简单地将原文反转 char[] charArray context.UntranslatedText.ToCharArray(); Array.Reverse(charArray); string reversedText new string(charArray); // 模拟网络延迟 // yield return new WaitForSeconds(0.1f); // 完成翻译 context.Complete(reversedText); yield break; } }5.2 使用资源重定向API修改游戏资源Resource Redirector的API非常强大。例如你想修改游戏加载的某个特定音频文件public class MyAudioModPlugin : BaseUnityPlugin { void Awake() { // 注册资源加载后的钩子 ResourceRedirection.RegisterResourceLoadedHook( HookBehaviour.OneCallbackPerResourceLoaded, 100, // 优先级 OnResourceLoaded); } private void OnResourceLoaded(ResourceLoadedContext context) { // 检查加载的资源类型和路径 if (context.Parameters.Type typeof(AudioClip) context.Parameters.Path.EndsWith(my_bgm.wav)) { // 从本地文件加载替换的音频 string customAudioPath Path.Combine(Paths.PluginPath, MyMod, new_bgm.wav); if (File.Exists(customAudioPath)) { // 使用WWW或UnityWebRequest加载自定义音频此处简化 // AudioClip customClip ...; // context.Asset customClip; // 替换资源 Logger.LogInfo($替换了音频: {context.Parameters.Path}); } context.Complete(true); // 跳过其他后置钩子 } } }通过这种方式你可以实现不修改游戏原始文件的前提下替换任何通过Resources API加载的资产包括纹理、音频、文本资产等为制作大型Mod提供了底层支持。6. 伦理、性能与最佳实践最后分享一些“软性”经验。使用这类工具不仅要考虑“能不能”还要考虑“该不该”和“怎么样最好”。关于性能XUA在翻译时会有微小开销。在低配电脑或大型开放世界游戏中如果开启了全场景纹理扫描EnableTextureScanOnSceneLoad或加载了大量高分辨率替换图片可能会引起卡顿。我的建议是按需启用功能。90%的情况下只启用文本翻译就足够了。图片翻译是最后的手段。关于翻译服务请尊重翻译API的服务条款。不要设置过高的并发MaxConcurrency或过短的请求间隔以免被服务商封禁IP或API Key。使用批处理EnableBatching是礼貌且高效的做法。如果可能优先使用提供免费额度或有明确商用条款的API。关于分享XUA鼓励你分享翻译缓存文件_AutoGeneratedTranslations.txt来帮助其他玩家。但绝对不要分享包含以下内容的配置或插件包启用了EnableTextureDumping、EnableTextureToggling、LoadUnmodifiedTextures或DetectDuplicateTextureNames的配置这些会导出或干扰游戏原始资源。内置了非公开、需要付费API Key的翻译端点配置。修改过的、指向非官方或自定义服务器的插件DLL除非你完全信任其来源。关于更新Unity游戏更新频繁有时会改变内部结构导致钩子失效。如果某天XUA突然不工作了第一反应不应该是抱怨插件而是去GitHub的Issues页面或相关社区看看是否有新版本发布。保持插件和游戏版本的同步是长久稳定使用的关键。折腾的过程本身从安装配置、调试参数、到最终看到游戏里流畅显示母语的那一刻所带来的成就感和愉悦有时甚至超过了游戏本身。希望这篇超详细的指南能帮你少走弯路更顺畅地享受那些未被官方汉化的佳作。如果在使用中发现了什么独特的技巧或踩到了新的坑不妨也分享出来让这个社区工具变得更加完善。 Unity游戏实时翻译插件XUnity.AutoTranslator：原理、配置与高级调优指南
1. 项目概述打破语言壁垒的Unity游戏翻译利器如果你是一名热爱独立游戏、视觉小说或者日系RPG的玩家肯定遇到过这样的烦恼一款游戏玩法精妙、美术出色但偏偏没有官方中文满屏的外文让你望而却步。手动打汉化补丁版本对不上、安装复杂、还容易导致游戏崩溃。有没有一种方法能像浏览器插件翻译网页一样实时、无缝地翻译游戏内的文本呢XUnity.AutoTranslator以下简称XUA就是为此而生的终极解决方案。简单来说XUA是一个功能极其强大的Unity游戏实时翻译插件。它通过“钩子”Hook技术在游戏运行时拦截所有文本渲染调用将原始文本发送到你指定的翻译服务如谷歌翻译、百度翻译、DeepL等获取翻译结果后再动态替换回游戏界面。整个过程对游戏本身几乎无感你只需要安装好插件进入游戏按下快捷键就能看到熟悉的母语。它支持的不仅仅是简单的UI文本还包括NGUI、UGUI、TextMeshPro等多种文本组件甚至能处理图片资源的替换堪称Unity游戏“民间汉化”的瑞士军刀。这个工具的核心价值在于其“非侵入性”和“自动化”。你不需要去反编译游戏、修改资源文件也无需等待某个汉化组针对特定版本发布补丁。只要游戏基于Unity引擎XUA就有很大概率能工作。无论是Steam上的独立游戏还是一些“特定类型”的日系游戏它都能大显身手。接下来我将带你深入拆解这个工具从原理到配置从基础使用到高级调优让你彻底掌握这把利器。2. 核心原理与架构拆解翻译是如何发生的要理解XUA的强大首先得明白它在Unity游戏里做了什么。Unity游戏中的文本最终都是通过诸如Text、TextMeshProUGUI这类组件显示在屏幕上的。当游戏需要显示一句“こんにちは”时它会调用这些组件的set_text属性或类似的方法。2.1 钩子Hook技术拦截与替换XUA的核心技术是“方法钩子”。它通过Harmony或MonoMod等库在游戏运行时动态修改游戏程序集的内存将游戏原本调用set_text方法的指令重定向到XUA自己编写的方法上。这个过程可以形象地理解为在游戏代码和显示结果之间插入了一个“中间人”。当这个“中间人”即XUA的钩子函数被调用时它会做以下几件事捕获原文获取游戏试图设置的原始文本字符串。查询缓存检查本地翻译缓存文件_AutoGeneratedTranslations.txt中是否已有该原文的翻译。如果有直接使用缓存结果性能最佳。在线翻译如无缓存如果缓存中没有则将该文本发送到配置好的在线翻译API如Google Translate。应用翻译将得到的翻译文本设置回游戏的文本组件完成替换。记录缓存将“原文-译文”对保存到本地缓存文件下次遇到相同文本就无需再请求网络。这一切都发生在毫秒之间对于玩家而言感受到的就是文本从外文瞬间变成了中文。2.2 资源重定向Resource Redirector更底层的替换除了运行时拦截文本XUA还集成了一个更强大的模块Resource Redirector。这个模块允许你在游戏加载资源如图片、文本资产、音频等时进行拦截和替换。比如游戏里有一张写有日文“スタート”的按钮图片。传统汉化需要你找到这个图片文件用PS修改再打包回去过程繁琐且易出错。而利用Resource Redirector你可以启用纹理转储EnableTextureDumpingTrue让XUA在游戏运行时自动将所有纹理图片导出到指定文件夹。你用图片编辑软件修改导出的“スタート”图片改成“开始”并保持文件名不变。启用纹理翻译EnableTextureTranslationTrue下次游戏加载这张图片时XUA会优先从你的修改文件夹里读取“开始”图片从而替换掉游戏原图。这个功能实现了真正意义上的“资源级”汉化尤其对于大量使用图片作为UI的游戏来说是革命性的。2.3 插件架构模块化与可扩展性XUA的架构设计非常清晰主要分为以下几个部分核心翻译引擎负责文本捕获、缓存管理、翻译流程调度。端点Endpoint系统定义与各个翻译服务谷歌、百度、DeepL等通信的接口。这是一个可插拔的架构开发者可以很容易地为其添加新的翻译源。资源重定向器独立但被整合的库负责资源文件的拦截与替换。配置与文件系统管理所有配置文件、翻译缓存文件、替换资源目录等。这种模块化设计使得XUA不仅是一个工具更是一个平台。高级用户和开发者可以基于它提供的API实现自定义的翻译逻辑、创建针对特定游戏的优化补丁甚至开发全新的功能模块。3. 从零开始安装与基础配置实战理论讲完了我们上手实操。假设我们要为一款名为MyUnityGame.exe的游戏安装XUA进行汉化。3.1 环境准备与插件安装首先你需要确定游戏使用的插件框架。Unity游戏Mod社区主要使用以下几种框架来加载插件BepInEx目前最主流、最通用的Unity插件框架兼容性最好。IPA主要用于特定平台的游戏。ReiPatcher较老的注入工具。注意在安装任何插件前务必备份你的游戏存档和游戏原始文件。虽然XUA非常稳定但这是良好的操作习惯。以BepInEx 5.x为例安装步骤如下下载从XUA的GitHub发布页下载对应BepInEx 5的压缩包通常名为XUnity.AutoTranslator-BepInEx-5.x.x.x.zip。安装BepInEx如果你的游戏还没有安装BepInEx需要先安装。将BepInEx压缩包内的文件解压到游戏根目录即MyUnityGame.exe所在的文件夹。安装XUA将XUA压缩包内的内容解压。你会看到类似这样的结构BepInEx/ ├── plugins/ │ └── XUnity.AutoTranslator/ (这是XUA的主插件目录) └── patchers/ (可能包含Resource Redirector的补丁器)将XUnity.AutoTranslator整个文件夹复制到游戏目录的BepInEx\plugins\下。运行游戏启动游戏一次。BepInEx会自动初始化并在BepInEx\plugins\XUnity.AutoTranslator目录下生成配置文件。3.2 核心配置文件详解首次运行后在插件目录下会生成Config.ini文件。这是XUA的大脑所有行为都由它控制。我们用文本编辑器打开它重点看几个核心区块[General]区块 - 基础设置[General] Languagezh-CN ; 目标语言简体中文 SourceLanguageja ; 源语言假设游戏是日文 EndpointGoogleTranslate ; 翻译端点使用谷歌翻译Language设置为你需要的语言代码如zh-CN简体中文、en英文。SourceLanguage游戏文本的原始语言。如果不知道可以留空或设为auto让翻译服务自动检测但准确率可能稍低。Endpoint选择翻译服务。内置选项包括GoogleTranslate谷歌、BaiduTranslate百度、DeepLTranslateDeepL等。重要使用谷歌或DeepL等国外服务可能需要网络环境支持。[Behaviour]区块 - 插件行为[Behaviour] EnableTranslationTrue MaxCharactersPerTranslation400 EnableBatchingTrueEnableTranslation总开关。MaxCharactersPerTranslation单次发送翻译的最大字符数。切勿超过400这是为了防止滥用翻译API也是社区规范。长文本会被拆分。EnableBatching是否启用请求批处理。开启后插件会累积一小批文本再发送减少API调用次数强烈建议开启以提升效率和避免触发频率限制。[Texture]区块 - 图片翻译高级功能图片翻译功能默认关闭因为对性能有影响。除非你需要替换游戏内的图片文字否则保持默认即可。[Texture] EnableTextureTranslationFalse EnableTextureDumpingFalse ; 谨慎开启会导出大量图片文件 TextureHashGenerationStrategyFromImageName3.3 首次运行与热键操作配置保存后重启游戏。如果一切正常游戏应该能正常启动。进入游戏主界面后你可以尝试以下热键默认ALT0打开翻译端点选择窗口。你可以在这里切换不同的翻译服务或者选择“空”来临时关闭翻译。ALTT全局翻译开关。按一下关闭翻译显示原文再按一下开启。ALTR重新加载所有翻译文件。当你手动修改了_AutoGeneratedTranslations.txt文件后按此键无需重启游戏即可生效。如果游戏画面角落出现了[XUnity Auto Translator]的字样并且随着你浏览菜单文本逐渐从外文变成中文那么恭喜你安装成功了4. 高级调优与疑难排错指南基础能用只是第一步要想获得完美的翻译体验还需要进行精细调优。下面是我在实际使用中总结出的核心技巧和常见问题解决方案。4.1 提升翻译质量的五大关键配置机器翻译生硬、上下文错误是常见问题。通过调整配置可以大幅改善空格与换行处理日语、英语的换行习惯与中文不同不当的换行会导致翻译API将一行句子拆成多个短句翻译结果支离破碎。[Behaviour] IgnoreWhitespaceInDialogueTrue ; 对长文本对话忽略首尾空格 IgnoreWhitespaceInNGUITrue ; 对NGUI组件忽略空格很多老游戏用NGUI ForceSplitTextAfterCharacters0 ; 设置为0禁用强制换行让翻译结果自然换行设置后插件会在发送翻译前清理多余的空白字符让翻译引擎看到完整的句子。前后处理器用于修正翻译结果中的常见错误。例如谷歌翻译经常把日语人名“さくら”翻译成“樱花”但游戏中这是个角色名应该音译为“樱”或保留“Sakura”。 在Translation\zh-CN\Text目录下创建Preprocessors.txt翻译前处理和Postprocessors.txt翻译后处理。Preprocessors.txt在翻译前替换原文。例如さくらSakuraPostprocessors.txt在翻译后替换译文。例如修正谷歌翻译的奇怪用词我咱 ; 将某些游戏语境下不自然的“我”改为“咱” 你您 ; 根据角色关系调整敬语正则表达式翻译对付游戏里那些动态拼接的文本。比如游戏显示“获得了 10 金币”原文可能是“获得了 {0} 金币”。直接翻译“获得了”和“金币”容易出错。 在翻译文件中使用r:开头的行定义正则表达式r:获得了 (\d) 金币获得了 $1 金币这样无论数字是多少都能正确匹配和翻译。UI字体与自适应中文通常比英文、日文占用更多像素宽度可能导致文字溢出框外。启用UI自动重设大小[Behaviour] EnableUIResizingTrue如果自动调整效果不佳可以手动创建resizer.txt文件指定特定UI路径的字体缩放比例。自定义字体游戏原版字体可能不包含中文汉字导致翻译后显示为方框□□□。你需要指定一个中文字体。[Behaviour] OverrideFontTextMeshProFonts Materials/LiberationSans SDF Fallback你需要将包含中文字体的AssetBundle文件可从社区获取或自己制作放入游戏目录并在此指定其内部路径。4.2 常见问题与解决方案实录即使配置得当在实际使用中还是会遇到各种稀奇古怪的问题。下面这个表格是我踩过无数坑后整理的排错指南问题现象可能原因解决方案游戏启动崩溃或黑屏1. BepInEx版本与游戏不兼容。2. XUA插件版本与游戏Unity版本冲突。3. 与其他Mod冲突。1. 尝试更换BepInEx版本如从5.x换到6.x预览版或使用专为游戏打包的BepInEx。2. 检查游戏Unity版本尝试XUA的旧版本如4.x。3. 暂时移除其他所有Mod只保留XUA排查冲突。翻译完全不生效1. 热键冲突被游戏屏蔽。2. 文本组件类型不被支持如自定义Shader文本。3. IL2CPP编译的游戏支持不佳。1. 尝试修改Config.ini中的热键键位如ToggleTranslationKeyLeftControlT。2. 尝试开启EnableIMGUITrue如果游戏用旧版UI。对于特殊组件可能需要社区特殊补丁。3. 对于IL2CPP游戏尝试使用XUnity.AutoTranslator.IL2CPP.BruteForceFix这个辅助插件。翻译断断续续部分文本不翻译1. 文本缓存未命中且在线翻译API请求失败或超时。2. 文本被游戏以特殊方式如动态生成、图片形式呈现。3.MaxCharactersPerTranslation设置过小长文本被跳过。1. 检查网络连接。尝试切换翻译端点如从谷歌换到百度。查看BepInEx\LogOutput.log文件是否有错误信息。2. 对于动态文本尝试开启TextGetterCompatibilityModeTrue。对于图片文字需启用纹理翻译功能。3. 确保该值不大于400但也不要太小如50建议200-400。翻译后游戏逻辑出错游戏代码依赖界面显示的原始文本来做判断蹩脚的编程实践。开启TextGetterCompatibilityModeTrue。这个模式会“欺骗”游戏让它以为显示的仍是原文从而避免逻辑错误。翻译结果错乱或重复1. 翻译缓存文件_AutoGeneratedTranslations.txt混乱。2. 多个翻译文件包括手动添加的中存在冲突条目。1. 备份后删除该文件让插件重新生成。翻译优先级是手动翻译文件 自动生成文件。清理自动文件可以解决很多奇怪问题。2. 检查Translation目录下所有.txt文件删除或修正重复、错误的条目。性能显著下降游戏卡顿1. 启用了纹理翻译或纹理转储。2. 在线翻译API延迟高且未开启批处理。3. 正则表达式过于复杂或数量太多。1. 除非必要否则关闭[Texture]下的所有选项特别是EnableTextureDumping和EnableTextureScanOnSceneLoad。2. 确保EnableBatchingTrue。考虑使用离线翻译词典UseStaticTranslationsTrue或预先翻译好大量文本放入缓存。3. 精简正则表达式或将其移至独立文件避免插件每次启动都解析大量复杂正则。4.3 手动翻译与词库管理打造完美汉化依赖机器翻译终究不够完美尤其是专有名词、技能名称、特定梗。XUA的强大之处在于它完美支持手动翻译覆盖。操作流程进入游戏用ALTT开启翻译游玩一段时间。所有被翻译过的文本都会自动记录在BepInEx\plugins\XUnity.AutoTranslator\Translation\zh-CN\Text\_AutoGeneratedTranslations.txt中。用记事本或VS Code等编辑器打开这个文件。你会看到类似这样的内容こんにちはHello ありがとうThank you将机器翻译的结果修改为你想要的翻译。例如你知道“こんにちは”在这个游戏语境下是“您好”而不是“Hello”就改成こんにちは您好保存文件回到游戏按下ALTR。对应的文本会立刻更新为你的手动翻译。高级技巧创建独立词库你不应该直接修改庞大的_AutoGeneratedTranslations.txt文件因为游戏更新或重置缓存后它会被覆盖。最佳实践是在Translation\zh-CN\Text目录下新建一个Manual_GameTerms.txt。将你需要固定翻译的词条如角色名、技能名、物品名剪切进去。魔王Demon King 勇者Hero ヒールHealXUA会读取该目录下所有.txt文件且Manual_GameTerms.txt的优先级高于_AutoGeneratedTranslations.txt。这样即使自动缓存重置你的精心翻译也会保留。5. 开发者视角扩展插件与资源重定向对于Mod开发者或高级用户XUA提供了丰富的API允许你深度定制或开发基于它的新功能。5.1 实现一个自定义翻译端点假设你想接入一个冷门但好用的翻译API。你需要创建一个类库项目。引用添加对XUnity.AutoTranslator.Plugin.Core.dll的引用。实现接口创建一个类实现ITranslateEndpoint接口或继承自HttpEndpoint等基类。核心方法在Translate方法中编写调用你API的逻辑并将结果通过context.Complete(translatedText)返回。部署将编译好的DLL放入游戏的BepInEx\plugins\XUnity.AutoTranslator\Translators文件夹。一个极简的示例反转字符串的“翻译器”public class ReverserEndpoint : ITranslateEndpoint { public string Id Reverser; // 在配置中EndpointReverser public string FriendlyName Text Reverser; public int MaxConcurrency 10; public int MaxTranslationsPerRequest 1; public void Initialize(IInitializationContext context) { // 这里可以读取你的自定义配置比如API Key // var myKey context.GetOrCreateSetting(Reverser, ApiKey, ); } public IEnumerator Translate(ITranslationContext context) { // 简单地将原文反转 char[] charArray context.UntranslatedText.ToCharArray(); Array.Reverse(charArray); string reversedText new string(charArray); // 模拟网络延迟 // yield return new WaitForSeconds(0.1f); // 完成翻译 context.Complete(reversedText); yield break; } }5.2 使用资源重定向API修改游戏资源Resource Redirector的API非常强大。例如你想修改游戏加载的某个特定音频文件public class MyAudioModPlugin : BaseUnityPlugin { void Awake() { // 注册资源加载后的钩子 ResourceRedirection.RegisterResourceLoadedHook( HookBehaviour.OneCallbackPerResourceLoaded, 100, // 优先级 OnResourceLoaded); } private void OnResourceLoaded(ResourceLoadedContext context) { // 检查加载的资源类型和路径 if (context.Parameters.Type typeof(AudioClip) context.Parameters.Path.EndsWith(my_bgm.wav)) { // 从本地文件加载替换的音频 string customAudioPath Path.Combine(Paths.PluginPath, MyMod, new_bgm.wav); if (File.Exists(customAudioPath)) { // 使用WWW或UnityWebRequest加载自定义音频此处简化 // AudioClip customClip ...; // context.Asset customClip; // 替换资源 Logger.LogInfo($替换了音频: {context.Parameters.Path}); } context.Complete(true); // 跳过其他后置钩子 } } }通过这种方式你可以实现不修改游戏原始文件的前提下替换任何通过Resources API加载的资产包括纹理、音频、文本资产等为制作大型Mod提供了底层支持。6. 伦理、性能与最佳实践最后分享一些“软性”经验。使用这类工具不仅要考虑“能不能”还要考虑“该不该”和“怎么样最好”。关于性能XUA在翻译时会有微小开销。在低配电脑或大型开放世界游戏中如果开启了全场景纹理扫描EnableTextureScanOnSceneLoad或加载了大量高分辨率替换图片可能会引起卡顿。我的建议是按需启用功能。90%的情况下只启用文本翻译就足够了。图片翻译是最后的手段。关于翻译服务请尊重翻译API的服务条款。不要设置过高的并发MaxConcurrency或过短的请求间隔以免被服务商封禁IP或API Key。使用批处理EnableBatching是礼貌且高效的做法。如果可能优先使用提供免费额度或有明确商用条款的API。关于分享XUA鼓励你分享翻译缓存文件_AutoGeneratedTranslations.txt来帮助其他玩家。但绝对不要分享包含以下内容的配置或插件包启用了EnableTextureDumping、EnableTextureToggling、LoadUnmodifiedTextures或DetectDuplicateTextureNames的配置这些会导出或干扰游戏原始资源。内置了非公开、需要付费API Key的翻译端点配置。修改过的、指向非官方或自定义服务器的插件DLL除非你完全信任其来源。关于更新Unity游戏更新频繁有时会改变内部结构导致钩子失效。如果某天XUA突然不工作了第一反应不应该是抱怨插件而是去GitHub的Issues页面或相关社区看看是否有新版本发布。保持插件和游戏版本的同步是长久稳定使用的关键。折腾的过程本身从安装配置、调试参数、到最终看到游戏里流畅显示母语的那一刻所带来的成就感和愉悦有时甚至超过了游戏本身。希望这篇超详细的指南能帮你少走弯路更顺畅地享受那些未被官方汉化的佳作。如果在使用中发现了什么独特的技巧或踩到了新的坑不妨也分享出来让这个社区工具变得更加完善。