终极Unity游戏翻译神器：XUnity.AutoTranslator一键本地化解决方案 🚀

XUnity.AutoTranslator是一款强大的Unity游戏自动翻译插件，能够无缝对接多种翻译服务，自动识别并翻译游戏内文本内容，支持UGUI、NGUI、TextMeshPro等主流UI框架，让开发者和玩家轻松实现多语言游戏体验。

📌 核心优势：为什么选择XUnity.AutoTranslator？

作为Unity生态中最受欢迎的翻译插件之一，XUnity.AutoTranslator凭借以下特性脱颖而出：

• 多框架支持：完美适配BepInEx、MelonLoader、IPA等主流插件管理器，兼容UnityInjector和独立安装模式
• 智能翻译引擎：集成Google、Bing、DeepL等15+翻译服务，支持API密钥认证与免费服务双重模式
• 性能优化：采用多线程处理与智能缓存机制，单次会话最多8000请求限制，避免翻译服务过载
• 灵活配置：可自定义翻译路径、字体替换、UI自适应调整，满足个性化翻译需求

🛠️ 快速安装指南：5分钟上手

BepInEx安装（推荐）

1. 确保已安装BepInEx插件管理器
2. 下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip
3. 解压至游戏根目录，确保文件结构如下：

{GameDirectory}/BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.Core.dll
{GameDirectory}/BepInEx/plugins/XUnity.AutoTranslator/Translators/{Translator}.dll

4. 启动游戏自动生成配置文件，根据需求调整翻译服务和语言设置

MelonLoader安装

1. 安装对应版本的MelonLoader
2. 下载XUnity.AutoTranslator-MelonMod-{VERSION}.zip
3. 解压至游戏目录，确保Mods和UserLibs文件夹正确放置
4. 运行游戏完成初始化配置

🌐 翻译服务配置：打造专属翻译引擎

XUnity.AutoTranslator支持多种翻译服务，满足不同场景需求：

免费翻译服务

• GoogleTranslate：无需API密钥，不稳定但无使用限制
• BingTranslate：微软翻译服务，免费且质量可靠
• DeepLTranslate：以高质量翻译著称，免费版足够日常使用

认证翻译服务

• GoogleTranslateLegitimate：Google Cloud翻译API，提供1年300美元免费额度
• BingTranslateLegitimate：Azure文本翻译，每月200万字符免费额度
• DeepLTranslateLegitimate：专业翻译服务，每月50万字符免费试用

配置示例（修改AutoTranslatorConfig.ini）：

[Service]
Endpoint=DeepLTranslateLegitimate
ApiKey=your_api_key_here
[General]
Language=en
FromLanguage=ja

⚙️ 高级功能：释放插件全部潜力

文本框架支持

插件默认启用主流UI框架翻译，可在配置文件中调整：

[TextFrameworks]
EnableUGUI=True
EnableNGUI=True
EnableTextMeshPro=True
EnableTextMesh=False  ; 3D空间文本默认禁用
EnableIMGUI=False     ; 即时模式GUI默认禁用

快捷键操作

掌握这些快捷键提升翻译效率：

• ALT+T：切换翻译/原文显示
• ALT+R：重新加载翻译文件
• ALT+0：显示翻译插件控制面板
• ALT+U：手动触发文本扫描

纹理翻译

除文本外，插件还支持纹理翻译功能，自动识别并替换游戏内图片资源，配置路径：

[Files]
Directory=Translation\{Lang}\Textures

📝 常见问题与解决方案

Q：翻译服务频繁失效怎么办？

A：建议切换至认证翻译服务（如DeepL API），或检查网络连接，部分服务需科学上网。

Q：UI元素翻译后出现重叠？

A：在配置文件中启用UI自适应调整：

[Behaviour]
EnableUIResizing=True
ResizeUILineSpacingScale=0.85

Q：如何添加自定义翻译词典？

A：在Translation目录下创建文本文件，格式为"原文=译文"，支持多行条目。

📚 开发资源与社区支持

XUnity.AutoTranslator拥有活跃的开发者社区，提供丰富的扩展资源：

• 第三方翻译插件：支持SugoiOfflineTranslator、LlmTranslators等离线翻译服务
• 源码扩展：通过实现ITranslator接口开发自定义翻译器，参考Translators目录下示例
• 问题反馈：项目使用过程中遇到的问题，可提交issue获取社区支持

💡 使用技巧：提升翻译体验的10个小贴士

1. 优先使用认证翻译服务获得更稳定的翻译质量
2. 大型游戏建议配合手动翻译文件，减少API调用次数
3. 启用文本缓存功能，避免重复翻译相同内容
4. 调整MaxCharactersPerTranslation参数控制单次翻译长度
5. 使用OverrideFont配置解决中文等特殊字符显示问题
6. 定期备份Translation目录下的翻译文件
7. 复杂UI建议先禁用EnableUIResizing手动调整布局
8. 通过ALT+F快捷键快速切换字体显示
9. 利用PreprocessorsFile预处理特殊格式文本
10. 生产环境建议使用离线翻译服务确保稳定性

XUnity.AutoTranslator通过libs目录下的各类依赖库（如0Harmony.dll、Mono.Cecil.dll）实现对Unity引擎的深度整合，确保在不同Unity版本和游戏类型中稳定运行。无论是独立开发者还是大型团队，都能通过这款插件快速实现游戏的多语言本地化，为全球玩家提供无障碍的游戏体验。

需要获取最新版本或参与项目开发，可通过仓库地址获取完整源码：git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator