如何用XUnity.AutoTranslator轻松实现Unity游戏实时翻译:完整指南
如何用XUnity.AutoTranslator轻松实现Unity游戏实时翻译完整指南【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity.AutoTranslator是一款强大的Unity游戏实时翻译插件能够自动翻译游戏中的文本内容同时提供手动翻译所需的工具。无论你是想玩日文游戏但不懂日语还是想为游戏制作本地化MOD这款插件都是你的理想选择。它支持多种翻译服务和插件框架为玩家提供了便捷的游戏本地化体验。 快速上手5分钟安装指南XUnity.AutoTranslator支持多种安装方式新手推荐使用BepInEx框架老手可以选择独立安装。安装方式对比安装方式适合人群依赖要求推荐度BepInEx插件大多数用户需要先安装BepInEx⭐⭐⭐⭐⭐独立安装(ReiPatcher)不想装插件管理器的用户无额外依赖⭐⭐⭐⭐MelonLoader插件MelonLoader用户需要MelonLoader⭐⭐⭐IPA插件IPA用户需要IPA⭐⭐UnityInjector插件UnityInjector用户需要UnityInjector⭐BepInEx安装步骤推荐下载插件从发布页面下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip解压文件直接解压到游戏根目录确保DLL文件放在BepInEx文件夹中启动游戏运行游戏插件会自动创建配置文件配置翻译服务在BepInEx/config/AutoTranslatorConfig.ini中设置翻译端点文件结构应如下所示游戏目录/ ├── BepInEx/ │ ├── core/ │ │ └── XUnity.Common.dll │ ├── plugins/ │ │ └── XUnity.AutoTranslator/ │ │ ├── XUnity.AutoTranslator.Plugin.Core.dll │ │ ├── XUnity.AutoTranslator.Plugin.BepInEx.dll │ │ ├── XUnity.AutoTranslator.Plugin.ExtProtocol.dll │ │ ├── ExIni.dll │ │ └── Translators/ │ │ └── GoogleTranslate.dll │ └── Translation/ │ └── Text/ │ └── _AutoGeneratedTranslations.txt独立安装步骤无需插件管理器对于不想安装插件管理器的用户独立安装是最简单的选择下载XUnity.AutoTranslator-ReiPatcher-{VERSION}.zip解压到游戏目录确保SetupReiPatcherAndAutoTranslator.exe与其他可执行文件放在一起运行SetupReiPatcherAndAutoTranslator.exe设置ReiPatcher运行创建的快捷方式启动游戏 核心功能详解支持的文本框架XUnity.AutoTranslator支持几乎所有Unity文本框架UGUI- Unity的标准UI系统NGUI- 流行的第三方UI系统TextMeshPro- 现代文本渲染系统IMGUI- Unity的即时模式GUI默认禁用TextMesh- 3D空间中的文本默认禁用FairyGUI for Unity- 流行的UI框架Utage- 视觉小说游戏引擎快捷键操作插件提供了一系列快捷键让翻译控制更加便捷快捷键功能描述ALT 0切换XUnity AutoTranslator UI界面ALT 1切换翻译聚合器UIALT T在所有文本的翻译和未翻译版本之间切换ALT R重新加载翻译文件修改翻译后立即生效ALT U手动挂钩文本组件ALT F在覆盖字体和默认字体之间切换ALT Q重启插件在连续错误导致关闭时使用 翻译服务选择内置翻译器XUnity.AutoTranslator支持多种翻译服务满足不同用户需求免费翻译服务无需API密钥GoogleTranslate- 基于在线Google翻译稳定但可能受限GoogleTranslateV2- 新版Google翻译API正在测试中BingTranslate- 基于Bing翻译服务DeepLTranslate- DeepL翻译质量出色PapagoTranslate- Naver的Papago翻译服务付费翻译服务需要API密钥GoogleTranslateLegitimate- Google Cloud翻译API首年$300额度BingTranslateLegitimate- Azure文本翻译每月200万字符免费DeepLLegitimate- DeepL API每月50万字符免费BaiduTranslate- 百度翻译API每月5万字符免费YandexTranslate- Yandex翻译每天100万字符免费本地翻译软件LecPowerTranslator15- 需要安装LEC Power Translator软件ezTrans XP- 日韩翻译软件需要安装ezTrans XP和Ehnd配置翻译端点在配置文件中简单设置即可切换翻译服务[Service] EndpointGoogleTranslate ; 使用的翻译端点 FallbackEndpoint ; 主端点失败时的备用端点 [General] Languageen ; 目标语言如en、zh、ja FromLanguageja ; 源语言游戏原始语言⚙️ 高级配置技巧性能优化设置[Behaviour] MaxCharactersPerTranslation200 ; 每次翻译的最大字符数 EnableBatchingTrue ; 启用翻译批处理 UseStaticTranslationsTrue ; 使用内置静态翻译缓存 CacheRegexLookupsFalse ; 缓存正则表达式查找结果UI调整配置[TextFrameworks] EnableUGUITrue ; 启用UGUI翻译 EnableTextMeshProTrue ; 启用TextMeshPro翻译 EnableIMGUIFalse ; 禁用IMGUI翻译默认 [Behaviour] EnableUIResizingTrue ; 启用UI自动调整大小 OverrideFont ; 覆盖UGUI字体 FallbackFontTextMeshPro ; TextMeshPro备用字体纹理翻译设置[Texture] EnableTextureTranslationFalse ; 启用纹理翻译 EnableTextureDumpingFalse ; 启用纹理转储性能影响大 TextureDirectoryTranslation\{Lang}\Texture ; 纹理目录 TextureHashGenerationStrategyFromImageName ; 纹理哈希生成策略 文件结构与翻译管理翻译文件组织Translation/ └── en/ ; 目标语言目录 ├── Text/ │ ├── _AutoGeneratedTranslations.txt ; 自动生成的翻译 │ ├── _Substitutions.txt ; 替换规则 │ ├── _Preprocessors.txt ; 预处理规则 │ ├── _Postprocessors.txt ; 后处理规则 │ └── manual_translations.txt ; 手动翻译 └── Texture/ ; 纹理翻译目录手动翻译管理编辑自动生成的翻译修改_AutoGeneratedTranslations.txt文件中的翻译按ALTR重新加载翻译立即生效创建手动翻译文件在Translation/{Lang}/Text/目录中创建新的.txt文件从_AutoGeneratedTranslations.txt复制需要手动翻译的内容插件会优先使用手动翻译文件中的内容使用正则表达式r:^物品 ([0-9])$Item $1 sr:^([0-9]{2}) ([\S\s])$$1 $2 常见问题与解决方案问题解决方案游戏在应用翻译后停止工作设置TextGetterCompatibilityModeTrue某些文本没有被翻译1. 检查文本框架是否启用2. 按ALTU手动挂钩3. 启用IMGUI翻译如果来自其他MOD翻译质量不佳1. 调整IgnoreWhitespaceInDialogue设置2. 使用预处理/后处理文件3. 尝试不同的翻译服务内存占用过高1. 禁用纹理缓存CacheTexturesInMemoryFalse2. 减少MaxCharactersPerTranslation值3. 关闭不需要的文本框架翻译速度慢1. 启用EnableBatchingTrue2. 使用本地翻译软件3. 增加静态翻译缓存字体显示异常1. 设置合适的OverrideFont2. 调整ResizeUILineSpacingScale3. 使用FallbackFontTextMeshPro调试技巧启用控制台输出[Debug] EnableConsoleTrue EnableLogTrue使用调试快捷键CTRL ALT NP7打印加载的场景名称和IDCTRL ALT NP6将GameObject层次结构输出到文件检查翻译缓存查看_AutoGeneratedTranslations.txt文件检查是否有重复或冲突的翻译条目️ 高级功能插件特定翻译为特定插件创建专用翻译在Translation/{Lang}/Text/Plugins/目录中创建插件名称的文件夹在文件夹中创建翻译文件添加#enable fallback指令以启用回退到通用翻译翻译范围限定使用指令限定翻译应用范围#set level 1,2,3 ; 仅在这些场景中应用翻译 #set exe game1,game2 ; 仅在这些可执行文件中应用翻译 #set required-resolution height 1280 width 720 ; 分辨率要求UI字体调整创建resizer.txt文件控制字体大小CharaCustom/CustomControl/CanvasDrawChangeFontSizeByPercentage(0.5) UI/Menu/TextAutoResize(true, 12, 36) 重新分发指南如果你要为特定游戏重新分发XUnity.AutoTranslator✅应该做的包含尽可能多的预翻译内容在_AutoGeneratedTranslations.txt中使用默认的GoogleTranslate作为端点启用日志测试游戏行为保持插件版本最新❌不应该做的使用非默认翻译端点配置如DeepLTranslate启用EnableTextureDumpingTrue启用OutputUntranslatableTextTrue设置MaxCharactersPerTranslation超过400 最佳实践建议游戏翻译工作流初始设置阶段使用默认配置启动游戏让插件自动生成翻译缓存检查哪些文本框架需要启用翻译优化阶段编辑_AutoGeneratedTranslations.txt修正错误翻译创建替换规则文件处理专有名词配置UI调整确保文本显示正常最终发布阶段禁用所有调试选项验证翻译文件完整性测试所有游戏功能是否正常性能优化技巧对于大型游戏启用EnableBatchingTrue减少API调用使用UseStaticTranslationsTrue利用内置缓存适当调整MaxCharactersPerTranslation避免过长文本禁用不需要的文本框架减少开销兼容性注意事项IL2CPP游戏支持有限可能需要额外插件某些游戏可能需要TextGetterCompatibilityModeTrue旧版Unity游戏可能需要EnableLegacyTextureLoadingTrue使用MonoMod钩子解决特殊方法挂钩问题 相关资源与下一步官方文档与源码核心插件源码src/XUnity.AutoTranslator.Plugin.Core/翻译器实现src/Translators/BepInEx适配src/XUnity.AutoTranslator.Plugin.BepInEx/资源重定向器src/XUnity.ResourceRedirector/社区资源查看CHANGELOG.md了解版本更新参考README.md获取详细技术文档访问项目仓库获取最新版本和问题反馈下一步行动建议新手用户从BepInEx安装开始使用默认配置体验基本功能进阶用户尝试不同的翻译服务优化配置参数MOD制作者学习插件API为特定游戏创建优化配置开发者查看源码实现自定义翻译器或资源重定向器XUnity.AutoTranslator为Unity游戏本地化提供了完整的解决方案无论你是普通玩家想要游玩外语游戏还是MOD制作者想要创建本地化补丁这个工具都能满足你的需求。通过合理的配置和使用你可以获得流畅的游戏翻译体验。记住好的翻译需要耐心和调整。从简单的配置开始逐步优化你会发现这个插件的强大之处。祝你游戏愉快【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考