1. 项目概述为什么我们需要游戏文本实时翻译如果你是一个热爱独立游戏、视觉小说或者经常在Steam上淘一些非中文区小作品的玩家那么“啃生肉”的经历一定不陌生。屏幕上密密麻麻的英文、日文或者其他语言即使查着词典游戏的沉浸感和节奏也被切割得支离破碎。对于开发者或Mod爱好者来说研究一款游戏的机制或文本结构时语言更是第一道高墙。XUnity.AutoTranslator以下简称AutoTranslator的出现就是为了推倒这堵墙。它不是一个独立的软件而是一个运行在游戏进程内的插件通常通过BepInEx等Mod框架加载能够实时拦截游戏引擎主要是Unity渲染到屏幕上的文本调用在线翻译API进行翻译并用翻译后的文本替换原文本进行显示。听起来很科幻其实原理并不复杂。Unity游戏在运行时所有要显示的UI文本最终都会通过特定的方法调用。AutoTranslator的核心工作就是“钩住”Hook这些方法在文本被绘制到屏幕前的那一刻将其截获。它首先会检查本地是否已有该句的翻译缓存一个文本文件如果有就直接使用避免重复翻译如果没有则将其发送到你配置的翻译服务如Google Translate、DeepL、百度翻译等获取译文后显示并保存到缓存。这一切都是动态发生的你看到的就是一个“实时汉化”的游戏界面。这个工具的价值远不止“玩汉化版游戏”这么简单。对于玩家它意味着几乎无限的“民间汉化”可能性尤其是对那些官方中文无望、汉化组也尚未顾及的小众作品。对于研究者或内容创作者它可以快速理解游戏剧情和系统降低学习成本。更重要的是它的运作机制本身就是一个学习游戏Mod开发、内存Hook和API调用的绝佳案例。接下来我将带你从零开始完成插件的部署、配置、优化并深入探讨其工作原理和高级玩法让你不仅能“用上”更能“精通”这款利器。2. 核心组件与工作原理深度拆解在动手之前我们必须理解AutoTranslator是由哪些部分构成的以及它们是如何协同工作的。这能帮助你在后续遇到问题时快速定位是哪个环节出了岔子。2.1 核心架构插件、框架与缓存AutoTranslator本身是一个“.NET程序集”通常是.dll文件。它不能直接运行必须依赖一个“模组加载器”将其注入到游戏进程中。对于Unity游戏目前最主流、兼容性最好的加载器是BepInEx。你可以把BepInEx理解为一个为Unity游戏打造的“模组操作系统”它负责在游戏启动时加载像AutoTranslator这样的插件并提供一系列基础服务如日志、配置管理。整个工作流程可以概括为以下几个步骤启动玩家启动游戏。BepInEx率先加载对游戏进程进行必要的修补。注入BepInEx读取其插件目录发现并加载XUnity.AutoTranslator.dll。初始化AutoTranslator插件启动读取自身的配置文件AutoTranslatorConfig.ini初始化翻译引擎和缓存系统。拦截游戏运行当需要渲染一段文本时例如调用UnityEngine.UI.Text的set_text方法AutoTranslator设置的钩子Hook生效截获这段原始文本。查询插件将截获的文本生成一个“签名”通常是MD5哈希值首先在本地缓存文件位于Translation文件夹下的.txt文件中查找是否有对应的翻译记录。翻译/显示缓存命中直接使用缓存中的译文替换原始文本显示到屏幕上。此过程极快玩家无感知。缓存未命中根据配置将原始文本发送至指定的在线翻译API。收到译文后一方面显示到屏幕另一方面将“原文-译文”对追加写入本地缓存文件。首次翻译某句时会有短暂延迟。循环上述过程在游戏运行期间不断重复实现实时翻译。这里的关键在于本地缓存。它不仅是提升速度的关键避免了重复网络请求更是实现“离线翻译”和“人工校对”的基础。缓存文件是纯文本格式你可以直接打开编辑用更准确、更符合语境的翻译替换掉机翻结果。下次游戏运行时插件就会优先使用你修改后的版本。2.2 支持的翻译引擎与选择策略AutoTranslator支持多种后端翻译服务你需要在其配置文件中指定。每种引擎都有其特点、限制和成本。翻译引擎配置标识优点缺点与注意事项Google TranslateGoogleTranslate免费、支持语言广泛、速度相对稳定。有请求频率限制大量、快速翻译时容易被暂时封禁IP。译文风格比较机械。DeepLDeepLTranslate翻译质量公认较高尤其对欧洲语言。免费版有每月50万字符的限制。需要申请API密钥。百度翻译BaiduTranslate对中文支持好国内访问速度快且稳定。需要申请API密钥有免费额度。翻译非中英文语对时可能不如Google。Papago (Naver)PapagoTranslate韩语翻译质量高。适合主打韩语游戏。需要API密钥。离线引擎Offline完全离线无网络、无延迟、无限制。需要单独下载庞大的离线翻译模型文件如Argos Translate初始设置复杂翻译质量一般。实操心得引擎选择建议对于绝大多数用户我建议从Google Translate开始。它无需注册开箱即用适合体验和初步汉化。如果你主要玩日系游戏且追求质量可以尝试申请DeepL的免费API。如果游戏是韩语Papago是不二之选。百度翻译是国内网络环境下的稳定备选。离线引擎仅推荐给网络环境极差或翻译需求极其庞大担心触发频率限制的进阶用户。3. 从零开始的完整部署与配置指南理论说得再多不如动手实践。我们以一款假设的Unity游戏《FantasyQuest.exe》为例演示从零开始的完整流程。3.1 环境准备获取必要工具确定游戏版本与架构右键点击游戏主程序如FantasyQuest.exe查看属性。确认它是基于Unity引擎通常游戏目录下有UnityPlayer.dll或GameAssembly.dll并记住它是32位x86还是64位x64。这将决定你下载的BepInEx版本。下载BepInEx前往BepInEx的GitHub发布页。对于大多数现代Unity游戏直接下载BepInEx_x64_版本号.zip64位或BepInEx_x86_版本号.zip32位。如果不确定可以两个都试试通常64位更常见。下载XUnity.AutoTranslator前往其GitHub发布页下载最新版本的XUnity.AutoTranslator-BepInEx-版本号.zip。注意一定要选择带“BepInEx”字样的版本这是为BepInEx框架预编译的插件包。3.2 安装BepInEx框架这是最关键的一步必须确保BepInEx本身能正常启动。解压下载的BepInEx压缩包将其中的所有文件和文件夹复制到你的游戏根目录即FantasyQuest.exe所在的文件夹。首次运行游戏。此时游戏可能会启动两次或者启动时间稍长。运行结束后关闭游戏。检查游戏根目录此时应该新生成了一个名为BepInEx的文件夹。进入BepInEx文件夹查看是否有LogOutput.log文件以及plugins等子文件夹。如果有说明BepInEx安装成功。踩坑记录安装失败常见原因杀毒软件拦截这是最常见的问题。BepInEx的安装过程会向游戏进程注入代码可能被误报为病毒。请暂时禁用杀毒软件或将其添加至信任区完成首次运行后再开启。游戏有反作弊或加密一些在线游戏或使用特殊打包工具如Il2Cpp的游戏可能需要特定版本的BepInEx或额外的插件如BepInEx Il2Cpp版本。这属于进阶问题需要查阅特定游戏社区的资料。版本不匹配确保BepInEx的位数x86/x64与游戏匹配。如果不匹配游戏可能无法启动或BepInEx不加载。3.3 安装并配置AutoTranslator插件解压下载的XUnity.AutoTranslator-BepInEx-版本号.zip文件。你会看到里面通常包含BepInEx文件夹和README文件。将解压出的BepInEx文件夹整体拖入游戏根目录与之前安装的BepInEx文件夹合并。确保XUnity.AutoTranslator.dll最终位于游戏根目录\BepInEx\plugins路径下。启动游戏然后退出。此举是为了让AutoTranslator生成默认的配置文件。现在打开游戏根目录\BepInEx\config文件夹找到AutoTranslatorConfig.ini文件用记事本或其他文本编辑器打开它。3.4 详解核心配置文件配置文件看起来参数很多但核心需要修改的就几项。我们分段解析[General] ; 是否启用插件保持True EnabledTrue ; 翻译服务我们改为GoogleTranslate TranslationServiceGoogleTranslate ; 源语言游戏文本语言根据游戏填写如ja日语、en英语、ko韩语 SourceLanguageja ; 目标语言想要翻译成的语言填zh中文 DestinationLanguagezh ; 是否在翻译文本前后加显示前缀后缀用于调试正式使用建议关掉 ShowTranslationForBrieflyDisplayedTextFalse[Service] ; 如果使用Google翻译这部分通常无需改动 ; 如果使用DeepL或百度需要在此处填写你的API密钥 ; 例如DeepL: DeepLAPIKey你的密钥[TextFrameworks] ; 这里定义了插件如何“钩住”文本。对于绝大多数Unity UI文本和TextMeshPro文本保持默认即可。 ; 如果游戏使用了非常规的文本渲染方式可能需要启用下面的实验性选项但这可能造成不稳定。 EnableIMGUIFalse ; 通常关闭除非是老旧Unity GUI游戏 EnableUGUITrue ; 必须为True这是现代Unity UI的基础 EnableNGUIFalse ; 除非游戏明确使用NGUI否则关闭 EnableTextMeshProTrue ; 现代游戏常用建议开启[Behaviour] ; 最大翻译字符数避免翻译超长文本如文件内容导致卡顿或API拒绝 MaxCharactersPerTranslation500 ; 是否自动分割长句建议开启 SplitLongTextTrue ; 是否翻译仅短暂显示的文本如提示音效字幕根据需求调整 TranslateOnlyBrieflyDisplayedTextFalse保存配置文件。至此最基本的配置就完成了。启动游戏如果一切顺利你应该能看到游戏内的UI文本、对话等逐渐被替换成中文。4. 高级技巧与深度优化方案基础翻译能用但想要体验更好、翻译更准就需要进行深度优化。这部分是区分“会用”和“精通”的关键。4.1 缓存管理与人工精修翻译缓存文件位于游戏根目录\BepInEx\Translation\zh\Text文件夹下假设目标语言是zh。里面会有类似GeneratedTranslations.txt和AdditionalTranslations.txt的文件。GeneratedTranslations.txt这是插件自动生成的缓存。不要直接编辑这个文件因为插件运行时会覆盖它。AdditionalTranslations.txt这是用于“追加”和“覆盖”翻译的文件。插件会优先读取这里的翻译条目。人工精修流程玩游戏让插件生成初始的GeneratedTranslations.txt。将GeneratedTranslations.txt中翻译生硬、错误或需要调整的整行内容复制到AdditionalTranslations.txt中。在AdditionalTranslations.txt中修改译文。格式是原文你的修正译文。保存文件。下次游戏启动时插件会优先采用AdditionalTranslations.txt中的版本。例如机翻可能将“Press Any Key”翻译成“按任何键”你可以修改为“按下任意键继续”。对于角色名、技能名等专有名词这是统一翻译、避免前后不一致的最佳方法。4.2 正则表达式过滤与文本替换游戏文本可能包含大量你不想翻译的内容比如代码变量{playerName}、格式标记colorred、或者无意义的系统日志。盲目翻译这些内容会导致游戏功能异常或显示乱码。AutoTranslator支持使用正则表达式进行过滤。在配置文件的[Regex]部分可以添加规则[Regex] ; 忽略所有包含大括号 {} 的文本通常是变量 0^\{.*\}$ ; 忽略所有包含HTML/富文本标签的文本 1^.*$ ; 忽略纯数字的文本 2^\d$此外[TextPreprocessing]部分可以在翻译前对原文进行替换常用于统一术语或处理特殊字符。[TextPreprocessing] ; 将游戏内的MP统一替换为魔法值然后再送去翻译 0MP魔法值 ; 处理一些全角/半角空格问题 1\u3000\u00204.3 字体与显示优化翻译成中文后游戏原版字体可能缺少中文字符导致显示为方框□□□。AutoTranslator提供了字体修补功能。准备一个包含完整中文字库的.ttf或.otf字体文件如思源黑体、方正准圆等将其复制到游戏根目录\BepInEx\Translation\zh文件夹下并重命名为default.ttf。在配置文件中启用字体替换[Font] ; 启用自定义字体 EnableFontPatchTrue ; 自定义字体路径相对于Translation/zh文件夹 FontPathdefault.ttf FontSize20 ; 可根据UI调整字号这个功能并非100%生效取决于游戏是如何创建字体对象的。但对于使用动态字体Dynamic Font的Unity UI文本通常效果很好。4.4 处理特殊游戏与Il2Cpp越来越多的Unity游戏使用Il2Cpp后端将C#代码编译成C这极大地提高了性能和安全性但也让传统的基于Mono的Hook变得困难。对于这类游戏你需要使用专门为Il2Cpp编译的BepInEx版本通常称为BepInEx Il2Cpp版本以及对应的AutoTranslator版本。安装流程类似但务必确保所有组件BepInEx、AutoTranslator都是针对Il2Cpp的版本。判断游戏是否为Il2Cpp可以查看游戏目录下是否存在GameAssembly.dll和UnityPlayer.dll如果存在GameAssembly.dll基本就是Il2Cpp了。这类游戏的翻译配置原理相同但底层注入方式不同稳定性也可能有所差异。5. 实战问题排查与经验实录即使按照指南操作在实际使用中仍会遇到各种问题。这里我整理了一份最常见问题的排查清单和我的解决经验。问题现象可能原因排查步骤与解决方案游戏启动崩溃或无反应1. BepInEx版本与游戏不兼容位数不对。2. 杀毒软件拦截。3. 游戏有强反作弊。1. 确认游戏是x86还是x64换用对应BepInEx。2. 关闭杀毒软件将游戏目录加入白名单。3. 查阅该游戏社区看是否有特殊的Mod加载方法或禁用反作弊的启动参数。游戏能运行但无任何翻译效果1. AutoTranslator插件未正确加载。2. 配置文件错误如语言代码写错。3. 文本框架未正确启用。1. 检查BepInEx\plugins下是否有XUnity.AutoTranslator.dll并查看BepInEx\LogOutput.log文件搜索“AutoTranslator”看是否有加载成功或报错信息。2. 检查AutoTranslatorConfig.ini中的SourceLanguage和DestinationLanguage是否正确使用ISO 639-1代码如en, zh, ja。3. 尝试在配置中同时启用EnableUGUI和EnableTextMeshPro。部分文本翻译了部分没翻译1. 文本渲染方式特殊如基于纹理的图片文字。2. 文本被正则表达式过滤掉了。3. 该文本在缓存中已有空翻译或错误翻译。1. 图片文字无法通过此插件翻译这是硬伤。2. 检查配置文件[Regex]部分暂时注释掉所有规则测试。3. 删除Translation文件夹下对应语言的缓存文件让插件重新抓取和翻译。翻译延迟非常高或频繁失败1. 网络问题连接翻译API不稳定。2. 触发了翻译API的请求频率限制尤其是Google免费版。3. 句子过长超出配置限制。1. 尝试切换翻译引擎如从Google换到百度。2. 在配置文件中增加DelayAfterTranslation参数如设为200毫秒降低请求频率。3. 确保SplitLongTextTrue并适当增加MaxCharactersPerTranslation但不宜过大。翻译后字体显示为方框游戏原字体不支持中文。1. 尝试使用4.3节所述的字体补丁功能。2. 如果字体补丁无效可能是游戏使用了自定义字体渲染可以尝试寻找该游戏的专用字体Mod。翻译结果质量极差或上下文错误机翻的固有缺陷。句子被截断丢失上下文。1. 利用AdditionalTranslations.txt进行人工修正这是提升质量最根本的方法。2. 尝试使用质量更高的引擎如DeepL。3. 检查SplitLongText设置有时不分割长句反而能保留更多上下文信息供翻译引擎判断。我的核心经验日志是你的最佳朋友。绝大多数问题都能在BepInEx\LogOutput.log这个日志文件中找到线索。打开它搜索“error”、“warn”、“exception”或“AutoTranslator”等关键词通常能直接定位到问题所在。例如如果日志显示“Failed to download translation”那就是网络或API配置问题如果显示“Hook failed for method…”那就是文本拦截环节出了问题。最后保持耐心和探索精神。AutoTranslator是一个社区驱动的强大工具但并非万能。对于每一款新游戏都是一次新的适配挑战。当你能成功为一款心爱的生肉游戏打上流畅的实时翻译时那种成就感绝对是值得的。
1. 项目概述为什么我们需要游戏文本实时翻译如果你是一个热爱独立游戏、视觉小说或者经常在Steam上淘一些非中文区小作品的玩家那么“啃生肉”的经历一定不陌生。屏幕上密密麻麻的英文、日文或者其他语言即使查着词典游戏的沉浸感和节奏也被切割得支离破碎。对于开发者或Mod爱好者来说研究一款游戏的机制或文本结构时语言更是第一道高墙。XUnity.AutoTranslator以下简称AutoTranslator的出现就是为了推倒这堵墙。它不是一个独立的软件而是一个运行在游戏进程内的插件通常通过BepInEx等Mod框架加载能够实时拦截游戏引擎主要是Unity渲染到屏幕上的文本调用在线翻译API进行翻译并用翻译后的文本替换原文本进行显示。听起来很科幻其实原理并不复杂。Unity游戏在运行时所有要显示的UI文本最终都会通过特定的方法调用。AutoTranslator的核心工作就是“钩住”Hook这些方法在文本被绘制到屏幕前的那一刻将其截获。它首先会检查本地是否已有该句的翻译缓存一个文本文件如果有就直接使用避免重复翻译如果没有则将其发送到你配置的翻译服务如Google Translate、DeepL、百度翻译等获取译文后显示并保存到缓存。这一切都是动态发生的你看到的就是一个“实时汉化”的游戏界面。这个工具的价值远不止“玩汉化版游戏”这么简单。对于玩家它意味着几乎无限的“民间汉化”可能性尤其是对那些官方中文无望、汉化组也尚未顾及的小众作品。对于研究者或内容创作者它可以快速理解游戏剧情和系统降低学习成本。更重要的是它的运作机制本身就是一个学习游戏Mod开发、内存Hook和API调用的绝佳案例。接下来我将带你从零开始完成插件的部署、配置、优化并深入探讨其工作原理和高级玩法让你不仅能“用上”更能“精通”这款利器。2. 核心组件与工作原理深度拆解在动手之前我们必须理解AutoTranslator是由哪些部分构成的以及它们是如何协同工作的。这能帮助你在后续遇到问题时快速定位是哪个环节出了岔子。2.1 核心架构插件、框架与缓存AutoTranslator本身是一个“.NET程序集”通常是.dll文件。它不能直接运行必须依赖一个“模组加载器”将其注入到游戏进程中。对于Unity游戏目前最主流、兼容性最好的加载器是BepInEx。你可以把BepInEx理解为一个为Unity游戏打造的“模组操作系统”它负责在游戏启动时加载像AutoTranslator这样的插件并提供一系列基础服务如日志、配置管理。整个工作流程可以概括为以下几个步骤启动玩家启动游戏。BepInEx率先加载对游戏进程进行必要的修补。注入BepInEx读取其插件目录发现并加载XUnity.AutoTranslator.dll。初始化AutoTranslator插件启动读取自身的配置文件AutoTranslatorConfig.ini初始化翻译引擎和缓存系统。拦截游戏运行当需要渲染一段文本时例如调用UnityEngine.UI.Text的set_text方法AutoTranslator设置的钩子Hook生效截获这段原始文本。查询插件将截获的文本生成一个“签名”通常是MD5哈希值首先在本地缓存文件位于Translation文件夹下的.txt文件中查找是否有对应的翻译记录。翻译/显示缓存命中直接使用缓存中的译文替换原始文本显示到屏幕上。此过程极快玩家无感知。缓存未命中根据配置将原始文本发送至指定的在线翻译API。收到译文后一方面显示到屏幕另一方面将“原文-译文”对追加写入本地缓存文件。首次翻译某句时会有短暂延迟。循环上述过程在游戏运行期间不断重复实现实时翻译。这里的关键在于本地缓存。它不仅是提升速度的关键避免了重复网络请求更是实现“离线翻译”和“人工校对”的基础。缓存文件是纯文本格式你可以直接打开编辑用更准确、更符合语境的翻译替换掉机翻结果。下次游戏运行时插件就会优先使用你修改后的版本。2.2 支持的翻译引擎与选择策略AutoTranslator支持多种后端翻译服务你需要在其配置文件中指定。每种引擎都有其特点、限制和成本。翻译引擎配置标识优点缺点与注意事项Google TranslateGoogleTranslate免费、支持语言广泛、速度相对稳定。有请求频率限制大量、快速翻译时容易被暂时封禁IP。译文风格比较机械。DeepLDeepLTranslate翻译质量公认较高尤其对欧洲语言。免费版有每月50万字符的限制。需要申请API密钥。百度翻译BaiduTranslate对中文支持好国内访问速度快且稳定。需要申请API密钥有免费额度。翻译非中英文语对时可能不如Google。Papago (Naver)PapagoTranslate韩语翻译质量高。适合主打韩语游戏。需要API密钥。离线引擎Offline完全离线无网络、无延迟、无限制。需要单独下载庞大的离线翻译模型文件如Argos Translate初始设置复杂翻译质量一般。实操心得引擎选择建议对于绝大多数用户我建议从Google Translate开始。它无需注册开箱即用适合体验和初步汉化。如果你主要玩日系游戏且追求质量可以尝试申请DeepL的免费API。如果游戏是韩语Papago是不二之选。百度翻译是国内网络环境下的稳定备选。离线引擎仅推荐给网络环境极差或翻译需求极其庞大担心触发频率限制的进阶用户。3. 从零开始的完整部署与配置指南理论说得再多不如动手实践。我们以一款假设的Unity游戏《FantasyQuest.exe》为例演示从零开始的完整流程。3.1 环境准备获取必要工具确定游戏版本与架构右键点击游戏主程序如FantasyQuest.exe查看属性。确认它是基于Unity引擎通常游戏目录下有UnityPlayer.dll或GameAssembly.dll并记住它是32位x86还是64位x64。这将决定你下载的BepInEx版本。下载BepInEx前往BepInEx的GitHub发布页。对于大多数现代Unity游戏直接下载BepInEx_x64_版本号.zip64位或BepInEx_x86_版本号.zip32位。如果不确定可以两个都试试通常64位更常见。下载XUnity.AutoTranslator前往其GitHub发布页下载最新版本的XUnity.AutoTranslator-BepInEx-版本号.zip。注意一定要选择带“BepInEx”字样的版本这是为BepInEx框架预编译的插件包。3.2 安装BepInEx框架这是最关键的一步必须确保BepInEx本身能正常启动。解压下载的BepInEx压缩包将其中的所有文件和文件夹复制到你的游戏根目录即FantasyQuest.exe所在的文件夹。首次运行游戏。此时游戏可能会启动两次或者启动时间稍长。运行结束后关闭游戏。检查游戏根目录此时应该新生成了一个名为BepInEx的文件夹。进入BepInEx文件夹查看是否有LogOutput.log文件以及plugins等子文件夹。如果有说明BepInEx安装成功。踩坑记录安装失败常见原因杀毒软件拦截这是最常见的问题。BepInEx的安装过程会向游戏进程注入代码可能被误报为病毒。请暂时禁用杀毒软件或将其添加至信任区完成首次运行后再开启。游戏有反作弊或加密一些在线游戏或使用特殊打包工具如Il2Cpp的游戏可能需要特定版本的BepInEx或额外的插件如BepInEx Il2Cpp版本。这属于进阶问题需要查阅特定游戏社区的资料。版本不匹配确保BepInEx的位数x86/x64与游戏匹配。如果不匹配游戏可能无法启动或BepInEx不加载。3.3 安装并配置AutoTranslator插件解压下载的XUnity.AutoTranslator-BepInEx-版本号.zip文件。你会看到里面通常包含BepInEx文件夹和README文件。将解压出的BepInEx文件夹整体拖入游戏根目录与之前安装的BepInEx文件夹合并。确保XUnity.AutoTranslator.dll最终位于游戏根目录\BepInEx\plugins路径下。启动游戏然后退出。此举是为了让AutoTranslator生成默认的配置文件。现在打开游戏根目录\BepInEx\config文件夹找到AutoTranslatorConfig.ini文件用记事本或其他文本编辑器打开它。3.4 详解核心配置文件配置文件看起来参数很多但核心需要修改的就几项。我们分段解析[General] ; 是否启用插件保持True EnabledTrue ; 翻译服务我们改为GoogleTranslate TranslationServiceGoogleTranslate ; 源语言游戏文本语言根据游戏填写如ja日语、en英语、ko韩语 SourceLanguageja ; 目标语言想要翻译成的语言填zh中文 DestinationLanguagezh ; 是否在翻译文本前后加显示前缀后缀用于调试正式使用建议关掉 ShowTranslationForBrieflyDisplayedTextFalse[Service] ; 如果使用Google翻译这部分通常无需改动 ; 如果使用DeepL或百度需要在此处填写你的API密钥 ; 例如DeepL: DeepLAPIKey你的密钥[TextFrameworks] ; 这里定义了插件如何“钩住”文本。对于绝大多数Unity UI文本和TextMeshPro文本保持默认即可。 ; 如果游戏使用了非常规的文本渲染方式可能需要启用下面的实验性选项但这可能造成不稳定。 EnableIMGUIFalse ; 通常关闭除非是老旧Unity GUI游戏 EnableUGUITrue ; 必须为True这是现代Unity UI的基础 EnableNGUIFalse ; 除非游戏明确使用NGUI否则关闭 EnableTextMeshProTrue ; 现代游戏常用建议开启[Behaviour] ; 最大翻译字符数避免翻译超长文本如文件内容导致卡顿或API拒绝 MaxCharactersPerTranslation500 ; 是否自动分割长句建议开启 SplitLongTextTrue ; 是否翻译仅短暂显示的文本如提示音效字幕根据需求调整 TranslateOnlyBrieflyDisplayedTextFalse保存配置文件。至此最基本的配置就完成了。启动游戏如果一切顺利你应该能看到游戏内的UI文本、对话等逐渐被替换成中文。4. 高级技巧与深度优化方案基础翻译能用但想要体验更好、翻译更准就需要进行深度优化。这部分是区分“会用”和“精通”的关键。4.1 缓存管理与人工精修翻译缓存文件位于游戏根目录\BepInEx\Translation\zh\Text文件夹下假设目标语言是zh。里面会有类似GeneratedTranslations.txt和AdditionalTranslations.txt的文件。GeneratedTranslations.txt这是插件自动生成的缓存。不要直接编辑这个文件因为插件运行时会覆盖它。AdditionalTranslations.txt这是用于“追加”和“覆盖”翻译的文件。插件会优先读取这里的翻译条目。人工精修流程玩游戏让插件生成初始的GeneratedTranslations.txt。将GeneratedTranslations.txt中翻译生硬、错误或需要调整的整行内容复制到AdditionalTranslations.txt中。在AdditionalTranslations.txt中修改译文。格式是原文你的修正译文。保存文件。下次游戏启动时插件会优先采用AdditionalTranslations.txt中的版本。例如机翻可能将“Press Any Key”翻译成“按任何键”你可以修改为“按下任意键继续”。对于角色名、技能名等专有名词这是统一翻译、避免前后不一致的最佳方法。4.2 正则表达式过滤与文本替换游戏文本可能包含大量你不想翻译的内容比如代码变量{playerName}、格式标记colorred、或者无意义的系统日志。盲目翻译这些内容会导致游戏功能异常或显示乱码。AutoTranslator支持使用正则表达式进行过滤。在配置文件的[Regex]部分可以添加规则[Regex] ; 忽略所有包含大括号 {} 的文本通常是变量 0^\{.*\}$ ; 忽略所有包含HTML/富文本标签的文本 1^.*$ ; 忽略纯数字的文本 2^\d$此外[TextPreprocessing]部分可以在翻译前对原文进行替换常用于统一术语或处理特殊字符。[TextPreprocessing] ; 将游戏内的MP统一替换为魔法值然后再送去翻译 0MP魔法值 ; 处理一些全角/半角空格问题 1\u3000\u00204.3 字体与显示优化翻译成中文后游戏原版字体可能缺少中文字符导致显示为方框□□□。AutoTranslator提供了字体修补功能。准备一个包含完整中文字库的.ttf或.otf字体文件如思源黑体、方正准圆等将其复制到游戏根目录\BepInEx\Translation\zh文件夹下并重命名为default.ttf。在配置文件中启用字体替换[Font] ; 启用自定义字体 EnableFontPatchTrue ; 自定义字体路径相对于Translation/zh文件夹 FontPathdefault.ttf FontSize20 ; 可根据UI调整字号这个功能并非100%生效取决于游戏是如何创建字体对象的。但对于使用动态字体Dynamic Font的Unity UI文本通常效果很好。4.4 处理特殊游戏与Il2Cpp越来越多的Unity游戏使用Il2Cpp后端将C#代码编译成C这极大地提高了性能和安全性但也让传统的基于Mono的Hook变得困难。对于这类游戏你需要使用专门为Il2Cpp编译的BepInEx版本通常称为BepInEx Il2Cpp版本以及对应的AutoTranslator版本。安装流程类似但务必确保所有组件BepInEx、AutoTranslator都是针对Il2Cpp的版本。判断游戏是否为Il2Cpp可以查看游戏目录下是否存在GameAssembly.dll和UnityPlayer.dll如果存在GameAssembly.dll基本就是Il2Cpp了。这类游戏的翻译配置原理相同但底层注入方式不同稳定性也可能有所差异。5. 实战问题排查与经验实录即使按照指南操作在实际使用中仍会遇到各种问题。这里我整理了一份最常见问题的排查清单和我的解决经验。问题现象可能原因排查步骤与解决方案游戏启动崩溃或无反应1. BepInEx版本与游戏不兼容位数不对。2. 杀毒软件拦截。3. 游戏有强反作弊。1. 确认游戏是x86还是x64换用对应BepInEx。2. 关闭杀毒软件将游戏目录加入白名单。3. 查阅该游戏社区看是否有特殊的Mod加载方法或禁用反作弊的启动参数。游戏能运行但无任何翻译效果1. AutoTranslator插件未正确加载。2. 配置文件错误如语言代码写错。3. 文本框架未正确启用。1. 检查BepInEx\plugins下是否有XUnity.AutoTranslator.dll并查看BepInEx\LogOutput.log文件搜索“AutoTranslator”看是否有加载成功或报错信息。2. 检查AutoTranslatorConfig.ini中的SourceLanguage和DestinationLanguage是否正确使用ISO 639-1代码如en, zh, ja。3. 尝试在配置中同时启用EnableUGUI和EnableTextMeshPro。部分文本翻译了部分没翻译1. 文本渲染方式特殊如基于纹理的图片文字。2. 文本被正则表达式过滤掉了。3. 该文本在缓存中已有空翻译或错误翻译。1. 图片文字无法通过此插件翻译这是硬伤。2. 检查配置文件[Regex]部分暂时注释掉所有规则测试。3. 删除Translation文件夹下对应语言的缓存文件让插件重新抓取和翻译。翻译延迟非常高或频繁失败1. 网络问题连接翻译API不稳定。2. 触发了翻译API的请求频率限制尤其是Google免费版。3. 句子过长超出配置限制。1. 尝试切换翻译引擎如从Google换到百度。2. 在配置文件中增加DelayAfterTranslation参数如设为200毫秒降低请求频率。3. 确保SplitLongTextTrue并适当增加MaxCharactersPerTranslation但不宜过大。翻译后字体显示为方框游戏原字体不支持中文。1. 尝试使用4.3节所述的字体补丁功能。2. 如果字体补丁无效可能是游戏使用了自定义字体渲染可以尝试寻找该游戏的专用字体Mod。翻译结果质量极差或上下文错误机翻的固有缺陷。句子被截断丢失上下文。1. 利用AdditionalTranslations.txt进行人工修正这是提升质量最根本的方法。2. 尝试使用质量更高的引擎如DeepL。3. 检查SplitLongText设置有时不分割长句反而能保留更多上下文信息供翻译引擎判断。我的核心经验日志是你的最佳朋友。绝大多数问题都能在BepInEx\LogOutput.log这个日志文件中找到线索。打开它搜索“error”、“warn”、“exception”或“AutoTranslator”等关键词通常能直接定位到问题所在。例如如果日志显示“Failed to download translation”那就是网络或API配置问题如果显示“Hook failed for method…”那就是文本拦截环节出了问题。最后保持耐心和探索精神。AutoTranslator是一个社区驱动的强大工具但并非万能。对于每一款新游戏都是一次新的适配挑战。当你能成功为一款心爱的生肉游戏打上流畅的实时翻译时那种成就感绝对是值得的。
