XUnity Auto Translator 终极使用指南：Unity游戏翻译的完整解决方案

开篇导览

XUnity Auto Translator 是一款专业的 Unity 游戏自动翻译插件，能够实时识别并翻译游戏内的文本内容，为开发者和玩家提供无缝的多语言游戏体验。这款工具特别适合想要为游戏添加多语言支持的独立开发者，以及希望畅玩外语游戏的普通玩家。

工具功能速览

• 实时文本翻译：自动检测游戏中的文本并进行翻译
• 多翻译服务支持：集成 Google、Bing、DeepL 等主流翻译服务
• 多种UI框架兼容：支持 UGUI、NGUI、TextMeshPro 等主流文本框架
• 资源重定向功能：支持纹理图片的替换和翻译

适用场景说明

• 为 Unity 游戏添加多语言支持
• 翻译外语游戏内容
• 游戏本地化开发测试
• 多语言游戏体验优化

快速入门体验

极简安装步骤

BepInEx 插件安装（推荐方式）

1. 下载 XUnity.AutoTranslator-BepInEx-{VERSION}.zip 安装包
2. 解压至游戏根目录，确保插件 dll 文件放置在 BepInEx 文件夹中
3. 启动游戏，配置文件将自动创建

首次使用演示

1. 启动游戏：安装完成后直接启动游戏
2. 验证安装：按 ALT+0 键查看翻译界面是否正常显示
3. 基础配置：在自动生成的配置文件中设置目标语言
4. 开始翻译：游戏中的文本将自动开始翻译

核心功能详解

文本翻译功能

支持的文本框架：

• UGUI（Unity GUI 系统）
• NGUI（下一代 UI）
• TextMeshPro（文本网格专业版）
• FairyGUI for Unity
• Utage（VN 游戏引擎）

基础配置示例：

[Service]
Endpoint=GoogleTranslate

[General]
Language=en
FromLanguage=ja

翻译服务选择

免费翻译服务：

• GoogleTranslate：无需认证，直接使用
• BingTranslate：在线必应翻译服务
• DeepLTranslate：高质量翻译服务

认证翻译服务：

• GoogleTranslateLegitimate：需要 API 密钥
• BingTranslateLegitimate：需要 Azure 密钥
• DeepLTranslateLegitimate：需要 API 密钥

快捷键操作

• ALT + 0：切换 XUnity AutoTranslator UI
• ALT + T：在翻译版本和未翻译版本之间切换所有文本
• ALT + R：重新加载翻译文件
• ALT + U：手动挂钩文本
• ALT + F：切换覆盖字体

高级配置技巧

性能优化设置

防垃圾邮件机制配置：

[Behaviour]
MaxCharactersPerTranslation=200
EnableTranslationCache=True
TranslationCacheSize=10000

个性化定制参数

翻译质量优化：

[Translation]
EnableBatching=True
BatchSize=50
TranslationDelay=1000

纹理翻译配置

从 2.16.0+ 版本开始支持纹理翻译功能：

[Texture]
EnableTextureTranslation=False
TextureDirectory=Translation\Texture
CacheTexturesInMemory=True

疑难排解手册

常见问题集锦

Q: 游戏在插件应用翻译时停止工作怎么办？ A: 尝试设置 TextGetterCompatibilityMode=True 配置参数。

Q: 如何禁用自动翻译？ A: 按 ALT+0 选择空端点，或将配置参数 Endpoint= 设置为空。

Q: 如何完全禁用插件？ A: 删除 "{GameDirectory}\BepInEx\plugins" 目录中的 "XUnity.AutoTranslator" 目录。

故障诊断流程

1. 检查安装：确认插件文件正确放置在 BepInEx 文件夹中
2. 验证配置：检查配置文件中的语言设置是否正确
3. 测试翻译服务：尝试不同的翻译端点
4. 查看日志文件：分析插件运行日志定位问题

进阶应用探索

与其他工具集成

作为模组作者集成翻译功能：

// 查询缓存，如果在缓存中找不到，则查询用户选择的翻译端点
AutoTranslator.Default.TranslateAsync( "お前はもう死んでいる！", result =>
{
   if( result.Succeeded )
   {
      var translatedText = result.TranslatedText;
   }
} );

自动化应用场景

批处理翻译配置：

• 设置自动翻译语言对
• 配置翻译缓存策略
• 启用智能文本检测

资源获取指引

官方文档路径

项目的主要文档位于根目录下的 README.md 文件，包含详细的配置说明和使用指南。

社区支持渠道

如需获取技术支持或参与讨论，可以通过以下方式获取项目源码：

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

更新日志查看

项目更新日志文件：

• CHANGELOG.md：主要功能更新记录
• CHANGELOG - ResourceRedirector.md：资源重定向功能更新

总结

XUnity Auto Translator 作为 Unity 游戏翻译领域的专业工具，通过其强大的功能和灵活的配置选项，为游戏开发者和玩家提供了完整的翻译解决方案。无论是为游戏添加多语言支持，还是畅玩外语游戏，这款工具都能提供卓越的使用体验。

记住合理使用翻译服务，避免过度调用导致服务限制，同时充分利用手动翻译功能来优化翻译质量。通过本文的指南，您应该能够快速上手并充分利用 XUnity Auto Translator 的各项功能。