XUnity Auto Translator 终极使用指南:Unity游戏翻译的完整解决方案
【免费下载链接】XUnity.AutoTranslator 项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
开篇导览
XUnity Auto Translator 是一款专业的 Unity 游戏自动翻译插件,能够实时识别并翻译游戏内的文本内容,为开发者和玩家提供无缝的多语言游戏体验。这款工具特别适合想要为游戏添加多语言支持的独立开发者,以及希望畅玩外语游戏的普通玩家。
工具功能速览
- 实时文本翻译:自动检测游戏中的文本并进行翻译
- 多翻译服务支持:集成 Google、Bing、DeepL 等主流翻译服务
- 多种UI框架兼容:支持 UGUI、NGUI、TextMeshPro 等主流文本框架
- 资源重定向功能:支持纹理图片的替换和翻译
适用场景说明
- 为 Unity 游戏添加多语言支持
- 翻译外语游戏内容
- 游戏本地化开发测试
- 多语言游戏体验优化
快速入门体验
极简安装步骤
BepInEx 插件安装(推荐方式)
- 下载 XUnity.AutoTranslator-BepInEx-{VERSION}.zip 安装包
- 解压至游戏根目录,确保插件 dll 文件放置在 BepInEx 文件夹中
- 启动游戏,配置文件将自动创建
首次使用演示
- 启动游戏:安装完成后直接启动游戏
- 验证安装:按 ALT+0 键查看翻译界面是否正常显示
- 基础配置:在自动生成的配置文件中设置目标语言
- 开始翻译:游戏中的文本将自动开始翻译
核心功能详解
文本翻译功能
支持的文本框架:
- 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" 目录。
故障诊断流程
- 检查安装:确认插件文件正确放置在 BepInEx 文件夹中
- 验证配置:检查配置文件中的语言设置是否正确
- 测试翻译服务:尝试不同的翻译端点
- 查看日志文件:分析插件运行日志定位问题
进阶应用探索
与其他工具集成
作为模组作者集成翻译功能:
// 查询缓存,如果在缓存中找不到,则查询用户选择的翻译端点
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 的各项功能。
【免费下载链接】XUnity.AutoTranslator 项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator