Unity游戏自动翻译终极指南:XUnity.AutoTranslator完全配置教程
Unity游戏自动翻译终极指南XUnity.AutoTranslator完全配置教程【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity.AutoTranslator是一款专为Unity游戏设计的开源自动翻译插件能够实时翻译游戏内文本帮助玩家突破语言障碍畅玩全球各地的游戏。这款强大的工具支持多种翻译引擎兼容主流游戏插件框架为Unity游戏本地化提供了完整的解决方案。 为什么选择XUnity.AutoTranslatorXUnity.AutoTranslator作为一款成熟的游戏翻译工具具有以下核心优势多平台兼容完美支持BepInEx、MelonLoader、IPA和UnityInjector等多种插件加载器翻译引擎丰富集成Google、Bing、DeepL、百度等10主流翻译服务智能缓存系统自动缓存翻译结果减少重复请求提升翻译速度性能优化对游戏性能影响极小运行稳定可靠开源免费完全开源社区活跃持续更新维护项目核心代码位于src/XUnity.AutoTranslator.Plugin.Core/目录包含完整的翻译管理、文本处理和UI适配系统。 快速安装三步完成部署系统要求在开始安装前请确保你的系统满足以下要求Windows 7/10/11操作系统.NET Framework 4.5或更高版本已安装目标游戏的插件加载器获取项目源码打开命令行工具执行以下命令克隆项目仓库git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator安装到游戏根据你使用的插件加载器选择对应的安装方式BepInEx用户推荐下载对应版本的BepInEx插件包将插件文件复制到游戏目录的BepInEx/plugins文件夹启动游戏插件会自动生成默认配置文件MelonLoader用户下载MelonLoader版本的插件包将文件复制到游戏目录的Mods文件夹运行游戏配置文件将生成在UserData/XUnity.AutoTranslator目录⚙️ 基础配置快速上手指南配置文件位置首次运行游戏后插件会自动生成配置文件AutoTranslatorConfig.ini通常位于以下路径BepInExBepInEx/config/XUnity.AutoTranslatorMelonLoaderUserData/XUnity.AutoTranslator关键配置项设置打开配置文件修改以下基础设置[General] ; 源语言游戏原始语言 SourceLanguage Japanese ; 目标语言你想要翻译成的语言 DestinationLanguage Chinese ; 翻译服务选择 Translator GoogleTranslate ; 启用翻译缓存 EnableCache true [Behaviour] ; 最大每行翻译字符数 MaxCharactersPerTranslation 200 ; 启用UI自动调整 EnableUIResizing true翻译服务配置不同翻译服务需要不同的配置以下是Google翻译的配置示例[GoogleTranslate] ; Google翻译服务URL可选用于绕过网络限制 ServiceUrl ; 翻译超时时间毫秒 Timeout 5000更多翻译服务配置可参考src/Translators/目录下的各翻译器实现。 高级功能配置文本格式化优化通过修改src/XUnity.AutoTranslator.Plugin.Core/Text/TextPostProcessing.cs中的规则可以自定义文本格式化方式解决翻译后的文本排版问题。UI适配调整如果翻译后的文本出现UI显示不全的问题可以通过src/XUnity.AutoTranslator.Plugin.Core/UIResize/目录下的UI调整模块进行优化支持自动调整文本框大小和字体适配。翻译缓存管理翻译缓存文件位于TranslationCache目录通过配置文件中的CacheExpirationDays参数可以设置缓存过期时间平衡翻译速度和新鲜度。 支持的翻译引擎XUnity.AutoTranslator支持多种翻译服务满足不同用户需求免费在线翻译GoogleTranslate基于Google在线翻译服务无需认证BingTranslate基于Bing在线翻译服务无需认证DeepLTranslate基于DeepL在线翻译服务翻译质量优秀PapagoTranslate基于Naver Papago翻译服务韩语翻译效果好官方API服务GoogleTranslateLegitimate基于Google Cloud翻译API需要API密钥BingTranslateLegitimate基于Azure文本翻译API需要API密钥DeepLLegitimate基于DeepL官方API需要API密钥BaiduTranslate基于百度翻译API需要AppId和AppSecret本地翻译软件LecPowerTranslator15基于LEC Power Translator软件ezTrans XP基于Changsinsoft的日韩翻译软件️ 实用技巧与优化快捷键操作插件提供了丰富的快捷键功能提升使用体验ALT 0切换XUnity AutoTranslator UI界面ALT 1切换翻译聚合器UIALT T在翻译和原文之间切换显示ALT R重新加载翻译文件ALT U手动触发文本钩子ALT F切换字体覆盖如果配置了OverrideFont翻译文件管理插件会自动生成翻译文件在Translation/{Language}/Text/目录下_AutoGeneratedTranslations.txt自动生成的翻译文件_Substitutions.txt文本替换规则文件_Preprocessors.txt翻译前处理规则_Postprocessors.txt翻译后处理规则正则表达式支持插件支持正则表达式翻译可以处理复杂的文本模式; 标准正则翻译 r:^アイテム ([0-9])$Item $1 ; 分割器正则 sr:^([0-9]{2}) ([\S\s])$$1 $2 常见问题解决翻译无响应检查网络连接是否正常确认翻译服务API密钥是否有效查看日志文件获取错误信息通常位于BepInEx/LogOutput.log游戏崩溃确保使用与游戏版本匹配的插件版本尝试禁用其他可能冲突的插件检查src/XUnity.AutoTranslator.Plugin.Core/Debugging/目录下的调试工具生成的报告翻译质量不佳尝试切换不同的翻译服务调整src/XUnity.AutoTranslator.Plugin.Core/Parsing/目录下的文本解析规则手动编辑翻译缓存文件修正错误翻译文本显示不全启用UI自动调整EnableUIResizing true调整字体大小使用resizer.txt文件自定义字体大小修改文本框溢出设置配置UGUI_HorizontalOverflow和UGUI_VerticalOverflow 项目结构解析了解项目结构有助于更好地使用和定制插件XUnity.AutoTranslator/ ├── src/ │ ├── Translators/ # 翻译器实现 │ ├── XUnity.AutoTranslator.Plugin.Core/ # 核心插件逻辑 │ │ ├── Configuration/ # 配置管理 │ │ ├── Endpoints/ # 翻译端点接口 │ │ ├── Hooks/ # 游戏钩子 │ │ ├── UI/ # 用户界面 │ │ ├── UIResize/ # UI调整功能 │ │ └── Utilities/ # 工具类 │ ├── XUnity.AutoTranslator.Plugin.BepInEx/ # BepInEx适配 │ ├── XUnity.AutoTranslator.Plugin.MelonMod/ # MelonLoader适配 │ └── XUnity.Common/ # 公共库 游戏兼容性支持的Unity文本框架UGUIUnity官方UI系统NGUI流行的第三方UI系统IMGUIUnity即时模式GUI默认禁用TextMeshPro高级文本渲染系统TextMesh3D空间中的文本默认禁用FairyGUI流行的UI框架Utage视觉小说游戏引擎特殊游戏支持项目还包含针对特定游戏的特殊支持src/XUnity.AutoTranslator.KoikatsuFormatter/Koikatsu游戏文本格式化src/XUnity.AutoTranslator.KoikatsuResources/Koikatsu游戏资源重定向 开发者扩展自定义翻译器开发开发者可以基于src/Translators/中的示例实现自定义翻译器。每个翻译器需要实现ITranslateEndpoint接口public interface ITranslateEndpoint { TaskTranslationResult TranslateAsync(TranslationEndpointArgs args); }资源重定向通过src/XUnity.ResourceRedirector/模块开发者可以重定向游戏资源实现更高级的本地化功能。插件集成其他插件可以通过TranslationRegistryAPI与AutoTranslator集成// 查询翻译 if (AutoTranslator.Default.TryTranslate(お前はもう死んでいる, out string translation)) { // 使用翻译结果 } 性能优化建议减少翻译请求启用批处理EnableBatching true使用静态翻译UseStaticTranslations true合理设置最大字符数MaxCharactersPerTranslation 200内存优化禁用不必要的功能如纹理翻译、IMGUI翻译等定期清理缓存文件使用压缩的翻译文件ZIP格式网络优化选择稳定的翻译服务配置合理的超时时间使用本地缓存减少网络请求 重要注意事项反垃圾邮件机制插件内置了反垃圾邮件保护机制新文本等待1秒后才发送翻译请求单次游戏会话最多发送8000个请求连续5次请求失败时自动关闭插件检测到文本滚动时自动关闭分发注意事项如果分发包含此插件的翻译包必须包含尽可能多的翻译以减少在线翻译请求不要启用EnableTextureDumping、EnableTextureToggling等调试选项测试插件在目标游戏中的稳定性保持插件版本更新法律与道德尊重游戏开发者的版权仅用于个人学习使用不要用于商业目的遵守各翻译服务的服务条款 未来展望XUnity.AutoTranslator持续更新中未来版本将带来更多功能更好的IL2CPP支持更多翻译服务集成性能优化和改进更好的错误处理和日志系统通过本教程你应该已经掌握了XUnity.AutoTranslator的完整使用方法。这款强大的工具能够帮助你轻松实现Unity游戏的自动翻译让你无障碍享受全球游戏。如果你在使用过程中遇到问题可以查阅项目文档或参与社区讨论。祝你游戏愉快【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考