如何用 XUnity AutoTranslator 一键汉化 Unity 游戏:从安装到精调的完整指南 如何用 XUnity AutoTranslator 一键汉化 Unity 游戏从安装到精调的完整指南【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator花了几十个小时玩一款日文 RPG剧情全靠手机拍照机翻那种体验相信不少玩家都经历过。XUnity AutoTranslator 正是为 Unity 游戏汉化这一场景而生的开源翻译插件它能实时拦截游戏内的文本调用在线翻译服务把日文、英文游戏文本即时替换成中文同时保留手动精翻的能力。本文将带你从零跑通一次完整的汉化流程再给出按场景抄作业的配置方案全程不需要任何编程基础。一、它到底能解决什么问题三类玩家的真实场景先别急着看安装步骤想清楚它适合谁能帮你省下大量试错时间。场景一日系 RPG / 视觉小说玩家剧情文本量大、对话密度高靠截图翻译效率极低。XUnity AutoTranslator 支持 UGUI、NGUI、TextMeshPro、IMGUI、FairyGUI 和 Utage 等主流文本框架绝大多数 Unity 游戏的对话、菜单、物品说明都能被自动抓取并翻译进游戏即可看到中文。场景二只想玩懂机制的轻度玩家不在意翻译质量只要大概能看懂。这类用户连注册翻译服务都嫌麻烦直接用内置的免费翻译端点即可。场景三想认真精翻某款游戏的玩家或汉化爱好者插件会把翻译结果自动写入翻译文件你可以手动修改、补充术语表甚至用正则和替换规则实现精准翻译——这正是它和其他一刀切机翻工具最大的区别。维度说明核心优势实时翻译 缓存机制 手动精翻 纹理图片替换四合一适用人群Unity 游戏玩家、视觉小说爱好者、轻度汉化作者不适合需要离线运行的场景、非 Unity 引擎游戏、对翻译延迟极敏感的竞技游戏一个重要的能力边界插件只负责翻译文本并写回游戏在线端点本身的稳定性由第三方服务决定免费端点随时可能失效。理解了这点后面排障就不会慌。二、零基础实战5 步让第一款游戏跑起中文以最常见的 BepInEx 安装方式为例全程约 10 分钟。以下是完整路径照着做就行。第 0 步确认游戏是 Unity 引擎在游戏目录里找到{游戏名}_Data文件夹部分游戏叫GameAssembly.dll对应的Managed目录存在即说明是 Unity 游戏可继续。第 1 步获取项目文件git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator提示源码仓库更适合学习和二次开发实际使用建议直接获取对应框架的发布包如XUnity.AutoTranslator-BepInEx-5.4.0.zip里面已包含运行所需的全部依赖。第 2 步安装 BepInEx 与插件本体先按 BepInEx 官方说明完成框架安装确保游戏目录出现BepInEx/文件夹将下载的 AutoTranslator 压缩包解压到游戏根目录使插件 dll 落入BepInEx/plugins/下最终结构类似BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.Core.dllBepInEx/plugins/XUnity.AutoTranslator/Translators/GoogleTranslate.dll第 3 步启动游戏生成配置文件首次启动游戏后插件会自动在BepInEx/config/下生成AutoTranslatorConfig.ini并在BepInEx/Translation/下创建翻译文件目录。这时先退出游戏开始改配置。第 4 步修改核心配置[General] Languagezh-CN ; 目标语言简体中文 FromLanguageja ; 源语言日语按游戏实际语言填写 [Service] EndpointGoogleTranslate ; 免费端点无需注册即可用 FallbackEndpoint ; 可留空或填 DeepLTranslate 做备用 [Behaviour] EnableUIResizingTrue ; 译文变长时自动调整 UI 溢出方式建议开启第 5 步启动验证重新启动游戏正常情况下对话和菜单文本会陆续变为中文。按下ALT T可以在原文和译文之间切换对照ALT 0可开关翻译界面。踩坑提醒如果某些文本没有翻译先按ALT U手动挂钩一次若仍无效多半是该文本框架默认关闭如 IMGUI、TextMesh去配置里把对应开关改为True。三、关键配置速查按场景抄作业的 3 套方案不用背参数对照你的需求选一套即可。方案 A免费快速尝鲜默认即用[Service] EndpointGoogleTranslate [Behaviour] MaxCharactersPerTranslation200 EnableBatchingTrue适合先确认插件在你的游戏上能跑通。Google 免费端点无需注册代价是偶尔不稳定。方案 B质量优先推荐 DeepL[Service] EndpointDeepLTranslate FallbackEndpointGoogleTranslate适合视觉小说、剧情类游戏。DeepL 的免费在线端点质量明显优于 Google配合FallbackEndpoint在失败时自动降级兼顾质量与稳定性。方案 C稳定与量足注册类端点[Service] EndpointBingTranslateLegitimate [BingLegitimate] OcpApimSubscriptionKey你的密钥适合长期汉化、文本量大的场景。Azure 文本翻译每月免费 200 万字符Google 云翻译提供一年 300 美元试用额度约 1500 万字符。注意这类端点需要先注册申请密钥且密钥不要外泄。提示MaxCharactersPerTranslation默认 200单条文本超过此长度会被忽略。对白越长翻译越慢调大需谨慎同时留意端点配额消耗。四、常见疑问与排障清单5 个高频问题问题 1游戏里只有部分文本被翻译了排查步骤按ALT U尝试手动挂钩 → 检查[TextFrameworks]中对应框架是否开启IMGUI、TextMesh 默认关闭→ 确认该文本不是纹理图片。 解决按需开启框架开关图片类文本参考第五节纹理翻译。问题 2中文显示成方块/乱码原因游戏自带字体不含中文字形这是汉化最常见的坑。 解决给 TextMeshPro 配置备用字体FallbackFontTextMeshPro或在[Behaviour]中设置OverrideFont仅 UGUI。可在src/XUnity.AutoTranslator.Plugin.Core/的 Fonts 目录查看字体处理相关实现。问题 3翻译后游戏逻辑异常比如选错选项、功能错乱原因部分游戏用当前显示的文本决定下一步逻辑。 解决将[Behaviour]中TextGetterCompatibilityMode设为True让游戏以为文本未被翻译。问题 4免费端点突然全部失败原因在线端点随时可能调整接口属正常现象。 解决切换其他端点或启用FallbackEndpoint若插件因连续错误自动关闭可在修复网络/更换节点后按ALT Q重启插件。问题 5想把机翻结果改成自己的翻译解决编辑BepInEx/Translation/zh-CN/Text/_AutoGeneratedTranslations.txt按原文译文格式修改保存后按ALT R立即重载无需重启游戏。该文件优先级最低新建的其他翻译文件优先级更高。五、进阶玩法从机翻走向精翻跑通机翻只是起点这个插件真正的价值在于人工可控的翻译管线。术语与专有名词修正在Translation/zh-CN/Text/_Substitutions.txt中加入替换规则翻译前先替换避免人名地名被反复翻错シンプルリングSimple Ring正则精准翻译标准正则对固定格式文本如物品名加编号非常有效r:^シンプルリング ([0-9])$Simple Ring $1分割正则sr:则能把组合文本拆开后分别翻译再拼回适合处理编号名称混排的界面。翻译作用域用#set level 1,2,3或#set exe game1,game2指令可以让特定翻译只在指定场景或指定 exe 下生效避免多游戏共用一个翻译目录时互相冲突需将EnableTranslationScoping设为True。纹理图片翻译在[Texture]中开启EnableTextureDumpingTrue可将游戏内图片导出到Translation/zh-CN/Texture/用任意图像工具修改后放回同名目录即可替换。注意该功能默认关闭且对性能有影响建议只在必要时开启。扩展翻译端点项目在src/Translators/下按服务商分目录组织翻译器实现如GoogleTranslate/、DeepLTranslate/、BaiduTranslate/。如果你有自己的翻译服务可通过CustomTranslate端点或实现ITranslateEndpoint接口接入核心逻辑位于src/XUnity.AutoTranslator.Plugin.Core/Endpoints/。此外项目还提供恋活Koikatsu专用模块src/XUnity.AutoTranslator.KoikatsuResources/可处理 Excel、TSV、剧本等资源文本相关游戏玩家可直接受益。六、下一步行动清单现在你已经掌握了从安装、配置到精调的全流程。接下来按这个顺序操作即可克隆仓库或下载对应框架的发布包BepInEx 版最省心完成 BepInEx 框架安装解压插件启动游戏生成配置按本文方案 A 验证翻译生效再切换到你偏好的端点遇到显示异常先查字体配置遇到漏翻先查文本框架开关有精力的话从_Substitutions.txt开始建立自己的术语表。XUnity AutoTranslator 最难得的地方在于它把实时机翻和人工精翻放在同一条流水线上让 Unity 游戏汉化从折腾变成了可以按步骤复现的操作。愿你今晚就能在游戏里看到熟悉的中文——汉化愉快。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考