XUnity.AutoTranslator：Unity游戏实时翻译解决方案

🌟 认识这款翻译神器

XUnity.AutoTranslator是一款专为Unity引擎游戏打造的实时翻译插件，能够帮助玩家突破语言障碍，即时翻译游戏内文本内容。无论你是想体验日本同人游戏，还是探索海外独立游戏佳作，这款工具都能让你无需等待官方本地化即可畅玩。

🔑 核心能力一览

• 多引擎翻译：整合多种翻译服务接口，确保翻译结果准确流畅
• 智能文本捕捉：自动识别游戏内UI元素、对话气泡和菜单文本
• 本地化记忆：自动保存已翻译内容，避免重复请求提升性能
• 个性化定制：支持手动调整翻译结果，打造符合个人习惯的翻译体验

🖥️ 运行环境支持

• ✅ Windows系统：完美兼容所有功能
• ⚠️ macOS/Linux：暂不支持，正在开发中

🔌 插件管理器适配

• ✅ BepInEx（推荐用于Unity Mono游戏）
• ✅ MelonLoader（推荐用于Unity IL2CPP游戏）
• ✅ IPA（轻量级选择）
• ✅ UnityInjector（适用于旧版Unity游戏）

🚀 快速上手指南

📋 前期准备

开始使用前，请确保你的系统已安装：

• Git版本控制工具
• 压缩解压软件（如7-Zip或WinRAR）
• 对应游戏的插件管理器

📥 获取项目源码

打开命令提示符或终端，执行以下命令克隆项目：

git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator

项目下载完成后，你将看到以下主要目录结构：

XUnity.AutoTranslator/
├── src/           # 源代码文件
├── libs/          # 依赖库文件
├── tools/         # 实用工具
├── test/          # 测试代码
└── README.md      # 项目说明文档

如果你不熟悉Git命令，也可以直接下载ZIP压缩包并解压到本地文件夹。

⚙️ 环境配置全流程

🔍 兼容性检测三步法

1️⃣ 确认操作系统
确保你的电脑运行的是Windows系统，其他操作系统暂不支持

2️⃣ 插件管理器检查
根据游戏引擎类型选择合适的插件管理器：

• Unity Mono游戏 → BepInEx
• Unity IL2CPP游戏 → MelonLoader

3️⃣ Unity版本验证
在游戏目录中找到GameAssembly.dll文件，右键属性查看版本信息，确认游戏使用的Unity版本

🛠️ 管理器安装指引

根据游戏类型选择并安装对应的插件管理器：

BepInEx安装（适用于Mono游戏）

1. 从BepInEx官方网站下载最新版本
2. 将压缩包内容解压到游戏根目录
3. 运行游戏一次，让BepInEx完成初始化配置

MelonLoader安装（适用于IL2CPP游戏）

1. 下载MelonLoader安装程序
2. 启动安装程序并选择游戏可执行文件
3. 按照向导完成安装，程序会自动配置必要文件

📦 插件部署方案

📌 方案A：BepInEx部署（推荐）

1. 文件复制
   将项目中src/XUnity.AutoTranslator.Plugin.BepInEx/bin/Release目录下的
   XUnity.AutoTranslator.Plugin.BepInEx.dll文件复制到：
   <游戏目录>/BepInEx/plugins/XUnity.AutoTranslator/

2. 配置翻译服务
   首次运行游戏后，在BepInEx/config目录下找到翻译配置文件，设置你偏好的翻译服务。

3. 验证安装
   启动游戏时观察控制台输出，看到"AutoTranslator initialized successfully"即表示安装成功。

📌 方案B：MelonLoader部署

1. 文件放置
   将XUnity.AutoTranslator.Plugin.MelonMod.dll复制到游戏目录的Mods文件夹
   将libs目录下的依赖文件复制到游戏目录的UserLibs文件夹

2. 启动验证
   通过MelonLoader启动游戏，检查加载界面是否显示插件信息
   首次启动会生成配置文件，位于UserData/XUnity.AutoTranslator/目录

💡 使用技巧与优化

🧠 翻译缓存管理

插件会自动缓存翻译结果，文件位于：
<游戏目录>/BepInEx/plugins/XUnity.AutoTranslator/Translations/

建议操作：

• 定期清理过时缓存文件（尤其是游戏更新后）
• 保留常用游戏的缓存文件，提升下次游玩体验

✏️ 自定义翻译规则

你可以通过修改翻译配置文件添加个人化翻译规则：

// 配置示例：自定义翻译规则
{
  "General": {
    "SourceLanguage": "ja",
    "DestinationLanguage": "zh"
  },
  "CustomTranslations": {
    "メニュー": "菜单",
    "セーブ": "存档",
    "ロード": "读档",
    "オプション": "设置"
  }
}

🔍 常见问题诊断

插件无法加载？

🔹 检查文件路径是否正确放置
🔹 确认插件版本与游戏Unity版本匹配
🔹 查看BepInEx/LogOutput.log或MelonLoader/Logs寻找错误信息

翻译没有效果？

🔹 检查网络连接是否正常
🔹 验证翻译服务API密钥是否有效
🔹 确认游戏文本是否被正确识别（可开启调试模式查看日志）

游戏出现卡顿？

🔹 尝试降低翻译请求频率（在配置文件中调整）
🔹 清理过大的翻译缓存文件
🔹 关闭其他后台应用释放系统资源

📂 项目结构解析

了解项目结构有助于你更好地自定义和扩展功能：

src/                      # 源代码主目录
├── Translators/          # 翻译服务实现
├── UnityEngine/          # Unity引擎接口定义
├── XUnity.AutoTranslator.Plugin.Core/  # 核心功能模块
└── 各插件管理器适配模块  # BepInEx/MelonLoader等适配代码

libs/                     # 依赖库文件
tools/                    # 辅助工具
test/                     # 单元测试代码

核心翻译逻辑位于src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs， 文本捕捉功能实现在src/XUnity.AutoTranslator.Plugin.Core/Hooks/目录下。

🤝 参与贡献

如果你有编程经验，欢迎通过以下方式参与项目改进：

1. 提交bug修复或功能增强的Pull Request
2. 改进翻译质量，优化特定游戏的文本识别规则
3. 帮助扩展对更多游戏引擎和插件管理器的支持

---

通过本指南，你已经掌握了XUnity.AutoTranslator的安装与使用方法。现在，尽情探索那些因语言障碍而被你忽略的精彩游戏世界吧！如有其他问题，欢迎在项目社区交流讨论。