XUnity.AutoTranslator 终极指南：10步掌握游戏自动化翻译技术
【免费下载链接】XUnity.AutoTranslator 
项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
XUnity.AutoTranslator是一款强大的Unity游戏本地化工具，能够实时翻译游戏文本，帮助玩家轻松跨越语言障碍，享受无障碍的游戏体验。作为Unity游戏爱好者的必备工具，它支持多种插件框架和翻译服务，为全球游戏玩家提供了完美的多语言支持方案。
一、为什么选择XUnity.AutoTranslator？
XUnity.AutoTranslator提供了全方位的游戏文本翻译解决方案，具有以下核心优势：
- 多框架支持：兼容BepInEx、MelonLoader、IPA和UnityInjector等主流插件框架
- 丰富翻译服务：内置Google、Bing、DeepL等多种翻译引擎，支持自定义翻译接口
- 智能文本处理：自动识别游戏内文本组件，支持正则表达式和文本替换功能
- 性能优化：内置防垃圾请求机制，避免过度调用翻译接口
- 灵活配置：可自定义翻译规则、UI调整和字体设置
二、安装准备：选择适合你的安装方式
XUnity.AutoTranslator提供多种安装方式，可根据游戏使用的插件框架选择：
2.1 BepInEx插件安装（推荐）
- 确保已安装BepInEx插件管理器
- 下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip
- 解压到游戏目录，确保插件DLL文件位于BepInEx/plugins/XUnity.AutoTranslator目录下
安装后的文件结构：
{GameDirectory}/BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.Core.dll
{GameDirectory}/BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.BepInEx.dll
{GameDirectory}/BepInEx/plugins/XUnity.AutoTranslator/Translators/{Translator}.dll
2.2 独立安装（ReiPatcher）
- 下载XUnity.AutoTranslator-ReiPatcher-{VERSION}.zip
- 直接解压到游戏目录，确保"SetupReiPatcherAndAutoTranslator.exe"与游戏可执行文件同目录
- 运行"SetupReiPatcherAndAutoTranslator.exe"完成安装
- 通过生成的快捷方式启动游戏
三、基础配置：10步快速开始
步骤1：获取并安装插件
从项目仓库克隆或下载最新版本：
git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
根据游戏使用的插件框架选择合适的安装包，按照对应框架的安装说明操作。
步骤2：首次启动生成配置文件
启动游戏后，插件会自动生成配置文件。配置文件位置因安装方式而异：
- BepInEx：{GameDirectory}/BepInEx/config/XUnity.AutoTranslator.cfg
- 独立安装：{GameDirectory}/AutoTranslator/Config.ini
步骤3：选择翻译服务
打开配置文件，设置首选翻译服务：
[Service]
Endpoint=GoogleTranslate ; 选择翻译服务，如GoogleTranslate、BingTranslate等
FallbackEndpoint= ; 可选的备用翻译服务
支持的内置翻译服务包括：
- GoogleTranslate：无需API密钥，不稳定但无使用限制
- DeepLTranslate：高质量翻译，无需API密钥
- BingTranslateLegitimate：需要Azure API密钥，每月200万字符免费
- GoogleTranslateLegitimate：需要Google Cloud API密钥，提供1年300美元免费额度
步骤4：设置语言对
[General]
Language=en ; 目标语言，如zh-CN表示简体中文
FromLanguage=ja ; 游戏原始语言，"auto"可自动检测
步骤5：配置文本框架
启用需要翻译的文本框架：
[TextFrameworks]
EnableUGUI=True ; 启用UGUI翻译
EnableNGUI=True ; 启用NGUI翻译
EnableTextMeshPro=True ; 启用TextMeshPro翻译
EnableTextMesh=False ; 启用TextMesh翻译（默认禁用）
EnableIMGUI=False ; 启用IMGUI翻译（默认禁用）
步骤6：设置翻译文件路径
[Files]
Directory=Translation\{Lang}\Text ; 翻译文件目录
OutputFile=Translation\{Lang}\Text\_AutoGeneratedTranslations.txt ; 自动生成的翻译文件
SubstitutionFile=Translation\{Lang}\Text\_Substitutions.txt ; 替换规则文件
步骤7：配置UI调整选项
[Behaviour]
EnableUIResizing=True ; 启用UI自动调整
OverrideFont= ; 覆盖字体（仅UGUI）
FallbackFontTextMeshPro= ; TextMeshPro备用字体
步骤8：设置热键
默认热键配置：
- ALT + 0：切换XUnity AutoTranslator UI
- ALT + T：切换翻译/原文显示
- ALT + R：重新加载翻译文件
- ALT + U：手动触发文本扫描
步骤9：启动游戏测试
启动游戏，观察是否有文本被翻译。首次使用时，翻译结果会保存在_AutoGeneratedTranslations.txt文件中。
步骤10：手动优化翻译
打开自动生成的翻译文件，手动修正不满意的翻译结果，下次启动游戏会自动加载修改后的翻译。
四、高级功能：提升翻译体验
4.1 自定义翻译规则
创建_Substitutions.txt文件定义替换规则，例如：
私は{{A}}=I am {{A}}
4.2 使用正则表达式翻译
在翻译文件中使用正则表达式：
r:"^シンプルリング ([0-9]+)$"=Simple Ring $1
4.3 文本分割与合并
使用分割正则表达式处理复杂文本：
sr:"^([0-9]{2}) ([\S\s]+)$"=$1 $2
4.4 字体与UI调整
创建resizer.txt文件自定义UI大小：
CharaCustom/CustomControl/CanvasDraw=ChangeFontSizeByPercentage(0.8)
五、常见问题解决
Q: 翻译不生效怎么办？
A: 检查以下几点：
- 确认配置文件中已启用对应文本框架
- 检查翻译服务是否正常工作
- 尝试按ALT+U手动触发文本扫描
- 查看日志文件排查问题
Q: 如何避免翻译API请求限制？
A: 配置文件中设置合理的请求限制：
[Behaviour]
MaxCharactersPerTranslation=200 ; 每次翻译的最大字符数
EnableBatching=True ; 启用批量翻译
Q: 如何完全禁用插件？
A: 删除以下目录：
- BepInEx：{GameDirectory}\BepInEx\plugins\XUnity.AutoTranslator
- 独立安装：{GameDirectory}\ReiPatcher\Patches\XUnity.AutoTranslator.Patcher.dll
六、核心文件与模块路径
- 核心插件：src/XUnity.AutoTranslator.Plugin.Core/
- 翻译服务实现：src/Translators/
- 配置文件：根据安装方式不同，位于BepInEx/config或AutoTranslator目录
- 翻译文件：默认位于Translation/{Lang}/Text目录
七、总结
通过本指南的详细讲解，你已全面掌握XUnity.AutoTranslator的使用方法。无论是简单的菜单翻译还是复杂的对话本地化，这款工具都能为你提供专业级的解决方案。立即开始你的无障碍游戏之旅，享受真正的本地化游戏体验！
XUnity.AutoTranslator通过其强大的功能和灵活的配置，为Unity游戏玩家提供了完美的多语言解决方案。无论是为游戏添加本地化支持，还是帮助玩家跨越语言障碍，都能获得出色的使用体验。
【免费下载链接】XUnity.AutoTranslator 项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
转载自 CSDN-专业IT技术社区
原文链接：https://blog.csdn.net/gitblog_00988/article/details/155457228
