如何5分钟翻译Unity游戏XUnity.AutoTranslator安装配置教程【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator因为语言问题玩不进去心爱的游戏XUnity.AutoTranslator 是一款面向 Unity 游戏的开源实时翻译插件它识别游戏内 UI、对话与菜单文本调用在线服务自动翻译也支持手动翻译和资源重定向。适合想玩未本地化 Unity 游戏的玩家也适合翻译组使用。先花一分钟搞懂这个插件到底在做什么简单说它是个挂在游戏里的翻译器。插件加载后会拦截游戏内各个文本框架UGUI、NGUI、TextMeshPro 等输出的文字查缓存、必要时请求在线翻译然后把译文写回显示组件。它的核心价值可以归纳成三点自动识别不用你逐行找文本UI、对话、菜单、弹窗都会被自动钩住并翻译。缓存优先翻译结果会写入本地文件并保存在内存同一句话只翻译一次第二次直接读缓存不重复消耗在线服务额度。可手动接管所有自动生成的译文都可以人工修改还能用替换规则、正则表达式、资源重定向做精细化处理从能玩升级到玩得好。三分钟准备环境要求速查装之前先花一分钟确认环境能省掉后面 90% 的排查时间。要求并不高绝大多数 Windows 上的 Unity 游戏都能满足项目要求操作系统Windows 10/11 64 位其他系统支持有限Unity 版本Unity 5.0 及以上插件管理器BepInEx 5.x / 6.x、MelonLoader、IPA 或 UnityInjector任选其一运行时.NET Framework 4.5BepInEx 安装包通常已自带网络自动翻译需要联网纯手动翻译可不联网注意自动翻译必然会把游戏文本发往在线翻译服务如果介意这一点可以安装后直接禁用在线端点只用手动翻译文件。一条流安装用 BepInEx 把翻译跑起来BepInEx 是覆盖游戏面最广的插件管理器也是官方推荐的方式所以下面以它为主线走一遍。先装好 BepInEx按 BepInEx 自己的说明安装到游戏目录这一步不做好后面全白搭。下载 BepInEx 版插件包从项目发布页拿XUnity.AutoTranslator-BepInEx-{版本号}.zipIL2CPP 编译的游戏要改用BepInEx-IL2CPP包。解压到游戏根目录让插件 dll 落入BepInEx/plugins/XUnity.AutoTranslator/公共库落入BepInEx/core/翻译 dll 在BepInEx/plugins/XUnity.AutoTranslator/Translators/。首次启动游戏等它生成配置文件和翻译目录首次加载会慢一点。抽查翻译效果进游戏看主菜单或对话是否变成目标语言如果部分文本没翻打开配置文件把默认禁用的文本框架如EnableIMGUI、EnableTextMesh改成True再试——这是官方在每种安装方式里都特别提醒的一步。备选方案没有插件管理器的游戏可用 ReiPatcher 独立包——解压XUnity.AutoTranslator-ReiPatcher-{版本号}.zip到游戏目录运行SetupReiPatcherAndAutoTranslator.exe后通过生成的快捷方式启动即可IL2CPP 游戏也可以选 MelonLoader放Mods/和UserLibs/、IPA放Plugins/或 UnityInjector放UnityInjector/。文件放错目录是最常见的安装事故拿不准就对照官方 README 里的目录清单核对一遍。首次配置改 2 处设置1 步验证配置文件在首次启动游戏后生成BepInEx 版位于BepInEx/config/目录文件名AutoTranslatorConfig.ini。真正必填的只有三处其余保持默认[Service] EndpointGoogleTranslate [General] Languagezh FromLanguagejaEndpoint翻译服务端点决定了谁来干翻译的活。Language/FromLanguage目标语言和源语言用语言代码源语言也支持auto多数场景不推荐。端点怎么选看你的取舍翻译服务需要密钥特点GoogleTranslate不需要开箱即用偶有不稳定BingTranslate不需要速度与稳定性均衡DeepLTranslate网页版免密钥Legitimate 版要 API Key质量口碑最好BaiduTranslate需要 AppId AppSecret中文场景优化有免费额度两个值得调的关键参数MaxCharactersPerTranslation默认 200上限 2500单条文本超过这个长度就直接跳过不翻译。长文本容易触发服务端点保护性关闭日常保持 200 最稳。TextGetterCompatibilityMode默认 False当游戏用屏幕上显示的文字去判断逻辑时比如按菜单文字做分支翻译后功能会异常这时把它设为True插件会对游戏装傻。如何确认翻译真的生效了游戏里按ALTT画面文本应该能在原文和译文之间切换改完手动翻译文件后按ALTR立即重载不用重启游戏。同时去翻译目录BepInEx 版在BepInEx/Translation/{Lang}/Text/确认出现了_AutoGeneratedTranslations.txt里面有持续追加的记录就说明整个链路是通的。提醒如果你用了需要密钥的服务DeepL、Baidu、Watson 等密钥只填在自己的配置里切勿分享或随汉化包分发。常见问题速查3 个高频故障与解法装完不出翻译、装了反而把游戏弄崩基本逃不出下面三种情况症状最可能的原因解决办法插件完全没加载日志里没有 XUnity 相关记录文件没放进正确目录BepInEx 版本与插件不匹配缺少依赖 dll对照 README 的文件结构清单逐项核对换用与你 BepInEx 版本对应的插件包IL2CPP 游戏确认用的是-IL2CPP包插件已加载但游戏文本还是原文网络不通或翻译端点报错对应文本框架默认被禁用检查网络按ALT0打开翻译聚合窗口看端点状态把[TextFrameworks]下相关项如EnableIMGUI设为True翻译后部分游戏功能/逻辑失效游戏依赖屏幕文本做逻辑判断设TextGetterCompatibilityModeTrue仍异常时尝试禁用 IMGUI 钩子EnableIMGUIFalse进阶调优用顺了之后值得知道的 4 件事1. 手动翻译 正则 替换规则。自动译文不满意就直接改_AutoGeneratedTranslations.txt或在Translation目录新建 txt 覆盖优先级更高。_Substitutions.txt适合固定术语人名、道具名统一替换翻译文件还支持正则比如r:^シンプルリング ([0-9])$Simple Ring $1注意正则不能写在以下划线开头的自动生成文件里。2. 字体与 UI 自适应。中文常出现字体缺字UGUI 用OverrideFont指定自己的字体TextMeshPro 推荐FallbackFontTextMeshPro加回退字体EnableUIResizingTrue让插件自动放宽文本组件的溢出限制译文过长时也不容易截断。3. 给翻译请求上刹车。插件自带一整套防刷机制等待文本稳定 1 秒再发请求、单连接复用、会话请求上限等你只需要保持EnableBatchingTrue和UseStaticTranslationsTrue让批处理与内置词库生效即可。如果要把汉化包分发给别人MaxCharactersPerTranslation不要设超过 400并附上尽可能全的自动生成翻译文件。4. 图片与资源重定向。游戏里的图片 UI 可以通过[Texture]一节开启纹理替换EnableTextureTranslation文本资源则能用资源重定向模块直接覆盖配合PreferredStoragePath指定存放位置。这块功能默认关闭按需开启即可。想深入看各翻译端点的实现可以参考 src/Translators/ 目录核心插件逻辑在 src/XUnity.AutoTranslator.Plugin.Core/。收尾XUnity.AutoTranslator 把Unity 游戏翻译拆成了装、配、调三步装 BepInEx 解压插件包改三行配置再按ALTT确认生效全程不超过五分钟。剩下的正则、字体、资源重定向都是可选的加分项遇到具体问题再查速查表即可。按 BepInEx 方式装好插件并首次启动生成配置文件设好Endpoint、Language、FromLanguage按ALTT验证翻译生效把没翻的文本框架开关打开手动修正不满意的译文需要分发汉化包时附上完整翻译缓存并保留密钥不外泄【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考