Unity游戏翻译革命：XUnity.AutoTranslator如何让本地化变得轻而易举

【免费下载链接】XUnity.AutoTranslator 项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator

作为Unity游戏爱好者的必备工具，XUnity.AutoTranslator能够智能识别并实时翻译游戏内文本，帮助玩家轻松跨越语言障碍，享受原汁原味的游戏体验。这款强大的自动翻译插件支持多种插件框架和翻译服务，为全球游戏玩家提供了完美的多语言支持方案。

🚀 为什么XUnity.AutoTranslator是首选？

XUnity.AutoTranslator提供了全方位的游戏文本翻译解决方案：

• 多框架支持：兼容BepInEx、MelonLoader、IPA和UnityInjector等主流插件框架
• 丰富翻译服务：内置Google、Bing、DeepL等15+翻译服务，支持自定义API
• 智能文本处理：自动识别UGUI、NGUI、TextMeshPro等多种文本框架
• 灵活配置选项：可自定义翻译语言、缓存策略和UI调整规则
• 性能优化：智能请求限流和本地缓存，减少网络请求并提高响应速度

📥 简单三步安装指南

1. 获取最新版安装包

从项目仓库克隆代码库：

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

2. 选择适合的安装方式

BepInEx插件（推荐）

1. 下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip
2. 解压到游戏目录，确保DLL文件位于BepInEx/plugins/XUnity.AutoTranslator/
3. 启动游戏自动生成配置文件

核心文件路径：

• 主插件：BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.Core.dll
• 配置文件：BepInEx/config/XUnity.AutoTranslator.ini

独立安装（ReiPatcher）

1. 下载XUnity.AutoTranslator-ReiPatcher-{VERSION}.zip
2. 解压到游戏目录并运行SetupReiPatcherAndAutoTranslator.exe
3. 使用生成的快捷方式启动游戏

⚙️ 快速配置指南

打开配置文件（首次启动后生成），设置基本参数：

[Service]
Endpoint=GoogleTranslate         ; 选择翻译服务
FallbackEndpoint=BingTranslate   ; 备用翻译服务

[General]
Language=en                      ; 目标语言
FromLanguage=ja                  ; 源语言（游戏原始语言）

[TextFrameworks]
EnableUGUI=True                  ; 启用UGUI翻译
EnableTextMeshPro=True           ; 启用TextMeshPro翻译

常用热键：

• ALT + 0：切换翻译UI
• ALT + T：切换翻译/原文显示
• ALT + R：重新加载翻译文件
• ALT + U：手动触发文本扫描

🔍 高级功能探索

手动翻译与自定义

XUnity.AutoTranslator会自动生成翻译文件，位于：

• Translation/{Lang}/Text/_AutoGeneratedTranslations.txt

你可以直接编辑这些文件添加手动翻译，格式如下：

原文=翻译文本
r:"正则表达式"=替换文本
sr:"拆分正则"=$1 $2

插件集成开发

开发者可以通过API扩展翻译功能：

// 翻译查询示例
AutoTranslator.Default.TranslateAsync("原文", result => {
  if(result.Succeeded) {
    Debug.Log(result.TranslatedText);
  }
});

核心API定义在 src/XUnity.AutoTranslator.Plugin.Core/ 目录下。

🛠️ 常见问题解决

文本未翻译？

1. 检查配置文件中对应文本框架是否启用
2. 尝试按ALT + U手动触发文本扫描
3. 确认翻译服务是否正常工作

UI显示异常？

调整配置文件中的UI调整参数：

[Behaviour]
EnableUIResizing=True
ResizeUILineSpacingScale=0.8
OverrideFont=你的字体路径

🎯 最佳实践

1. 优先使用认证服务：如DeepL Legitimate或Google Cloud翻译，提高稳定性
2. 定期更新翻译文件：减少重复翻译请求
3. 使用批量翻译：在配置中启用EnableBatching=True减少API调用
4. 合理设置缓存：通过CacheRegexLookups=True缓存正则匹配结果

XUnity.AutoTranslator通过其强大的功能和灵活的配置，为Unity游戏玩家提供了完美的多语言解决方案。无论是为游戏添加本地化支持，还是帮助玩家跨越语言障碍，都能获得出色的使用体验。立即开始你的无障碍游戏之旅吧！

【免费下载链接】XUnity.AutoTranslator 项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator