1. 项目概述：为什么你需要XUnity自动翻译插件？

如果你是一名游戏玩家，尤其是喜欢探索Steam、DLSite等平台上的独立游戏或视觉小说，那你一定遇到过这个痛点：心心念念的游戏终于发售了，但一看，只有日文或英文界面。硬啃生肉吧，剧情看不懂，选项点错，游戏体验大打折扣；等汉化吧，又不知道猴年马月。这时候，一个能实时翻译游戏内文本的工具，就成了“救世主”。XUnity Auto Translator（以下简称XUAT）正是这样一个在特定玩家圈子里口口相传的神器。

它不是一个独立的软件，而是一个基于BepInEx等Mod加载框架的插件。其核心原理是“挂钩”（Hook）游戏读取和显示文本的流程，在文本被渲染到屏幕之前，截获原始字符串，调用你配置的翻译引擎（如谷歌翻译、百度翻译、DeepL等）进行实时翻译，再将翻译结果“替换”上去。整个过程对游戏本身几乎无感，你看到的就是即时翻译后的中文。我最初接触它是因为一款非常小众的日式RPG，民间汉化遥遥无期，官方更无可能。在尝试了各种OCR截图翻译软件都感觉割裂感太强之后，XUAT给了我近乎原生的体验。

这个“5分钟快速上手”指南，就是要帮你绕过复杂的配置迷雾，直击核心，让你用最短的时间，把这款工具武装起来，真正为你所用。它适合任何被语言门槛阻挡的PC游戏玩家，无论你是技术小白还是有一定动手能力的爱好者，只要跟着步骤走，都能搞定。

2. 核心思路与工作原理解析

2.1 插件是如何“无痕”翻译游戏的？

要理解XUAT，你得先明白现代PC游戏显示文字的基本流程。游戏程序内部有一个“文本池”，里面存储了所有对话、菜单、物品描述等字符串。当游戏需要显示某段文字时，它会调用系统或游戏引擎的文本渲染函数，比如Unity引擎的Text组件的text属性赋值。

XUAT的核心技术“挂钩”（Hooking），就像是在这个赋值操作的必经之路上，设了一个智能检查站。它利用BepInEx等插件的注入能力，在游戏运行时，修改游戏程序的内存指令，让原本直接执行“显示文本A”的代码，先跳转到XUAT自己的处理函数里。

这个处理函数会做以下几件事：

1. 拦截：拿到游戏原本要显示的文本A（比如日文“こんにちは”）。
2. 查询：检查本地是否已经有文本A的翻译缓存。XUAT会生成一个翻译缓存文件，通常是Translation.txt，里面存储了“原文->译文”的映射。
3. 决策：
   • 如果缓存里有，直接返回缓存的中文“你好”。
   • 如果缓存里没有，则启动在线翻译流程，将文本A发送到你预设的翻译API（如Google Translate）。
4. 替换与存储：收到API返回的翻译结果“你好”后，一方面将这个结果返回给游戏进行显示，另一方面将“こんにちは -> 你好”这对映射追加到本地缓存文件中。
5. 显示：游戏接收到的是“你好”，于是屏幕上显示的就是中文。

这样一来，第一次遇到某句文本时，可能会因为网络请求有瞬间延迟，但一旦翻译过并被缓存，后续再出现相同文本就是瞬间本地替换，毫无延迟感。整个流程对游戏进程是透明的，不会修改游戏原始文件，因此相对安全。

2.2 为什么选择XUAT？与其他方案的对比

在解决游戏语言问题上有几种常见思路，XUAT的优势和局限都很明显。

1. 传统外挂式OCR翻译（如团子翻译器、VNR）

• 原理：实时捕获游戏窗口的指定区域图像，进行OCR文字识别，再调用翻译API，最后以悬浮窗或覆盖层的方式显示译文。
• 优点：通用性强，几乎支持任何窗口程序，无需游戏特定支持。
• 缺点：
  • 精度问题：受字体、背景、文字排版影响大，识别错误率高。
  • 性能开销：需要持续截图和OCR运算，占用CPU/GPU资源。
  • 体验割裂：译文悬浮在游戏画面上方，遮挡画面，需要手动调整区域，沉浸感差。
  • 无法交互：翻译只是“看”，无法点击被翻译的按钮或选项。

2. 注入式内存翻译（XUAT所属类别）

• 原理：如上所述，直接拦截游戏内存中的文本数据流。
• 优点：
  • 精准无误：直接拿到程序原文本，100%准确。
  • 性能无损：除首次翻译的网络请求外，几乎零性能开销。
  • 无缝集成：译文直接“替换”原文本，显示在游戏UI中，如同官方汉化。
  • 可交互：翻译后的按钮、选项可以直接点击。
• 缺点：
  • 门槛较高：需要游戏支持Mod（如Unity引擎游戏常用BepInEx），并找到适配的XUAT版本。
  • 非通用：严重依赖社区为特定游戏制作的“挂钩点”或“配置文件”（Text Hooker）。没有对应配置，插件可能无法识别文本。
  • 首次配置复杂：需要安装多个组件并正确配置。

3. 官方汉化或完整汉化补丁

• 优点：完美体验，稳定可靠。
• 缺点：完全被动，取决于官方或汉化组是否制作，覆盖游戏极少。

结论：对于支持Mod的Unity游戏（Steam上大量独立游戏使用Unity引擎），XUAT提供了在“无汉化”和“完美汉化”之间最好的平衡点——一种高度可用的“即时汉化”方案。它牺牲了一定的通用性，换来了无与伦比的精度和体验。

3. 五分钟极速部署：从零到翻译

听起来很复杂？其实核心步骤就四步。我们以最典型的“Unity游戏 + BepInEx”环境为例。

3.1 第一步：环境准备——安装BepInEx

BepInEx是一个通用的Unity游戏Mod注入器和插件框架，是运行XUAT的基础。你可以把它理解为游戏的一个“模组管理器”。

1. 确定游戏架构：在Steam游戏库中右键游戏 ->属性->已安装文件->浏览，打开游戏根目录。查看是否存在GameAssembly.dll或UnityPlayer.dll文件，并注意是否有<游戏名>_Data/Managed/文件夹。这通常意味着是Unity游戏。另外，查看是否有<游戏名>.exe的同级目录下存在<游戏名>_Data文件夹，这是Unity游戏的标志。
2. 下载BepInEx：访问BepInEx的GitHub发布页。这里有个关键选择：下载对应游戏位数（32位/64位）的BepInEx版本。如何判断？可以右键游戏的.exe主程序 ->属性->兼容性选项卡，有时会提示；或者更简单的方法，直接尝试下载BepInEx x64版本，因为现代游戏多为64位。如果不行，再换x86版本。
3. 安装：将下载的BepInEx压缩包（例如BepInEx_x64_5.4.21.0.zip）全部文件解压到游戏根目录（即.exe文件所在的目录）。
4. 验证：运行一次游戏，然后关闭。此时游戏根目录下会生成BepInEx文件夹，里面包含plugins、config等子目录。这说明BepInEx安装成功。

注意：有些游戏可能有反作弊或特殊保护，导致BepInEx注入失败。如果游戏完全无法启动或启动后无BepInEx文件夹生成，可能需要寻找特定的BepInEx补丁或放弃此方案。

3.2 第二步：安装XUnity Auto Translator插件本体

1. 下载插件：在GitHub上搜索“XUnity Auto Translator”或“XUAT”，找到最新的Release版本。通常核心文件是一个名为XUnity.AutoTranslator-{版本号}.zip的压缩包。
2. 放置插件：将压缩包内的XUnity.AutoTranslator文件夹（注意是整个文件夹）复制到游戏根目录/BepInEx/plugins/下。
3. 安装依赖：XUAT通常依赖另一个基础库XUnity.Common。检查下载的Release包内是否包含此文件夹，如果有，同样将其复制到BepInEx/plugins/下。没有它插件可能无法加载。

3.3 第三步：配置翻译引擎（以谷歌翻译为例）

插件默认可能没有启用或配置翻译引擎。我们需要告诉它去哪里获取翻译。

1. 定位配置文件：运行一次游戏并退出，在游戏根目录/BepInEx/config/下会生成AutoTranslatorConfig.ini。
2. 编辑配置：用记事本或任何文本编辑器打开此文件。
3. 修改关键参数：找到并修改以下几行（如果找不到，可以手动添加在文件末尾）：

   [Service] # 启用在线翻译服务 Enable= true # 指定翻译服务，这里用谷歌翻译 Endpoint= GoogleTranslate # 如果你在中国大陆，可能需要指定区域端点，常规情况不用改 # GoogleTranslateRegion= com

4. 设置语言：继续在文件中找到或添加：

   [General] # 源语言（游戏文本语言），设为auto让插件自动检测 FromLanguage= auto # 目标语言（你想翻译成的语言） ToLanguage= zh-CN # 是否启用翻译缓存，强烈建议开启以提升速度 EnableTranslationCache= true

5. （可选）调整字体：如果翻译后中文显示为方块（口口口），需要指定中文字体。在[General]部分添加：

   # 指定备用字体，使用你系统里存在的中文字体，如微软雅黑 FallbackFont= Microsoft YaHei # 有时需要同时指定字体文件路径，但通常指定字体名即可 # FallbackFontPath= C:\Windows\Fonts\msyh.ttc

3.4 第四步：启动游戏与验证

完成以上三步后，直接启动游戏。如果一切顺利：

• 游戏启动时，在命令行窗口或游戏日志中（有时会在BepInEx/LogOutput.log里）能看到XUAT加载成功的提示。
• 进入游戏主界面或任何有文字的地方，观察文字是否变成了中文。注意：第一次翻译某句文本时，会有轻微的延迟（等待网络请求），这是正常的。
• 检查BepInEx/Translation/文件夹，会发现生成了以游戏命名的子文件夹，里面有一个Translation.txt文件。这个文件就是翻译缓存，随着你游玩的进行，它会不断增长。

如果游戏内文字没有任何变化，请跳转到第5章进行问题排查。

4. 高阶配置与个性化调优

基础翻译能用了，但你可能对效果还不满意：翻译生硬、某些UI没翻译、字体不好看。这一章我们来解决这些问题。

4.1 翻译引擎的选择与配置密钥

谷歌翻译免费且方便，但有时可能不稳定或翻译质量不佳。XUAT支持多种后端：

1. Google Translate（默认）：免费，无需密钥，但可能受网络环境影响。
2. Baidu Translate（百度翻译）：国内访问稳定，需要申请API密钥。
   • 前往百度翻译开放平台注册开发者，创建通用翻译服务，获取AppID和密钥。
   • 在AutoTranslatorConfig.ini中配置：

     [Service] Endpoint= BaiduTranslate [Baidu] AppId= 你的AppID Secret= 你的密钥

3. DeepL：翻译质量公认较高，尤其是欧洲语言，但有免费额度限制，需要API密钥。
   • 注册DeepL开发者，获取认证密钥。
   • 配置：

     [Service] Endpoint= DeepL [DeepL] AuthKey= 你的认证密钥 # DeepL API免费版使用 https://api-free.deepl.com DeepLEndpoint= https://api-free.deepl.com/v2/translate

实操心得：对于日译中，我个人体验是DeepL > 百度 > 谷歌。谷歌在口语化、游戏用语上经常翻车，DeepL则更贴近语境。百度介于两者之间，且国内网络无压力。可以准备多个配置，通过注释切换来对比效果。

4.2 文本挂钩（Text Hooker）与正则表达式

这是XUAT能否生效的最关键，也是最复杂的一环。插件需要知道“从哪里”拦截文本。对于热门游戏，社区可能已经提供了现成的“挂钩”配置。对于冷门游戏，你可能需要自己摸索或等待。

1. 寻找现成配置：在GitHub、游戏相关的Mod站（如Nexus Mods）或贴吧、论坛搜索“<游戏名> XUnity”或“<游戏名> auto translator”。如果找到，通常会是一个.cfg或.txt配置文件，将其放入BepInEx/config/或BepInEx/plugins/XUnity.AutoTranslator/下的特定文件夹（参考插件说明）。
2. 理解挂钩原理：挂钩配置的本质是一系列“正则表达式”或“方法签名”，它们告诉BepInEx：“当游戏执行到这个特定的函数时，把它拦截下来，看看它传递的参数是不是字符串，如果是，就交给XUAT翻译”。例如，一个配置可能包含：

   [UnityEngine.UI.Text:set_text] -> 这表示挂钩Unity UI Text组件的文本设置方法。

3. 手动尝试与日志调试：如果没有现成配置，可以开启插件的详细日志模式。在AutoTranslatorConfig.ini中设置：

   [General] EnableDebugLogging= true

   然后运行游戏，进行一些操作（如打开菜单、对话），查看BepInEx/LogOutput.log。你可能会看到插件尝试挂钩各种方法的信息。有经验的用户可以通过分析日志，猜测出需要挂钩的方法，并手动编写配置。但这需要一定的逆向工程知识，对新手不友好。

4.3 字体、UI与缓存深度管理

1. 字体问题终极解决：如果设置了FallbackFont仍显示方块，可能是游戏使用的字体渲染方式特殊。可以尝试：
   • 在AutoTranslatorConfig.ini的[General]部分添加：UseStaticFontReplacement=true。这会尝试强制替换游戏字体。
   • 使用更强大的字体修改Mod，如“UnityEX”或“AssetStudio”导出游戏字体文件后替换，但这属于高阶操作。
2. 忽略特定文本：有些文本（如版本号、代码、文件名）不需要翻译，翻译了反而出错。可以在配置中设置“忽略列表”：

   [General] # 使用正则表达式匹配忽略的文本 RegexIgnorePattern= ^v\d+\.\d+|^[A-Z0-9_]+$

3. 管理翻译缓存：Translation.txt文件会越来越大。你可以：
   • 备份：在重装游戏或插件前，备份此文件，以后可以直接复用。
   • 清理：如果翻译有误，可以手动编辑这个文本文件，找到错误的那一行（格式为原文<|>译文），修改或删除它。
   • 共享：和玩同一款游戏的朋友共享此文件，他就可以直接获得你已翻译的所有内容，无需再请求在线翻译。

5. 常见问题排查与实战技巧实录

即使按照指南操作，也难免会遇到问题。这里汇总了我踩过的坑和解决方案。

5.1 游戏启动失败或崩溃

• 症状：点击游戏后无反应，或闪退。
• 排查：
  1. 检查BepInEx版本：确认下载的BepInEx位数（x86/x64）与游戏匹配。这是最常见的原因。
  2. 检查游戏完整性：在Steam上验证游戏文件完整性，确保游戏原文件未被破坏。
  3. 移除插件：将BepInEx/plugins/下的XUnity.AutoTranslator文件夹暂时移走，再启动游戏。如果能启动，说明是XUAT插件或其依赖与游戏冲突。尝试更新XUAT到最新版本，或寻找针对该游戏的特定版本。
  4. 查看日志：检查BepInEx/LogOutput.log文件末尾的错误信息，通常会有明确的崩溃原因提示。

5.2 插件已加载，但游戏内无任何翻译

• 症状：日志显示XUAT加载成功，但游戏文字仍是原文。
• 排查：
  1. 确认翻译服务：检查AutoTranslatorConfig.ini中[Service]下的Enable是否设为true，Endpoint是否正确。
  2. 检查语言设置：确认ToLanguage是zh-CN或zh-TW（简体/繁体中文）。
  3. 网络问题：如果使用谷歌翻译且你在国内，可能无法直接访问。第一次翻译时观察日志，看是否有网络超时错误。考虑切换为百度翻译或配置网络代理（注意：此操作需符合当地法律法规，仅作技术可能性探讨）。
  4. 缺少Text Hooker：这是最可能的原因！XUAT本身只是一个翻译框架，它需要针对具体游戏的“挂钩配置”才能抓到文本。检查是否有该游戏的专用配置文件。如果没有，对于Unity游戏，可以尝试使用更通用的“Resource Redirector”插件配合XUAT，或者寻找“Unity游戏通用Text Hooker”配置，但成功率无法保证。
  5. 缓存干扰：尝试临时删除或重命名BepInEx/Translation/文件夹，让插件重新生成缓存。

5.3 翻译延迟高或部分文本未翻译

• 症状：文字变成中文很慢，或者有些按钮、提示还是外文。
• 排查：
  1. 首次翻译延迟：正常现象。一旦翻译被缓存，后续就会飞快。
  2. 翻译引擎限速：免费API有调用频率限制。如果短时间内触发大量翻译请求（如快速跳过对话），会被暂时限制。稍等片刻即可。
  3. 文本类型不同：游戏内的文本可能来自不同源头（UI文本、纹理图片上的文字、3D字体等）。XUAT主要拦截内存中的字符串，对于“图片里的文字”和某些动态生成的3D文字无能为力，这些需要OCR方案辅助。
  4. 挂钩不完整：现有的Text Hooker配置可能只覆盖了部分UI系统。这需要社区完善配置或自行研究补充。

5.4 中文显示为方块（口口口）

• 症状：翻译生效了，但显示的是乱码方块。
• 解决：
  1. 确保FallbackFont设置正确：字体名必须准确。可以在系统“字体设置”里查看准确的字体名称。
  2. 尝试其他字体：将FallbackFont换成SimHei（黑体）、SimSun（宋体）、NSimSun（新宋体）等系统绝对存在的字体。
  3. 启用静态字体替换：在配置中添加UseStaticFontReplacement=true。
  4. 游戏字体纹理问题：极少数情况下，游戏可能使用了自定义字体图集，替换失败。这需要更复杂的字体Mod，超出了XUAT的能力范围。

5.5 翻译缓存文件（Translation.txt）的使用技巧

这个文件是你的宝贵财富。

• 手动编辑修正：如果发现某句翻译非常离谱，你可以用记事本打开Translation.txt，搜索原文（部分即可），找到形如OriginalText<|>TranslatedText的行，直接修改TranslatedText部分，保存。重启游戏后，该处就会显示你的修正。
• 合并缓存：如果你从朋友那里拿到了一个更完整的Translation.txt，可以直接用它替换你的，或者用文本编辑器的“合并”功能，将两个文件去重后合并，能最大化利用已翻译内容。
• 定期备份：在更新游戏、更新BepInEx或XUAT之前，备份这个文件。更新后放回原处，可以省去大量重新翻译的时间。

折腾XUnity Auto Translator的过程，很像是在和游戏程序本身进行一场“对话”和“合作”。它没有一键万能的魔法，需要你根据不同的游戏“对症下药”。但当配置成功，看着满屏的外文流畅地变成你能理解的母语，那种攻克障碍的成就感和随之而来的沉浸式游戏体验，绝对是值得这最初五分钟乃至更长时间投入的。最关键的是，一旦你掌握了这套流程，以后再遇到任何Unity引擎的无中文游戏，你都有了将其“汉化”的底气和能力。这不再是一个被动等待的过程，而是主动解决问题的乐趣。