1. 项目概述为什么你的Unity游戏需要智能实时翻译做独立游戏或者面向全球发行的中小团队应该都遇到过这个头疼的问题游戏文本量不小但预算请不起专业的本地化团队或者游戏上线后玩家社区自发做了多语言翻译你却不知道怎么高效地集成进去。手动替换UI文本那得改多少预制体。等官方出语言包周期太长玩家可能都流失了。这就是XUnity.AutoTranslator这类插件存在的意义。它不是一个简单的文本替换工具而是一个运行时的、可高度定制的实时翻译框架。简单来说它能在游戏运行时动态拦截游戏引擎Unity试图在屏幕上显示的任何文本调用你指定的翻译服务比如谷歌翻译、百度翻译、DeepL甚至是本地离线词典然后将翻译结果“贴”回原处整个过程对玩家几乎是透明的。对于开发者这意味着你可以用极低的成本为你的游戏快速添加多语言支持或者让玩家社区贡献的翻译文件能够即时生效无需重新打包游戏。我最初接触它是为了解决一个Steam上发布的视觉小说游戏的日语本地化问题。当时只有英文版但日语玩家呼声很高。如果走传统流程导出文本、交给翻译、导入、测试、再发布补丁至少一个月。用了XUnity.AutoTranslator配合社区翻译者提供的文本文件我们在一周内就上线了一个可玩的日语版本玩家反馈极好。这不仅仅是“翻译”更是打开了玩家驱动内容Player-Driven Localization的大门。2. 核心需求解析不只是“翻译一下”在深入配置之前我们必须先厘清使用XUnity.AutoTranslator的几种核心场景。这决定了你后续的配置策略和复杂程度。2.1 场景一开发者快速实现游戏多语言化作为开发者你手头有游戏的源代码或资产。你的目标是系统性地为游戏添加几种主流语言支持。需求需要翻译游戏内所有静态文本UI、物品描述、对话等并希望翻译结果稳定、可管理。XUnity.AutoTranslator的角色此时插件更像一个“实时本地化框架”。你会倾向于使用它的“离线模式”即预先准备好所有文本的翻译文件如.txt或.po格式。插件在运行时加载这些文件实现即时翻译。优势是翻译质量完全可控、无网络依赖、无API调用费用。关键考量如何从游戏中高效提取所有待翻译文本翻译文件如何组织和管理如何让翻译与游戏的原生文本系统如 Unity 的Localization包或I2 Localization协同工作2.2 场景二为已发布的游戏集成社区翻译你的游戏已经上线活跃的玩家社区为它制作了非官方的语言补丁MOD。你想官方化地集成这些成果提升玩家体验。需求安全、便捷地加载和使用玩家社区生成的翻译文件同时避免破坏游戏本身的更新和存档。XUnity.AutoTranslator的角色作为“社区翻译加载器”。你可以引导社区翻译者使用插件规定的格式如每行原文译文的.txt文件制作补丁。玩家只需将翻译文件放入指定文件夹如BepInEx/Translation游戏启动时便会自动加载。这极大地降低了分发和使用门槛。关键考量如何设计翻译文件的格式和存放路径以方便玩家如何确保社区翻译的文本与游戏更新后的新文本保持同步如何应对同一文本有多份社区翻译时的冲突解决2.3 场景三玩家实时翻译非母语游戏你是一名玩家下载了一款没有中文的独立游戏。你想立刻玩懂它。需求无需等待官方汉化实时将游戏内文本翻译成中文。可以接受一定的翻译生硬感追求即时性和便利性。XUnity.AutoTranslator的角色这才是最经典的“实时机器翻译”场景。你需要配置在线的翻译服务API如谷歌、百度。插件会截获游戏文本发送到云端获取翻译后显示。整个过程可能会有少许延迟并且翻译质量取决于机器翻译引擎。关键考量选择哪个翻译服务速度、质量、费用如何申请和配置API密钥如何设置缓存以减少重复翻译和API调用次数如何应对网络不稳定导致的翻译失败注意无论哪种场景XUnity.AutoTranslator的核心工作原理都是“钩子”Hooking。它通过 HarmonyX 等库在运行时修改 Unity 的部分方法在文本被渲染到屏幕前将其拦截替换为翻译后的文本。这意味着它对于大多数使用标准 Unity UIuGUI、TextMeshPro或常见对话系统的游戏兼容性很好但对于一些使用自定义渲染或极度冷门插件显示文本的情况可能需要额外配置。3. 环境准备与插件安装工欲善其事必先利其器。XUnity.AutoTranslator的安装方式取决于你的游戏运行环境。它主要支持通过BepInEx这个强大的 Unity 游戏 Mod 框架来加载。下面我们分步进行。3.1 第一步确认游戏运行环境与Mod支持绝大多数使用此插件的场景都是针对已编译发布的PC平台独立游戏.exe。首先你需要确认目标游戏是否支持BepInEx。查看游戏根目录打开游戏安装文件夹寻找BepInEx文件夹。如果存在并且里面有core、plugins等子文件夹说明游戏已预装或可以安装 BepInEx。查询社区在游戏的Steam社区、贴吧或相关Mod网站如 Nexus Mods搜索游戏名 “BepInEx”。如果该游戏有Mod社区通常会有详细的BepInEx安装指南。手动安装 BepInEx如果游戏没有预装你需要手动安装。前往 BepInEx 的 GitHub 发布页下载对应版本的BepInEx_x64_版本号.zip对于大多数64位Unity游戏。将压缩包内所有文件解压到游戏根目录即.exe文件所在目录。3.2 第二步获取 XUnity.AutoTranslator 插件插件本身通常以.dll文件形式分发。最可靠的来源是 GitHub 发布页。访问发布页在浏览器中搜索 “XUnity AutoTranslator Releases”找到其 GitHub 页面。选择版本下载最新稳定版的XUnity.AutoTranslator-BepInEx-版本号.zip。注意区分BepInEx版本和MelonLoader版本我们这里使用前者。解压文件将下载的压缩包解压你会看到类似BepInEx的文件夹结构。3.3 第三步安装与部署安装过程本质上是文件合并。合并文件夹将解压得到的BepInEx文件夹整体拖拽或复制到你的游戏根目录。如果系统提示有重复文件选择“替换”或“合并”。关键文件位置确认安装完成后正确的文件路径应该是游戏根目录/BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.dll(核心插件)游戏根目录/BepInEx/config/AutoTranslatorConfig.ini(配置文件首次运行后生成)游戏根目录/Translation(翻译文件存放目录首次运行需要翻译后生成)首次运行启动游戏。如果安装成功游戏启动时在命令行窗口或BepInEx的日志文件BepInEx/LogOutput.log中你应该能看到XUnity.AutoTranslator加载成功的日志信息。同时在BepInEx/config目录下会自动生成AutoTranslatorConfig.ini配置文件。3.4 第四步基础配置检查配置文件初探首次运行后不要急于设置翻译API。先打开AutoTranslatorConfig.ini关注以下几个最基础的设置它们决定了插件的全局行为[General] ; 是否启用翻译插件 Enabledtrue ; 翻译结果显示的延迟秒用于防止文本闪烁。对于视觉小说可以设低些0.1对于快速变化的UI可以设高些0.5 Delay0.3 ; 最大翻译缓存数量。缓存已翻译的文本极大提升重复文本的显示速度。建议保持默认或调高。 MaxCachedTranslations1000 [Text] ; 要翻译的文本类型。默认全部开启即可。 EnableTextMeshProtrue EnableNGUIfalse ; 如果游戏不用NGUI可关闭 EnableUnityUItrue [Translation] ; 离线翻译文件优先级。数字越小优先级越高。 ; 例如1 的翻译会覆盖 2 的翻译。 OfflineTranslationPriority1 ; 在线翻译优先级。 OnlineTranslationPriority2这个阶段确保Enabledtrue其他保持默认即可。我们接下来会深入配置在线和离线翻译。4. 核心配置详解在线翻译与离线翻译这是配置的核心部分决定了你的翻译从哪里来。XUnity.AutoTranslator支持多种后端Endpoint你可以同时配置在线和离线并设置优先级。4.1 在线翻译服务配置在线翻译适合“玩家实时翻译”场景。你需要一个翻译服务的API。这里以谷歌翻译和百度翻译为例因为两者相对稳定且免费额度通常足够个人使用。4.1.1 配置谷歌翻译GoogleTranslate谷歌翻译的免费API通过translate.google.com不稳定且可能被限。更推荐使用官方付费APIGoogle Cloud Translation但有每月50万字符的免费额度。获取API密钥访问 Google Cloud Console创建一个新项目。在项目中启用 “Cloud Translation API”。在“凭据”页面创建API密钥。修改配置文件打开AutoTranslatorConfig.ini找到[GoogleTranslate]部分如果没有可以手动添加。[GoogleTranslate] ; 启用此服务 Enabledtrue ; 填写你申请的API密钥 ApiKeyYOUR_GOOGLE_CLOUD_API_KEY_HERE ; 源语言设为 auto 让谷歌自动检测 SourceLanguageauto ; 目标语言例如中文 TargetLanguagezh-CN ; 请求频率限制毫秒避免请求过快被限制建议≥500 RequestFrequency1000实操心得谷歌云翻译API质量很高但配置稍复杂。RequestFrequency不要设得太低尤其是免费额度下频繁请求可能导致临时封禁。对于单人游玩的单机游戏1000毫秒1秒的间隔是安全且体验可接受的。4.1.2 配置百度翻译BaiduTranslate百度翻译通用API提供每月200万字符的免费额度对中文支持更地道。获取API密钥注册百度开发者账号。在“管理控制台”创建通用翻译服务应用。获取App ID和密钥。修改配置文件[BaiduTranslate] Enabledtrue ; 百度提供的App ID AppIdYOUR_BAIDU_APP_ID ; 百度提供的密钥 SecretKeyYOUR_BAIDU_SECRET_KEY SourceLanguageauto TargetLanguagezh RequestFrequency1000注意事项百度翻译的TargetLanguage参数是zh中文而非zh-CN。RequestFrequency同样重要百度对免费API的QPS每秒查询率也有限制。4.1.3 在线翻译的通用优化设置在[Translation]部分有一些关键设置影响在线翻译体验[Translation] ; 在线翻译失败后的重试次数 MaxTranslationsPerRequest1 ; 是否启用翻译缓存强烈建议开启 EnableTranslationCachetrue ; 缓存文件路径 CachePathTranslation\Cache ; 是否在游戏启动时预加载缓存加快初始翻译速度 PreloadCachetrueEnableTranslationCachetrue是最重要的优化选项。开启后所有成功翻译的文本都会以原文-译文的形式保存在Cache文件夹的.dat文件中。下次游戏启动或遇到相同文本时直接读取缓存速度极快且不消耗API额度。PreloadCachetrue会让插件在游戏启动时加载整个缓存文件到内存。对于缓存很大的情况比如全游戏翻译这会增加一点启动时间但能实现游戏中真正的“零延迟”翻译。4.2 离线翻译文件配置离线翻译是开发者和社区翻译的利器。它不依赖网络翻译质量由你完全掌控。4.2.1 翻译文件格式与位置插件默认从游戏根目录/Translation文件夹或BepInEx/Translation取决于配置加载翻译文件。文件格式最简单的格式是.txt每行一条记录格式为原文译文。Hello World!你好世界 Press any key to start.按任意键开始。文件命名与优先级你可以创建多个.txt文件。插件加载时会按照[Translation]部分OfflineTranslationFiles指定的顺序加载后加载的文件会覆盖先加载文件中相同的“原文”。你可以利用这一点实现模块化翻译如Base.txt,DLC1.txt,CommunityPatch.txt。4.2.2 为开发者生成与管理翻译文件手动提取游戏内所有文本是不现实的。XUnity.AutoTranslator提供了一个强大功能文本转储Text Dump。启用转储在配置文件中设置[TextDump] ; 启用文本转储 Enabledtrue ; 转储文件路径 DumpPathTranslation\TextDump.txt ; 是否在转储时排除已翻译的文本避免文件过大 ExcludeAlreadyTranslatedtrue运行游戏并触发文本启动游戏尽可能多地游玩访问所有菜单、对话、场景。插件会将它捕获到的所有未翻译的原文记录到TextDump.txt中。处理转储文件这个文件是一个宝贵的“待翻译词条库”。你可以将其交给翻译人员或者用CAT计算机辅助翻译工具处理。翻译完成后将原文译文格式的内容保存到新的.txt文件如zh-CN.txt并放入Translation文件夹。关闭转储翻译文件准备就绪后务必将[TextDump]下的Enabled设为false否则每次游戏都会重新生成转储文件覆盖你的翻译。4.2.3 高级格式PO文件支持对于专业的本地化流程插件也支持.po(Portable Object) 格式这是 GNU gettext 使用的标准格式被许多专业翻译工具支持。[Translation] ; 指定离线翻译文件优先级从高到低 OfflineTranslationFilesTranslation\zh_CN.po, Translation\zh_CN.txt.po文件结构更复杂但包含更多元数据如注释、上下文适合团队协作。msgid Hello World! msgstr 你好世界 msgid Save Game msgctxt Menu ; 提供上下文避免歧义 msgstr 保存游戏5. 高级功能与疑难排查当基础翻译工作流跑通后你会遇到一些特定场景下的问题。这部分分享的正是常规教程里很少提及的“踩坑”经验。5.1 处理动态文本与特殊UI不是所有文本都能被轻松钩住。以下情况需要额外处理TextMeshPro动态生成文本有些游戏会动态创建TextMeshProUGUI组件并赋值。确保配置中EnableTextMeshProtrue。如果仍不生效可能需要检查游戏是否使用了非常规的字体渲染或Shader极少数情况下需要针对该游戏编写补丁Patch。纹理图中的文字图片文字这是机器翻译的盲区。XUnity.AutoTranslator无法翻译图片中的文字。对于这种情况只能通过替换纹理资源的方式解决这超出了本插件的范畴需要制作传统的“汉化补丁”来替换游戏资源文件。控制台/日志文本通常插件默认不翻译这些输出到控制台的文本。如果你需要翻译可以在配置中寻找类似EnableConsoleText的选项如果该版本插件提供。5.2 翻译缓存的管理与妙用缓存文件.dat不仅是加速工具更是宝贵的资产。缓存即词典当你使用在线翻译玩通一款游戏后Cache文件夹里保存的原文-译文映射实际上就是一份为这款游戏量身定制的机器翻译词典。你可以将这个缓存文件分享给其他玩家他们只需放入对应目录即使不配置在线API也能享受到完全相同的翻译效果且速度更快。缓存合并与清理如果从多个来源获得了缓存文件你可以用文本编辑器打开它们注意是二进制格式但部分可读手动合并。或者更简单的方法是清空Cache文件夹重新用你首选的翻译服务如百度生成一份纯净的缓存。缓存与离线文件的优先级记住离线翻译文件.txt/.po的优先级默认高于在线翻译但翻译缓存的优先级又高于离线文件如果EnableTranslationCachetrue。这意味着一旦某个句子被在线翻译并缓存即使你在离线文件中修改了它的翻译也不会生效。此时需要手动删除缓存文件中对应的条目或清空整个缓存。5.3 常见问题与解决方案速查表下表整理了配置和使用过程中最常见的问题及排查思路问题现象可能原因排查步骤与解决方案游戏启动无翻译效果BepInEx日志无相关记录。1. 插件未正确安装。2. BepInEx未成功加载。1. 检查BepInEx/plugins/XUnity.AutoTranslator下是否有.dll文件。2. 查看BepInEx/LogOutput.log搜索 “AutoTranslator”看是否有加载成功或错误信息。3. 确认游戏版本与BepInEx、插件版本兼容。部分UI文本翻译了但对话/任务文本没翻译。1. 文本未被插件钩子捕获。2. 该文本可能是图片或特殊组件。1. 启用[TextDump]进入游戏触发那些未翻译的文本查看TextDump.txt中是否出现。如果出现说明被捕获了问题在翻译环节如果没出现说明插件钩子没挂上。2. 对于特殊组件可能需要社区针对该游戏制作的额外补丁。在线翻译时好时坏经常失败。1. 网络连接问题。2. API调用频率超限。3. API密钥无效或额度用尽。1. 检查网络。2.大幅增加RequestFrequency值如设为3000这是最常见原因。3. 登录对应的云服务平台谷歌云/百度云检查API是否启用、密钥是否正确、额度是否充足。翻译结果有延迟文字先显示原文再变成译文。翻译延迟设置过短或网络请求慢。1. 适当增加[General]下的Delay值如0.5秒给翻译请求留出时间。2. 更治本的方法是启用并预加载翻译缓存(EnableTranslationCachetruePreloadCachetrue)缓存命中则无延迟。自己添加的离线翻译文件不生效。1. 文件格式错误。2. 文件未放在正确目录。3. 优先级被缓存或更高优先级文件覆盖。1. 检查文件是否为UTF-8编码格式是否为原文译文。2. 确认文件在Translation文件夹内且文件名在OfflineTranslationFiles配置中被列出。3. 临时删除Cache文件夹或检查是否有其他更高优先级的翻译文件包含了相同原文。翻译了不该翻译的文字如代码、变量名。插件过于“积极”地钩住了所有文本。在配置文件中使用[Regex]部分进行过滤。例如添加规则忽略包含大括号或特定前缀的文本Ignore.*\{.*\}.*或Ignore^[A-Z_]$(忽略全大写下划线文本可能是常量)。5.4 性能调优与资源占用对于大型游戏翻译插件可能会对性能产生轻微影响合理配置可以将其降至最低。内存占用主要来自缓存。如果预加载了包含数万条翻译的缓存可能会占用几十MB内存。对于现代PC这不是问题。如果内存紧张可以关闭PreloadCache但首次翻译时会有延迟。CPU占用文本匹配和替换操作消耗CPU。MaxCachedTranslations设置缓存大小避免无限增长。保持默认的1000或10000通常足够。I/O操作首次运行或缓存未命中时会读写磁盘。使用SSD可以忽略此影响。确保插件有对游戏目录的写入权限否则缓存会失败。我个人在为一个拥有超过3万条对话文本的RPG游戏配置时最终方案是社区提供的精校离线翻译文件优先级1 谷歌翻译API作为后备优先级2 全量预加载缓存。这样确保了99%的文本在游戏启动瞬间就已就绪体验与原生中文版无异而剩下的1%生僻词条也能通过在线API获得翻译实现了质量与覆盖率的完美平衡。整个配置过程的核心思路其实就是理解“优先级”和“缓存”这两个概念它们让你能在可控的翻译质量、即时的响应速度和灵活的工作流之间找到最佳结合点。
1. 项目概述为什么你的Unity游戏需要智能实时翻译做独立游戏或者面向全球发行的中小团队应该都遇到过这个头疼的问题游戏文本量不小但预算请不起专业的本地化团队或者游戏上线后玩家社区自发做了多语言翻译你却不知道怎么高效地集成进去。手动替换UI文本那得改多少预制体。等官方出语言包周期太长玩家可能都流失了。这就是XUnity.AutoTranslator这类插件存在的意义。它不是一个简单的文本替换工具而是一个运行时的、可高度定制的实时翻译框架。简单来说它能在游戏运行时动态拦截游戏引擎Unity试图在屏幕上显示的任何文本调用你指定的翻译服务比如谷歌翻译、百度翻译、DeepL甚至是本地离线词典然后将翻译结果“贴”回原处整个过程对玩家几乎是透明的。对于开发者这意味着你可以用极低的成本为你的游戏快速添加多语言支持或者让玩家社区贡献的翻译文件能够即时生效无需重新打包游戏。我最初接触它是为了解决一个Steam上发布的视觉小说游戏的日语本地化问题。当时只有英文版但日语玩家呼声很高。如果走传统流程导出文本、交给翻译、导入、测试、再发布补丁至少一个月。用了XUnity.AutoTranslator配合社区翻译者提供的文本文件我们在一周内就上线了一个可玩的日语版本玩家反馈极好。这不仅仅是“翻译”更是打开了玩家驱动内容Player-Driven Localization的大门。2. 核心需求解析不只是“翻译一下”在深入配置之前我们必须先厘清使用XUnity.AutoTranslator的几种核心场景。这决定了你后续的配置策略和复杂程度。2.1 场景一开发者快速实现游戏多语言化作为开发者你手头有游戏的源代码或资产。你的目标是系统性地为游戏添加几种主流语言支持。需求需要翻译游戏内所有静态文本UI、物品描述、对话等并希望翻译结果稳定、可管理。XUnity.AutoTranslator的角色此时插件更像一个“实时本地化框架”。你会倾向于使用它的“离线模式”即预先准备好所有文本的翻译文件如.txt或.po格式。插件在运行时加载这些文件实现即时翻译。优势是翻译质量完全可控、无网络依赖、无API调用费用。关键考量如何从游戏中高效提取所有待翻译文本翻译文件如何组织和管理如何让翻译与游戏的原生文本系统如 Unity 的Localization包或I2 Localization协同工作2.2 场景二为已发布的游戏集成社区翻译你的游戏已经上线活跃的玩家社区为它制作了非官方的语言补丁MOD。你想官方化地集成这些成果提升玩家体验。需求安全、便捷地加载和使用玩家社区生成的翻译文件同时避免破坏游戏本身的更新和存档。XUnity.AutoTranslator的角色作为“社区翻译加载器”。你可以引导社区翻译者使用插件规定的格式如每行原文译文的.txt文件制作补丁。玩家只需将翻译文件放入指定文件夹如BepInEx/Translation游戏启动时便会自动加载。这极大地降低了分发和使用门槛。关键考量如何设计翻译文件的格式和存放路径以方便玩家如何确保社区翻译的文本与游戏更新后的新文本保持同步如何应对同一文本有多份社区翻译时的冲突解决2.3 场景三玩家实时翻译非母语游戏你是一名玩家下载了一款没有中文的独立游戏。你想立刻玩懂它。需求无需等待官方汉化实时将游戏内文本翻译成中文。可以接受一定的翻译生硬感追求即时性和便利性。XUnity.AutoTranslator的角色这才是最经典的“实时机器翻译”场景。你需要配置在线的翻译服务API如谷歌、百度。插件会截获游戏文本发送到云端获取翻译后显示。整个过程可能会有少许延迟并且翻译质量取决于机器翻译引擎。关键考量选择哪个翻译服务速度、质量、费用如何申请和配置API密钥如何设置缓存以减少重复翻译和API调用次数如何应对网络不稳定导致的翻译失败注意无论哪种场景XUnity.AutoTranslator的核心工作原理都是“钩子”Hooking。它通过 HarmonyX 等库在运行时修改 Unity 的部分方法在文本被渲染到屏幕前将其拦截替换为翻译后的文本。这意味着它对于大多数使用标准 Unity UIuGUI、TextMeshPro或常见对话系统的游戏兼容性很好但对于一些使用自定义渲染或极度冷门插件显示文本的情况可能需要额外配置。3. 环境准备与插件安装工欲善其事必先利其器。XUnity.AutoTranslator的安装方式取决于你的游戏运行环境。它主要支持通过BepInEx这个强大的 Unity 游戏 Mod 框架来加载。下面我们分步进行。3.1 第一步确认游戏运行环境与Mod支持绝大多数使用此插件的场景都是针对已编译发布的PC平台独立游戏.exe。首先你需要确认目标游戏是否支持BepInEx。查看游戏根目录打开游戏安装文件夹寻找BepInEx文件夹。如果存在并且里面有core、plugins等子文件夹说明游戏已预装或可以安装 BepInEx。查询社区在游戏的Steam社区、贴吧或相关Mod网站如 Nexus Mods搜索游戏名 “BepInEx”。如果该游戏有Mod社区通常会有详细的BepInEx安装指南。手动安装 BepInEx如果游戏没有预装你需要手动安装。前往 BepInEx 的 GitHub 发布页下载对应版本的BepInEx_x64_版本号.zip对于大多数64位Unity游戏。将压缩包内所有文件解压到游戏根目录即.exe文件所在目录。3.2 第二步获取 XUnity.AutoTranslator 插件插件本身通常以.dll文件形式分发。最可靠的来源是 GitHub 发布页。访问发布页在浏览器中搜索 “XUnity AutoTranslator Releases”找到其 GitHub 页面。选择版本下载最新稳定版的XUnity.AutoTranslator-BepInEx-版本号.zip。注意区分BepInEx版本和MelonLoader版本我们这里使用前者。解压文件将下载的压缩包解压你会看到类似BepInEx的文件夹结构。3.3 第三步安装与部署安装过程本质上是文件合并。合并文件夹将解压得到的BepInEx文件夹整体拖拽或复制到你的游戏根目录。如果系统提示有重复文件选择“替换”或“合并”。关键文件位置确认安装完成后正确的文件路径应该是游戏根目录/BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.dll(核心插件)游戏根目录/BepInEx/config/AutoTranslatorConfig.ini(配置文件首次运行后生成)游戏根目录/Translation(翻译文件存放目录首次运行需要翻译后生成)首次运行启动游戏。如果安装成功游戏启动时在命令行窗口或BepInEx的日志文件BepInEx/LogOutput.log中你应该能看到XUnity.AutoTranslator加载成功的日志信息。同时在BepInEx/config目录下会自动生成AutoTranslatorConfig.ini配置文件。3.4 第四步基础配置检查配置文件初探首次运行后不要急于设置翻译API。先打开AutoTranslatorConfig.ini关注以下几个最基础的设置它们决定了插件的全局行为[General] ; 是否启用翻译插件 Enabledtrue ; 翻译结果显示的延迟秒用于防止文本闪烁。对于视觉小说可以设低些0.1对于快速变化的UI可以设高些0.5 Delay0.3 ; 最大翻译缓存数量。缓存已翻译的文本极大提升重复文本的显示速度。建议保持默认或调高。 MaxCachedTranslations1000 [Text] ; 要翻译的文本类型。默认全部开启即可。 EnableTextMeshProtrue EnableNGUIfalse ; 如果游戏不用NGUI可关闭 EnableUnityUItrue [Translation] ; 离线翻译文件优先级。数字越小优先级越高。 ; 例如1 的翻译会覆盖 2 的翻译。 OfflineTranslationPriority1 ; 在线翻译优先级。 OnlineTranslationPriority2这个阶段确保Enabledtrue其他保持默认即可。我们接下来会深入配置在线和离线翻译。4. 核心配置详解在线翻译与离线翻译这是配置的核心部分决定了你的翻译从哪里来。XUnity.AutoTranslator支持多种后端Endpoint你可以同时配置在线和离线并设置优先级。4.1 在线翻译服务配置在线翻译适合“玩家实时翻译”场景。你需要一个翻译服务的API。这里以谷歌翻译和百度翻译为例因为两者相对稳定且免费额度通常足够个人使用。4.1.1 配置谷歌翻译GoogleTranslate谷歌翻译的免费API通过translate.google.com不稳定且可能被限。更推荐使用官方付费APIGoogle Cloud Translation但有每月50万字符的免费额度。获取API密钥访问 Google Cloud Console创建一个新项目。在项目中启用 “Cloud Translation API”。在“凭据”页面创建API密钥。修改配置文件打开AutoTranslatorConfig.ini找到[GoogleTranslate]部分如果没有可以手动添加。[GoogleTranslate] ; 启用此服务 Enabledtrue ; 填写你申请的API密钥 ApiKeyYOUR_GOOGLE_CLOUD_API_KEY_HERE ; 源语言设为 auto 让谷歌自动检测 SourceLanguageauto ; 目标语言例如中文 TargetLanguagezh-CN ; 请求频率限制毫秒避免请求过快被限制建议≥500 RequestFrequency1000实操心得谷歌云翻译API质量很高但配置稍复杂。RequestFrequency不要设得太低尤其是免费额度下频繁请求可能导致临时封禁。对于单人游玩的单机游戏1000毫秒1秒的间隔是安全且体验可接受的。4.1.2 配置百度翻译BaiduTranslate百度翻译通用API提供每月200万字符的免费额度对中文支持更地道。获取API密钥注册百度开发者账号。在“管理控制台”创建通用翻译服务应用。获取App ID和密钥。修改配置文件[BaiduTranslate] Enabledtrue ; 百度提供的App ID AppIdYOUR_BAIDU_APP_ID ; 百度提供的密钥 SecretKeyYOUR_BAIDU_SECRET_KEY SourceLanguageauto TargetLanguagezh RequestFrequency1000注意事项百度翻译的TargetLanguage参数是zh中文而非zh-CN。RequestFrequency同样重要百度对免费API的QPS每秒查询率也有限制。4.1.3 在线翻译的通用优化设置在[Translation]部分有一些关键设置影响在线翻译体验[Translation] ; 在线翻译失败后的重试次数 MaxTranslationsPerRequest1 ; 是否启用翻译缓存强烈建议开启 EnableTranslationCachetrue ; 缓存文件路径 CachePathTranslation\Cache ; 是否在游戏启动时预加载缓存加快初始翻译速度 PreloadCachetrueEnableTranslationCachetrue是最重要的优化选项。开启后所有成功翻译的文本都会以原文-译文的形式保存在Cache文件夹的.dat文件中。下次游戏启动或遇到相同文本时直接读取缓存速度极快且不消耗API额度。PreloadCachetrue会让插件在游戏启动时加载整个缓存文件到内存。对于缓存很大的情况比如全游戏翻译这会增加一点启动时间但能实现游戏中真正的“零延迟”翻译。4.2 离线翻译文件配置离线翻译是开发者和社区翻译的利器。它不依赖网络翻译质量由你完全掌控。4.2.1 翻译文件格式与位置插件默认从游戏根目录/Translation文件夹或BepInEx/Translation取决于配置加载翻译文件。文件格式最简单的格式是.txt每行一条记录格式为原文译文。Hello World!你好世界 Press any key to start.按任意键开始。文件命名与优先级你可以创建多个.txt文件。插件加载时会按照[Translation]部分OfflineTranslationFiles指定的顺序加载后加载的文件会覆盖先加载文件中相同的“原文”。你可以利用这一点实现模块化翻译如Base.txt,DLC1.txt,CommunityPatch.txt。4.2.2 为开发者生成与管理翻译文件手动提取游戏内所有文本是不现实的。XUnity.AutoTranslator提供了一个强大功能文本转储Text Dump。启用转储在配置文件中设置[TextDump] ; 启用文本转储 Enabledtrue ; 转储文件路径 DumpPathTranslation\TextDump.txt ; 是否在转储时排除已翻译的文本避免文件过大 ExcludeAlreadyTranslatedtrue运行游戏并触发文本启动游戏尽可能多地游玩访问所有菜单、对话、场景。插件会将它捕获到的所有未翻译的原文记录到TextDump.txt中。处理转储文件这个文件是一个宝贵的“待翻译词条库”。你可以将其交给翻译人员或者用CAT计算机辅助翻译工具处理。翻译完成后将原文译文格式的内容保存到新的.txt文件如zh-CN.txt并放入Translation文件夹。关闭转储翻译文件准备就绪后务必将[TextDump]下的Enabled设为false否则每次游戏都会重新生成转储文件覆盖你的翻译。4.2.3 高级格式PO文件支持对于专业的本地化流程插件也支持.po(Portable Object) 格式这是 GNU gettext 使用的标准格式被许多专业翻译工具支持。[Translation] ; 指定离线翻译文件优先级从高到低 OfflineTranslationFilesTranslation\zh_CN.po, Translation\zh_CN.txt.po文件结构更复杂但包含更多元数据如注释、上下文适合团队协作。msgid Hello World! msgstr 你好世界 msgid Save Game msgctxt Menu ; 提供上下文避免歧义 msgstr 保存游戏5. 高级功能与疑难排查当基础翻译工作流跑通后你会遇到一些特定场景下的问题。这部分分享的正是常规教程里很少提及的“踩坑”经验。5.1 处理动态文本与特殊UI不是所有文本都能被轻松钩住。以下情况需要额外处理TextMeshPro动态生成文本有些游戏会动态创建TextMeshProUGUI组件并赋值。确保配置中EnableTextMeshProtrue。如果仍不生效可能需要检查游戏是否使用了非常规的字体渲染或Shader极少数情况下需要针对该游戏编写补丁Patch。纹理图中的文字图片文字这是机器翻译的盲区。XUnity.AutoTranslator无法翻译图片中的文字。对于这种情况只能通过替换纹理资源的方式解决这超出了本插件的范畴需要制作传统的“汉化补丁”来替换游戏资源文件。控制台/日志文本通常插件默认不翻译这些输出到控制台的文本。如果你需要翻译可以在配置中寻找类似EnableConsoleText的选项如果该版本插件提供。5.2 翻译缓存的管理与妙用缓存文件.dat不仅是加速工具更是宝贵的资产。缓存即词典当你使用在线翻译玩通一款游戏后Cache文件夹里保存的原文-译文映射实际上就是一份为这款游戏量身定制的机器翻译词典。你可以将这个缓存文件分享给其他玩家他们只需放入对应目录即使不配置在线API也能享受到完全相同的翻译效果且速度更快。缓存合并与清理如果从多个来源获得了缓存文件你可以用文本编辑器打开它们注意是二进制格式但部分可读手动合并。或者更简单的方法是清空Cache文件夹重新用你首选的翻译服务如百度生成一份纯净的缓存。缓存与离线文件的优先级记住离线翻译文件.txt/.po的优先级默认高于在线翻译但翻译缓存的优先级又高于离线文件如果EnableTranslationCachetrue。这意味着一旦某个句子被在线翻译并缓存即使你在离线文件中修改了它的翻译也不会生效。此时需要手动删除缓存文件中对应的条目或清空整个缓存。5.3 常见问题与解决方案速查表下表整理了配置和使用过程中最常见的问题及排查思路问题现象可能原因排查步骤与解决方案游戏启动无翻译效果BepInEx日志无相关记录。1. 插件未正确安装。2. BepInEx未成功加载。1. 检查BepInEx/plugins/XUnity.AutoTranslator下是否有.dll文件。2. 查看BepInEx/LogOutput.log搜索 “AutoTranslator”看是否有加载成功或错误信息。3. 确认游戏版本与BepInEx、插件版本兼容。部分UI文本翻译了但对话/任务文本没翻译。1. 文本未被插件钩子捕获。2. 该文本可能是图片或特殊组件。1. 启用[TextDump]进入游戏触发那些未翻译的文本查看TextDump.txt中是否出现。如果出现说明被捕获了问题在翻译环节如果没出现说明插件钩子没挂上。2. 对于特殊组件可能需要社区针对该游戏制作的额外补丁。在线翻译时好时坏经常失败。1. 网络连接问题。2. API调用频率超限。3. API密钥无效或额度用尽。1. 检查网络。2.大幅增加RequestFrequency值如设为3000这是最常见原因。3. 登录对应的云服务平台谷歌云/百度云检查API是否启用、密钥是否正确、额度是否充足。翻译结果有延迟文字先显示原文再变成译文。翻译延迟设置过短或网络请求慢。1. 适当增加[General]下的Delay值如0.5秒给翻译请求留出时间。2. 更治本的方法是启用并预加载翻译缓存(EnableTranslationCachetruePreloadCachetrue)缓存命中则无延迟。自己添加的离线翻译文件不生效。1. 文件格式错误。2. 文件未放在正确目录。3. 优先级被缓存或更高优先级文件覆盖。1. 检查文件是否为UTF-8编码格式是否为原文译文。2. 确认文件在Translation文件夹内且文件名在OfflineTranslationFiles配置中被列出。3. 临时删除Cache文件夹或检查是否有其他更高优先级的翻译文件包含了相同原文。翻译了不该翻译的文字如代码、变量名。插件过于“积极”地钩住了所有文本。在配置文件中使用[Regex]部分进行过滤。例如添加规则忽略包含大括号或特定前缀的文本Ignore.*\{.*\}.*或Ignore^[A-Z_]$(忽略全大写下划线文本可能是常量)。5.4 性能调优与资源占用对于大型游戏翻译插件可能会对性能产生轻微影响合理配置可以将其降至最低。内存占用主要来自缓存。如果预加载了包含数万条翻译的缓存可能会占用几十MB内存。对于现代PC这不是问题。如果内存紧张可以关闭PreloadCache但首次翻译时会有延迟。CPU占用文本匹配和替换操作消耗CPU。MaxCachedTranslations设置缓存大小避免无限增长。保持默认的1000或10000通常足够。I/O操作首次运行或缓存未命中时会读写磁盘。使用SSD可以忽略此影响。确保插件有对游戏目录的写入权限否则缓存会失败。我个人在为一个拥有超过3万条对话文本的RPG游戏配置时最终方案是社区提供的精校离线翻译文件优先级1 谷歌翻译API作为后备优先级2 全量预加载缓存。这样确保了99%的文本在游戏启动瞬间就已就绪体验与原生中文版无异而剩下的1%生僻词条也能通过在线API获得翻译实现了质量与覆盖率的完美平衡。整个配置过程的核心思路其实就是理解“优先级”和“缓存”这两个概念它们让你能在可控的翻译质量、即时的响应速度和灵活的工作流之间找到最佳结合点。
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
