XUnity.AutoTranslator 使用全攻略免费为Unity游戏开启实时汉化的完整方案【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator如果你是一位热衷日系或欧美单机游戏的玩家多半经历过这样的时刻剧情正到高潮屏幕上却蹦出一段看不懂的日文或英文。而XUnity.AutoTranslator正是为破解这一场景而生的免费 Unity 游戏自动翻译插件——它能在游戏运行时实时捕获文本、调用在线翻译服务并把译文无缝替换回画面里。你既不用等汉化组也不用改游戏文件装好、配置、启动三步就能让游戏开口说中文。本文不会堆砌源码而是按第一次上手 → 日常使用 → 进阶调优的完整旅程带你把这套工具真正用起来。第一章 第一次上手让游戏开口说中文1.1 动手前先弄清一件事你的游戏属于哪类环境Unity 游戏的 MOD 加载方式五花八门XUnity.AutoTranslator 的聪明之处在于它适配了几乎所有主流加载框架。安装前先确认游戏用的是哪一套游戏环境如何判断对应安装包BepInEx游戏目录下存在BepInEx文件夹XUnity.AutoTranslator-BepInEx-版本.zipMelonLoader存在Mods与UserLibs文件夹XUnity.AutoTranslator-MelonMod-版本.zipIPA存在Plugins文件夹XUnity.AutoTranslator-IPA-版本.zipUnityInjector存在UnityInjector文件夹XUnity.AutoTranslator-UnityInjector-版本.zip什么都没有干净的游戏根目录XUnity.AutoTranslator-ReiPatcher-版本.zip独立安装 经验之谈绝大多数单机 Unity 游戏都走 BepInEx 路线这也是项目官方最推荐的方案。如果游戏里已经装好某个 MOD 加载器就不要再用独立安装ReiPatcher方式否则会引发冲突。1.2 三步完成 BepInEx 环境下的插件安装以最常见的 BepInEx 场景为例全程只需要三步下载解压把 BepInEx 版本压缩包直接解压到游戏根目录让BepInEx/core、BepInEx/plugins等文件夹自然合并进游戏目录。启动一次游戏首次启动会自动生成翻译目录和配置文件如BepInEx/Translation/与BepInEx/plugins/XUnity.AutoTranslator/下的AutoTranslatorConfig.ini。验证效果进入游戏找到一个文本框如果文字被替换成目标语言说明管线已经打通。独立安装ReiPatcher则更简单解压后运行SetupReiPatcherAndAutoTranslator.exe它会自动完成补丁配置再用生成的快捷方式启动游戏即可。之后的日常启动仍用原来的 exe。1.3 记住这几个快捷键日常操作事半功倍插件内置了一套全局快捷键第一次上手时务必记下前四个快捷键作用ALT 0打开/关闭翻译配置界面0 是数字零ALT T一键切换原文与译文方便对照检查ALT R热重载翻译文件改完文本立刻生效ALT U手动触发文本捕获默认钩子漏掉文本时用ALT F在自定义字体与默认字体间切换需配置OverrideFont第二章 日常使用选对翻译服务调出理想效果2.1 翻译服务怎么选先看懂这张服务地图XUnity.AutoTranslator 内置了 15 种翻译端点Endpoint它们在Translators子目录里以独立 DLL 的形式存在。按使用门槛可以分成四类服务端点需要密钥吗免费额度参考适合谁GoogleTranslate / BingTranslate / DeepLTranslate / Papago不需要无硬性限制但稳定性不保证新手开箱即用GoogleTranslateLegitimate / BingTranslateLegitimate / DeepLLegitimate / 百度 / Yandex / Watson / 彩云需要各家月免费额度如 DeepL 每月 50 万字符追求稳定与质量的进阶玩家ezTrans XP / LEC Power Translator不需要需本机安装对应翻译软件离线或网络受限场景CustomTranslate / ExtProtocol按实现而定由你的自定义服务决定开发者、折腾型用户判断原则很简单先免费的免费端点不稳定或质量不够再上带密钥的付费端点。另外请注意——任何在线免费端点都可能在服务商改版后突然失效这是插件作者无法左右的。2.2 语言与端点配置改三行就能跑起来配置文件AutoTranslatorConfig.ini中最核心的其实是两处[Service] EndpointGoogleTranslate ; 主翻译服务 FallbackEndpointBingTranslate ; 主服务失败时自动切换的备用服务 [General] Languagezh ; 翻译成什么语言zh简体中文 FromLanguageja ; 游戏原文语言ja日语auto 可自动检测新手建议主端点选免认证的免费服务再配一个备用端点兜底FromLanguage尽量写明确的语言代码比auto更稳。2.3 中文字体缺失90% 汉化玩家都会撞上的坑把日文翻译成中文后最常出现的问题是翻译出来了但全是方块。原因很简单游戏默认字体根本不包含中文字形。解法有两个[Behaviour] OverrideFontfonts/msyh.ttf ; 方式一全局替换字体仅 UGUI FallbackFontTextMeshProFonts Materials/ARIAL SDF ; 方式二给 TextMeshPro 加回退字体推荐方式二比方式一更温和只在原字体缺字时才动用备胎字体是目前 TextMeshPro 场景下的首选方案。字体文件路径写在游戏目录内即可。2.4 文本框架开关为什么有的文字就是不翻译游戏渲染文字有多种技术栈插件默认只开启了最常用的几个[TextFrameworks] EnableUGUITrue ; 通用 UI默认开 EnableTextMeshProTrue ; 主流文字方案默认开 EnableNGUITrue ; 老牌 UI 插件默认开 EnableTextMeshFalse ; 3D 空间漂浮文字默认关需要时打开 EnableIMGUIFalse ; 老式即时模式 UI默认关界面大部分翻译了唯独某块文字不动时十有八九是对应框架没开。例如想翻译其他 MOD 的菜单往往就得把EnableIMGUITrue打开。第三章 进阶调优从能翻译到翻译得好3.1 如何把翻译请求量压到最低在线翻译端点对请求量通常有限制插件内置了一整套防滥用机制单条文本稳定 1 秒后才发请求、单次游戏会话最多 8000 次、同一时刻只发一个请求、翻译结果永久缓存到本地磁盘……你还可以主动配合EnableBatchingTrue支持的端点会把多条文本打包成一次请求。UseStaticTranslationsTrue命中内置常用短语词典约 2000 条日英对照直接免请求。MaxCharactersPerTranslation200超过该长度的文本直接跳过兼顾质量与开销。缓存机制所有译文会写进Translation\{Lang}\Text\_AutoGeneratedTranslations.txt同一句话第二次出现不再请求网络。3.2 手动翻译让译文质量更上一层楼自动翻译质量再高也常有词不达意的地方。插件支持纯手动接管——直接把原文和译文以原文译文的格式写进任意.txt放在翻译目录下就会覆盖自动翻译结果私は{{A}}I am {{A}}自动生成的文件永远拥有最低优先级这意味着你手动维护的翻译永远优先于自动翻译。改完文件按ALT R即可即时生效无需重启游戏。3.3 正则与拆分配置处理动态文本的利器游戏里常见的动态拼接文本比如01 シンプルリング这种带编号的道具名用普通字典匹配效率极低。插件提供了两套正则语法r:^シンプルリング ([0-9])$Simple Ring $1 ; r: 直接匹配整段文本 sr:^([0-9]{2}) ([\S\s])$$1 $2 ; sr: 先把文本拆块再分别翻译sr:拆分配置在数值类、道具类、状态栏文本上特别好用配合命名分组如(?stat[\w\s])还能实现更精细的控制。相关能力全部收在src/XUnity.AutoTranslator.Plugin.Core/目录中想深挖可以去读源码。3.4 连图片也不放过纹理翻译与资源重定向文本之外插件还提供了一套图片替换能力开启EnableTextureDumpingTrue后游戏里的 UI 图片会被导出到Translation\{Lang}\Texture目录你用 PS 改完保存回去再开EnableTextureTranslationTrue游戏就会用你改过的图替换原图。这在汉化没有 MOD 支持的老游戏时是救命功能。⚠️ 重要提醒EnableTextureDumping、EnableTextureToggling、LoadUnmodifiedTextures这些开关只建议自己汉化时临时开启任何分发汉化包的行为都务必先关掉否则会拖累所有下游玩家的性能。3.5 给其他 MOD 也提供翻译如果想让自己的翻译只作用于某个 MOD避免与通用翻译冲突在翻译目录下按Plugins/{插件名}/建子目录即可目录名取 DLL 文件名不含扩展名。文件内加一行#enable fallback就可以让该 MOD 的专属翻译在缺失时回退到通用翻译。3.6 接入 AI从机器翻译到大模型翻译社区里已经涌现出大量基于大语言模型的第三方端点OpenAI 系的 GPT 翻译、本地 Ollama 模型、以及支持 Grok、Gemini 等多个模型的通用端点。它们的接入方式与内置端点完全一致——把第三方 DLL 放进Translators目录再把Endpoint指向它即可。这意味着你完全可以把 XUnity.AutoTranslator 变成一个本地免费 LLM 离线翻译器零请求成本。想自己动手写一个端点也不难实现ITranslator接口并编译成 DLL 丢进Translators目录即可参考实现都在src/Translators/下比如src/Translators/Common.ExtProtocol/与src/Translators/Http.ExtProtocol/。第四章 踩坑排查常见问题的对症下药装好了但一句都没翻译先按ALT 0打开配置面板确认端点是否为空再确认翻译目录里确实生成了文件。绝大多数完全不工作都源于安装包与游戏框架不匹配。只翻译了一部分文本对照 2.4 节的文本框架开关逐项排查最常漏掉的是 TextMesh 与 IMGUI。翻译出来了全是方块字字体问题回到 2.3 节配置OverrideFont或FallbackFontTextMeshPro。一翻译游戏就卡死或报错很多游戏会用当前显示的文本来决定游戏逻辑插件把文本改了逻辑就乱了。此时打开TextGetterCompatibilityModeTrue让游戏以为显示的还是原文。玩着玩着插件自动关闭了这是防滥用机制在保护你——比如连续向端点请求失败。ALT Q可以在修复问题如更换网络后手动重启插件。需要更深层定位时可在配置里打开调试开关[Debug] EnableConsoleTrue、EnableLogTrue配合CTRL ALT NP7查看场景列表、CTRL ALT NP6导出整个场景对象树能帮你快速定位是哪个对象没被钩住。写在最后一次配置长期受益回看整段旅程XUnity.AutoTranslator 的价值在于把游戏本地化这件原本需要专业团队数月完成的事压缩成了普通玩家十分钟就能上手的日常操作。它免费开源、横跨 BepInEx 与 MelonLoader 等全部主流框架、内置 15 翻译服务、支持手动精修、正则处理、图片替换乃至 AI 大模型接入——无论是只想看懂剧情的外语苦手还是想自己组一套高质量汉化的资深玩家都能在这套工具里找到自己需要的那一块。如果你读到这里已经心动了行动路线很清晰确认游戏的 MOD 环境下载对应版本安装包并解压启动游戏按本章指引完成端点、语言、字体三项基础配置从免费端点开始体验再按需开启缓存、批处理与手动翻译打磨质量想读源码或参与贡献的开发者可通过git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator获取完整工程核心逻辑集中在src/XUnity.AutoTranslator.Plugin.Core/翻译端点示例在src/Translators/。现在挑一款搁置已久的游戏去试试让它开口说中文的感觉吧——你会发现语言从来不该是游戏体验的终点。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
XUnity.AutoTranslator 使用全攻略：免费为Unity游戏开启实时汉化的完整方案
XUnity.AutoTranslator 使用全攻略免费为Unity游戏开启实时汉化的完整方案【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator如果你是一位热衷日系或欧美单机游戏的玩家多半经历过这样的时刻剧情正到高潮屏幕上却蹦出一段看不懂的日文或英文。而XUnity.AutoTranslator正是为破解这一场景而生的免费 Unity 游戏自动翻译插件——它能在游戏运行时实时捕获文本、调用在线翻译服务并把译文无缝替换回画面里。你既不用等汉化组也不用改游戏文件装好、配置、启动三步就能让游戏开口说中文。本文不会堆砌源码而是按第一次上手 → 日常使用 → 进阶调优的完整旅程带你把这套工具真正用起来。第一章 第一次上手让游戏开口说中文1.1 动手前先弄清一件事你的游戏属于哪类环境Unity 游戏的 MOD 加载方式五花八门XUnity.AutoTranslator 的聪明之处在于它适配了几乎所有主流加载框架。安装前先确认游戏用的是哪一套游戏环境如何判断对应安装包BepInEx游戏目录下存在BepInEx文件夹XUnity.AutoTranslator-BepInEx-版本.zipMelonLoader存在Mods与UserLibs文件夹XUnity.AutoTranslator-MelonMod-版本.zipIPA存在Plugins文件夹XUnity.AutoTranslator-IPA-版本.zipUnityInjector存在UnityInjector文件夹XUnity.AutoTranslator-UnityInjector-版本.zip什么都没有干净的游戏根目录XUnity.AutoTranslator-ReiPatcher-版本.zip独立安装 经验之谈绝大多数单机 Unity 游戏都走 BepInEx 路线这也是项目官方最推荐的方案。如果游戏里已经装好某个 MOD 加载器就不要再用独立安装ReiPatcher方式否则会引发冲突。1.2 三步完成 BepInEx 环境下的插件安装以最常见的 BepInEx 场景为例全程只需要三步下载解压把 BepInEx 版本压缩包直接解压到游戏根目录让BepInEx/core、BepInEx/plugins等文件夹自然合并进游戏目录。启动一次游戏首次启动会自动生成翻译目录和配置文件如BepInEx/Translation/与BepInEx/plugins/XUnity.AutoTranslator/下的AutoTranslatorConfig.ini。验证效果进入游戏找到一个文本框如果文字被替换成目标语言说明管线已经打通。独立安装ReiPatcher则更简单解压后运行SetupReiPatcherAndAutoTranslator.exe它会自动完成补丁配置再用生成的快捷方式启动游戏即可。之后的日常启动仍用原来的 exe。1.3 记住这几个快捷键日常操作事半功倍插件内置了一套全局快捷键第一次上手时务必记下前四个快捷键作用ALT 0打开/关闭翻译配置界面0 是数字零ALT T一键切换原文与译文方便对照检查ALT R热重载翻译文件改完文本立刻生效ALT U手动触发文本捕获默认钩子漏掉文本时用ALT F在自定义字体与默认字体间切换需配置OverrideFont第二章 日常使用选对翻译服务调出理想效果2.1 翻译服务怎么选先看懂这张服务地图XUnity.AutoTranslator 内置了 15 种翻译端点Endpoint它们在Translators子目录里以独立 DLL 的形式存在。按使用门槛可以分成四类服务端点需要密钥吗免费额度参考适合谁GoogleTranslate / BingTranslate / DeepLTranslate / Papago不需要无硬性限制但稳定性不保证新手开箱即用GoogleTranslateLegitimate / BingTranslateLegitimate / DeepLLegitimate / 百度 / Yandex / Watson / 彩云需要各家月免费额度如 DeepL 每月 50 万字符追求稳定与质量的进阶玩家ezTrans XP / LEC Power Translator不需要需本机安装对应翻译软件离线或网络受限场景CustomTranslate / ExtProtocol按实现而定由你的自定义服务决定开发者、折腾型用户判断原则很简单先免费的免费端点不稳定或质量不够再上带密钥的付费端点。另外请注意——任何在线免费端点都可能在服务商改版后突然失效这是插件作者无法左右的。2.2 语言与端点配置改三行就能跑起来配置文件AutoTranslatorConfig.ini中最核心的其实是两处[Service] EndpointGoogleTranslate ; 主翻译服务 FallbackEndpointBingTranslate ; 主服务失败时自动切换的备用服务 [General] Languagezh ; 翻译成什么语言zh简体中文 FromLanguageja ; 游戏原文语言ja日语auto 可自动检测新手建议主端点选免认证的免费服务再配一个备用端点兜底FromLanguage尽量写明确的语言代码比auto更稳。2.3 中文字体缺失90% 汉化玩家都会撞上的坑把日文翻译成中文后最常出现的问题是翻译出来了但全是方块。原因很简单游戏默认字体根本不包含中文字形。解法有两个[Behaviour] OverrideFontfonts/msyh.ttf ; 方式一全局替换字体仅 UGUI FallbackFontTextMeshProFonts Materials/ARIAL SDF ; 方式二给 TextMeshPro 加回退字体推荐方式二比方式一更温和只在原字体缺字时才动用备胎字体是目前 TextMeshPro 场景下的首选方案。字体文件路径写在游戏目录内即可。2.4 文本框架开关为什么有的文字就是不翻译游戏渲染文字有多种技术栈插件默认只开启了最常用的几个[TextFrameworks] EnableUGUITrue ; 通用 UI默认开 EnableTextMeshProTrue ; 主流文字方案默认开 EnableNGUITrue ; 老牌 UI 插件默认开 EnableTextMeshFalse ; 3D 空间漂浮文字默认关需要时打开 EnableIMGUIFalse ; 老式即时模式 UI默认关界面大部分翻译了唯独某块文字不动时十有八九是对应框架没开。例如想翻译其他 MOD 的菜单往往就得把EnableIMGUITrue打开。第三章 进阶调优从能翻译到翻译得好3.1 如何把翻译请求量压到最低在线翻译端点对请求量通常有限制插件内置了一整套防滥用机制单条文本稳定 1 秒后才发请求、单次游戏会话最多 8000 次、同一时刻只发一个请求、翻译结果永久缓存到本地磁盘……你还可以主动配合EnableBatchingTrue支持的端点会把多条文本打包成一次请求。UseStaticTranslationsTrue命中内置常用短语词典约 2000 条日英对照直接免请求。MaxCharactersPerTranslation200超过该长度的文本直接跳过兼顾质量与开销。缓存机制所有译文会写进Translation\{Lang}\Text\_AutoGeneratedTranslations.txt同一句话第二次出现不再请求网络。3.2 手动翻译让译文质量更上一层楼自动翻译质量再高也常有词不达意的地方。插件支持纯手动接管——直接把原文和译文以原文译文的格式写进任意.txt放在翻译目录下就会覆盖自动翻译结果私は{{A}}I am {{A}}自动生成的文件永远拥有最低优先级这意味着你手动维护的翻译永远优先于自动翻译。改完文件按ALT R即可即时生效无需重启游戏。3.3 正则与拆分配置处理动态文本的利器游戏里常见的动态拼接文本比如01 シンプルリング这种带编号的道具名用普通字典匹配效率极低。插件提供了两套正则语法r:^シンプルリング ([0-9])$Simple Ring $1 ; r: 直接匹配整段文本 sr:^([0-9]{2}) ([\S\s])$$1 $2 ; sr: 先把文本拆块再分别翻译sr:拆分配置在数值类、道具类、状态栏文本上特别好用配合命名分组如(?stat[\w\s])还能实现更精细的控制。相关能力全部收在src/XUnity.AutoTranslator.Plugin.Core/目录中想深挖可以去读源码。3.4 连图片也不放过纹理翻译与资源重定向文本之外插件还提供了一套图片替换能力开启EnableTextureDumpingTrue后游戏里的 UI 图片会被导出到Translation\{Lang}\Texture目录你用 PS 改完保存回去再开EnableTextureTranslationTrue游戏就会用你改过的图替换原图。这在汉化没有 MOD 支持的老游戏时是救命功能。⚠️ 重要提醒EnableTextureDumping、EnableTextureToggling、LoadUnmodifiedTextures这些开关只建议自己汉化时临时开启任何分发汉化包的行为都务必先关掉否则会拖累所有下游玩家的性能。3.5 给其他 MOD 也提供翻译如果想让自己的翻译只作用于某个 MOD避免与通用翻译冲突在翻译目录下按Plugins/{插件名}/建子目录即可目录名取 DLL 文件名不含扩展名。文件内加一行#enable fallback就可以让该 MOD 的专属翻译在缺失时回退到通用翻译。3.6 接入 AI从机器翻译到大模型翻译社区里已经涌现出大量基于大语言模型的第三方端点OpenAI 系的 GPT 翻译、本地 Ollama 模型、以及支持 Grok、Gemini 等多个模型的通用端点。它们的接入方式与内置端点完全一致——把第三方 DLL 放进Translators目录再把Endpoint指向它即可。这意味着你完全可以把 XUnity.AutoTranslator 变成一个本地免费 LLM 离线翻译器零请求成本。想自己动手写一个端点也不难实现ITranslator接口并编译成 DLL 丢进Translators目录即可参考实现都在src/Translators/下比如src/Translators/Common.ExtProtocol/与src/Translators/Http.ExtProtocol/。第四章 踩坑排查常见问题的对症下药装好了但一句都没翻译先按ALT 0打开配置面板确认端点是否为空再确认翻译目录里确实生成了文件。绝大多数完全不工作都源于安装包与游戏框架不匹配。只翻译了一部分文本对照 2.4 节的文本框架开关逐项排查最常漏掉的是 TextMesh 与 IMGUI。翻译出来了全是方块字字体问题回到 2.3 节配置OverrideFont或FallbackFontTextMeshPro。一翻译游戏就卡死或报错很多游戏会用当前显示的文本来决定游戏逻辑插件把文本改了逻辑就乱了。此时打开TextGetterCompatibilityModeTrue让游戏以为显示的还是原文。玩着玩着插件自动关闭了这是防滥用机制在保护你——比如连续向端点请求失败。ALT Q可以在修复问题如更换网络后手动重启插件。需要更深层定位时可在配置里打开调试开关[Debug] EnableConsoleTrue、EnableLogTrue配合CTRL ALT NP7查看场景列表、CTRL ALT NP6导出整个场景对象树能帮你快速定位是哪个对象没被钩住。写在最后一次配置长期受益回看整段旅程XUnity.AutoTranslator 的价值在于把游戏本地化这件原本需要专业团队数月完成的事压缩成了普通玩家十分钟就能上手的日常操作。它免费开源、横跨 BepInEx 与 MelonLoader 等全部主流框架、内置 15 翻译服务、支持手动精修、正则处理、图片替换乃至 AI 大模型接入——无论是只想看懂剧情的外语苦手还是想自己组一套高质量汉化的资深玩家都能在这套工具里找到自己需要的那一块。如果你读到这里已经心动了行动路线很清晰确认游戏的 MOD 环境下载对应版本安装包并解压启动游戏按本章指引完成端点、语言、字体三项基础配置从免费端点开始体验再按需开启缓存、批处理与手动翻译打磨质量想读源码或参与贡献的开发者可通过git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator获取完整工程核心逻辑集中在src/XUnity.AutoTranslator.Plugin.Core/翻译端点示例在src/Translators/。现在挑一款搁置已久的游戏去试试让它开口说中文的感觉吧——你会发现语言从来不该是游戏体验的终点。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
配置指南：从邮件投递到网络安全)
