如何快速安装 XUnity.AutoTranslator：让 Unity 游戏翻译效率提升 10 倍的完整指南

XUnity.AutoTranslator 是一款强大的 Unity 游戏自动翻译插件，支持多种翻译服务和手动翻译工具，兼容 BepInEx、MelonLoader 等主流插件管理器，让你轻松解决外文游戏语言障碍。

🌟 为什么选择 XUnity.AutoTranslator？

作为 Unity 游戏翻译的终极解决方案，XUnity.AutoTranslator 具备三大核心优势：

• 多框架支持：完美适配 BepInEx、MelonLoader、IPA 等多种插件管理器
• 智能翻译引擎：集成 Google、DeepL、Bing 等 15+ 翻译服务
• 一键操作体验：自动缓存翻译结果，支持快捷键实时切换翻译状态

📋 环境准备清单

基础环境要求

• 操作系统：Windows（推荐 10/11 64位）
• Unity 版本：支持 Unity 5.6+ 开发的游戏
• 插件管理器：根据游戏类型选择以下任意一种：
  • [BepInEx](https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator/libs/BepInEx 5.0/)（推荐）
  • MelonLoader
  • IPA

硬件配置建议

• 至少 2GB 空闲内存（翻译缓存需要）
• 稳定网络连接（在线翻译服务需要）

🚀 三种快速安装方法

方法 1：BepInEx 插件安装（推荐）

1. 安装 BepInEx 基础框架

   • 下载对应版本的 BepInEx 压缩包
   • 解压至游戏根目录，确保 BepInEx 文件夹与游戏 exe 同级

2. 部署翻译插件

   git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator.git
   cd XUnity.AutoTranslator
   cp -r libs/BepInEx 5.0/* /path/to/game/BepInEx/
   

3. 验证安装结构

   {GameDirectory}/BepInEx/plugins/XUnity.AutoTranslator/
   ├── XUnity.AutoTranslator.Plugin.Core.dll
   ├── ExIni.dll
   └── Translators/
       ├── GoogleTranslate.dll
       └── DeepLTranslate.dll
   

方法 2：MelonLoader 安装

1. 安装 MelonLoader 加载器

   • 运行 MelonLoader.Installer.exe 并选择游戏可执行文件
   • 等待自动安装完成（需联网下载依赖）

2. 复制插件文件

   • 将下载的 XUnity.AutoTranslator-MelonMod-*.zip 解压
   • 复制 Mods 和 UserLibs 文件夹到游戏根目录

方法 3：独立版安装（免插件管理器）

适合无法安装插件管理器的特殊游戏：

1. 下载 XUnity.AutoTranslator-ReiPatcher-*.zip
2. 解压至游戏根目录，双击运行 SetupReiPatcherAndAutoTranslator.exe
3. 自动生成补丁后，通过创建的快捷方式启动游戏

⚙️ 3分钟快速配置

基础配置文件位置

翻译配置文件会在首次启动后自动生成：

• BepInEx 版：{GameDir}/BepInEx/config/XUnity.AutoTranslator.ini
• MelonLoader 版：{GameDir}/UserData/XUnity.AutoTranslator.ini

必改配置项

[Service]
Endpoint=DeepLTranslate  ; 推荐使用 DeepL 获得最佳翻译质量
FromLanguage=ja          ; 游戏原始语言（日语填 ja，英语填 en）
Language=zh-CN           ; 目标翻译语言

[Behaviour]
EnableUIResizing=True    ; 自动调整 UI 适配翻译文本
FallbackFontTextMeshPro=Arial Unicode MS  ; 解决中文显示问题

💡 实用功能指南

常用快捷键

• ALT+T：实时切换翻译/原文显示
• ALT+R：重新加载翻译文件（修改翻译后使用）
• ALT+0：显示翻译控制面板
• ALT+U：手动触发文本扫描（解决部分未翻译文本）

高级功能：手动翻译文件

1. 游戏运行时会在 Translation/{Lang}/Text/ 目录生成翻译缓存文件
2. 直接编辑 _AutoGeneratedTranslations.txt 可自定义翻译结果：

   ゲームを開始する=开始游戏
   設定を開く=打开设置
   

3. 按 ALT+R 立即应用修改，无需重启游戏

🛠️ 常见问题解决

问题 1：翻译文本显示乱码

• 解决方案：在配置文件中设置字体：

  FallbackFontTextMeshPro=SimHei  ; 添加中文字体支持
  

问题 2：插件未加载（BepInEx）

• 检查 BepInEx/LogOutput.log 日志文件
• 确保插件文件放置正确：BepInEx/plugins/XUnity.AutoTranslator/

问题 3：翻译请求失败

• 检查网络连接，部分翻译服务需要科学上网
• 尝试切换翻译引擎：Endpoint=BingTranslate

📚 进阶使用技巧

批量导出未翻译文本

1. 启动游戏并完成初始加载
2. 按 ALT+1 打开翻译聚合器
3. 点击「导出未翻译文本」按钮，文件保存至： {GameDir}/AutoTranslator/Translation/待翻译文本.txt

自定义翻译规则

通过修改预处理文件实现特殊翻译需求：

; 在 _Preprocessors.txt 中添加
/(\d+)金/=$1金币  ; 将 "100金" 翻译为 "100金币"
/Level (\d+)/=等级$1  ; 将 "Level 5" 翻译为 "等级5"

📄 官方资源获取

• 完整文档：README.md
• 翻译引擎源码：Translators/
• 问题反馈：项目 Issues 页面提交 bug 报告

🔍 为什么选择本项目镜像？

本 GitCode 镜像仓库提供三大保障：

• 代码完整性：完整同步 GitHub 主仓库代码
• 下载加速：国内服务器节点，下载速度提升 10 倍
• 版本归档：保留所有历史版本，支持回滚到稳定版本

---

通过 XUnity.AutoTranslator，你可以告别繁琐的手动翻译，让每一款外文 Unity 游戏都能即时获得高质量翻译。现在就开始你的无障碍游戏之旅吧！🎮