5 分钟上手 XUnity.AutoTranslatorUnity 游戏自动翻译插件的完整配置指南【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator上个周末我下载了一款心心念念的日系 RPG结果开场十分钟就卡住了——女主角站在樱花树下说了三句话我只认得出其中两个汉字。相信不少玩家都经历过这种游戏在手、剧情全靠猜的尴尬时刻。如果你也在为 Unity 游戏的语言障碍发愁或者正想给自己的游戏加上多语言支持却不知从何下手那么 XUnity.AutoTranslator 这个开源翻译插件很可能就是你要找的答案。这篇文章会从零开始带你搞懂它是怎么工作的、怎么装、怎么配以及遇到问题时该怎么排查。全程不需要你有编程基础跟着操作就能跑起来。先聊清楚它到底帮我们干了什么简单说XUnity.AutoTranslator 是一个运行在游戏内部的实时翻译引擎。它不像传统汉化补丁那样需要你手动替换文件而是在游戏启动后自动接住每一段要显示的文字翻译完再送回去。你看到的体验就是游戏还是那个游戏但文字悄悄变成了你熟悉的语言。它最打动我的三点不挑游戏只要是 Unity 引擎做的游戏理论上都能用不需要游戏作者专门留接口。不挑框架BepInEx、MelonLoader、IPA、UnityInjector 这些主流 Mod 加载器它都支持甚至能独立运行。不挑翻译源Google、Bing、DeepL、百度、Papago 等十几家翻译服务随意切换还有离线方案。换句话说它把文本捕获、翻译请求、结果缓存、界面适配这一整条链路都替你打通了你要做的只是选一个翻译源然后开始玩。它是怎么接住游戏文字的理解原理能帮你少踩很多坑。XUnity.AutoTranslator 的核心思路可以拆成四个环节拦截通过动态钩子技术在游戏渲染文字的那一刻截获内容无论是 UGUI、TextMeshPro 还是 NGUI 都覆盖到了。翻译把截获的文本打包发给翻译服务拿到结果后回填。记忆每次翻译结果都会存进本地缓存文件同一句话第二次出现时直接读缓存不再重复请求网络。适配自动处理字体缺失、UI 溢出、富文本标签这些翻译后遗症。想深入看拦截逻辑的可以直接翻源码里的 src/XUnity.AutoTranslator.Plugin.Core/ 目录翻译端点的实现都在 src/XUnity.AutoTranslator.Plugin.Core/Endpoints/ 下面。3 步完成安装选对版本就成功了一半安装这一步80% 的报错都来自版本和你的游戏环境不匹配。动手前先确认两件事你的游戏用的是什么 Mod 加载器以及它的版本号。第 1 步确认环境你的游戏环境选择安装包装了 BepInEx 5 或 6XUnity.AutoTranslator-BepInEx 版本用 MelonLoader 启动XUnity.AutoTranslator-MelonMod 版本特定游戏社区常用的 IPAXUnity.AutoTranslator-IPA 版本什么都没装想图省事通过 ReiPatcher 独立安装第 2 步放进正确的位置以最常见的 BepInEx 环境为例把下载好的压缩包解压后将plugins目录里的文件放进游戏根目录对应的BepInEx/plugins文件夹确保 DLL 文件就位即可。第 3 步启动一次游戏首次启动时插件会在游戏目录下自动生成AutoTranslatorConfig.ini配置文件同时建好翻译缓存目录。看到这些文件出现就说明安装成功了。整个流程走下来通常不超过五分钟这也是我最喜欢它的地方——先跑起来再慢慢调。第一次启动后这几项配置强烈建议改一改打开生成的AutoTranslatorConfig.ini你会看到按段落分好的配置项。新手不需要全部看懂重点改下面这几个就够用了[Service] EndpointGoogleTranslate FallbackEndpointBingTranslate [General] Languagezh FromLanguageja [Behaviour] MaxCharactersPerTranslation200 EnableUIResizingTrue对照着解释一下Endpoint / FallbackEndpoint主翻译源和备用翻译源。主源挂了或超时插件会自动切到备用源这条配置能救你很多次。Language / FromLanguage目标语言和源语言。日语游戏汉化就填zh和ja不确定原文语言时FromLanguage 可以填auto让插件自动判断。MaxCharactersPerTranslation单次翻译的最大字符数。调低一点响应更快调高一点长句翻译更完整。EnableUIResizing强烈建议保持开启它能自动缩小或换行避免翻译后的长文本把 UI 撑破。改完保存重启游戏翻译就会开始生效。进阶技巧这几招让翻译体验直接翻倍基础能用之后下面几个技巧可以明显提升翻译质量和流畅度。技巧一用静态翻译文件锁住高频文本游戏里的菜单、物品名、技能名这类高频文本每次都走在线翻译又慢又容易不稳定。你可以在翻译目录下放置静态翻译文件把固定翻译结果写进去插件会优先读取命中就直接显示完全不发网络请求。对强迫症玩家来说这也是统一术语的最佳方式。技巧二用正则规则处理模板化文本像HP 120/500、LV 12这种带数字和格式的文本直接翻译常常会把数字搞乱。这时可以写替换规则把固定部分剥离开r:(\d)\s*/\s*(\d)$1 / $2 sr:LV\.?\s*(\d)等级 $1r:开头表示普通替换sr:开头表示先翻译再替换。正则这块建议先用小样本试跑确认无误再批量启用。技巧三处理特殊字符与富文本游戏文本里经常夹杂[colorred]、b这类样式标签。翻译时如果不处理标签会被打散导致显示错乱。你可以在[Behaviour]下配置富文本的保留策略让标签原样保留、只翻译里面的文字内容这是翻译后 UI 变乱码问题的最常见解法。技巧四开启批处理翻译快一个量级把EnableBatching打开插件会把一小段时间内收集到的多条文本合并成一次请求发给翻译服务。网络开销大幅下降卡顿感会小很多尤其适合文本密集的剧情游戏。新手高频疑问这些问题我当年都踩过Q1装好了但游戏里一个字都没翻译先检查版本是否匹配——BepInEx 5 和 6 的插件不通用。再看游戏根目录有没有生成配置文件如果没有说明插件压根没被加载通常是放置位置不对。Q2大部分文本翻译了个别地方还是原文优先检查[TextFrameworks]段落看看对应的文本渲染框架UGUI、TextMeshPro 等有没有被启用。有些游戏混用多种框架漏掉一个就会漏掉一片文本。Q3翻译后按钮文字显示不全、UI 错位这是字体和排版问题。可以试试配置OverrideFont指向一个支持目标语言字符集的字体文件同时确认EnableUIResizing处于开启状态。Q4翻译质量忽高忽低免费翻译源质量波动是正常的。可以在[Service]里换一个主端点对比效果或者接入需要密钥的专业服务比如在 DeepL 的配置段里填上你的 AuthKey质量会稳定不少。Q5重启游戏后翻译缓存还在吗在的。所有翻译结果会持久化保存随着游戏时长增加你的本地缓存会越来越厚在线请求会越来越少速度也会越来越快。玩出花它还能对接你自己的翻译服务如果你觉得内置翻译源不够用XUnity.AutoTranslator 留了很开放的扩展口子。方案一接入本地或第三方程序通过扩展协议你可以让插件把文本交给任意一个独立程序去处理比如本地的 Ollama 大模型、自建的翻译服务甚至是公司内部的专用翻译工具。相关实现参考 src/XUnity.AutoTranslator.Plugin.ExtProtocol/ 和 src/Translators/Common.ExtProtocol/。方案二自己写一个翻译端点如果你会一点 C#可以直接实现ITranslator接口把任意在线 API 包装成插件认识的翻译源。翻译端点的完整示例都集中在 src/Translators/ 目录下照着现有实现改是最快的入门方式。方案三用翻译目录组织多 Mod 协作在翻译目录下按Plugins/{Mod名}/建子目录就能为不同 Mod 单独维护翻译文件配合优先级指令可以控制加载顺序。多个翻译 Mod 同时工作时这个结构能帮你把资源整理得明明白白。写在最后现在就去装一个试试回头看XUnity.AutoTranslator 给我的感受是它把给游戏做翻译这件事从一项技术活变成了一次十分钟就能完成的配置。你不需要懂钩子、不需要懂正则、甚至不需要理解缓存机制——装上、改两行配置、开玩仅此而已。如果你手头正好有一款因为语言问题而吃灰的 Unity 游戏不妨现在就去给它装上 XUnity.AutoTranslator。如果遇到环境相关的坑大概率是版本匹配问题回到上面3 步安装那节对照一遍就能解决。如果你想自己动手改点东西仓库地址是https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator把整个项目 clone 下来从 src/Translators/ 里挑一个最简单的翻译端点源码读起你会很快发现为游戏世界添一座语言的桥并没有想象中那么难。祝你玩得开心也译得顺畅【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 5 分钟上手 XUnity.AutoTranslator：Unity 游戏自动翻译插件的完整配置指南
5 分钟上手 XUnity.AutoTranslatorUnity 游戏自动翻译插件的完整配置指南【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator上个周末我下载了一款心心念念的日系 RPG结果开场十分钟就卡住了——女主角站在樱花树下说了三句话我只认得出其中两个汉字。相信不少玩家都经历过这种游戏在手、剧情全靠猜的尴尬时刻。如果你也在为 Unity 游戏的语言障碍发愁或者正想给自己的游戏加上多语言支持却不知从何下手那么 XUnity.AutoTranslator 这个开源翻译插件很可能就是你要找的答案。这篇文章会从零开始带你搞懂它是怎么工作的、怎么装、怎么配以及遇到问题时该怎么排查。全程不需要你有编程基础跟着操作就能跑起来。先聊清楚它到底帮我们干了什么简单说XUnity.AutoTranslator 是一个运行在游戏内部的实时翻译引擎。它不像传统汉化补丁那样需要你手动替换文件而是在游戏启动后自动接住每一段要显示的文字翻译完再送回去。你看到的体验就是游戏还是那个游戏但文字悄悄变成了你熟悉的语言。它最打动我的三点不挑游戏只要是 Unity 引擎做的游戏理论上都能用不需要游戏作者专门留接口。不挑框架BepInEx、MelonLoader、IPA、UnityInjector 这些主流 Mod 加载器它都支持甚至能独立运行。不挑翻译源Google、Bing、DeepL、百度、Papago 等十几家翻译服务随意切换还有离线方案。换句话说它把文本捕获、翻译请求、结果缓存、界面适配这一整条链路都替你打通了你要做的只是选一个翻译源然后开始玩。它是怎么接住游戏文字的理解原理能帮你少踩很多坑。XUnity.AutoTranslator 的核心思路可以拆成四个环节拦截通过动态钩子技术在游戏渲染文字的那一刻截获内容无论是 UGUI、TextMeshPro 还是 NGUI 都覆盖到了。翻译把截获的文本打包发给翻译服务拿到结果后回填。记忆每次翻译结果都会存进本地缓存文件同一句话第二次出现时直接读缓存不再重复请求网络。适配自动处理字体缺失、UI 溢出、富文本标签这些翻译后遗症。想深入看拦截逻辑的可以直接翻源码里的 src/XUnity.AutoTranslator.Plugin.Core/ 目录翻译端点的实现都在 src/XUnity.AutoTranslator.Plugin.Core/Endpoints/ 下面。3 步完成安装选对版本就成功了一半安装这一步80% 的报错都来自版本和你的游戏环境不匹配。动手前先确认两件事你的游戏用的是什么 Mod 加载器以及它的版本号。第 1 步确认环境你的游戏环境选择安装包装了 BepInEx 5 或 6XUnity.AutoTranslator-BepInEx 版本用 MelonLoader 启动XUnity.AutoTranslator-MelonMod 版本特定游戏社区常用的 IPAXUnity.AutoTranslator-IPA 版本什么都没装想图省事通过 ReiPatcher 独立安装第 2 步放进正确的位置以最常见的 BepInEx 环境为例把下载好的压缩包解压后将plugins目录里的文件放进游戏根目录对应的BepInEx/plugins文件夹确保 DLL 文件就位即可。第 3 步启动一次游戏首次启动时插件会在游戏目录下自动生成AutoTranslatorConfig.ini配置文件同时建好翻译缓存目录。看到这些文件出现就说明安装成功了。整个流程走下来通常不超过五分钟这也是我最喜欢它的地方——先跑起来再慢慢调。第一次启动后这几项配置强烈建议改一改打开生成的AutoTranslatorConfig.ini你会看到按段落分好的配置项。新手不需要全部看懂重点改下面这几个就够用了[Service] EndpointGoogleTranslate FallbackEndpointBingTranslate [General] Languagezh FromLanguageja [Behaviour] MaxCharactersPerTranslation200 EnableUIResizingTrue对照着解释一下Endpoint / FallbackEndpoint主翻译源和备用翻译源。主源挂了或超时插件会自动切到备用源这条配置能救你很多次。Language / FromLanguage目标语言和源语言。日语游戏汉化就填zh和ja不确定原文语言时FromLanguage 可以填auto让插件自动判断。MaxCharactersPerTranslation单次翻译的最大字符数。调低一点响应更快调高一点长句翻译更完整。EnableUIResizing强烈建议保持开启它能自动缩小或换行避免翻译后的长文本把 UI 撑破。改完保存重启游戏翻译就会开始生效。进阶技巧这几招让翻译体验直接翻倍基础能用之后下面几个技巧可以明显提升翻译质量和流畅度。技巧一用静态翻译文件锁住高频文本游戏里的菜单、物品名、技能名这类高频文本每次都走在线翻译又慢又容易不稳定。你可以在翻译目录下放置静态翻译文件把固定翻译结果写进去插件会优先读取命中就直接显示完全不发网络请求。对强迫症玩家来说这也是统一术语的最佳方式。技巧二用正则规则处理模板化文本像HP 120/500、LV 12这种带数字和格式的文本直接翻译常常会把数字搞乱。这时可以写替换规则把固定部分剥离开r:(\d)\s*/\s*(\d)$1 / $2 sr:LV\.?\s*(\d)等级 $1r:开头表示普通替换sr:开头表示先翻译再替换。正则这块建议先用小样本试跑确认无误再批量启用。技巧三处理特殊字符与富文本游戏文本里经常夹杂[colorred]、b这类样式标签。翻译时如果不处理标签会被打散导致显示错乱。你可以在[Behaviour]下配置富文本的保留策略让标签原样保留、只翻译里面的文字内容这是翻译后 UI 变乱码问题的最常见解法。技巧四开启批处理翻译快一个量级把EnableBatching打开插件会把一小段时间内收集到的多条文本合并成一次请求发给翻译服务。网络开销大幅下降卡顿感会小很多尤其适合文本密集的剧情游戏。新手高频疑问这些问题我当年都踩过Q1装好了但游戏里一个字都没翻译先检查版本是否匹配——BepInEx 5 和 6 的插件不通用。再看游戏根目录有没有生成配置文件如果没有说明插件压根没被加载通常是放置位置不对。Q2大部分文本翻译了个别地方还是原文优先检查[TextFrameworks]段落看看对应的文本渲染框架UGUI、TextMeshPro 等有没有被启用。有些游戏混用多种框架漏掉一个就会漏掉一片文本。Q3翻译后按钮文字显示不全、UI 错位这是字体和排版问题。可以试试配置OverrideFont指向一个支持目标语言字符集的字体文件同时确认EnableUIResizing处于开启状态。Q4翻译质量忽高忽低免费翻译源质量波动是正常的。可以在[Service]里换一个主端点对比效果或者接入需要密钥的专业服务比如在 DeepL 的配置段里填上你的 AuthKey质量会稳定不少。Q5重启游戏后翻译缓存还在吗在的。所有翻译结果会持久化保存随着游戏时长增加你的本地缓存会越来越厚在线请求会越来越少速度也会越来越快。玩出花它还能对接你自己的翻译服务如果你觉得内置翻译源不够用XUnity.AutoTranslator 留了很开放的扩展口子。方案一接入本地或第三方程序通过扩展协议你可以让插件把文本交给任意一个独立程序去处理比如本地的 Ollama 大模型、自建的翻译服务甚至是公司内部的专用翻译工具。相关实现参考 src/XUnity.AutoTranslator.Plugin.ExtProtocol/ 和 src/Translators/Common.ExtProtocol/。方案二自己写一个翻译端点如果你会一点 C#可以直接实现ITranslator接口把任意在线 API 包装成插件认识的翻译源。翻译端点的完整示例都集中在 src/Translators/ 目录下照着现有实现改是最快的入门方式。方案三用翻译目录组织多 Mod 协作在翻译目录下按Plugins/{Mod名}/建子目录就能为不同 Mod 单独维护翻译文件配合优先级指令可以控制加载顺序。多个翻译 Mod 同时工作时这个结构能帮你把资源整理得明明白白。写在最后现在就去装一个试试回头看XUnity.AutoTranslator 给我的感受是它把给游戏做翻译这件事从一项技术活变成了一次十分钟就能完成的配置。你不需要懂钩子、不需要懂正则、甚至不需要理解缓存机制——装上、改两行配置、开玩仅此而已。如果你手头正好有一款因为语言问题而吃灰的 Unity 游戏不妨现在就去给它装上 XUnity.AutoTranslator。如果遇到环境相关的坑大概率是版本匹配问题回到上面3 步安装那节对照一遍就能解决。如果你想自己动手改点东西仓库地址是https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator把整个项目 clone 下来从 src/Translators/ 里挑一个最简单的翻译端点源码读起你会很快发现为游戏世界添一座语言的桥并没有想象中那么难。祝你玩得开心也译得顺畅【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考