XUnity.AutoTranslator 使用指南3 步给 Unity 游戏加上实时翻译【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity.AutoTranslator 是一个 Unity 游戏翻译插件它自动识别游戏内的对话、菜单和界面文本通过在线翻译服务实时翻译并把结果写入本地缓存下次遇到相同文本直接命中速度快、不重复请求。 先做适配判断它适合你的游戏吗场景XUnity.AutoTranslator 的能力游戏文本使用 UGUI、NGUI、TextMeshPro、TextMesh、FairyGUI、Utage 等文本框架自动检测并翻译开箱即用文本以图片形式烘焙角色立绘、地图文字主流程不处理纹理翻译属实验功能需单独开启且性能开销大游戏以 IL2CPP 方式编译部分支持部分文本变化需手动刷新IMGUI 与插件专属翻译不可用离线翻译需求不支持必须能访问所选翻译服务想顺带翻译其他 MOD 的菜单默认不处理需手动开启 IMGUI 钩子适合的类型日英原版剧情 RPG、视觉小说、菜单密集的单机游戏且为 Mono 编译{游戏名}_Data下有Managed目录。 不适合的类型文本全部画在图片里的游戏、无法访问任何翻译服务的环境、对 IL2CPP 功能完整性要求极高的场景。✅ 动手前自检一份打勾清单检查项要求不满足时的替代办法操作系统Windows换 Windows 环境运行插件未提供 macOS/Linux 支持编译类型MonoIL2CPP 改走 IL2CPP 专用包并接受功能缩水插件管理器BepInEx 5/6、MelonLoader、IPA、UnityInjector 任一走 ReiPatcher 独立安装路线零依赖网络可达所选翻译服务更换服务或配置FallbackEndpoint备用端点快速判断编译类型游戏目录{游戏名}_Data下存在Managed目录且里面是 DLL一般为 Mono只有il2cpp_data目录则基本是 IL2CPP。️ 四条接入路线按你的游戏走对应分支如果你的游戏已装 BepInEx → 走 A 路线下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip发布包。解压到游戏根目录DLL 会落入BepInEx/plugins/XUnity.AutoTranslator/。启动游戏等待配置文件自动生成。如果你的游戏是 IL2CPP → 走 B 路线先装好支持 IL2CPP 的 BepInEx 6 构建或 MelonLoader。改用BepInEx-IL2CPP或MelonMod-IL2CPP包其余步骤与 A 路线一致。接受已知限制部分文本变化不会自动刷新可配合社区的手动刷新辅助插件。如果你没有任何插件管理器 → 走 C 路线ReiPatcher 独立版下载XUnity.AutoTranslator-ReiPatcher-{VERSION}.zip包。解压到游戏根目录运行SetupReiPatcherAndAutoTranslator.exe。之后用生成的(Patch and Run)快捷方式启动游戏。若游戏里已存在 BepInEx 或 MelonLoader不要使用 C 路线两种注入方式叠加会导致冲突。如果你用 MelonLoader / IPA / UnityInjector → 走 D 路线下载对应的MelonMod/IPA/UnityInjector发布包。解压到游戏根目录DLL 分别进入ModsUserLibs、Plugins或UnityInjector目录。启动游戏。验证是否装好了首次启动后插件管理器目录下生成了 XUnity.AutoTranslator 配置文件。游戏内按Alt0能呼出插件窗口。按AltT可在翻译前后文本之间切换确认文本确实被替换。⚙️ 最小可用配置三件套配置文件里只需要动三项其余全部保持默认[Service] EndpointGoogleTranslate [General] FromLanguageja Languagezh-Hans在Endpoint选一个翻译服务免密钥的 Google、Bing、DeepL 即可起步用需要密钥的服务百度、DeepL 官方版等时把密钥填进配置文件对应的节里。FromLanguage填游戏原语言Language填你的目标语言。确认缓存位置翻译结果默认写入Translation\{Lang}\Text\_AutoGeneratedTranslations.txt{Lang}会自动替换为目标语言代码目录无需手工创建。免认证服务随时可能失效这是其代价请求失败时更换Endpoint或补上FallbackEndpoint作为备份。 按游戏类型调优翻译剧情向 RPG对话长、换行多文本特征成段对话原文换行会被翻译服务当成独立句子整段质量明显下降。保持IgnoreWhitespaceInDialogueTrue默认开启发送前清除多余空白。译文撑破对话框时保留EnableUIResizingTrueUGUI 游戏可再加ResizeUILineSpacingScale0.8压缩行距。游戏字体缺中文字形导致方块字时给 UGUI 填OverrideFont指向一个含中文的字库。视觉小说文字逐字滚动出现文本特征文本以滚动方式逐字显现钩子捕获到的常是不完整文本翻译缺失或错位。开启GeneratePartialTranslationsTrue让插件按滚动进度生成部分翻译。仅在该游戏确实逐字滚动时才开否则会放大请求量。UI 密集短文本多、MOD 菜单多文本特征菜单项短而杂很多来自 IMGUI 界面排版紧凑。在[TextFrameworks]设EnableIMGUITrueMOD 界面才会被翻译。开启EnableUIResizingTrue让插件自动调整组件溢出行为减少文字被裁切。 故障排查决策树按症状推进Alt0 无反应插件没加载→ 先查配置文件是否生成没生成说明 DLL 放错位置 → 再看插件管理器日志里的加载报错 → 最后核对包版本与 Mono/IL2CPP 类型是否匹配。部分文本没被翻译→ 到[TextFrameworks]逐项开启对应框架IMGUI、TextMesh 默认关闭→ 按AltU触发手动钩子 → 用AltT对比确认是否属于未接管状态。译文出现方块或乱码→ 优先按字体问题处理UGUI 配OverrideFontTextMeshPro 配FallbackFontTextMeshPro。翻译后游戏卡死或闪退→ 设TextGetterCompatibilityModeTrue→ 仍异常则调低MaxCharactersPerTranslation→ 最后把Endpoint置空暂停自动翻译逐项定位。插件自行关闭日志提示连续错误→ 检查所选服务是否可达 → 修复网络或更换Endpoint→ 问题解决后按AltQ重启插件。修改翻译文件后不必重启游戏直接按AltR重载即可。 进阶与开发者视角自定义翻译规则。插件会读取Translation目录下所有.txt文件手写条目优先级高于自动生成文件可直接改错。文件内支持r:正则替换的表达式翻译、sr:前缀把复合文本拆段后再查表以及_Substitutions.txt里的固定术语人名、道具名。正则影响性能尽量少写。资源重定向。要做完整汉化补丁而非即时翻译可在[ResourceRedirector]开启EnableTextAssetRedirectorTrue并把PreferredStoragePath指向你的资源目录插件会用你的版本替换游戏文本资源实现见 XUnity.ResourceRedirector 模块。API 集成与自定义服务。其他插件作者可调用TranslationRegistry.RegisterPluginSpecificTranslations注册专属翻译集想接入自有翻译服务参考 src/Translators/ 里的现成实现实现ITranslateEndpoint接口即可。全部可配置项的准确定义见 src/XUnity.AutoTranslator.Plugin.Core/。 收尾上线前检查清单确认配置文件已生成Endpoint、FromLanguage、Language三项已填。游戏内按Alt0呼出窗口用AltT切换确认文本已被接管。打开_AutoGeneratedTranslations.txt确认新译文正在写入。手工修改两三条不满意的结果按AltR重载验证生效。使用付费服务时核对月度额度并备份Translation目录。更多参数解释见项目 README 的 Configuration 与 FAQ 章节核心实现位于 src/遇到配置疑问先在那里查一遍再考虑社区求助。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考