XUnity.AutoTranslator Unity游戏实时翻译插件教程：10分钟装好完整汉化

XUnity.AutoTranslator Unity游戏实时翻译插件教程10分钟装好完整汉化【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity.AutoTranslator是一款免费开源的、面向 Unity 引擎游戏的实时翻译插件游戏运行中把外文文本实时替换成中文的 Mod。装好之后菜单、对话、物品说明直接变中文不用等官方汉化也不用逐句查词典。上周末我入了一款心仪很久的英文策略游戏结果图鉴每页都是密密麻麻的长句光看物品说明就想弃坑。如果你也遇到过这种时刻这篇文章带你从零把 XUnity.AutoTranslator 装好、跑通、调顺。 上手前先核对 3 个前提条件这个插件不是独立程序它要钻进游戏进程里才能工作所以先确认游戏本身的状况能省下装完却跑不起来的折腾。游戏引擎必须是 Unity 开发的游戏。虚幻、Source 等其他引擎不在支持范围插件管理器现代 Unity 游戏通常需要插件管理器把第三方 Mod 注入游戏的加载器。最常用的是BepInEx先按它自己的说明装进游戏如果你的游戏是IL2CPP编译的Unity 把 C# 代码转成原生代码的编译模式注入方式不同安装时要用对应的 IL2CPP 版本包系统与网络Windows 系统自动翻译依赖在线翻译服务需要能联网三个都能对上就可以往下走。 三步装好BepInEx 主流路径BepInEx 是 Unity Mod 社区覆盖最广的插件管理器官方 README 也把它列为推荐安装方式卡住时参考资料最多。第 1 步拿到插件文件。从项目 releases 页面下载名为XUnity.AutoTranslator-BepInEx-{版本号}.zip的压缩包或者用命令拉取源码git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator第 2 步解压到游戏根目录。先装好 BepInEx再把插件包整个解压到游戏根目录让文件各归其位BepInEx/plugins/XUnity.AutoTranslator/插件核心其Translators/子文件夹存放各翻译服务的 DLL默认自带 Google 版BepInEx/core/插件依赖的公共库Translation/翻译缓存目录首次启动时自动生成第 3 步启动游戏。插件会自建配置文件并立刻开始翻译。如果发现有文字没翻多半是某个文本框架的开关默认关着去配置文件的[TextFrameworks]段打开即可。其余方式一句话带过完全不想装 BepInEx 的话ReiPatcher 独立包两次点击就能完成注入但游戏已装插件管理器时别用它IL2CPP 游戏则改用 MelonLoader 或 BepInEx 6 IL2CPP 版本的包步骤相同。️ 启动之后默认行为与 5 个热键装完并不会弹出设置窗口插件是在游戏里静默工作的所以先搞清它默认做了什么、怎么调出来。默认行为有两点值得知道屏幕上出现的文本会被实时翻译结果写入翻译缓存Translation/目录下的本地 txt 文件。同一句文本第二次出现时秒出不再发网络请求插件非常克制新文本会等 1 秒确认内容不再变化才提交翻译且同一时间只发一个请求。所以游戏开局阶段翻译会有轻微延迟越玩越快常用热键ALT0弹出插件自带 UI查看状态、切换翻译服务ALTT翻译/原文一键切换排查问题的第一工具ALTR改完翻译文件后立刻重新加载不用重启游戏ALTU手动触发一次扫描补抓自动挂钩漏掉的文本ALTQ插件因服务连续报错自动停机后手动重启它⚙️ 4 个决定翻译体验的配置项配置文件是插件唯一露出来的开关面板几十个参数里你日常只会动下面这几个。BepInEx 环境下它在BepInEx/config/目录里核心部分长这样[Service] EndpointGoogleTranslate ; 翻译服务GoogleTranslate / DeepLTranslate / BaiduTranslate 等 FallbackEndpoint ; 备用服务主服务翻译失败时自动顶上 [General] Languagezh ; 目标语言中文 FromLanguageja ; 游戏原文语言ja 日 / en 英 / ko 韩 [TextFrameworks] EnableIMGUIFalse ; IMGUI 框架文本开关想翻 Mod 菜单就改成 TrueEndpoint翻译端点决定文本发给哪家在线服务。Google 版免费无需密钥但偶尔抽风DeepL 质量最高百度版对中文语感更友好。怎么选见下一节FromLanguage把原文语言指对服务才不会误判语言导致乱翻官方不建议用 auto 自动检测EnableIMGUIIMGUI是 Unity 里用于简易绘制的文本框架其他 Mod 的菜单大多用它画出来。这个开关默认关闭想连 Mod 界面一起汉化必须打开MaxCharactersPerTranslation默认 200超过这个长度的文本不做自动翻译避免单条请求过大拖累整屏 进阶改造3 个高频场景默认配置能覆盖大多数游戏但翻译对了、显示不对或个别词总翻错时需要再往下走一层。换翻译服务与密钥各服务的实现代码在仓库的Translators/目录下配置文件里改Endpoint的名字即可切换。几个实用结论Google、Bing、DeepL 的网页版接口免密钥但不是官方 API随时可能失效官方 API 类服务Google Cloud、BingLegitimate、DeepLLegitimate、Baidu、Yandex、LingoCloud需要密钥大多有免费额度Bing 官方版每月 200 万字符免费LingoCloud 认证后每月 100 万字符免费百度实名后每月 100 万字符免费密钥写在配置文件对应段落如[Baidu]、[DeepL]里密钥一旦泄露马上去服务商官网吊销解决中文显示与文字溢出游戏字体不含中文字形时会显示方块字。UGUI 游戏在[Behaviour]段给OverrideFont填一个中文字体路径即可全局替换TextMeshPro 游戏推荐用FallbackFontTextMeshPro加一个后备字体译文比原文长时会顶出文本框。插件默认会调整 UI 组件的溢出方式EnableUIResizing尽量完整显示个别对话框仍溢出时可在翻译目录放一个resizer.txt文件按路径命令的格式单独缩小那组组件的字号或行距手动修正翻译自动翻译不会句句完美插件把修正的口子留得很宽# 语法与自动翻译文件一致 角色名你确认过的正确译名 r:^アイテム([0-9])$物品$1 ; 正则规则批量处理带编号的文本所有自动结果都落在Translation/{语言}/Text/_AutoGeneratedTranslations.txt直接改右边的译文按 ALTR 立即生效自己新建 txt或 zip放进同一目录同名条目会覆盖自动文件——做人工修正包就是这么来的正则规则不能写在_开头的自动文件里要放在自建文件中_Substitutions.txt用来锁定角色名、道具名这类固定译法全局生效️ 出问题时按现象走的自救路线多数问题不是插件 bug而是开关没开或服务临时不可用按下面顺序查几分钟就能定位。现象文字压根不翻译。排查按 ALT0 确认插件在运行、服务已启用再查配置文件[TextFrameworks]段看游戏实际用的框架TextMeshPro、IMGUI 等是否开着。解法打开对应开关后重启游戏个别文本漏翻就按 ALTU 强制扫一遍。现象开了翻译后游戏崩溃或功能错乱。排查按 ALTT 关掉翻译若立刻恢复正常说明游戏逻辑依赖屏幕上的文字做判断。解法在[Behaviour]段设TextGetterCompatibilityModeTrue让游戏读到的仍是原文。现象翻译着着突然停了。排查插件内置防滥用机制服务连续 5 次无结果、或排队任务堆到 4000 条它会主动停机保护自己通常指向网络或服务问题。解法检查网络或代理或把Endpoint换成更稳定的服务确认解决后按 ALTQ 重启插件。现象想彻底停用。把Endpoint置空即停用自动翻译要完全移除则删除BepInEx/plugins下的XUnity.AutoTranslator目录注意别删XUnity.ResourceRedirector其他插件可能依赖它。 想深入源码结构导读如果你打算写自己的翻译端点或弄清内部机制不必通读整个工程核心就集中在几个目录。主翻译逻辑、热键、缓存与防滥用机制src/XUnity.AutoTranslator.Plugin.Core/各翻译服务的具体实现src/Translators/一个服务一个子目录资源重定向与图片替换src/XUnity.ResourceRedirector/最完整的参考文档是仓库根目录的 README.md每个配置项都有解释正则、图片翻译也有专门章节从 3.0 版本起支持自定义翻译端点实现 Core 里的ITranslateEndpoint接口编译出的 DLL 丢进Translators/目录就能用适合接本地模型做离线翻译现在就动手5 步走完确认游戏是 Unity 引擎、Windows 系统BepInEx 已装好插件包解压到游戏根目录启动游戏按 ALT0 确认插件在运行选一个顺手的翻译服务打开配置文件把Language、FromLanguage设成你要的语言对有漏翻的文字去[TextFrameworks]打开对应框架开关再试一次默认配置已经覆盖了大多数游戏的情况遇到问题再按现象调参不必逐项盲改。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考