1. 项目概述当Unity游戏遇上语言壁垒如果你是一名热爱独立游戏或日系RPG的玩家或者是一位需要处理多语言版本发行的游戏开发者那么“语言不通”这个问题大概率是你绕不开的痛点。面对屏幕上密密麻麻的异国文字无论是想沉浸体验剧情还是进行本地化测试都让人头疼不已。手动替换文本资源那意味着要解包游戏、修改资源、重新打包过程繁琐且极易出错对于加密或更新频繁的游戏更是难上加难。正是在这种普遍需求下XUnity.AutoTranslator应运而生。它不是一个简单的文本替换工具而是一个运行在游戏进程内、功能强大的实时翻译与资源重定向框架。简单来说它就像给Unity游戏安装了一个“同声传译”插件。游戏运行时当需要显示文本或加载图片时插件会拦截这些请求然后从你配置的翻译服务如谷歌翻译、百度翻译或本地的翻译文件中获取对应的译文并动态替换到游戏界面上。整个过程对游戏本身几乎无感实现了真正的“实时”翻译。这个项目的核心价值在于其非侵入性和高度可定制性。你不需要游戏的源代码也不需要重新编译游戏。它通过BepInEx、IPA或ReiPatcher等Unity Mod管理器注入游戏进程利用Harmony或MonoMod等技术在运行时“勾住”HookUnity引擎的文本渲染和资源加载函数从而实现动态替换。对于玩家它提供了开箱即用的多语言游戏体验对于Mod作者和本地化团队它则是一套强大的、可用于制作汉化补丁或进行本地化测试的底层框架。2. 核心架构与工作原理拆解要理解XUnity.AutoTranslator的强大之处我们需要深入其内部看看它是如何在不修改游戏原始文件的情况下实现如此复杂的功能的。2.1 核心模块翻译器与资源重定向器的双引擎驱动XUnity.AutoTranslator主要由两大核心模块构成它们协同工作构成了插件的基础。翻译器模块是大脑负责文本的识别、翻译和替换。其工作流程可以概括为“拦截-查询-替换”拦截插件会Hook住Unity中用于设置文本的底层方法例如TextMeshPro的text属性设置器、UGUI Text组件的文本更新等。当游戏调用这些方法显示文字时插件会首先截获原始的未翻译文本。查询插件拿到原始文本后会先在本地翻译缓存文件通常是_AutoGeneratedTranslations.txt中进行查找。如果找到了匹配的译文则直接使用。如果没有找到且用户配置了在线翻译端点如Google Translate插件就会将文本发送到对应的翻译API获取译文并将结果保存到本地缓存中供后续使用。替换最后插件将获取到的译文文本设置回游戏的UI组件中替换掉原本要显示的原文。这个过程对游戏逻辑是透明的游戏“以为”它显示的就是自己设置的原始文本。资源重定向器模块是扩展的双手它提供了更底层的资源替换能力。如果说翻译器模块是针对“文本流”的那么资源重定向器就是针对“资源文件”本身的。它可以拦截Unity引擎加载资源如Resources.Load和AssetBundle的调用。文本资源重定向这是AutoTranslator自带的默认功能。当游戏尝试加载一个TextAsset例如.txt、.json配置文件时重定向器可以将其重定向到插件目录下的一个修改后的版本。这意味着你可以直接替换游戏内的脚本文件、对话文件实现更彻底、更稳定的翻译尤其是对付那些把文本硬编码在二进制文件里的游戏。纹理替换从2.16.0版本开始插件支持替换游戏内的图片纹理。这对于翻译游戏内的UI图标、带有文字的图片按钮至关重要。插件通过计算纹理的哈希值来唯一标识游戏内的每一张图片并将替换用的图片如汉化后的按钮图以相同的哈希命名存放在指定目录游戏加载时便会自动使用你的版本。2.2 关键技术Harmony与MonoMod的运行时注入实现上述拦截功能的核心是运行时补丁技术。XUnity.AutoTranslator主要依赖两种方案Harmony这是一个非常流行的.NET库用于在运行时修改、替换或包装已有方法。它通过创建方法的前缀Prefix、后缀Postfix或绕行Transpiler补丁来改变原有方法的执行逻辑。Harmony是插件默认使用的钩子方案稳定且高效。MonoMod这是一个更底层的工具集用于直接修改程序集。当Harmony无法钩住某些特殊方法例如没有方法体的抽象方法或基于.NET Standard 2.0构建的Unity版本中的方法时MonoMod可以作为备选方案。在插件的配置中你可以通过设置ForceMonoModHooksTrue来强制使用MonoMod。注意选择哪种钩子方案通常不需要用户操心插件会根据游戏环境自动选择最合适的。但在某些极端情况下如果遇到翻译不生效或游戏崩溃可以尝试在配置中切换钩子方案进行排查。2.3 配置体系高度可定制的行为控制插件的所有行为都通过一个名为Config.ini的配置文件进行控制。这个文件结构清晰分为了多个区块Section每个区块管理一类功能[General]核心设置如源语言、目标语言、翻译端点选择、热键等。[Behaviour]插件行为微调如是否启用UI自动重设大小、是否忽略特定开头的文本等。[Texture]纹理替换功能的相关设置。[Http]网络请求相关设置如User-Agent。[Google]、[Baidu]等各个翻译服务所需的API密钥配置。理解并熟练编辑这个配置文件是玩转XUnity.AutoTranslator的关键。例如通过修改[General]下的Language和FromLanguage你可以指定翻译的方向如从日语到简体中文。通过配置[Google]下的ServiceUrl在某些网络环境下可能需要你可以指定谷歌翻译API的自定义端点。3. 从零开始完整部署与配置实战理论说得再多不如动手操作一遍。下面我将以最常见的BepInEx模组框架为例带你完成一次完整的XUnity.AutoTranslator部署与基础配置。3.1 环境准备与插件安装首先确保你的目标Unity游戏能够使用BepInEx。通常社区会有针对特定游戏的BepInEx安装教程。下载插件前往项目的GitHub Releases页面下载对应BepInEx版本的插件包通常是XUnity.AutoTranslator-BepInEx-{VERSION}.zip。安装插件将压缩包解压你会看到BepInEx文件夹。将其中的plugins和patchers如果有文件夹整体复制到你的游戏根目录即Game.exe所在的目录。如果提示文件合并选择覆盖即可。首次运行启动游戏。如果安装成功游戏启动时在命令行窗口或游戏内如果启用了控制台会看到XUnity.AutoTranslator的初始化日志。首次运行后插件会在BepInEx\plugins目录下生成Translation文件夹和Config.ini配置文件。3.2 核心配置文件详解与调优首次运行后打开BepInEx\plugins\XUnity.AutoTranslator\Config.ini我们将对关键参数进行设置。[General] ; 目标语言即你想翻译成的语言。例如zh-CN (简体中文), en (英语), ja (日语) Languagezh-CN ; 源语言即游戏原本的语言。如果留空插件会尝试自动检测。 FromLanguage ; 翻译服务端点。这是核心设置决定使用哪个翻译引擎。 ; 可选值GoogleTranslate, GoogleTranslateLegitimate, BaiduTranslate, YandexTranslate, DeepL等留空则禁用在线翻译。 EndpointGoogleTranslate ; 在线翻译延迟秒。避免请求过快被服务商限制。 DelaySeconds1.5 [Behaviour] ; 是否启用UI自动重设大小。翻译后文本长度可能变化启用此选项可尝试自动调整文本框大小。 EnableUIResizingTrue ; 是否启用文本路径日志。调试时非常有用会在日志中输出每个文本组件的完整路径。 EnableTextPathLoggingFalse ; 最大翻译字符数。超过此长度的文本不会被翻译避免翻译长文本出错或超时。 MaxCharactersPerTranslation500 [Google] ; 谷歌翻译API的自定义服务地址。在某些网络环境下你可能需要配置一个可访问的代理地址。 ; ServiceUrlhttps://translate.google.com配置心得Endpoint选择对于国内用户BaiduTranslate通常是延迟最低、最稳定的选择但需要申请百度翻译开放平台的AppID和密钥。GoogleTranslate是免费且支持语言最广的但可能需要网络条件。DeepL的翻译质量公认较高但有调用频率限制。DelaySeconds设置不要设置得太小尤其是使用免费API时过于频繁的请求会导致IP被暂时封禁。1.5到3秒是一个比较安全的区间。EnableUIResizing对于UI布局紧凑的游戏务必开启此项否则翻译后的文字可能会显示不全被截断。3.3 翻译源管理本地缓存与手动翻译插件运行后所有通过在线翻译获得的文本都会自动保存到Translation\{Language}\Text\_AutoGeneratedTranslations.txt文件中。这个文件就是你的本地翻译缓存库。手动修正翻译机器翻译难免有生硬或错误的地方。你可以直接打开这个txt文件进行编辑。文件格式非常简单就是“原文译文”的键值对。例如こんにちは你好 新しいゲーム开始新游戏保存文件后在游戏中按默认热键AltR即可即时重载翻译文件看到修正后的效果。翻译文件优先级插件会读取Translation\{Language}\Text目录下所有的.txt文件。你可以创建多个文件来分类管理翻译例如Items.txt专门放物品翻译Dialogue.txt放对话翻译。当同一个原文出现在不同文件时_AutoGeneratedTranslations.txt的优先级最低其他手动创建的文件优先级更高。这方便你进行版本管理和协作。高级功能正则表达式与文本拆分对于游戏中动态拼接的文本如“攻击力10”直接翻译整个字符串会很困难。插件支持在翻译文件中使用正则表达式。标准正则替换以r:开头。例如r:^攻击力\([0-9])$Attack $1拆分器正则以sr:开头。用于将复合文本拆分成多个部分分别翻译再组合。例如游戏显示“01 healing potion”你可以写sr:^([0-9]{2}) ([\S\s])$$1 $2这样插件会先拆分出“01”和“healing potion”然后单独去翻译“healing potion”这个词组。4. 高级应用与疑难排错指南掌握了基础配置我们就可以探索一些更高级的功能并解决实际使用中可能遇到的棘手问题。4.1 字体替换解决中文显示方块问题这是汉化过程中最常见的问题之一。许多游戏的原始字体不包含中文字符集导致翻译出来的中文全部显示为“□□□”。解决方案使用插件的字体覆盖功能。获取字体文件你需要一个包含目标语言字符的.ttf或.otf字体文件例如“微软雅黑”。针对TextMeshPro这是现代Unity游戏最常用的文本系统。你需要将字体文件制作成TextMeshPro可用的SDF Font Asset。这通常需要使用Unity编辑器。一个取巧的方法是寻找社区已经制作好的、适用于常见Unity版本的字体AssetBundle有时在插件发布页的“TMP_Font_AssetBundles”中能找到。将下载的.font或.assetbundle文件放入游戏根目录。修改配置在Config.ini中找到[Behaviour]部分设置[Behaviour] ; 对于UGUI系统使用系统字体名 OverrideFontMicrosoft YaHei ; 对于TextMeshPro系统指定字体AssetBundle的文件名不含扩展名或Resources路径 OverrideFontTextMeshProMyChineseFont ; 或者使用回退字体这是更推荐的方式只对缺失字符使用备用字体 FallbackFontTextMeshProMyChineseFontFallbackFontTextMeshPro是更好的选择它让游戏优先使用原有字体只在遇到无法显示的字符如中文时才使用你指定的字体能更好地保持UI原貌。4.2 纹理图片翻译实战翻译UI上的图片按钮、图标是完整本地化的关键一步。启用功能在Config.ini中设置[Texture] EnableTextureTranslationTrue EnableTextureDumpingTrue ; 首次使用时开启用于导出游戏内所有纹理 TextureHashGenerationStrategyFromImageName ; 推荐使用性能最好导出纹理启动游戏并尽可能浏览所有界面。插件会将游戏加载的纹理图片自动导出到Translation\Texture目录下文件名会包含一个哈希值如button_attack [ABCD1234-EF567890].png。编辑与替换用图片编辑软件如Photoshop、GIMP打开导出的图片将上面的外文修改为目标语言。关键一步保存时必须保持文件名完全不变包括中括号里的哈希值。这个哈希值是插件识别和匹配游戏内原始纹理的唯一依据。关闭导出享受成果编辑完成后将配置中的EnableTextureDumping改回False以避免重复导出和性能损耗。重新进入游戏对应的图片就应该已经被替换成你修改后的版本了。重要警告EnableTextureDumping、EnableTextureToggling、LoadUnmodifiedTextures、DetectDuplicateTextureNames这几个选项会显著影响性能且可能导致视觉错误。在制作完翻译补丁准备分发时务必确保它们都是False。4.3 常见问题与排查技巧实录即使配置正确在实际使用中也可能遇到各种问题。下面是一个常见问题速查表问题现象可能原因解决方案游戏启动崩溃或黑屏1. BepInEx版本与游戏或插件不兼容。2. 与其他Mod冲突。3. 钩子方式不兼容。1. 尝试更换BepInEx版本5.x/6.x。2. 暂时移除其他Mod单独测试AutoTranslator。3. 在Config.ini中尝试设置ForceMonoModHooksTrue或False。翻译完全不显示1. 在线翻译端点配置错误或网络不通。2. 目标语言代码设置错误。3. 插件未成功加载。1. 检查Endpoint配置尝试切换为BaiduTranslate并配置正确的AppID/密钥。2. 确认Language代码正确如简体中文是zh-CN。3. 查看游戏启动日志确认XUnity.AutoTranslator初始化成功。部分文本未被翻译1. 文本可能来自动态生成或脚本。2. 文本被游戏逻辑特殊处理。3. 文本长度超过MaxCharactersPerTranslation限制。1. 尝试开启EnableTextPathLogging查看该文本是否被插件捕获。2. 尝试开启TextGetterCompatibilityModeTrue这能欺骗游戏逻辑。3. 适当调大MaxCharactersPerTranslation的值但不要超过1000。翻译后UI布局错乱翻译文本长度远超原文UI组件未自适应。1. 确保EnableUIResizingTrue。2. 更精细的控制创建resizer.txt文件手动指定特定UI路径的字体缩放比例。例如UI/SomePanel/TextChangeFontSizeByPercentage(0.8)。中文显示为方块游戏字体缺失中文字形。按照上文“字体替换”章节操作配置FallbackFontTextMeshPro。在线翻译速度极慢或失败翻译API限制或网络问题。1. 增加DelaySeconds如设为3。2. 为谷歌翻译配置可用的ServiceUrl。3. 考虑使用离线翻译词典或主要依赖事先准备好的本地翻译文件。ALTT热键无效热键被游戏或其他软件占用。在Config.ini的[General]章节修改ToggleTranslationKey和ReloadTranslationsKey更换为其他按键组合。调试心法当遇到任何奇怪的问题时第一件事是打开日志。在Config.ini中设置[Debug] EnableConsoleTrue和EnableLogTrue然后重启游戏。仔细观察控制台输出的错误信息或警告它们能提供最直接的线索。例如如果日志中频繁出现“Failed to translate”或网络超时错误那问题肯定出在翻译端点上。5. 面向开发者扩展插件与资源重定向对于想要深度定制或为特定游戏制作高质量汉化补丁的开发者XUnity.AutoTranslator提供了强大的扩展能力。5.1 实现自定义翻译端点如果你有自己的翻译服务或想接入小众的翻译API可以自行实现ITranslateEndpoint接口。创建类库项目新建一个.NET Framework 3.5或.NET Standard类库项目需修改为net35目标框架。引用与继承引用插件提供的XUnity.AutoTranslator.Plugin.Core.dll。你的类需要实现ITranslateEndpoint接口或更简单地继承自HttpEndpoint基类适用于基于HTTP API的服务。核心方法Id和FriendlyName定义你端点的唯一标识和显示名称。Initialize在这里读取配置、验证API密钥等。OnCreateRequest构建发送给翻译API的HTTP请求。OnExtractTranslation从API响应中解析出翻译结果。编译与部署将编译好的DLL文件放入游戏的BepInEx\plugins\XUnity.AutoTranslator\Translators目录。重启游戏后你就可以在插件的端点列表中选择你自己的翻译服务了。5.2 使用资源重定向器进行深度修改资源重定向器Resource Redirector是一个独立但随AutoTranslator分发的强大库。它允许你在资源加载的瞬间对其进行修改或替换。一个典型场景替换游戏内的音频文件。假设你想把游戏的日语音效替换成中文配音。创建插件项目同样创建一个类库项目引用XUnity.ResourceRedirector.dll。注册钩子在你的插件初始化代码中如Awake或Start方法注册资源加载的回调。public void Awake() { ResourceRedirection.RegisterAssetLoadedHook(HookBehaviour.OneCallbackPerResourceLoaded, 100, OnAssetLoaded); }实现回调逻辑在OnAssetLoaded方法中检查加载的资源类型和路径。private void OnAssetLoaded(AssetLoadedContext context) { // 检查是否是音频资源并且路径包含我们想替换的特定语音文件 if (context.Asset is AudioClip audioClip context.Parameters.Name.Contains(japanese_voice_01)) { // 从本地文件加载替换后的中文音频 AudioClip myChineseClip LoadMyAudioClip(chinese_voice_01.wav); if (myChineseClip ! null) { context.Asset myChineseClip; // 进行替换 context.Complete(true); // 完成跳过其他后置钩子 } } }部署将编译好的DLL作为普通BepInEx插件安装。这样当游戏加载那个日语音频时实际加载的就会是你提供的中文版本。通过资源重定向器你几乎可以修改游戏加载的任何资源——模型、贴图、动画、脚本这为制作大型Mod或完全本地化提供了无限可能。不过这也要求开发者对Unity的资源系统和目标游戏的结构有较深的理解。XUnity.AutoTranslator的成功在于它精准地捕捉到了Unity游戏社区对无障碍语言体验的强烈需求并以一种优雅、非侵入式的技术方案提供了解决路径。它不仅仅是一个工具更是一个平台通过开放的API和可扩展的架构吸引了大量开发者和本地化爱好者共同构建生态。从简单的实时屏幕翻译到复杂的、包含图片和音频的完整本地化补丁这个项目证明了通过社区的力量和精巧的技术语言的壁垒在数字世界中正变得越来越容易跨越。
1. 项目概述当Unity游戏遇上语言壁垒如果你是一名热爱独立游戏或日系RPG的玩家或者是一位需要处理多语言版本发行的游戏开发者那么“语言不通”这个问题大概率是你绕不开的痛点。面对屏幕上密密麻麻的异国文字无论是想沉浸体验剧情还是进行本地化测试都让人头疼不已。手动替换文本资源那意味着要解包游戏、修改资源、重新打包过程繁琐且极易出错对于加密或更新频繁的游戏更是难上加难。正是在这种普遍需求下XUnity.AutoTranslator应运而生。它不是一个简单的文本替换工具而是一个运行在游戏进程内、功能强大的实时翻译与资源重定向框架。简单来说它就像给Unity游戏安装了一个“同声传译”插件。游戏运行时当需要显示文本或加载图片时插件会拦截这些请求然后从你配置的翻译服务如谷歌翻译、百度翻译或本地的翻译文件中获取对应的译文并动态替换到游戏界面上。整个过程对游戏本身几乎无感实现了真正的“实时”翻译。这个项目的核心价值在于其非侵入性和高度可定制性。你不需要游戏的源代码也不需要重新编译游戏。它通过BepInEx、IPA或ReiPatcher等Unity Mod管理器注入游戏进程利用Harmony或MonoMod等技术在运行时“勾住”HookUnity引擎的文本渲染和资源加载函数从而实现动态替换。对于玩家它提供了开箱即用的多语言游戏体验对于Mod作者和本地化团队它则是一套强大的、可用于制作汉化补丁或进行本地化测试的底层框架。2. 核心架构与工作原理拆解要理解XUnity.AutoTranslator的强大之处我们需要深入其内部看看它是如何在不修改游戏原始文件的情况下实现如此复杂的功能的。2.1 核心模块翻译器与资源重定向器的双引擎驱动XUnity.AutoTranslator主要由两大核心模块构成它们协同工作构成了插件的基础。翻译器模块是大脑负责文本的识别、翻译和替换。其工作流程可以概括为“拦截-查询-替换”拦截插件会Hook住Unity中用于设置文本的底层方法例如TextMeshPro的text属性设置器、UGUI Text组件的文本更新等。当游戏调用这些方法显示文字时插件会首先截获原始的未翻译文本。查询插件拿到原始文本后会先在本地翻译缓存文件通常是_AutoGeneratedTranslations.txt中进行查找。如果找到了匹配的译文则直接使用。如果没有找到且用户配置了在线翻译端点如Google Translate插件就会将文本发送到对应的翻译API获取译文并将结果保存到本地缓存中供后续使用。替换最后插件将获取到的译文文本设置回游戏的UI组件中替换掉原本要显示的原文。这个过程对游戏逻辑是透明的游戏“以为”它显示的就是自己设置的原始文本。资源重定向器模块是扩展的双手它提供了更底层的资源替换能力。如果说翻译器模块是针对“文本流”的那么资源重定向器就是针对“资源文件”本身的。它可以拦截Unity引擎加载资源如Resources.Load和AssetBundle的调用。文本资源重定向这是AutoTranslator自带的默认功能。当游戏尝试加载一个TextAsset例如.txt、.json配置文件时重定向器可以将其重定向到插件目录下的一个修改后的版本。这意味着你可以直接替换游戏内的脚本文件、对话文件实现更彻底、更稳定的翻译尤其是对付那些把文本硬编码在二进制文件里的游戏。纹理替换从2.16.0版本开始插件支持替换游戏内的图片纹理。这对于翻译游戏内的UI图标、带有文字的图片按钮至关重要。插件通过计算纹理的哈希值来唯一标识游戏内的每一张图片并将替换用的图片如汉化后的按钮图以相同的哈希命名存放在指定目录游戏加载时便会自动使用你的版本。2.2 关键技术Harmony与MonoMod的运行时注入实现上述拦截功能的核心是运行时补丁技术。XUnity.AutoTranslator主要依赖两种方案Harmony这是一个非常流行的.NET库用于在运行时修改、替换或包装已有方法。它通过创建方法的前缀Prefix、后缀Postfix或绕行Transpiler补丁来改变原有方法的执行逻辑。Harmony是插件默认使用的钩子方案稳定且高效。MonoMod这是一个更底层的工具集用于直接修改程序集。当Harmony无法钩住某些特殊方法例如没有方法体的抽象方法或基于.NET Standard 2.0构建的Unity版本中的方法时MonoMod可以作为备选方案。在插件的配置中你可以通过设置ForceMonoModHooksTrue来强制使用MonoMod。注意选择哪种钩子方案通常不需要用户操心插件会根据游戏环境自动选择最合适的。但在某些极端情况下如果遇到翻译不生效或游戏崩溃可以尝试在配置中切换钩子方案进行排查。2.3 配置体系高度可定制的行为控制插件的所有行为都通过一个名为Config.ini的配置文件进行控制。这个文件结构清晰分为了多个区块Section每个区块管理一类功能[General]核心设置如源语言、目标语言、翻译端点选择、热键等。[Behaviour]插件行为微调如是否启用UI自动重设大小、是否忽略特定开头的文本等。[Texture]纹理替换功能的相关设置。[Http]网络请求相关设置如User-Agent。[Google]、[Baidu]等各个翻译服务所需的API密钥配置。理解并熟练编辑这个配置文件是玩转XUnity.AutoTranslator的关键。例如通过修改[General]下的Language和FromLanguage你可以指定翻译的方向如从日语到简体中文。通过配置[Google]下的ServiceUrl在某些网络环境下可能需要你可以指定谷歌翻译API的自定义端点。3. 从零开始完整部署与配置实战理论说得再多不如动手操作一遍。下面我将以最常见的BepInEx模组框架为例带你完成一次完整的XUnity.AutoTranslator部署与基础配置。3.1 环境准备与插件安装首先确保你的目标Unity游戏能够使用BepInEx。通常社区会有针对特定游戏的BepInEx安装教程。下载插件前往项目的GitHub Releases页面下载对应BepInEx版本的插件包通常是XUnity.AutoTranslator-BepInEx-{VERSION}.zip。安装插件将压缩包解压你会看到BepInEx文件夹。将其中的plugins和patchers如果有文件夹整体复制到你的游戏根目录即Game.exe所在的目录。如果提示文件合并选择覆盖即可。首次运行启动游戏。如果安装成功游戏启动时在命令行窗口或游戏内如果启用了控制台会看到XUnity.AutoTranslator的初始化日志。首次运行后插件会在BepInEx\plugins目录下生成Translation文件夹和Config.ini配置文件。3.2 核心配置文件详解与调优首次运行后打开BepInEx\plugins\XUnity.AutoTranslator\Config.ini我们将对关键参数进行设置。[General] ; 目标语言即你想翻译成的语言。例如zh-CN (简体中文), en (英语), ja (日语) Languagezh-CN ; 源语言即游戏原本的语言。如果留空插件会尝试自动检测。 FromLanguage ; 翻译服务端点。这是核心设置决定使用哪个翻译引擎。 ; 可选值GoogleTranslate, GoogleTranslateLegitimate, BaiduTranslate, YandexTranslate, DeepL等留空则禁用在线翻译。 EndpointGoogleTranslate ; 在线翻译延迟秒。避免请求过快被服务商限制。 DelaySeconds1.5 [Behaviour] ; 是否启用UI自动重设大小。翻译后文本长度可能变化启用此选项可尝试自动调整文本框大小。 EnableUIResizingTrue ; 是否启用文本路径日志。调试时非常有用会在日志中输出每个文本组件的完整路径。 EnableTextPathLoggingFalse ; 最大翻译字符数。超过此长度的文本不会被翻译避免翻译长文本出错或超时。 MaxCharactersPerTranslation500 [Google] ; 谷歌翻译API的自定义服务地址。在某些网络环境下你可能需要配置一个可访问的代理地址。 ; ServiceUrlhttps://translate.google.com配置心得Endpoint选择对于国内用户BaiduTranslate通常是延迟最低、最稳定的选择但需要申请百度翻译开放平台的AppID和密钥。GoogleTranslate是免费且支持语言最广的但可能需要网络条件。DeepL的翻译质量公认较高但有调用频率限制。DelaySeconds设置不要设置得太小尤其是使用免费API时过于频繁的请求会导致IP被暂时封禁。1.5到3秒是一个比较安全的区间。EnableUIResizing对于UI布局紧凑的游戏务必开启此项否则翻译后的文字可能会显示不全被截断。3.3 翻译源管理本地缓存与手动翻译插件运行后所有通过在线翻译获得的文本都会自动保存到Translation\{Language}\Text\_AutoGeneratedTranslations.txt文件中。这个文件就是你的本地翻译缓存库。手动修正翻译机器翻译难免有生硬或错误的地方。你可以直接打开这个txt文件进行编辑。文件格式非常简单就是“原文译文”的键值对。例如こんにちは你好 新しいゲーム开始新游戏保存文件后在游戏中按默认热键AltR即可即时重载翻译文件看到修正后的效果。翻译文件优先级插件会读取Translation\{Language}\Text目录下所有的.txt文件。你可以创建多个文件来分类管理翻译例如Items.txt专门放物品翻译Dialogue.txt放对话翻译。当同一个原文出现在不同文件时_AutoGeneratedTranslations.txt的优先级最低其他手动创建的文件优先级更高。这方便你进行版本管理和协作。高级功能正则表达式与文本拆分对于游戏中动态拼接的文本如“攻击力10”直接翻译整个字符串会很困难。插件支持在翻译文件中使用正则表达式。标准正则替换以r:开头。例如r:^攻击力\([0-9])$Attack $1拆分器正则以sr:开头。用于将复合文本拆分成多个部分分别翻译再组合。例如游戏显示“01 healing potion”你可以写sr:^([0-9]{2}) ([\S\s])$$1 $2这样插件会先拆分出“01”和“healing potion”然后单独去翻译“healing potion”这个词组。4. 高级应用与疑难排错指南掌握了基础配置我们就可以探索一些更高级的功能并解决实际使用中可能遇到的棘手问题。4.1 字体替换解决中文显示方块问题这是汉化过程中最常见的问题之一。许多游戏的原始字体不包含中文字符集导致翻译出来的中文全部显示为“□□□”。解决方案使用插件的字体覆盖功能。获取字体文件你需要一个包含目标语言字符的.ttf或.otf字体文件例如“微软雅黑”。针对TextMeshPro这是现代Unity游戏最常用的文本系统。你需要将字体文件制作成TextMeshPro可用的SDF Font Asset。这通常需要使用Unity编辑器。一个取巧的方法是寻找社区已经制作好的、适用于常见Unity版本的字体AssetBundle有时在插件发布页的“TMP_Font_AssetBundles”中能找到。将下载的.font或.assetbundle文件放入游戏根目录。修改配置在Config.ini中找到[Behaviour]部分设置[Behaviour] ; 对于UGUI系统使用系统字体名 OverrideFontMicrosoft YaHei ; 对于TextMeshPro系统指定字体AssetBundle的文件名不含扩展名或Resources路径 OverrideFontTextMeshProMyChineseFont ; 或者使用回退字体这是更推荐的方式只对缺失字符使用备用字体 FallbackFontTextMeshProMyChineseFontFallbackFontTextMeshPro是更好的选择它让游戏优先使用原有字体只在遇到无法显示的字符如中文时才使用你指定的字体能更好地保持UI原貌。4.2 纹理图片翻译实战翻译UI上的图片按钮、图标是完整本地化的关键一步。启用功能在Config.ini中设置[Texture] EnableTextureTranslationTrue EnableTextureDumpingTrue ; 首次使用时开启用于导出游戏内所有纹理 TextureHashGenerationStrategyFromImageName ; 推荐使用性能最好导出纹理启动游戏并尽可能浏览所有界面。插件会将游戏加载的纹理图片自动导出到Translation\Texture目录下文件名会包含一个哈希值如button_attack [ABCD1234-EF567890].png。编辑与替换用图片编辑软件如Photoshop、GIMP打开导出的图片将上面的外文修改为目标语言。关键一步保存时必须保持文件名完全不变包括中括号里的哈希值。这个哈希值是插件识别和匹配游戏内原始纹理的唯一依据。关闭导出享受成果编辑完成后将配置中的EnableTextureDumping改回False以避免重复导出和性能损耗。重新进入游戏对应的图片就应该已经被替换成你修改后的版本了。重要警告EnableTextureDumping、EnableTextureToggling、LoadUnmodifiedTextures、DetectDuplicateTextureNames这几个选项会显著影响性能且可能导致视觉错误。在制作完翻译补丁准备分发时务必确保它们都是False。4.3 常见问题与排查技巧实录即使配置正确在实际使用中也可能遇到各种问题。下面是一个常见问题速查表问题现象可能原因解决方案游戏启动崩溃或黑屏1. BepInEx版本与游戏或插件不兼容。2. 与其他Mod冲突。3. 钩子方式不兼容。1. 尝试更换BepInEx版本5.x/6.x。2. 暂时移除其他Mod单独测试AutoTranslator。3. 在Config.ini中尝试设置ForceMonoModHooksTrue或False。翻译完全不显示1. 在线翻译端点配置错误或网络不通。2. 目标语言代码设置错误。3. 插件未成功加载。1. 检查Endpoint配置尝试切换为BaiduTranslate并配置正确的AppID/密钥。2. 确认Language代码正确如简体中文是zh-CN。3. 查看游戏启动日志确认XUnity.AutoTranslator初始化成功。部分文本未被翻译1. 文本可能来自动态生成或脚本。2. 文本被游戏逻辑特殊处理。3. 文本长度超过MaxCharactersPerTranslation限制。1. 尝试开启EnableTextPathLogging查看该文本是否被插件捕获。2. 尝试开启TextGetterCompatibilityModeTrue这能欺骗游戏逻辑。3. 适当调大MaxCharactersPerTranslation的值但不要超过1000。翻译后UI布局错乱翻译文本长度远超原文UI组件未自适应。1. 确保EnableUIResizingTrue。2. 更精细的控制创建resizer.txt文件手动指定特定UI路径的字体缩放比例。例如UI/SomePanel/TextChangeFontSizeByPercentage(0.8)。中文显示为方块游戏字体缺失中文字形。按照上文“字体替换”章节操作配置FallbackFontTextMeshPro。在线翻译速度极慢或失败翻译API限制或网络问题。1. 增加DelaySeconds如设为3。2. 为谷歌翻译配置可用的ServiceUrl。3. 考虑使用离线翻译词典或主要依赖事先准备好的本地翻译文件。ALTT热键无效热键被游戏或其他软件占用。在Config.ini的[General]章节修改ToggleTranslationKey和ReloadTranslationsKey更换为其他按键组合。调试心法当遇到任何奇怪的问题时第一件事是打开日志。在Config.ini中设置[Debug] EnableConsoleTrue和EnableLogTrue然后重启游戏。仔细观察控制台输出的错误信息或警告它们能提供最直接的线索。例如如果日志中频繁出现“Failed to translate”或网络超时错误那问题肯定出在翻译端点上。5. 面向开发者扩展插件与资源重定向对于想要深度定制或为特定游戏制作高质量汉化补丁的开发者XUnity.AutoTranslator提供了强大的扩展能力。5.1 实现自定义翻译端点如果你有自己的翻译服务或想接入小众的翻译API可以自行实现ITranslateEndpoint接口。创建类库项目新建一个.NET Framework 3.5或.NET Standard类库项目需修改为net35目标框架。引用与继承引用插件提供的XUnity.AutoTranslator.Plugin.Core.dll。你的类需要实现ITranslateEndpoint接口或更简单地继承自HttpEndpoint基类适用于基于HTTP API的服务。核心方法Id和FriendlyName定义你端点的唯一标识和显示名称。Initialize在这里读取配置、验证API密钥等。OnCreateRequest构建发送给翻译API的HTTP请求。OnExtractTranslation从API响应中解析出翻译结果。编译与部署将编译好的DLL文件放入游戏的BepInEx\plugins\XUnity.AutoTranslator\Translators目录。重启游戏后你就可以在插件的端点列表中选择你自己的翻译服务了。5.2 使用资源重定向器进行深度修改资源重定向器Resource Redirector是一个独立但随AutoTranslator分发的强大库。它允许你在资源加载的瞬间对其进行修改或替换。一个典型场景替换游戏内的音频文件。假设你想把游戏的日语音效替换成中文配音。创建插件项目同样创建一个类库项目引用XUnity.ResourceRedirector.dll。注册钩子在你的插件初始化代码中如Awake或Start方法注册资源加载的回调。public void Awake() { ResourceRedirection.RegisterAssetLoadedHook(HookBehaviour.OneCallbackPerResourceLoaded, 100, OnAssetLoaded); }实现回调逻辑在OnAssetLoaded方法中检查加载的资源类型和路径。private void OnAssetLoaded(AssetLoadedContext context) { // 检查是否是音频资源并且路径包含我们想替换的特定语音文件 if (context.Asset is AudioClip audioClip context.Parameters.Name.Contains(japanese_voice_01)) { // 从本地文件加载替换后的中文音频 AudioClip myChineseClip LoadMyAudioClip(chinese_voice_01.wav); if (myChineseClip ! null) { context.Asset myChineseClip; // 进行替换 context.Complete(true); // 完成跳过其他后置钩子 } } }部署将编译好的DLL作为普通BepInEx插件安装。这样当游戏加载那个日语音频时实际加载的就会是你提供的中文版本。通过资源重定向器你几乎可以修改游戏加载的任何资源——模型、贴图、动画、脚本这为制作大型Mod或完全本地化提供了无限可能。不过这也要求开发者对Unity的资源系统和目标游戏的结构有较深的理解。XUnity.AutoTranslator的成功在于它精准地捕捉到了Unity游戏社区对无障碍语言体验的强烈需求并以一种优雅、非侵入式的技术方案提供了解决路径。它不仅仅是一个工具更是一个平台通过开放的API和可扩展的架构吸引了大量开发者和本地化爱好者共同构建生态。从简单的实时屏幕翻译到复杂的、包含图片和音频的完整本地化补丁这个项目证明了通过社区的力量和精巧的技术语言的壁垒在数字世界中正变得越来越容易跨越。
