1. 项目概述为什么我们需要游戏实时翻译工具如果你是一个热爱探索全球游戏作品的玩家或者是一个需要研究海外游戏设计、本地化方案的从业者那么语言障碍绝对是你绕不开的一座大山。Steam上那些只有日文、韩文或俄文的小众独立游戏常常因为看不懂剧情和菜单而让人望而却步一些尚未推出官方中文版的3A大作也让我们只能对着生硬的机翻补丁或干脆“盲玩”。手动截图、切到翻译软件、再切回游戏——这种繁琐的操作会彻底破坏沉浸感。正是在这种普遍需求下像XUnity.AutoTranslator这样的实时游戏文本翻译工具应运而生它就像一个常驻在游戏进程内的“同声传译”能将游戏界面、对话、物品描述等文本内容近乎实时地替换为你指定的语言。简单来说XUnity.AutoTranslator下文简称AutoTranslator是一个基于BepInEx插件框架主要面向Unity引擎游戏的翻译注入工具。它的核心工作原理是“钩住”Hook游戏渲染或处理文本的函数在文本被绘制到屏幕之前截获它调用外部翻译API如谷歌翻译、百度翻译、DeepL等进行翻译然后将翻译结果覆盖回原文本位置。整个过程对游戏本身的影响极小实现了“即玩即译”的体验。它解决的不仅仅是“看不懂”的问题更是“如何无缝、便捷地看懂”的问题。本指南将用最直白的方式带你三步掌握这个强大工具从原理到避坑让你能独立应对绝大多数游戏的实时翻译需求。2. 核心思路与工具选型为什么是XUnity.AutoTranslator市面上并非没有其他游戏翻译工具比如Visual Novel ReaderVNR专注于视觉小说Textractor则常用于GalGame。选择AutoTranslator是基于其泛用性、易用性和社区生态的综合考量。2.1 AutoTranslator的独特优势首先泛用性极强。由于它基于BepInEx而BepInEx是Unity游戏最流行的Mod加载器之一这意味着它能覆盖Steam上超过一半的游戏基于Unity引擎开发。对于非Unity游戏AutoTranslator也提供了通用注入器XUnity.ResourceRedirector等组件进行尝试虽然成功率不如Unity游戏高但仍有不少成功案例。其次高度可定制化。它不仅仅是一个“翻译器”更是一个翻译“框架”。你可以自由选择翻译引擎谷歌、百度、彩云小译等可以精细调整翻译触发规则哪些文本需要翻译、翻译的延迟时间等更强大的是它的缓存与词典功能。翻译过的文本会被自动保存到本地下次遇到相同文本时直接使用缓存无需再次请求网络这既提升了速度又避免了因频繁请求导致的API限额问题。你还可以手动编辑词典对特定词条进行固定翻译比如将游戏内的专有名词“Mana”固定译为“法力值”而不是每次都被机翻成“马纳”或“魔力”。第三对游戏体验的侵入性最小。它以内置插件Plugin的形式运行不需要你额外开启一个翻译软件并手动框选区域进行OCR光学字符识别。OCR翻译在字体特殊、背景复杂或文字快速滚动时识别率和速度都会大打折扣。AutoTranslator直接从游戏内存中读取文本准确率接近100%且延迟极低。2.2 核心组件与工作流解析理解AutoTranslator的工作流有助于你在出现问题时快速定位。其核心运行依赖于一个工具链BepInEx这是基石。它是一个.NET程序的插件注入框架负责在游戏启动时将我们编写的插件包括AutoTranslator加载到游戏进程中。XUnity.AutoTranslator主插件。它包含文本钩子、翻译逻辑、UI渲染可显示原文/译文对照和配置管理等功能。翻译插件AutoTranslator本身不包含翻译引擎需要额外的插件来对接具体API。例如XUnity.AutoTranslator.Plugin.GoogleTranslate或XUnity.AutoTranslator.Plugin.BaiduTranslate。可选XUnity.ResourceRedirector这是一个更底层的资源重定向工具可以帮助AutoTranslator拦截更多类型的文本资源尤其对于某些加密或动态加载文本的游戏至关重要。它们的工作顺序是游戏启动 → BepInEx加载 → AutoTranslator及翻译插件初始化 → 游戏运行中产生文本 → AutoTranslator钩子函数截获文本 → 查询本地缓存/词典 → 若未命中则通过翻译插件调用API → 收到译文后覆盖原文本或显示在浮动窗口中。注意使用任何第三方翻译API都可能涉及服务条款和费用。谷歌翻译免费但有速率限制百度翻译等国内API通常需要注册并获取免费的额度或付费。务必遵守各平台的使用政策。3. 三步实操从零部署到流畅翻译下面我们进入核心的实操环节。整个过程可以清晰地分为三步环境部署、插件配置与启动、优化与问题排查。3.1 第一步基础环境部署与游戏适配检查这一步的目标是为目标游戏搭建好BepInEx运行环境。1. 确定游戏引擎与位数首先你需要确认你想翻译的游戏是基于什么引擎的以及是32位x86还是64位x64版本。最直接的方法是查看游戏安装目录如果存在GameName_Data/Managed/Assembly-CSharp.dll这类文件这通常是Unity游戏。查看主执行文件.exe的属性在“兼容性”或“详细信息”标签页中可以看到位数信息。 AutoTranslator对Unity游戏支持最好本指南也主要围绕Unity游戏展开。2. 下载并安装BepInEx访问BepInEx的GitHub发布页下载与你的游戏位数匹配的版本通常是BepInEx x64。将下载的压缩包全部解压到游戏的根目录即和游戏主.exe文件同一层目录。首次运行游戏BepInEx会自动生成必要的配置文件和文件夹结构如BepInEx/plugins,BepInEx/config,BepInEx/patchers等。运行后正常关闭游戏。3. 安装XUnity.AutoTranslator主插件访问AutoTranslator的GitHub发布页下载最新版本的XUnity.AutoTranslator-BepInEx-版本号.zip。将其解压把里面的plugins文件夹和translation文件夹合并复制到游戏根目录下的BepInEx文件夹里。确保最终路径类似BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.dll。4. 安装翻译API插件同样在AutoTranslator的发布页下载你需要的翻译插件例如XUnity.AutoTranslator.Plugin.GoogleTranslate.zip。解压后将其中的.dll文件复制到BepInEx/plugins目录下通常直接放在BepInEx/plugins下即可无需子文件夹。至此基础环境就部署完成了。你的BepInEx/plugins目录下至少应该有XUnity.AutoTranslator文件夹和XUnity.AutoTranslator.Plugin.GoogleTranslate.dll这样的文件。3.2 第二步关键配置详解与首次运行安装后需要通过配置文件来告诉AutoTranslator如何工作。配置文件位于BepInEx/config/AutoTranslatorConfig.ini。用记事本等文本编辑器打开它以下几个部分是必须关注的1. 启用与基础设置[General] ; 是否启用翻译 Enabled true ; 翻译语言目标例如简体中文 Language zh ; 是否在屏幕上显示一个小的翻译状态窗口 ShowTranslationInfo false ; 是否在游戏内日志中输出调试信息遇到问题时可以开启 EnableDebugLogging false将Enabled设为trueLanguage设为zh中文。初次使用建议将ShowTranslationInfo设为true这样游戏画面上会有一个小浮窗显示最后翻译的文本方便你确认插件是否在工作。2. 翻译服务配置找到类似[Google]的段落取决于你安装的翻译插件。以谷歌翻译为例[Google] ; 是否启用此服务 Enabled true ; 这里通常不需要填API密钥公共端点但有时需要 ; ApiKey ; 源语言自动检测 SourceLanguage auto确保你安装的翻译插件对应的段落中Enabled true。谷歌翻译的公共端点通常可直接使用但可能不稳定或有频率限制。如果使用百度翻译则需要在此处填写从百度云控制台申请的API Key和Secret Key。3. 文本处理与UI配置[Texture] ; 是否尝试翻译图片中的文字通过OCR性能开销大成功率低一般不开启 Enabled false [Behaviour] ; 最大翻译同时请求数防止卡顿 MaxConcurrentTranslations 3 ; 翻译延迟秒文本出现后等待多久才翻译防止快速滚动的文本刷屏 Delay 0.2对于[Texture]除非游戏大量使用图片文本且无解否则保持false。Delay参数很实用设置一个0.2-0.5秒的延迟可以避免在对话高速跳过或列表快速滚动时产生大量无效的翻译请求。4. 启动与验证保存配置文件启动游戏。如果一切正常进入游戏后你应该能看到游戏启动时控制台窗口如果BepInEx配置为显示会输出AutoTranslator的加载日志。游戏内文本菜单、物品名、对话会逐渐被替换成中文。第一次翻译某段文本时会有轻微的网络延迟之后因缓存存在会立即显示。如果开启了ShowTranslationInfo屏幕角落会有小字显示翻译状态。3.3 第三步高级优化与词典管理当基础翻译工作后优化体验和解决“翻译怪象”就成了重点。1. 利用缓存与翻译结果管理所有翻译结果会自动保存在BepInEx/translation/游戏名/文本哈希这样的文件里。你可以直接打开这些.txt文件查看。更重要的是你可以手动编辑这些缓存文件来修正错误的翻译。例如机器将“Attack”翻译成了“攻击”但在这个游戏里它更合适的译名是“出击”。你可以找到对应的条目将译文直接改成“出击”保存文件。下次游戏运行时AutoTranslator会优先使用你修改后的版本。2. 创建和使用自定义词典这是更强大的功能。在BepInEx/translation目录下你可以创建一个名为Dictionary.csv的文件UTF-8编码。格式如下原文,译文 Mana,法力值 HP,生命值 “I‘m the bone of my sword.”,“身为剑所天成。”词典的优先级高于缓存和在线翻译。对于游戏内的专有名词、固定技能名、或者你想玩梗的经典台词用词典固定下来能极大提升翻译质量的一致性。词典也支持正则表达式实现更复杂的匹配规则但这属于进阶用法。3. 处理未翻译或翻译错误的文本有时你会发现某些UI文本或对话没有被翻译。这可能是因为文本未被钩住AutoTranslator可能没有找到渲染该文本的函数。可以尝试在配置文件中启用Fallback模式或安装XUnity.ResourceRedirector插件来增强拦截能力。文本是图片如前所述需要开启OCR功能但效果通常不理想。对于重要图片文本更可行的办法是去社区寻找玩家手动制作的图片汉化补丁与AutoTranslator的文本翻译结合使用。翻译API抽风临时切换另一个翻译服务如从谷歌换到百度试试看。4. 性能调优如果游戏出现明显卡顿可以调整以下配置降低MaxConcurrentTranslations如从5降到2。适当增加Delay如从0.2增加到0.5。在[General]中关闭EnableDebugLogging减少日志输出对性能的占用。4. 常见问题排查与实战心得即使按照步骤操作也难免会遇到问题。下面是我在长期使用中总结的“排坑指南”。4.1 插件加载失败或游戏崩溃现象游戏启动即崩溃或BepInEx控制台报错显示AutoTranslator加载失败。排查思路版本兼容性这是最常见的原因。确保你下载的BepInEx版本与游戏位数匹配且AutoTranslator插件版本与BepInEx版本大致兼容通常GitHub发布页会说明。对于较老的游戏可能需要尝试旧版的AutoTranslator。安装位置错误再次检查所有.dll文件是否放在了正确的BepInEx/plugins目录下且目录结构没有嵌套错误。依赖缺失AutoTranslator可能需要额外的.NET运行库。确保你的系统已安装游戏所需的.NET Framework或.NET Core/Desktop Runtime版本。可以在游戏社区或BepInEx的Wiki中查找依赖信息。4.2 游戏运行正常但没有任何文本被翻译现象游戏能玩BepInEx日志也显示插件已加载但文字全是原文。排查思路配置文件未生效检查AutoTranslatorConfig.ini中的Enabled是否设为trueLanguage是否正确。有时配置文件编码错误会导致读取失败确保它是ANSI或UTF-8无BOM编码。翻译服务未启用或配置错误检查[Google]或[Baidu]段落下的Enabled是否为true。如果使用需要密钥的API确认密钥填写正确且未过期。网络连接问题AutoTranslator需要访问外部翻译API。检查网络连接特别是如果使用了需要特殊网络环境的服务。可以尝试在配置中开启调试日志查看是否有网络请求失败的记录。游戏文本类型特殊有些游戏使用TextMeshProTMP这种更现代的UI文本组件或者对文本进行了特殊打包。这时需要为游戏安装专门的“补丁”Patch或“资源重定向器”Resource Redirector。去AutoTranslator的GitHub页面或相关游戏社区论坛搜索“游戏名 AutoTranslator”或“游戏名 BepInEx”看看是否有其他玩家分享针对该游戏的特定插件或配置方法。4.3 翻译结果质量差或出现乱码现象翻译出来了但词不达意或者显示为“”或乱码。解决方案乱码问题这通常是编码问题。确保游戏、系统区域设置、以及AutoTranslator的缓存/词典文件都使用UTF-8编码。对于某些老游戏可能需要尝试在配置中指定不同的编码方式虽然不常见。翻译质量差机翻的固有缺陷。积极使用自定义词典功能是唯一高效的解决方案。将游戏中反复出现的关键术语、技能名、角色名在词典中做好固定翻译。对于长句可以结合缓存修改手动润色机器翻译的生硬结果。虽然需要一些前期投入但一旦建立好词典后续游戏体验会提升好几个档次。句子被截断或翻译不完整有些游戏动态拼接文本导致钩子截获的是碎片。可以尝试调整配置中[Behaviour]下的MaxQueuedPerFrame等参数或者寻找针对该游戏的特定文本解析插件。4.4 实战心得与技巧先社区后动手在折腾某个游戏前先到像“3DM论坛”、“其乐Keylol”或GitHub的Issues板块搜索一下。很大概率已经有先驱者踩完了所有的坑并分享了现成的插件包、配置文件甚至完整的词典文件。这能节省你大量时间。分而治之如果游戏文本量巨大首次启动时翻译请求会非常密集可能导致卡顿或触发API限流。一个技巧是第一次进入游戏时先不要急着推进剧情而是在主菜单、设置界面、物品栏等地方停留一下让插件把这些静态UI文本先翻译并缓存起来。然后再开始游戏这样动态对话的翻译压力会小很多。混合翻译策略不要只依赖一个翻译引擎。可以在配置中设置备用服务Fallback。例如主用谷歌翻译当谷歌失败或返回空结果时自动尝试百度翻译。这能提高翻译的可用性。缓存是财富定期备份你的BepInEx/translation文件夹。尤其是当你花费心血完善了某个游戏的词典和缓存后这个文件夹就是你的汉化成果。重装游戏或更换电脑时直接复制回去就能恢复完美的翻译状态。性能监控如果感觉游戏帧数下降明显可以打开任务管理器观察游戏进程的网络和磁盘活动。翻译过程中的网络请求和缓存读写可能会引起轻微卡顿。根据情况调整并发数和延迟参数在翻译速度和游戏流畅度之间找到平衡点。通过以上三步和问题排查指南你应该能够应对绝大多数使用XUnity.AutoTranslator的场景。它的本质是一个强大的“文本替换”工具理解其原理后你甚至可以用它来做一些有趣的事情比如将游戏内的英文术语替换成你更熟悉的另一套英文术语适用于学习或者进行一些个性化的文本修改。记住核心在于“钩子”、“缓存”和“词典”这三板斧用好它们语言就再也不会成为你探索游戏世界的屏障了。
1. 项目概述为什么我们需要游戏实时翻译工具如果你是一个热爱探索全球游戏作品的玩家或者是一个需要研究海外游戏设计、本地化方案的从业者那么语言障碍绝对是你绕不开的一座大山。Steam上那些只有日文、韩文或俄文的小众独立游戏常常因为看不懂剧情和菜单而让人望而却步一些尚未推出官方中文版的3A大作也让我们只能对着生硬的机翻补丁或干脆“盲玩”。手动截图、切到翻译软件、再切回游戏——这种繁琐的操作会彻底破坏沉浸感。正是在这种普遍需求下像XUnity.AutoTranslator这样的实时游戏文本翻译工具应运而生它就像一个常驻在游戏进程内的“同声传译”能将游戏界面、对话、物品描述等文本内容近乎实时地替换为你指定的语言。简单来说XUnity.AutoTranslator下文简称AutoTranslator是一个基于BepInEx插件框架主要面向Unity引擎游戏的翻译注入工具。它的核心工作原理是“钩住”Hook游戏渲染或处理文本的函数在文本被绘制到屏幕之前截获它调用外部翻译API如谷歌翻译、百度翻译、DeepL等进行翻译然后将翻译结果覆盖回原文本位置。整个过程对游戏本身的影响极小实现了“即玩即译”的体验。它解决的不仅仅是“看不懂”的问题更是“如何无缝、便捷地看懂”的问题。本指南将用最直白的方式带你三步掌握这个强大工具从原理到避坑让你能独立应对绝大多数游戏的实时翻译需求。2. 核心思路与工具选型为什么是XUnity.AutoTranslator市面上并非没有其他游戏翻译工具比如Visual Novel ReaderVNR专注于视觉小说Textractor则常用于GalGame。选择AutoTranslator是基于其泛用性、易用性和社区生态的综合考量。2.1 AutoTranslator的独特优势首先泛用性极强。由于它基于BepInEx而BepInEx是Unity游戏最流行的Mod加载器之一这意味着它能覆盖Steam上超过一半的游戏基于Unity引擎开发。对于非Unity游戏AutoTranslator也提供了通用注入器XUnity.ResourceRedirector等组件进行尝试虽然成功率不如Unity游戏高但仍有不少成功案例。其次高度可定制化。它不仅仅是一个“翻译器”更是一个翻译“框架”。你可以自由选择翻译引擎谷歌、百度、彩云小译等可以精细调整翻译触发规则哪些文本需要翻译、翻译的延迟时间等更强大的是它的缓存与词典功能。翻译过的文本会被自动保存到本地下次遇到相同文本时直接使用缓存无需再次请求网络这既提升了速度又避免了因频繁请求导致的API限额问题。你还可以手动编辑词典对特定词条进行固定翻译比如将游戏内的专有名词“Mana”固定译为“法力值”而不是每次都被机翻成“马纳”或“魔力”。第三对游戏体验的侵入性最小。它以内置插件Plugin的形式运行不需要你额外开启一个翻译软件并手动框选区域进行OCR光学字符识别。OCR翻译在字体特殊、背景复杂或文字快速滚动时识别率和速度都会大打折扣。AutoTranslator直接从游戏内存中读取文本准确率接近100%且延迟极低。2.2 核心组件与工作流解析理解AutoTranslator的工作流有助于你在出现问题时快速定位。其核心运行依赖于一个工具链BepInEx这是基石。它是一个.NET程序的插件注入框架负责在游戏启动时将我们编写的插件包括AutoTranslator加载到游戏进程中。XUnity.AutoTranslator主插件。它包含文本钩子、翻译逻辑、UI渲染可显示原文/译文对照和配置管理等功能。翻译插件AutoTranslator本身不包含翻译引擎需要额外的插件来对接具体API。例如XUnity.AutoTranslator.Plugin.GoogleTranslate或XUnity.AutoTranslator.Plugin.BaiduTranslate。可选XUnity.ResourceRedirector这是一个更底层的资源重定向工具可以帮助AutoTranslator拦截更多类型的文本资源尤其对于某些加密或动态加载文本的游戏至关重要。它们的工作顺序是游戏启动 → BepInEx加载 → AutoTranslator及翻译插件初始化 → 游戏运行中产生文本 → AutoTranslator钩子函数截获文本 → 查询本地缓存/词典 → 若未命中则通过翻译插件调用API → 收到译文后覆盖原文本或显示在浮动窗口中。注意使用任何第三方翻译API都可能涉及服务条款和费用。谷歌翻译免费但有速率限制百度翻译等国内API通常需要注册并获取免费的额度或付费。务必遵守各平台的使用政策。3. 三步实操从零部署到流畅翻译下面我们进入核心的实操环节。整个过程可以清晰地分为三步环境部署、插件配置与启动、优化与问题排查。3.1 第一步基础环境部署与游戏适配检查这一步的目标是为目标游戏搭建好BepInEx运行环境。1. 确定游戏引擎与位数首先你需要确认你想翻译的游戏是基于什么引擎的以及是32位x86还是64位x64版本。最直接的方法是查看游戏安装目录如果存在GameName_Data/Managed/Assembly-CSharp.dll这类文件这通常是Unity游戏。查看主执行文件.exe的属性在“兼容性”或“详细信息”标签页中可以看到位数信息。 AutoTranslator对Unity游戏支持最好本指南也主要围绕Unity游戏展开。2. 下载并安装BepInEx访问BepInEx的GitHub发布页下载与你的游戏位数匹配的版本通常是BepInEx x64。将下载的压缩包全部解压到游戏的根目录即和游戏主.exe文件同一层目录。首次运行游戏BepInEx会自动生成必要的配置文件和文件夹结构如BepInEx/plugins,BepInEx/config,BepInEx/patchers等。运行后正常关闭游戏。3. 安装XUnity.AutoTranslator主插件访问AutoTranslator的GitHub发布页下载最新版本的XUnity.AutoTranslator-BepInEx-版本号.zip。将其解压把里面的plugins文件夹和translation文件夹合并复制到游戏根目录下的BepInEx文件夹里。确保最终路径类似BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.dll。4. 安装翻译API插件同样在AutoTranslator的发布页下载你需要的翻译插件例如XUnity.AutoTranslator.Plugin.GoogleTranslate.zip。解压后将其中的.dll文件复制到BepInEx/plugins目录下通常直接放在BepInEx/plugins下即可无需子文件夹。至此基础环境就部署完成了。你的BepInEx/plugins目录下至少应该有XUnity.AutoTranslator文件夹和XUnity.AutoTranslator.Plugin.GoogleTranslate.dll这样的文件。3.2 第二步关键配置详解与首次运行安装后需要通过配置文件来告诉AutoTranslator如何工作。配置文件位于BepInEx/config/AutoTranslatorConfig.ini。用记事本等文本编辑器打开它以下几个部分是必须关注的1. 启用与基础设置[General] ; 是否启用翻译 Enabled true ; 翻译语言目标例如简体中文 Language zh ; 是否在屏幕上显示一个小的翻译状态窗口 ShowTranslationInfo false ; 是否在游戏内日志中输出调试信息遇到问题时可以开启 EnableDebugLogging false将Enabled设为trueLanguage设为zh中文。初次使用建议将ShowTranslationInfo设为true这样游戏画面上会有一个小浮窗显示最后翻译的文本方便你确认插件是否在工作。2. 翻译服务配置找到类似[Google]的段落取决于你安装的翻译插件。以谷歌翻译为例[Google] ; 是否启用此服务 Enabled true ; 这里通常不需要填API密钥公共端点但有时需要 ; ApiKey ; 源语言自动检测 SourceLanguage auto确保你安装的翻译插件对应的段落中Enabled true。谷歌翻译的公共端点通常可直接使用但可能不稳定或有频率限制。如果使用百度翻译则需要在此处填写从百度云控制台申请的API Key和Secret Key。3. 文本处理与UI配置[Texture] ; 是否尝试翻译图片中的文字通过OCR性能开销大成功率低一般不开启 Enabled false [Behaviour] ; 最大翻译同时请求数防止卡顿 MaxConcurrentTranslations 3 ; 翻译延迟秒文本出现后等待多久才翻译防止快速滚动的文本刷屏 Delay 0.2对于[Texture]除非游戏大量使用图片文本且无解否则保持false。Delay参数很实用设置一个0.2-0.5秒的延迟可以避免在对话高速跳过或列表快速滚动时产生大量无效的翻译请求。4. 启动与验证保存配置文件启动游戏。如果一切正常进入游戏后你应该能看到游戏启动时控制台窗口如果BepInEx配置为显示会输出AutoTranslator的加载日志。游戏内文本菜单、物品名、对话会逐渐被替换成中文。第一次翻译某段文本时会有轻微的网络延迟之后因缓存存在会立即显示。如果开启了ShowTranslationInfo屏幕角落会有小字显示翻译状态。3.3 第三步高级优化与词典管理当基础翻译工作后优化体验和解决“翻译怪象”就成了重点。1. 利用缓存与翻译结果管理所有翻译结果会自动保存在BepInEx/translation/游戏名/文本哈希这样的文件里。你可以直接打开这些.txt文件查看。更重要的是你可以手动编辑这些缓存文件来修正错误的翻译。例如机器将“Attack”翻译成了“攻击”但在这个游戏里它更合适的译名是“出击”。你可以找到对应的条目将译文直接改成“出击”保存文件。下次游戏运行时AutoTranslator会优先使用你修改后的版本。2. 创建和使用自定义词典这是更强大的功能。在BepInEx/translation目录下你可以创建一个名为Dictionary.csv的文件UTF-8编码。格式如下原文,译文 Mana,法力值 HP,生命值 “I‘m the bone of my sword.”,“身为剑所天成。”词典的优先级高于缓存和在线翻译。对于游戏内的专有名词、固定技能名、或者你想玩梗的经典台词用词典固定下来能极大提升翻译质量的一致性。词典也支持正则表达式实现更复杂的匹配规则但这属于进阶用法。3. 处理未翻译或翻译错误的文本有时你会发现某些UI文本或对话没有被翻译。这可能是因为文本未被钩住AutoTranslator可能没有找到渲染该文本的函数。可以尝试在配置文件中启用Fallback模式或安装XUnity.ResourceRedirector插件来增强拦截能力。文本是图片如前所述需要开启OCR功能但效果通常不理想。对于重要图片文本更可行的办法是去社区寻找玩家手动制作的图片汉化补丁与AutoTranslator的文本翻译结合使用。翻译API抽风临时切换另一个翻译服务如从谷歌换到百度试试看。4. 性能调优如果游戏出现明显卡顿可以调整以下配置降低MaxConcurrentTranslations如从5降到2。适当增加Delay如从0.2增加到0.5。在[General]中关闭EnableDebugLogging减少日志输出对性能的占用。4. 常见问题排查与实战心得即使按照步骤操作也难免会遇到问题。下面是我在长期使用中总结的“排坑指南”。4.1 插件加载失败或游戏崩溃现象游戏启动即崩溃或BepInEx控制台报错显示AutoTranslator加载失败。排查思路版本兼容性这是最常见的原因。确保你下载的BepInEx版本与游戏位数匹配且AutoTranslator插件版本与BepInEx版本大致兼容通常GitHub发布页会说明。对于较老的游戏可能需要尝试旧版的AutoTranslator。安装位置错误再次检查所有.dll文件是否放在了正确的BepInEx/plugins目录下且目录结构没有嵌套错误。依赖缺失AutoTranslator可能需要额外的.NET运行库。确保你的系统已安装游戏所需的.NET Framework或.NET Core/Desktop Runtime版本。可以在游戏社区或BepInEx的Wiki中查找依赖信息。4.2 游戏运行正常但没有任何文本被翻译现象游戏能玩BepInEx日志也显示插件已加载但文字全是原文。排查思路配置文件未生效检查AutoTranslatorConfig.ini中的Enabled是否设为trueLanguage是否正确。有时配置文件编码错误会导致读取失败确保它是ANSI或UTF-8无BOM编码。翻译服务未启用或配置错误检查[Google]或[Baidu]段落下的Enabled是否为true。如果使用需要密钥的API确认密钥填写正确且未过期。网络连接问题AutoTranslator需要访问外部翻译API。检查网络连接特别是如果使用了需要特殊网络环境的服务。可以尝试在配置中开启调试日志查看是否有网络请求失败的记录。游戏文本类型特殊有些游戏使用TextMeshProTMP这种更现代的UI文本组件或者对文本进行了特殊打包。这时需要为游戏安装专门的“补丁”Patch或“资源重定向器”Resource Redirector。去AutoTranslator的GitHub页面或相关游戏社区论坛搜索“游戏名 AutoTranslator”或“游戏名 BepInEx”看看是否有其他玩家分享针对该游戏的特定插件或配置方法。4.3 翻译结果质量差或出现乱码现象翻译出来了但词不达意或者显示为“”或乱码。解决方案乱码问题这通常是编码问题。确保游戏、系统区域设置、以及AutoTranslator的缓存/词典文件都使用UTF-8编码。对于某些老游戏可能需要尝试在配置中指定不同的编码方式虽然不常见。翻译质量差机翻的固有缺陷。积极使用自定义词典功能是唯一高效的解决方案。将游戏中反复出现的关键术语、技能名、角色名在词典中做好固定翻译。对于长句可以结合缓存修改手动润色机器翻译的生硬结果。虽然需要一些前期投入但一旦建立好词典后续游戏体验会提升好几个档次。句子被截断或翻译不完整有些游戏动态拼接文本导致钩子截获的是碎片。可以尝试调整配置中[Behaviour]下的MaxQueuedPerFrame等参数或者寻找针对该游戏的特定文本解析插件。4.4 实战心得与技巧先社区后动手在折腾某个游戏前先到像“3DM论坛”、“其乐Keylol”或GitHub的Issues板块搜索一下。很大概率已经有先驱者踩完了所有的坑并分享了现成的插件包、配置文件甚至完整的词典文件。这能节省你大量时间。分而治之如果游戏文本量巨大首次启动时翻译请求会非常密集可能导致卡顿或触发API限流。一个技巧是第一次进入游戏时先不要急着推进剧情而是在主菜单、设置界面、物品栏等地方停留一下让插件把这些静态UI文本先翻译并缓存起来。然后再开始游戏这样动态对话的翻译压力会小很多。混合翻译策略不要只依赖一个翻译引擎。可以在配置中设置备用服务Fallback。例如主用谷歌翻译当谷歌失败或返回空结果时自动尝试百度翻译。这能提高翻译的可用性。缓存是财富定期备份你的BepInEx/translation文件夹。尤其是当你花费心血完善了某个游戏的词典和缓存后这个文件夹就是你的汉化成果。重装游戏或更换电脑时直接复制回去就能恢复完美的翻译状态。性能监控如果感觉游戏帧数下降明显可以打开任务管理器观察游戏进程的网络和磁盘活动。翻译过程中的网络请求和缓存读写可能会引起轻微卡顿。根据情况调整并发数和延迟参数在翻译速度和游戏流畅度之间找到平衡点。通过以上三步和问题排查指南你应该能够应对绝大多数使用XUnity.AutoTranslator的场景。它的本质是一个强大的“文本替换”工具理解其原理后你甚至可以用它来做一些有趣的事情比如将游戏内的英文术语替换成你更熟悉的另一套英文术语适用于学习或者进行一些个性化的文本修改。记住核心在于“钩子”、“缓存”和“词典”这三板斧用好它们语言就再也不会成为你探索游戏世界的屏障了。
![【Bug已解决】[modular] ensure branch-specific input defaults 解决方案](http://pic.xiahunao.cn/yaotu/【Bug已解决】[modular] ensure branch-specific input defaults 解决方案)
