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

XUnity.AutoTranslator是一款强大的开源自动化游戏翻译工具，专为Unity引擎游戏设计，支持自动翻译与手动翻译双重模式。无论是新手玩家还是进阶开发者，都能通过简单配置享受高质量的游戏本地化体验，轻松解决外语游戏的语言障碍。

为什么选择XUnity.AutoTranslator？🌟

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

• 多框架支持：完美兼容BepInEx、MelonLoader、IPA等主流插件管理器
• 智能翻译引擎：集成DeepL、Google、Bing等15+翻译服务，支持专业版API密钥配置
• 防滥用机制：内置12种请求限制策略，避免翻译服务滥用与账号风险
• 灵活配置选项：从字体替换到UI自适应，提供20+精细化调节参数

准备工作：3分钟环境搭建 ⚙️

支持的游戏引擎版本

• Unity 5.6+ 至 Unity 2022（包括IL2CPP架构）
• 兼容.NET 3.5/4.x运行时环境

推荐安装方式（BepInEx插件版）

1. 确保已安装BepInEx插件管理器
2. 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
3. 将压缩包中XUnity.AutoTranslator-BepInEx-{VERSION}.zip解压至游戏根目录
4. 验证文件结构是否正确：

{GameDirectory}/BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.Core.dll
{GameDirectory}/BepInEx/Translation/ (自动生成翻译文件目录)

DeepL专业版API配置：5步实现精准翻译 🔑

1. 获取DeepL API密钥

• 访问DeepL开发者平台注册账号
• 选择合适套餐（免费版每月50万字，专业版支持批量翻译）
• 在账号设置中生成并复制API密钥（格式如：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:fx）

2. 定位配置文件

启动游戏后，配置文件会自动生成在以下路径：

• BepInEx版：BepInEx/config/XUnity.AutoTranslator.ini
• MelonLoader版：UserData/Config/XUnity.AutoTranslator.ini

3. 修改核心配置参数

用文本编辑器打开配置文件，设置以下关键参数：

[Service]
Endpoint=DeepLTranslateLegitimate  ;启用DeepL官方API
FallbackEndpoint=GoogleTranslate   ;设置备用翻译服务

[DeepL]
AuthKey=your_api_key_here          ;粘贴你的DeepL API密钥

4. 高级参数优化

根据游戏文本特点调整以下参数提升翻译质量：

[Behaviour]
MaxCharactersPerTranslation=500    ;增加单次翻译字符上限
EnableBatching=True                ;启用批量翻译模式
UseStaticTranslations=True         ;启用内置翻译缓存

5. 验证配置是否生效

• 启动游戏并按ALT+0打开翻译控制台
• 观察日志输出：Using DeepLTranslateLegitimate endpoint表示配置成功
• 首次翻译可能有2-3秒延迟，后续会启用本地缓存加速

实用功能：提升体验的7个技巧 💡

翻译模式快速切换

• ALT+T：即时切换原文/译文显示
• ALT+R：手动刷新翻译缓存（修改翻译文件后使用）
• ALT+U：强制扫描未翻译文本（适用于动态加载内容）

翻译文件管理

自动生成的翻译文件位于：

• BepInEx：BepInEx/Translation/{目标语言}/Text/
• 手动编辑：通过_AutoGeneratedTranslations.txt优化机翻结果
• 术语库维护：创建_Substitutions.txt定义固定翻译规则

UI适配优化

解决翻译后文本溢出问题：

[Behaviour]
EnableUIResizing=True              ;自动调整UI尺寸
ForceSplitTextAfterCharacters=40   ;过长文本自动换行
FallbackFontTextMeshPro=NotoSans.ttc ;添加多语言字体支持

常见问题排查：90%用户会遇到的5个问题 🛠️

Q1: API调用失败提示"403 Forbidden"

• 检查：API密钥是否包含fx后缀（免费版特征）
• 修复：在DeepL账号页确认密钥状态

Q2: 翻译频繁中断或闪退

• 检查：BepInEx/LogOutput.log中是否有Rate limit exceeded记录
• 修复：降低翻译请求频率：

[Behaviour]
MaxCharactersPerTranslation=150    ;减少单次翻译长度

Q3: 部分文本无法翻译

• 检查：是否启用对应UI框架支持

[TextFrameworks]
EnableUGUI=True
EnableTextMeshPro=True             ;确保目标UI框架已启用

Q4: 中文显示乱码

• 修复：配置支持中文的字体：

[Behaviour]
FallbackFontTextMeshPro=SimHei.ttf ;添加中文字体 fallback

Q5: 翻译缓存占用空间过大

• 清理：定期删除Translation/Cache/目录下的过期缓存文件
• 限制：设置缓存上限（高级功能）

高级玩家指南：自定义翻译流程 🚀

翻译预处理规则

创建_Preprocessors.txt文件定义文本替换规则：

# 格式：原始文本=处理后文本
{player_name}=勇者
<system_msg>=【系统提示】

批量翻译管理

使用插件提供的批量翻译工具：

• 导出待翻译文本：AutoTranslator/Exports/待翻译文本.csv
• 导入人工翻译结果：AutoTranslator/Imports/人工翻译结果.csv

性能优化配置

对于低配设备，建议调整以下参数：

[Performance]
MaxConcurrentTranslations=1        ;降低并发请求数
TranslationCacheTTL=86400          ;延长缓存有效期（秒）

总结：开启无障碍游戏之旅 🌍

通过XUnity.AutoTranslator的DeepL API配置，你已获得专业级的游戏翻译解决方案。无论是日系RPG的复杂剧情，还是独立游戏的创意文本，都能实时转换为流畅的母语体验。

记得定期备份Translation目录下的翻译文件，它们是你个性化翻译成果的重要积累。如有更多需求，可探索插件开发文档扩展自定义功能。

现在，尽情享受无语言障碍的游戏世界吧！🎮