XUnity.AutoTranslator 实时汉化插件:最小配置与排障清单

📅 发布时间:2026/8/27 2:23:54
XUnity.AutoTranslator 实时汉化插件:最小配置与排障清单 XUnity.AutoTranslator 实时汉化插件最小配置与排障清单【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity.AutoTranslator 是运行在 Unity 游戏进程内的实时翻译插件它拦截界面渲染出的外文文本发送到翻译服务再把结果写回原位置同时支持手动翻译文件与正则规则做精细修正。适合装好模组加载器、想快速让外语游戏可读的玩家收益是多数界面文本无需重启、即时变中文。先确认安装包与运行时装之前先判断两个条件已有什么加载器、游戏是什么运行时。当前环境应选版本DLL 放置位置未装任何加载器ReiPatcher 独立版解压到游戏根目录运行一次安装程序之后用生成的快捷方式启动游戏已装 BepInExBepInEx 版BepInEx子目录MelonLoader / IPA / UnityInjector对应版本分别放入Mods、Plugins、UnityInjector 目录两条判断规则已有加载器就不要再引入 ReiPatcher两套注入方案并存会互相干扰近年新游戏多为 IL2CPP 运行时必须选带 IL2CPP 后缀的版本选错插件根本不会加载。最小可运行配置改哪 3 个字段插件首次运行会生成AutoTranslator/Config.ini。只需固定三处Language目标显示语言填zh-CNFromLanguage游戏原文语言需与Language同时被所选服务支持代码写错不会报错只会静默不翻译Endpoint翻译服务。GoogleTranslate、DeepLTranslate等免费网页端点无需密钥适合先用DeepLAPI 需自行申请密钥长期更稳定本机装有 LEC 或 ezTrans 时可接为离线端点有自建服务的可用CustomTranslate直接填 URL。[TextFrameworks]节先保持原样UGUI、NGUI、TextMeshPro 等默认开启EnableIMGUI与EnableTextMesh默认关闭。等发现某处文字没被抓到再回来打开对应开关。启动后如何验证插件已生效进入游戏按ALT 0能呼出设置界面说明 DLL 位置正确按ALT T画面在原文与译文间切换说明整条翻译链路已通。界面呼不出来时优先检查 DLL 是否放进了正确加载器的目录其次看游戏日志有无启动记录。日常操作按键速查快捷键作用使用场景ALT 0呼出/隐藏设置界面进游戏先确认插件存活ALT T原文/译文切换验证翻译是否生效ALT R热加载翻译文件编辑完手动译文立即生效ALT U手动触发文本捕获单段文本未被捕获时ALT Q重启已停机的翻译网络恢复之后重点记住ALT Q连续请求失败后插件会自动停机保护网络恢复后按一次即可恢复无需重开游戏。翻译不生效时按顺序排查插件是否存活ALT 0能否呼出、日志有无启动记录。没有就是 DLL 放错位置语言代码Language/FromLanguage必须是服务双方都支持的代码写错不报错、只停翻框架开关该游戏若使用默认关闭的 IMGUI 或 TextMesh原文就不会被捕获打开对应框架开关再验证长度上限MaxCharactersPerTranslation默认 200超过直接跳过上限 2500长文本游戏可上调特殊情形游戏逻辑依赖显示的文字做判断时打开TextGetterCompatibilityMode个别漏翻按ALT U手动捕获一次。插件自带限流与去重长时间挂机运行没有问题。从能用到好用手动文件、正则与中文字体手动译文游戏运行一段时间后翻译结果会写入Translation/{语言}/Text/_AutoGeneratedTranslations.txt按「原文译文」逐行存放。编辑完按ALT R立即生效同目录另建 txt 或 zip 可分层管理优先级更高针对某模组的译文放Text/Plugins/{模组名}/文件首行写#enable fallback该模组原文缺失时回退到通用译文。正则装备名这类模板化文本用一行正则覆盖全部r:^シンプルリング ([0-9])$简约戒指 $1游戏把多段文字拼接显示时用sr:前缀先拆块、再逐块翻译。中文字体翻译成功但显示为方块说明游戏字体缺少中文字形。TMP 用FallbackFontTextMeshPro、UGUI 用OverrideFont指定中文字体译文过长导致按钮溢出时EnableUIResizing会自动调整默认开启。进阶能力默认关闭[Texture]节导出游戏内贴图借助图像处理软件修改地图与立绘中直接绘制的文字再导回游戏[ResourceRedirector]节拦截资源加载并改道 TextAsset 等资源路径CustomTranslate接入自建翻译服务或本地模型。如果卡住了怎么办先打开配置中的EnableLog复现一次问题后对照日志定位官方 README 的 FAQ 覆盖了多数常见故障社区里还有第三方端点列表与现成字体包可参考。按上面的顺序排查一遍绝大多数不翻译问题都能在第五步之前找到原因。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考