XUnity Auto TranslatorUnity游戏自动翻译完整指南【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator面对外语Unity游戏时的语言障碍XUnity Auto Translator提供了完整的实时翻译解决方案。这款开源工具能够在游戏运行时自动识别并翻译界面文本支持多种翻译引擎和插件框架让玩家无需等待官方本地化即可享受游戏内容。 核心功能与价值定位XUnity Auto Translator的核心价值在于其无缝集成能力。它直接嵌入Unity游戏运行时环境通过钩子技术捕获游戏中的文本渲染调用实现即时翻译替换。不同于外部翻译工具它能够实时文本替换在游戏渲染过程中动态替换文本内容多框架支持兼容UGUI、NGUI、TextMeshPro等主流Unity UI框架智能缓存系统翻译结果自动保存避免重复请求翻译服务配置灵活性支持在线翻译API和本地翻译软件 安装与配置流程选择合适的安装方式根据游戏使用的插件管理器选择对应的安装包安装方式适用场景核心文件位置独立安装ReiPatcher无插件管理器的Unity游戏游戏根目录/ReiPatcher/BepInEx插件已使用BepInEx的游戏BepInEx/plugins/XUnity.AutoTranslator/MelonLoader插件使用MelonLoader的游戏Mods/和UserLibs/目录IPA插件使用IPA的游戏Plugins/目录UnityInjector插件使用UnityInjector的游戏UnityInjector/目录基本配置步骤下载对应版本的安装包解压到游戏目录运行游戏一次生成默认配置文件修改配置文件设置语言和翻译服务关键配置项说明[Service] EndpointGoogleTranslate ; 选择翻译服务 [General] Languagezh-CN ; 目标语言中文 FromLanguageja ; 源语言日语 [Behaviour] MaxCharactersPerTranslation200 ; 每次翻译最大字符数 EnableUIResizingTrue ; 启用UI自动调整 主要功能详解翻译引擎选择XUnity Auto Translator支持多种翻译服务满足不同用户需求免费在线服务Google Translate最常用的免费翻译服务Bing Translate微软提供的翻译服务DeepL Translate翻译质量较高Papago Translate韩语翻译效果优秀认证API服务Google Cloud Translation API每月有免费额度DeepL API专业级翻译质量百度翻译API中文翻译优化Yandex Translate俄语翻译专家本地翻译软件ezTrans XP日语→韩语专业翻译LEC Power Translator 15离线翻译解决方案UI文本框架支持工具支持所有主流Unity文本渲染框架框架名称默认启用说明UGUI是Unity官方UI系统NGUI是流行的第三方UI系统TextMeshPro是现代文本渲染方案IMGUI否Unity旧版即时模式GUIFairyGUI是专业UI解决方案Utage是视觉小说游戏引擎智能文本处理正则表达式支持对于复杂的翻译场景可以使用正则表达式进行精确控制# 替换特定格式的文本 r:^アイテム ([0-9])$物品 $1 # 拆分复合文本分别翻译 sr:^([0-9]{2}) ([\S\s])$$1 $2翻译范围限定避免翻译冲突可以限定翻译只在特定场景生效#set level 1,2,3 # 只在场景1、2、3中生效 #set exe game1 # 只在game1.exe中生效 实用操作指南快捷键控制游戏运行时可以使用以下快捷键控制翻译功能快捷键功能说明ALT0打开/关闭设置界面ALT1切换翻译聚合器界面ALTT切换翻译显示状态ALTR重新加载翻译文件ALTU手动触发文本钩取ALTF切换字体覆盖如配置了OverrideFont性能优化建议启用批处理设置EnableBatchingTrue减少API调用次数合理设置字符限制MaxCharactersPerTranslation200平衡质量与性能使用静态翻译缓存UseStaticTranslationsTrue减少在线翻译需求选择性启用框架只启用游戏实际使用的文本框架常见问题解决翻译后游戏卡顿或崩溃尝试设置TextGetterCompatibilityModeTrue检查是否启用了过多的文本框架部分文本未被翻译确认对应的文本框架已启用尝试手动刷新ALTU触发手动钩取检查文本是否以特殊字符开头翻译质量不理想尝试不同的翻译引擎使用预处理器和后处理器优化文本添加自定义替换规则到_Substitutions.txt️ 高级配置与定制翻译文件管理翻译文件存储在Translation/{Language}/Text/目录中_AutoGeneratedTranslations.txt自动生成的翻译_Substitutions.txt文本替换规则_Preprocessors.txt翻译前处理规则_Postprocessors.txt翻译后处理规则字体与UI调整当翻译文本长度变化时UI可能需要调整[Behaviour] OverrideFont ; 覆盖UGUI字体 OverrideFontTextMeshPro ; 覆盖TextMeshPro字体 FallbackFontTextMeshPro ; TextMeshPro备用字体 ResizeUILineSpacingScale0.80 ; 行间距缩放比例纹理翻译功能从版本2.16.0开始支持纹理翻译[Texture] EnableTextureTranslationTrue TextureDirectoryTranslation\{Lang}\Texture EnableTextureDumpingFalse # 发布时务必设为False TextureHashGenerationStrategyFromImageName 项目结构与源码参考XUnity Auto Translator采用模块化设计主要源码结构核心插件模块src/XUnity.AutoTranslator.Plugin.Core/翻译引擎实现src/Translators/资源重定向模块src/XUnity.ResourceRedirector/插件适配器src/XUnity.AutoTranslator.Plugin.BepInEx/ 等开发者集成为模组添加翻译支持// 查询翻译 string originalText 獲得経験値; if(AutoTranslator.Default.TryTranslate(originalText, out string translation)) { // 使用翻译后的文本 textComponent.text translation; }避免翻译干扰// 在GameObject名称中包含XUAIGNORE gameObject.name MyUI_XUAIGNORE; // 或者使用XUAIGNORETREE忽略整个子树 parentObject.name UIRoot_XUAIGNORETREE; 调试与故障排除调试快捷键快捷键功能CTRLALTNP9模拟同步错误CTRLALTNP8模拟异步错误延迟1秒CTRLALTNP7打印场景名称和ID到控制台CTRLALTNP6输出完整GameObject层次结构到hierarchy.txt日志与监控启用调试日志查看详细运行信息[Debug] EnableConsoleTrue EnableLogTrue 最佳实践总结发布翻译模组注意事项包含翻译缓存分发时包含_AutoGeneratedTranslations.txt文件禁用调试功能确保EnableTextureDumpingFalse和OutputUntranslatableTextFalse测试稳定性启用日志检查游戏是否出现异常行为保持更新定期更新到最新版本性能优化配置[Behaviour] MaxCharactersPerTranslation200 EnableBatchingTrue UseStaticTranslationsTrue EnableUIResizingTrue [Texture] CacheTexturesInMemoryTrue TextureHashGenerationStrategyFromImageName 开始使用要开始使用XUnity Auto Translator只需从项目仓库克隆或下载最新版本git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator根据游戏环境选择对应的安装包按照安装说明配置游戏启动游戏并按ALT0打开设置界面配置翻译服务这款工具为Unity游戏玩家和开发者提供了强大的本地化支持无论是想要畅玩外语游戏的普通用户还是需要为游戏添加多语言支持的开发者都能从中受益。通过合理的配置和使用可以显著提升游戏的可访问性和用户体验。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考