XUnity.AutoTranslator游戏翻译插件零基础上手指南：10分钟看懂Unity游戏实时汉化

XUnity.AutoTranslator游戏翻译插件零基础上手指南10分钟看懂Unity游戏实时汉化【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator打开心心念念的日文游戏剧情看不懂、菜单全靠猜、装备属性只能连蒙带猜——这种游戏看得见、内容摸不着的体验相信每个玩家都经历过。XUnity.AutoTranslator 正是解决这个痛点的 Unity 游戏翻译插件它能在游戏运行时自动抓取屏幕上的对话、菜单、道具名等文本调用在线翻译服务实时转换成你的母语。本文面向零基础玩家带你用 10 分钟走完从安装、配置到进阶调优的全流程从此告别玩了个寂寞。一、先搞清楚这个工具到底能帮你做什么XUnity.AutoTranslator 是一款面向 Unity 引擎游戏的全自动翻译与本地化插件。它的核心能力可以用四句话概括实时翻译游戏里的对话、UI 菜单、物品说明等文本出现即翻译无需退出游戏手动查词。框架兼容广支持 UGUI、NGUI、TextMeshPro、TextMesh、IMGUI、FairyGUI 等主流 Unity 文本框架。多模组管理器适配可独立安装也可作为 BepInEx、MelonLoader、IPA、UnityInjector 的插件运行。可扩展架构内置十几种在线翻译服务支持自定义翻译接口也能配合资源重定向替换游戏字体和贴图。简单说它是给游戏戴上的实时同声传译耳机。你不用懂代码装好、配好、启动游戏剩下的交给它。二、它是怎么工作的30 秒看懂原理在动手之前先建立一点直觉后面排错会轻松很多。它的工作链路大致是文本钩子插件注入游戏监听各文本框架UGUI、TextMeshPro 等的赋值行为抓到屏幕要显示什么字。查缓存先把抓到的原文拿去查本地翻译缓存命中就直接替换显示。在线翻译缓存没命中就打包发给翻译服务端点拿到结果后写回游戏并存入缓存文件。落盘缓存所有翻译结果保存在AutoTranslator/Translation/{语言}/Text/_AutoGeneratedTranslations.txt同一个句子永远只翻译一次。这就是为什么越玩越流畅——第一次见到的句子要联网之后全靠本地缓存秒开。三、安装前先选路五种装法怎么挑插件可以通过五种方式部署本质区别在于谁来负责把它挂进游戏。先看对比表再选适合自己的。安装方式前置依赖上手难度适合人群ReiPatcher 独立安装无需任何依赖自带打补丁工具★☆☆☆☆新手首选两下点击搞定BepInEx 插件需先装 BepInEx 5★★☆☆☆主流玩家生态最丰富MelonLoader 插件需先装 MelonLoader★★★☆☆已在使用 MelonLoader 的玩家IPA 插件需先装 IPA★★★☆☆特定老游戏的用户UnityInjector 插件需先装 UnityInjector★★★☆☆怀旧方案功能受限给新手的建议如果游戏还没装任何模组管理器直接选 ReiPatcher 独立安装最不容易出错。如果你已经在用 BepInEx 管理其他模组就选 BepInEx 插件版避免两套补丁系统打架。路线一ReiPatcher 独立安装最省心获取项目最新发布包源码仓库地址https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator选择名字里带ReiPatcher的压缩包。把压缩包内容直接解压到游戏根目录让SetupReiPatcherAndAutoTranslator.exe和其他 exe 放在一起。运行安装程序它会自动把打补丁工具配置好。启动游戏目录下生成的游戏名 (Patch and Run)快捷方式完成首次补丁写入。之后正常双击游戏 exe 即可进入翻译功能常驻生效。路线二BepInEx 插件安装最主流先按 BepInEx 官方流程装好 BepInEx 5。获取名字里带BepInEx的发布包解压到游戏根目录让插件 dll 各就各位落到 BepInEx 文件夹对应位置。启动游戏第一次运行会自动生成翻译目录和配置文件。两种方式完成后检验标准是同一个按ALT0如果能呼出/隐藏翻译界面说明插件已成功加载。安装完成提醒出于性能考虑并非所有文本框架默认开启。如果发现游戏大部分内容没翻译优先去配置文件里打开对应框架而不是怀疑装错了。四、基础配置认识你的 Config.ini首次启动游戏后插件会在游戏根目录生成AutoTranslator/Config.ini。这是整个插件的控制中枢用记事本就能编辑。最常动的就三个小节[General] Languagezh-CN ; 目标语言你想翻译成什么语言 FromLanguageja ; 源语言游戏原本的语言 [Service] EndpointGoogleTranslateV2 ; 翻译服务想换直接改这里 [TextFrameworks] EnableUGUITrue ; UGUI 文本框架 EnableTextMeshProTrue ; TextMeshPro 文本框架 EnableIMGUIFalse ; IMGUI 默认关闭需要时再开几个容易踩坑的点提前说明FromLanguage支持填auto自动检测但部分服务下自动检测不稳定建议明确填写游戏原始语言。配置文件是游戏启动时才生成的别在没启动过游戏的情况下满硬盘找它。修改配置后需要重启游戏才生效。五、翻译服务怎么选一张表讲清楚插件内置了十几种翻译端点全部以 dll 形式放在Translators子目录。选服务主要看两点要不要 API 密钥、翻译质量你满不满意。翻译服务是否需要密钥特点GoogleTranslate / GoogleTranslateV2否免费、语言全、日常首选BingTranslate否微软出品稳定性尚可DeepLTranslate否公认质量顶尖适合剧情向游戏PapagoTranslate否韩语场景表现突出BaiduTranslate是AppId/AppSecret国内直连稳定适合大陆网络YandexTranslate是API Key免费额度大日俄互译强GoogleTranslateLegitimate是API Key商业级稳定适合长期使用BingTranslateLegitimate是订阅密钥Azure 通道月免 200 万字符CustomTranslate否自建翻译接口开发者向⚠️重要提醒免费在线翻译端点如 Google、Bing、DeepL 的网页版接口随时可能因官方调整而失效这属于正常现象换个端点即可。使用付费 API 时务必保管好密钥不要分享给任何人。日常使用直接默认的GoogleTranslateV2就够追求剧情体验换DeepLTranslate网络环境特殊则考虑BaiduTranslate。配置方法都是在[Service]里改Endpoint一行。六、快捷键速查五个键玩转日常操作快捷键功能ALT0显示/隐藏翻译界面ALT1打开翻译聚合窗口可对比多个服务的翻译结果ALTT在原文和译文之间切换显示ALTR重新加载磁盘上的翻译文件改完文件无需重启游戏ALTU手动触发文本钩子自动钩子漏抓时补救ALTF切换自定义字体需配置 OverrideFontALTQ插件因连续报错自动停机后手动重启插件实用技巧遇到个别文本没翻译时按ALTU手动补钩再按ALTR重载翻译文件绝大多数情况都能救回来。七、手动翻译与缓存管理从被翻译到我定义自动翻译只是起点真正让翻译质量飞升的是手动翻译。插件的翻译文件放在AutoTranslator/Translation/{语言}/Text/目录几个关键文件各司其职文件作用_AutoGeneratedTranslations.txt插件自动生成的翻译缓存机器翻译结果都在这里_Substitutions.txt替换规则先于翻译执行可纠正人名、专有名词_Preprocessors.txt发送给翻译服务前的预处理规则_Postprocessors.txt拿到翻译结果后的后处理规则手动翻译的格式简单得令人发指——每行一个原文译文シンプルリングSimple Ring レベルアップ升级规则就三条任何 txt 文件都能放翻译推荐按场景拆文件管理比如Dialogues.txt、Items.txt、UI.txt。自动生成的文件下划线开头里不要放手动规则改了也可能被插件覆盖。想翻译得更细可以用#set level、#set exe这类指令把翻译限定到特定关卡或特定程序需要先开启[Behaviour] EnableTranslationScopingTrue。改完文件按ALTR即时重载不用重启游戏。八、进阶玩法用正则表达式驯服动态文本游戏里大量文本是固定结构 动态数字比如アイテム 12、等级 35逐条手动翻译不现实。这时正则表达式就派上用场了语法为r:正则替换例如r:^アイテム ([0-9])$物品 $1 r:^レベル ([0-9])$等级 $1拆分发splitter regex是另一个杀手锏。有些游戏会把多段文本拼起来一次性显示比如01 シンプルリング直接匹配永远差一点。这时用sr:开头的正则先把文本拆开翻译再拼回去sr:^([0-9]{2}) ([\S\s])$$1 $2这样一个シンプルリングSimple Ring的普通翻译就能通吃01 シンプルリング、02 シンプルリング等所有变体。⚠️性能忠告正则虽然强大但每条正则都会在每次文本查找时参与匹配务必少而精。能用普通翻译解决的场景绝不上正则并尽量让正则精确匹配避免宽泛模式拖慢游戏。九、常见问题排查一张表对症下药问题现象可能原因解决方案完全没有翻译插件未正确加载或文件缺失检查 dll 是否在对应模组管理器目录重跑安装大部分文本不翻译对应文本框架未启用在 Config.ini 的[TextFrameworks]中开启翻译质量差或乱码源语言/目标语言设置错误核对FromLanguage与Language游戏崩溃或卡死钩子兼容性问题尝试TextGetterCompatibilityModeTrue某一段文本永远不翻自动钩子漏抓按ALTU手动补钩改了翻译文件不生效未重载按ALTR或重启游戏部分游戏必须联网才工作无网络免费在线端点均需联网可换本地端点如 ezTrans XP如果问题依旧可以开启[Debug] EnableConsoleTrue查看日志或在[Behaviour]里打开EnableTextPathLoggingTrue追踪文本组件的路径方便定位具体是哪个 UI 没被钩到。十、性能调优游戏卡顿三招解决插件默认配置已经相当保守但如果遇到掉帧按优先级检查这三处1. 控制单条翻译的字符上限[Behaviour] MaxCharactersPerTranslation200 ; 默认 200最大 2500不建议贪大2. 保持批量翻译开启[Behaviour] EnableBatchingTrue ; 默认开启支持批量合并请求显著减少请求次数3. 只开游戏真正用到的文本框架[TextFrameworks] EnableUGUITrue EnableTextMeshProTrue EnableIMGUIFalse ; 除非确需翻译其他模组的 IMGUI 界面否则保持关闭另外可以放心的是插件自带一套防滥用机制同一条文本变化停止 1 秒后才发起请求、同一会话最多发 8000 次请求、同一时间只发一个请求、结果全部缓存落盘。这些设计决定了它默认不会刷爆你的翻译 API 额度。十一、按身份进阶你的下一步行动如果你是新手玩家先用默认配置跑通一个游戏熟悉ALT0和ALTT的用法。玩的过程中留意_AutoGeneratedTranslations.txt手动修正几处机器翻译不满意的地方。再考虑换 DeepL 等服务提升质量。如果你是进阶玩家用正则表达式处理物品名、装备属性等动态文本。尝试[Texture]的贴图翻译开启EnableTextureDumpingTrue让插件导出游戏贴图改完放进Translation/{语言}/Texture/即可实现贴图汉化。用[ResourceRedirector]的EnableTextAssetRedirectorTrue重定向游戏内置文本资源配合字体替换OverrideFont、FallbackFontTextMeshPro解决中文显示不全的问题。如果你是开发者研究src/XUnity.AutoTranslator.Plugin.Core/Endpoints/下的端点实现仿照写出自己的翻译服务。使用CustomTranslate端点对接任意 HTTP 翻译接口参数只需from、to、text。为特定模组注入专属翻译在Text/Plugins/{模组名}/目录放置翻译文件可配合#enable fallback指令控制回退逻辑。十二、总结回顾到这里你已经掌握了 XUnity.AutoTranslator 从入门到进阶的完整脉络。最后用清单帮你过一遍✅选对装法没装模组管理器用 ReiPatcher已用 BepInEx 就装插件版 ✅首次启动确认AutoTranslator/Config.ini生成按ALT0验证生效 ✅基础配置设好Language、FromLanguage和Endpoint✅选对服务日常 Google、追求质量 DeepL、国内网络 Baidu ✅善用快捷键ALTU补钩、ALTR重载、ALTT切换原文 ✅手动打磨在翻译目录建 txt 文件一行一个原文译文 ✅正则进阶r:精准匹配动态文本sr:拆分组合文本 ✅性能优先控制字符上限、按需开启框架、慎用宽泛正则翻译质量从来不是装上就完美它是一场机器初翻 人工精修的协作。但有了 XUnity.AutoTranslator你至少可以先完整地玩下去再慢慢把体验打磨到母语级。现在就装上它去通关那款搁置已久的游戏吧——语言不该是放弃一款好游戏的理由。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考