XUnity.AutoTranslator 5.4.0版本IL2CPP游戏翻译问题解析与解决方案

问题背景

XUnity.AutoTranslator是一款广泛使用的游戏自动翻译工具，支持Mono和IL2CPP两种Unity引擎运行模式。近期发布的5.4.0版本中，用户反馈在IL2CPP模式下出现了翻译功能失效的问题，而Mono模式则工作正常。

问题表现

用户在升级到5.4.0版本后，发现以下现象：

1. 使用ReiPatcher和BepInEx的Mono游戏翻译功能正常
2. 无论是32位还是64位的IL2CPP游戏都无法进行翻译
3. 日志中显示"Could not find the configured endpoint 'GoogleTranslateV2'"错误
4. 翻译菜单(alt+0)中不显示任何翻译端点

技术分析

通过日志分析，可以识别出几个关键问题点：

1. 翻译端点缺失：新版本中默认没有包含翻译端点插件，这是设计变更而非bug。开发者已在发布说明中提示需要从旧版本升级以保留所有翻译器。

2. 类型解析失败：日志显示部分Unity类型解析失败，如TextMesh、ToolbarButtonSize等，这是由于IL2CPP与Mono在类型系统上的差异导致的，属于正常现象。

3. 输入API不可用：系统检测到游戏使用了新的Input System而非传统的Unity Input系统，导致快捷键检测失败，这不会影响核心翻译功能。

解决方案

对于遇到此问题的用户，可以采取以下步骤解决：

1. 保留翻译端点插件：

   • 从5.3.1版本中复制Translators文件夹下的所有DLL文件
   • 将这些文件粘贴到5.4.0版本的对应目录中
   • 确保GoogleTranslate、BaiduTranslate等所需的翻译端点DLL都存在

2. 文件更新注意事项：

   • FullNET文件夹中的文件可以保留5.4.0版本
   • 不需要从旧版本覆盖这些文件
   • 新旧版本的核心功能实现相同，差异主要在翻译端点支持上

3. 配置检查：

   • 确保Config.ini中配置的翻译端点与实际提供的插件匹配
   • 验证翻译缓存目录(Translation)的读写权限

技术建议

1. 对于IL2CPP游戏，建议使用最新版的BepInEx IL2CPP支持(如704 Build版本)
2. 安装时确保正确合并BepInEx和AutoTranslator的文件结构
3. 遇到问题时首先检查LogOutput.log和ErrorLog.log文件
4. 不同Unity版本可能需要特定的兼容性处理，2022.3.x版本已验证可用

总结

XUnity.AutoTranslator 5.4.0版本的IL2CPP支持本身功能完整，但为了减小发布包体积，默认移除了翻译端点插件。用户只需从旧版本迁移这些插件即可恢复完整功能。这一设计变更提高了核心组件的更新灵活性，同时让用户可以根据需要选择具体的翻译服务提供商。