XUnity AutoTranslator 实战指南五步装好 Unity 游戏实时翻译插件附 4 个高频坑的处理办法【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity AutoTranslator 是一个面向 Unity 游戏的自动翻译插件它会在游戏运行中拦截各界面文本调用你选定的在线翻译引擎实时翻译并把结果缓存下来。除了自动翻译它还提供了完整的半自动汉化工具链手动翻译文件、正则规则、UI 字体缩放和贴图替换。这个插件适配 BepInEx官方推荐、MelonLoader、IPA、UnityInjector 四种主流 Mod 加载框架也提供无需任何框架的独立安装方式内置 16 种翻译端点Google、Bing、DeepL、Papago、百度等并支持自行编写翻译端点。适合两类人想立刻玩日文/英文 Unity 游戏的玩家以及想给游戏做民间汉化的开发者。 能力总览它具体能帮你做什么实时自动翻译运行时钩取游戏文本组件发现新文本先等 1 秒确认其不再变化再发请求翻译全程最多 1 个并发请求、单会话最多 8000 次请求。双重缓存所有翻译结果同时存内存和磁盘Translation\{Lang}\Text\下的文本文件同一文本永远不会翻译第二次。多端点可切换配置文件里改一行Endpoint就能换引擎配了FallbackEndpoint时主引擎单条翻译失败会自动降级。手动翻译覆盖插件会读取Translation目录下所有.txt文件也支持打包成.zip你手写的翻译优先级高于自动翻译结果。正则翻译规则支持标准正则r:和分割正则sr:用一条规则覆盖一类带编号、带数值的文本。UI 适配自动调整文本组件的溢出参数防止译文被裁切还可以用resizer.txt按 GameObject 路径精确改字号、行距、对齐。多文本框架支持 UGUI、NGUI、IMGUI、TextMeshPro、TextMesh、FairyGUI、Utage其中 IMGUI 和 TextMesh 默认关闭。贴图替换可把游戏内贴图导出到本地目录再用你改过的图替换回去默认关闭无自动翻译适合汉化 UI 图。 快速上手按游戏插件框架选择安装方式先确认你的游戏用了哪种 Mod 框架再选对应安装包。注意如果游戏已经装了插件管理器不要用独立ReiPatcher方式两者同时存在会出问题。安装方式前提条件插件解压位置适用场景BepInEx推荐已装 BepInEx直接解压到游戏根目录DLL 落入BepInEx/plugins/Mono 游戏的首选MelonLoader已装 MelonLoader直接解压到游戏根目录DLL 分别落入Mods/和UserLibs/MelonLoader 游戏IPA已装 IPA直接解压到游戏根目录DLL 落入Plugins/仅支持 IPA 的游戏UnityInjector已装 UnityInjector解压到UnityInjector/目录不一定是游戏根目录无 Mono 环境的老游戏独立安装ReiPatcher无安装包自带 ReiPatcher解压到游戏根目录后运行SetupReiPatcherAndAutoTranslator.exe游戏什么框架都没有以最常用的 BepInEx 方式为例最小路径是三步从 releases 下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip直接解压到游戏根目录。启动游戏首次启动会在BepInEx/config/下自动生成配置文件并在BepInEx/Translation/下生成翻译目录。按ALT0调出插件界面能正常打开并看到端点选择说明装好了再按ALTT在译文和原文之间切换确认文本真的被替换了。如果游戏是 IL2CPP 构建要用BepInEx-IL2CPP或MelonMod-IL2CPP安装包前者需要 BepInEx 6 的 IL2CPP 版本但 IL2CPP 支持并不完整部分文本变化检测不到、IMGUI 翻译和 TextGetterCompatibilityMode 均不支持遇到漏翻可用ALTU手动触发一次查找。⚙️ 配置要点上手必须改的几个参数配置文件默认生成的关键项如下加注释的都是你需要动手的地方[Service] EndpointGoogleTranslate ; 默认 GoogleTranslate免费但不稳定 FallbackEndpoint ; 默认空建议填一个备用引擎兜底 [General] Languageen ; 默认 en汉化成 zh-CN FromLanguageja ; 默认 ja支持 auto 但不推荐参数默认值为什么这么改EndpointGoogleTranslate免费、免认证先用它跑通追求质量换DeepLTranslate同样免认证在意稳定性用*Legitimate系列需 API KeyFallbackEndpoint空单条翻译失败时自动换引擎重试建议配一个与主引擎不同的服务Language/FromLanguageen/ja汉化为zh-CN源语言尽量写明确如ja、en少用autoMaxCharactersPerTranslation200超过该长度的文本直接不翻。想减少请求就调大如果要分发汉化包官方要求不要超过 400[TextFrameworks]各开关UGUI/NGUI/TMP/UIElements 为TrueIMGUI/TextMesh 为False默认没开全是有原因的TextMesh 常导致 3D 文字乱漂发现某类界面没被翻译时再逐个打开改完配置按ALTR可以立即重载翻译文件不必重启游戏。 进阶技巧手动翻译、正则规则与 UI 字号调整技巧一手动翻译 专有名词替换。自动翻译会把你见过的文本写进Translation\{Lang}\Text\_AutoGeneratedTranslations.txt直接改这个文件里的译文即可该文件优先级最低适合自己用。如果要分发汉化包更好的做法是新建一个.txt文件放进Translation目录只放修正过的条目它会自动覆盖自动结果。另外_Substitutions.txt里的替换会在翻译前生效适合钉死人名、技能名等总被翻错的词魔法使い魔法师使用替换后自动生成的译文会带参数占位例如私は{{A}}我是{{A}}一条规则即可覆盖所有含该词的句子。技巧二用正则覆盖一类文本。游戏常把编号和名称拼在一起如01 シンプルリング、02 シンプルリング逐条写翻译不现实。在翻译文件里注意不能写在以_开头的自动生成文件里写一条分割正则它会先把文本拆开再分别查词sr:^([0-9]{2}) ([\S\s])$$1 $2如果文本模式完全固定直接写标准正则更简单r:^シンプルリング ([0-9])$简易戒指 $1技巧三按 GameObject 路径调整 UI 字号。译文比原文长时自动缩放EnableUIResizing默认开启不一定够用。在翻译目录下建一个以resizer.txt结尾的文件左半边写组件路径可只写部分路径右半边写命令CharaCustom/CustomControl/CanvasDrawChangeFontSizeByPercentage(0.5)支持的命令包括ChangeFontSize(24)设为固定字号、AutoResize(true, keep, 20)控制自动缩放范围、UGUI_ChangeLineSpacing、TMP_Alignment等。组件路径可以用 Runtime Unity Editor 这类工具查到插件本身不提供路径查询。 问题排查四个高频问题的现象、原因与解决现象游戏启动后部分或全部文本没有翻译。原因并非所有文本钩子默认开启——IMGUI 和 TextMesh 默认关闭而且默认钩子有时抓不到某些组件。 解决在[TextFrameworks]里把对应项改为True重启游戏要翻其他 Mod 的界面多为 IMGUI就打开EnableIMGUI个别漏翻可先按ALTU手动触发一次查找。现象翻译生效后游戏某些功能异常甚至停止工作。原因部分游戏用屏幕上显示的文本来判断走哪段逻辑译文把它的判断打乱了。 解决把TextGetterCompatibilityMode设为True该模式会让游戏读到的文本仍是原文。先用ALTT关闭翻译验证一下如果关掉就恢复正常基本可以确定是这个原因。现象翻译成中文后游戏里部分汉字显示不出来。原因游戏自带字体不含中文字形。 解决给OverrideFont仅 UGUI或FallbackFontTextMeshPro推荐仅 TextMeshPro配置一个含中文字形的自定义字体ALTF可在替换字体和默认字体间切换。现象玩了一段时间后翻译全部停止日志显示插件已关闭。原因内置的防滥用保护会主动关停插件例如连续 5 次请求无结果、每秒持续排队超过 60 秒、检测到滚动文本等。 解决先确认网络能访问翻译服务必要时换网络然后按ALTQ重启插件反复出现就更换Endpoint或配置FallbackEndpoint。 延伸阅读文档、源码路径与求助入口README.md完整配置项说明在Configuration一节空格处理、字体替换、纹理翻译、资源重定向等机制都有专节展开Frequently Asked Questions一节还回答了如何彻底停用插件删BepInEx/plugins/XUnity.AutoTranslator目录但别删XUnity.ResourceRedirector其他插件可能依赖它。翻译端点源码src/Translators/下每个子目录就是一个内置翻译器的完整实现照着其中任意一个如 BaiduTranslate、PapagoTranslate写把你的翻译服务接进来编译出的 DLL 丢进Translators/目录即可。端点接口定义src/XUnity.AutoTranslator.Plugin.Core/Endpoints/ITranslateEndpoint.cs定义了实现翻译器必须提供的 5 个成员接口注释里写清了每个成员的含义。资源重定向模块src/XUnity.ResourceRedirector/是独立于本插件的库可单独用于替换游戏加载的Resources/AssetBundle资源适合做版本无关的汉化补丁。更新记录CHANGELOG.md记录了各版本功能与修复比如 5.6.0 新增的 UIElements 支持、5.5.1 对新旧两套输入系统的支持升级前值得看一眼。下一步建议先保持默认GoogleTranslate跑一遍游戏观察Translation\{Lang}\Text\_AutoGeneratedTranslations.txt里自动生成了哪些条目。把Language改成目标语言并把FromLanguage明确为游戏原语言配一个FallbackEndpoint。挑几处翻得不对的关键文本建一个手动翻译文件覆盖它们用_Substitutions.txt钉住高频专有名词。遇到整块 UI 不翻译时按 UGUI → TextMeshPro → NGUI → IMGUI → TextMesh 的顺序逐个开启[TextFrameworks]里的开关并重启验证。排错时打开[Debug]里的EnableConsole和EnableLog用日志确认插件是没装对还是被保护机制关停了。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 XUnity AutoTranslator 实战指南：五步装好 Unity 游戏实时翻译插件，附 4 个高频坑的处理办法
XUnity AutoTranslator 实战指南五步装好 Unity 游戏实时翻译插件附 4 个高频坑的处理办法【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity AutoTranslator 是一个面向 Unity 游戏的自动翻译插件它会在游戏运行中拦截各界面文本调用你选定的在线翻译引擎实时翻译并把结果缓存下来。除了自动翻译它还提供了完整的半自动汉化工具链手动翻译文件、正则规则、UI 字体缩放和贴图替换。这个插件适配 BepInEx官方推荐、MelonLoader、IPA、UnityInjector 四种主流 Mod 加载框架也提供无需任何框架的独立安装方式内置 16 种翻译端点Google、Bing、DeepL、Papago、百度等并支持自行编写翻译端点。适合两类人想立刻玩日文/英文 Unity 游戏的玩家以及想给游戏做民间汉化的开发者。 能力总览它具体能帮你做什么实时自动翻译运行时钩取游戏文本组件发现新文本先等 1 秒确认其不再变化再发请求翻译全程最多 1 个并发请求、单会话最多 8000 次请求。双重缓存所有翻译结果同时存内存和磁盘Translation\{Lang}\Text\下的文本文件同一文本永远不会翻译第二次。多端点可切换配置文件里改一行Endpoint就能换引擎配了FallbackEndpoint时主引擎单条翻译失败会自动降级。手动翻译覆盖插件会读取Translation目录下所有.txt文件也支持打包成.zip你手写的翻译优先级高于自动翻译结果。正则翻译规则支持标准正则r:和分割正则sr:用一条规则覆盖一类带编号、带数值的文本。UI 适配自动调整文本组件的溢出参数防止译文被裁切还可以用resizer.txt按 GameObject 路径精确改字号、行距、对齐。多文本框架支持 UGUI、NGUI、IMGUI、TextMeshPro、TextMesh、FairyGUI、Utage其中 IMGUI 和 TextMesh 默认关闭。贴图替换可把游戏内贴图导出到本地目录再用你改过的图替换回去默认关闭无自动翻译适合汉化 UI 图。 快速上手按游戏插件框架选择安装方式先确认你的游戏用了哪种 Mod 框架再选对应安装包。注意如果游戏已经装了插件管理器不要用独立ReiPatcher方式两者同时存在会出问题。安装方式前提条件插件解压位置适用场景BepInEx推荐已装 BepInEx直接解压到游戏根目录DLL 落入BepInEx/plugins/Mono 游戏的首选MelonLoader已装 MelonLoader直接解压到游戏根目录DLL 分别落入Mods/和UserLibs/MelonLoader 游戏IPA已装 IPA直接解压到游戏根目录DLL 落入Plugins/仅支持 IPA 的游戏UnityInjector已装 UnityInjector解压到UnityInjector/目录不一定是游戏根目录无 Mono 环境的老游戏独立安装ReiPatcher无安装包自带 ReiPatcher解压到游戏根目录后运行SetupReiPatcherAndAutoTranslator.exe游戏什么框架都没有以最常用的 BepInEx 方式为例最小路径是三步从 releases 下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip直接解压到游戏根目录。启动游戏首次启动会在BepInEx/config/下自动生成配置文件并在BepInEx/Translation/下生成翻译目录。按ALT0调出插件界面能正常打开并看到端点选择说明装好了再按ALTT在译文和原文之间切换确认文本真的被替换了。如果游戏是 IL2CPP 构建要用BepInEx-IL2CPP或MelonMod-IL2CPP安装包前者需要 BepInEx 6 的 IL2CPP 版本但 IL2CPP 支持并不完整部分文本变化检测不到、IMGUI 翻译和 TextGetterCompatibilityMode 均不支持遇到漏翻可用ALTU手动触发一次查找。⚙️ 配置要点上手必须改的几个参数配置文件默认生成的关键项如下加注释的都是你需要动手的地方[Service] EndpointGoogleTranslate ; 默认 GoogleTranslate免费但不稳定 FallbackEndpoint ; 默认空建议填一个备用引擎兜底 [General] Languageen ; 默认 en汉化成 zh-CN FromLanguageja ; 默认 ja支持 auto 但不推荐参数默认值为什么这么改EndpointGoogleTranslate免费、免认证先用它跑通追求质量换DeepLTranslate同样免认证在意稳定性用*Legitimate系列需 API KeyFallbackEndpoint空单条翻译失败时自动换引擎重试建议配一个与主引擎不同的服务Language/FromLanguageen/ja汉化为zh-CN源语言尽量写明确如ja、en少用autoMaxCharactersPerTranslation200超过该长度的文本直接不翻。想减少请求就调大如果要分发汉化包官方要求不要超过 400[TextFrameworks]各开关UGUI/NGUI/TMP/UIElements 为TrueIMGUI/TextMesh 为False默认没开全是有原因的TextMesh 常导致 3D 文字乱漂发现某类界面没被翻译时再逐个打开改完配置按ALTR可以立即重载翻译文件不必重启游戏。 进阶技巧手动翻译、正则规则与 UI 字号调整技巧一手动翻译 专有名词替换。自动翻译会把你见过的文本写进Translation\{Lang}\Text\_AutoGeneratedTranslations.txt直接改这个文件里的译文即可该文件优先级最低适合自己用。如果要分发汉化包更好的做法是新建一个.txt文件放进Translation目录只放修正过的条目它会自动覆盖自动结果。另外_Substitutions.txt里的替换会在翻译前生效适合钉死人名、技能名等总被翻错的词魔法使い魔法师使用替换后自动生成的译文会带参数占位例如私は{{A}}我是{{A}}一条规则即可覆盖所有含该词的句子。技巧二用正则覆盖一类文本。游戏常把编号和名称拼在一起如01 シンプルリング、02 シンプルリング逐条写翻译不现实。在翻译文件里注意不能写在以_开头的自动生成文件里写一条分割正则它会先把文本拆开再分别查词sr:^([0-9]{2}) ([\S\s])$$1 $2如果文本模式完全固定直接写标准正则更简单r:^シンプルリング ([0-9])$简易戒指 $1技巧三按 GameObject 路径调整 UI 字号。译文比原文长时自动缩放EnableUIResizing默认开启不一定够用。在翻译目录下建一个以resizer.txt结尾的文件左半边写组件路径可只写部分路径右半边写命令CharaCustom/CustomControl/CanvasDrawChangeFontSizeByPercentage(0.5)支持的命令包括ChangeFontSize(24)设为固定字号、AutoResize(true, keep, 20)控制自动缩放范围、UGUI_ChangeLineSpacing、TMP_Alignment等。组件路径可以用 Runtime Unity Editor 这类工具查到插件本身不提供路径查询。 问题排查四个高频问题的现象、原因与解决现象游戏启动后部分或全部文本没有翻译。原因并非所有文本钩子默认开启——IMGUI 和 TextMesh 默认关闭而且默认钩子有时抓不到某些组件。 解决在[TextFrameworks]里把对应项改为True重启游戏要翻其他 Mod 的界面多为 IMGUI就打开EnableIMGUI个别漏翻可先按ALTU手动触发一次查找。现象翻译生效后游戏某些功能异常甚至停止工作。原因部分游戏用屏幕上显示的文本来判断走哪段逻辑译文把它的判断打乱了。 解决把TextGetterCompatibilityMode设为True该模式会让游戏读到的文本仍是原文。先用ALTT关闭翻译验证一下如果关掉就恢复正常基本可以确定是这个原因。现象翻译成中文后游戏里部分汉字显示不出来。原因游戏自带字体不含中文字形。 解决给OverrideFont仅 UGUI或FallbackFontTextMeshPro推荐仅 TextMeshPro配置一个含中文字形的自定义字体ALTF可在替换字体和默认字体间切换。现象玩了一段时间后翻译全部停止日志显示插件已关闭。原因内置的防滥用保护会主动关停插件例如连续 5 次请求无结果、每秒持续排队超过 60 秒、检测到滚动文本等。 解决先确认网络能访问翻译服务必要时换网络然后按ALTQ重启插件反复出现就更换Endpoint或配置FallbackEndpoint。 延伸阅读文档、源码路径与求助入口README.md完整配置项说明在Configuration一节空格处理、字体替换、纹理翻译、资源重定向等机制都有专节展开Frequently Asked Questions一节还回答了如何彻底停用插件删BepInEx/plugins/XUnity.AutoTranslator目录但别删XUnity.ResourceRedirector其他插件可能依赖它。翻译端点源码src/Translators/下每个子目录就是一个内置翻译器的完整实现照着其中任意一个如 BaiduTranslate、PapagoTranslate写把你的翻译服务接进来编译出的 DLL 丢进Translators/目录即可。端点接口定义src/XUnity.AutoTranslator.Plugin.Core/Endpoints/ITranslateEndpoint.cs定义了实现翻译器必须提供的 5 个成员接口注释里写清了每个成员的含义。资源重定向模块src/XUnity.ResourceRedirector/是独立于本插件的库可单独用于替换游戏加载的Resources/AssetBundle资源适合做版本无关的汉化补丁。更新记录CHANGELOG.md记录了各版本功能与修复比如 5.6.0 新增的 UIElements 支持、5.5.1 对新旧两套输入系统的支持升级前值得看一眼。下一步建议先保持默认GoogleTranslate跑一遍游戏观察Translation\{Lang}\Text\_AutoGeneratedTranslations.txt里自动生成了哪些条目。把Language改成目标语言并把FromLanguage明确为游戏原语言配一个FallbackEndpoint。挑几处翻得不对的关键文本建一个手动翻译文件覆盖它们用_Substitutions.txt钉住高频专有名词。遇到整块 UI 不翻译时按 UGUI → TextMeshPro → NGUI → IMGUI → TextMesh 的顺序逐个开启[TextFrameworks]里的开关并重启验证。排错时打开[Debug]里的EnableConsole和EnableLog用日志确认插件是没装对还是被保护机制关停了。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考