三步掌握XUnity.AutoTranslator：让Unity游戏翻译自动化的完整指南

为什么选择这款翻译插件？

在全球化游戏市场中，语言障碍常常影响玩家体验。XUnity.AutoTranslator作为一款专为Unity引擎设计的翻译插件，能够自动识别并翻译游戏内文本，支持多种插件管理器和翻译服务，让你轻松实现游戏本地化。无论是独立游戏还是大型模组，这款工具都能提供高效、精准的翻译解决方案。

📋 环境准备：安装前的检查清单

在开始安装前，请确保你的系统满足以下要求：

系统要求

• 操作系统：Windows 7/8/10/11（32位或64位）
• Unity版本：支持Unity 5及以上版本的游戏
• .NET框架：.NET Framework 4.5或更高版本

插件管理器选择

插件管理器	适用场景	优势	安装难度
BepInEx	大多数Unity游戏，推荐使用	社区活跃，兼容性好，支持IL2CPP	⭐⭐☆☆☆
MelonLoader	支持最新Unity版本，适合模组开发	轻量级，易于集成	⭐⭐☆☆☆
IPA	特定Unity游戏（如VR游戏）	专注于音频可视化插件	⭐⭐⭐☆☆
UnityInjector	老版本Unity游戏	适合传统Unity引擎游戏	⭐⭐⭐☆☆
ReiPatcher	无插件管理器时使用	独立安装，无需其他依赖	⭐☆☆☆☆

⚠️ 注意：不要同时安装多个插件管理器，可能导致冲突。推荐优先使用BepInEx，兼容性最佳。

🚀 多样化部署：五种安装方式任选

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

前置检查

• 已安装BepInEx插件管理器（官方安装指南）
• 游戏目录具有写入权限

核心操作

1. 下载插件包 XUnity.AutoTranslator-BepInEx-[VERSION].zip
2. 解压至游戏根目录，确保文件结构如下：

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

3. 启动游戏，插件会自动加载

验证方法

• 游戏启动后，按 ALT + 0 应显示XUnity AutoTranslator控制面板
• 检查游戏目录下是否生成 BepInEx/Translation 文件夹

方法二：MelonLoader插件安装

前置检查

• 已安装MelonLoader v0.6.1或更高版本
• 游戏支持MelonLoader注入

核心操作

1. 下载插件包 XUnity.AutoTranslator-MelonMod-[VERSION].zip
2. 解压文件至游戏根目录，确保：
   • Mod文件放入 Mods 文件夹
   • 依赖库放入 UserLibs 文件夹
3. 启动游戏，MelonLoader会自动加载插件

验证方法

• 查看MelonLoader控制台输出，应有 XUnity.AutoTranslator loaded 信息
• 游戏目录生成 AutoTranslator/Translation 文件夹

方法三：ReiPatcher独立安装

前置检查

• 游戏可执行文件路径无中文或特殊字符
• 管理员权限运行安装程序

核心操作

1. 下载 XUnity.AutoTranslator-ReiPatcher-[VERSION].zip
2. 解压至游戏根目录，确保 SetupReiPatcherAndAutoTranslator.exe 与游戏exe同目录
3. 双击运行安装程序，按提示完成安装
4. 使用生成的 [GameExeName] (Patch and Run).lnk 快捷方式启动游戏

验证方法

• 游戏根目录生成 ReiPatcher 文件夹
• 启动游戏后，插件自动补丁生效，首次运行会生成配置文件

方法四：IPA插件安装

前置检查

• 已安装IPA插件管理器
• 游戏支持IPA注入

核心操作

1. 下载 XUnity.AutoTranslator-IPA-[VERSION].zip
2. 解压至游戏 Plugins 文件夹
3. 启动游戏，IPA会自动加载插件

验证方法

• 游戏目录 Plugins 文件夹下存在 XUnity.AutoTranslator.Plugin.IPA.dll
• 按 ALT + T 可切换翻译/原文显示

方法五：UnityInjector插件安装

前置检查

• 已安装UnityInjector
• 游戏为老版本Unity引擎（2017年前）

核心操作

1. 下载 XUnity.AutoTranslator-UnityInjector-[VERSION].zip
2. 解压至 UnityInjector 文件夹
3. 启动游戏，插件自动加载

验证方法

• UnityInjector/Config 目录生成翻译配置文件
• 游戏内文本显示翻译结果

⚙️ 个性化配置：打造你的专属翻译体验

配置文件位置

根据安装方式不同，配置文件 config.ini 位置如下：

• BepInEx：BepInEx/config/XUnity.AutoTranslator.ini
• MelonLoader：AutoTranslator/config.ini
• ReiPatcher：AutoTranslator/config.ini
• IPA：Plugins/Translation/config.ini
• UnityInjector：UnityInjector/Config/Translation.ini

关键配置项说明

翻译服务设置

[Service]
Endpoint=GoogleTranslate       ; 主要翻译服务
FallbackEndpoint=BingTranslate ; 备用翻译服务

支持的翻译服务：GoogleTranslate、BingTranslate、DeepLTranslate、PapagoTranslate等

语言设置

[General]
Language=en                    ; 目标语言（如zh-CN表示简体中文）
FromLanguage=ja                ; 源语言（游戏原始语言）

文本框架设置

[TextFrameworks]
EnableUGUI=True                ; 启用UGUI翻译
EnableTextMeshPro=True         ; 启用TextMeshPro翻译
EnableIMGUI=False              ; 禁用IMGUI翻译（可能影响性能）

UI优化设置

[Behaviour]
EnableUIResizing=True          ; 自动调整UI大小以适应翻译文本
OverrideFont=Arial.ttf         ; 替换默认字体（仅UGUI）
FallbackFontTextMeshPro=NotoSansCJKsc-Regular.otf ; 添加字体回退（推荐）

📌 提示：修改配置后，按 ALT + R 可实时 reload 翻译文件，无需重启游戏。

手动翻译文件

翻译文件位于 Translation/{Lang}/Text/ 目录下，格式为：

# 这是注释
原文文本=翻译后的文本
Another example line=另一个示例行

支持多行文本，使用 \n 表示换行。修改后按 ALT + R 生效。

🎮 功能探索：掌握插件核心用法

快捷键一览

• ALT + 0：显示/隐藏主控制面板
• ALT + T：切换翻译/原文显示
• ALT + R：重新加载翻译文件
• ALT + U：手动触发文本扫描
• ALT + F：切换字体（需配置OverrideFont）

翻译质量优化

1. 选择合适的翻译服务：DeepL翻译质量最佳，但有字符限制；Google翻译免费且稳定。
2. 使用备用翻译服务：配置FallbackEndpoint，当主服务故障时自动切换。
3. 优化字体设置：对中文等复杂文字，建议设置FallbackFontTextMeshPro。
4. 手动修正翻译：将常用文本添加到翻译文件，提高准确性。

❓ 常见问题速查

安装问题

Q: 安装后无反应，游戏没有翻译效果？
A: 检查插件管理器日志，确认插件是否加载。常见原因：

• BepInEx版本过低，升级到最新版
• 游戏为IL2CPP架构，需使用对应版本插件
• 杀毒软件误删插件文件，添加信任区

Q: ReiPatcher安装后无法生成快捷方式？
A: 手动创建快捷方式，目标设为：

"{GameDirectory}\ReiPatcher\ReiPatcher.exe" -c -r -l "{GameExeName} (Patch and Run).lnk" "{GameExeName}.exe"

使用问题

Q: 翻译速度慢，出现大量未翻译文本？
A: 检查配置文件：

• 降低 MaxCharactersPerTranslation 值（默认200）
• 启用 EnableBatching=True 批量翻译
• 确认网络连接正常，翻译服务未被墙

Q: UI错乱，翻译文本显示不全？
A: 调整UI设置：

• 设置 EnableUIResizing=True
• 增加 ForceSplitTextAfterCharacters=50 自动换行
• 调整 ResizeUILineSpacingScale=0.8 缩小行间距

高级问题

Q: 如何添加自定义翻译服务？
A: 1. 创建实现 ITranslator 接口的类库 2. 将DLL放入 Translators 文件夹 3. 配置文件中设置 Endpoint=CustomTranslate 并指定URL

Q: 插件导致游戏卡顿怎么办？
A: 优化性能设置：

• 禁用不必要的文本框架（如 EnableIMGUI=False）
• 增加 MinDialogueChars=30 减少短文本翻译
• 降低 MaxCharactersPerTranslation=150 减少单次翻译负载

📝 总结

XUnity.AutoTranslator是一款功能强大的Unity游戏翻译插件，通过灵活的安装方式和丰富的配置选项，满足不同场景下的翻译需求。无论是普通玩家还是模组开发者，都能通过本指南快速掌握其使用方法。记住，选择合适的插件管理器、优化翻译服务配置、及时更新翻译文件，是获得最佳翻译效果的关键。

希望本指南能帮助你轻松实现Unity游戏的自动化翻译，享受无语言障碍的游戏体验！如有其他问题，欢迎在项目GitHub仓库提交Issue或参与讨论。