玩游戏不等汉化组XUnity.AutoTranslator自动翻译插件安装、配置与调优实战手册【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator玩日文 RPG 却卡在剧情选项前啃英文视觉小说读到眼皮打架——这不是你的语言能力问题而是缺一个能当场翻译的工具。XUnity.AutoTranslator是一款针对 Unity 引擎游戏的自动翻译插件游戏运行到哪文本就被翻译到哪无需改游戏本体文件更不用等汉化组出手。它同时面向两类人想无障碍通关外语游戏的普通玩家以及需要给游戏或 Mod 增加多语言能力的开发者。一、先把原理看明白生肉是如何变熟肉的翻译链路并不神秘可以拆成一条六步流水线步骤发生了什么说明1. 文本钩子插件监听 Unity 的 UI 文本组件UGUI、NGUI、TextMeshPro、TextMesh、IMGUI、FairyGUI、Utage 等框架均被覆盖IMGUI 和 TextMesh 默认关闭2. 去重排队同一段文字合并为一个请求两个组件引用同一句台词时只发一次翻译请求3. 防刷拦截内置 16 条防滥用规则见下文免被服务商封号4. 引擎翻译请求你指定的翻译服务免费在线服务、付费 API、本地软件均可5. 多层缓存结果写入内存与磁盘同一句台词第二次出现时零网络开销6. 文本回填把译文写回 UI 并自适应缩放可配置文本框自动扩容EnableUIResizing免被服务商封号的隐形防线插件对每段新文本会先等待 1 秒确认不再变化再发送请求单次游戏会话最多发送 8000 个请求同一时刻只允许 1 个请求在途日式短语内置约 2000 条静态词典日语→英语直接命中不产生网络请求。连续 5 次请求无结果、或发现文本滚动式不断入队时插件会自动关闭以免刷爆服务——遇到这种情况别慌排查方法见第六节。二、先选引擎再谈安装一张表搞定翻译服务所有可用引擎的源码集中在src/Translators/目录下按要不要钱、要不要认证分成四类类型代表引擎特点适合谁免费在线无需认证GoogleTranslate、BingTranslate、DeepLTranslate、PapagoTranslate零成本但接口随时可能失效先跑通流程的尝鲜用户官方 API需密钥GoogleTranslateLegitimate、BingTranslateLegitimateAzure、DeepLTranslateLegitimate、YandexTranslate、WatsonTranslate、BaiduTranslate稳定、有免费额度如 Azure 每月 200 万字符但需注册申请追求翻译质量稳定的长期用户本地离线LecPowerTranslator15、ezTrans XP不联网、不限额但需自行安装对应翻译软件注重隐私或网络受限的用户自定义 HTTPCustomTranslate任何返回纯文本的 GET 接口都能接开发者 / 折腾党选型建议第一次使用直接选 Google 系免费引擎跑通全流程确定长期使用后优先切到带官方免费额度的 API 引擎并顺手填上FallbackEndpoint备用引擎主引擎挂掉时自动切换。三、三条安装路线按你的情况对号入座项目不依赖任何特定 Mod 框架安装方式取决于游戏里已有的插件管理器。路线 A独立安装ReiPatcher——什么都不用装适合没有安装任何 Mod 管理器的游戏。把发布包解压到游戏根目录运行SetupReiPatcherAndAutoTranslator.exe完成打补丁之后通过生成的Patch and Run快捷方式启动游戏即可。这是最省事的方案但如果游戏已装了 BepInEx 等管理器请改用对应路线否则会冲突。路线 B插件管理器——BepInEx / MelonLoader / IPA / UnityInjector先装好对应管理器再把对应的发布包解压到游戏目录让 dll 落到正确位置例如 BepInEx 是BepInEx/plugins/下。注意游戏若为 IL2CPP 后端需使用 BepInEx 6或 MelonLoader IL2CPP配合BepInEx-IL2CPP专用包仓库src/XUnity.AutoTranslator.Plugin.BepInEx-IL2CPP/目录就是为它准备的。需要从源码构建时克隆仓库git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator无论哪条路线首次启动游戏后配置才会生成。所有文本钩子并非默认全开发现部分文本没被翻译时第一步就是回配置里打开对应的 TextFramework 开关。四、第一次启动后配置与翻译文件体系一次讲清配置文件根据框架落在不同位置BepInExBepInEx/config/AutoTranslatorConfig.ini独立安装AutoTranslator/Config.ini核心三段配置长这样[Service] EndpointGoogleTranslateV2 ; 主翻译引擎 FallbackEndpoint ; 备用引擎留空表示不启用 [General] Languageen ; 目标语言你想翻译成什么 FromLanguageja ; 源语言游戏原文语言 [Behaviour] MaxCharactersPerTranslation200 ; 单条文本最长翻译字符数上限 2500 EnableBatchingTrue ; 合并同段文本减少请求数紧接着插件会在Translation/{Language}/Text/目录BepInEx 下是BepInEx/Translation/自动生成几个会呼吸的文本文件文件用途_AutoGeneratedTranslations.txt插件自动积累的译文缓存可手动增删修正_Substitutions.txt翻译前替换把固定错误翻译或专有名词直接改成你想要的_Preprocessors.txt/_Postprocessors.txt送译前 / 取译后的文本加工规则适合处理特殊符号日常最常用的是_Substitutions.txt——游戏里的角色名、技能名翻译得不对时在这里写一行原文想要的译文就能强制纠正。五、三类游戏实战调校把配置用起来视觉小说对话多、格式多把MinDialogueChars设为 20少于 20 字符不当对话处理开启HandleRichTextTrue让带富文本标记的台词保持格式。遇到日式长句被截断调大MaxCharactersPerTranslation。别忘了ALTT可在原文/译文间切换方便对比。RPG道具与 UI 密集开启EnableUIResizing翻译后文本框会自动扩容防文字溢出中文等非 ASCII 字符显示成方块时配置OverrideFont仅 UGUI或FallbackFontTextMeshProTextMeshPro 推荐用这个而非整体覆盖在Fonts目录放入目标语言字体即可。模拟经营动态生成文本多这类游戏每帧都可能产生新文本最容易触发防刷机制。务必保持EnableBatchingTrue并利用缓存文件让重复出现的文本直接命中本地不再走网络。六、常见症状速查表症状大概率原因处理方式部分文本没翻译对应 TextFramework 默认关闭配置里打开EnableTextMesh/EnableIMGUI界面全卡、请求堆积触发防刷关机按ALTQ重启插件先排查网络与密钥中文/韩文显示方块游戏字体缺字配FallbackFontTextMeshPro或OverrideFont翻译全是错的免费接口已失效换引擎或启用FallbackEndpoint某个词永远翻不对无解于引擎在_Substitutions.txt手动覆盖完全无反应钩子没生效按ALTU手动触发文本钩子七、快捷键速记ALT0开关插件主 UIALT1开关翻译聚合窗口ALTT原文 / 译文切换含纹理需在配置里开启ALTR热重载翻译文件改完 txt 不必重启游戏ALTU手动触发文本钩子补漏必用ALTF开关字体覆盖ALTQ被防刷关闭后重启插件八、不止文字纹理替换与资源重定向很多游戏的文本其实是图片如菜单底图、UI 图标。插件提供了两条路纹理翻译在[Texture]节把EnableTextureDumping设为 True游戏会把可替换图片导出到Translation/{Lang}/Texture/你用修图工具改好后按原文件名放回游戏即加载你的版本。EnableTextureTranslation控制是否启用替换。资源重定向借助仓库src/XUnity.ResourceRedirector/模块可对 TextAsset 等资源做整体重定向用于完整的游戏本地化改造Koikatsu 等游戏的专项适配位于src/XUnity.AutoTranslator.KoikatsuResources/可作参考。九、开发者进阶接入你自己的翻译引擎想给团队或社区接入私有翻译服务CustomTranslate是成本最低的入口只要提供一个 GET 接口接收from、to、text三个参数并返回纯文本即可。[Service] EndpointCustomTranslate [Custom] Urlhttp://你的服务地址/translate请求形如GET http://你的服务地址/translate?fromjatoentextこんにちは响应体直接是译文。想实现更复杂的协议多行批处理、错误码语义参照src/XUnity.AutoTranslator.Plugin.ExtProtocol/的扩展协议。Mod 开发者还能在运行时直接调用AutoTranslator.Default.TryTranslate(...)查询译文让自家 Mod 的文本也吃上同一套缓存。十、给两类人的收尾清单新手请记住这四件事先用默认配置跑通一个游戏再调参数免费引擎只是试金石长期用选带免费额度的官方 API改完任何 txt 按ALTR即可生效翻译缓存文件请定期备份换游戏重装时直接复用。开发者请记住这四件事优先复用插件的缓存与防刷机制别自己裸调翻译接口接入 ExtProtocol 前先读透src/XUnity.AutoTranslator.Plugin.ExtProtocol/的协议定义为 Mod 做本地化时把资源重定向纳入方案社区里涌现的 LLM 类第三方端点如 Ollama 本地模型值得持续关注质量已接近付费 API。语言从来不该是游戏的边界。装上 XUnity.AutoTranslator把这份指南存进收藏夹现在就从你库里吃灰最久的那款外语游戏开始动手吧。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
