XUnity.AutoTranslator 游戏实时翻译插件：从原理到实战的完整指南

1. 项目概述：当游戏语言成为一堵墙

作为一名玩了十几年日系、欧美独立游戏的“老油条”，我太懂那种面对一款心仪已久、画风玩法都戳中G点的游戏，却因为语言不通而望而却步的痛了。尤其是那些基于Unity引擎开发的、体量不大但内容精良的作品，往往因为受众问题，官方汉化遥遥无期。以前，我们要么硬啃生肉，要么苦等民间汉化组，过程被动且煎熬。

直到我遇到了XUnity.AutoTranslator（下文简称XUA），它彻底改变了我的游戏体验。这不仅仅是一个“翻译插件”，它是一个完整的、运行在游戏进程内的实时翻译与文本替换框架。简单来说，它能在游戏运行时，拦截屏幕上出现的任何文本（对话、UI、物品描述），调用你配置的翻译服务（如谷歌、百度、DeepL）进行翻译，并将结果无缝替换到游戏界面上。更强大的是，它支持手动翻译文件的创建、管理和缓存，实现“一次翻译，永久生效”，还能替换游戏内的图片资源（比如日文路牌换成中文）。

网络上关于XUA的讨论很多，但信息零散，官方文档虽然详尽却过于技术化，让很多新手望而却步。今天，我就结合自己多年的使用和折腾经验，为你带来一份从零开始、保姆级、覆盖从安装配置到高阶定制的完整指南。无论你是想无障碍畅玩某款特定游戏，还是想为整个游戏库搭建一个通用的翻译环境，这篇文章都能帮你搞定。

2. 核心原理与架构拆解：它到底是怎么工作的？

在深入实操之前，理解XUA的工作原理至关重要，这能帮你后续排查各种诡异问题。你可以把它想象成一个安装在游戏内部的“智能代理”。

2.1 核心工作流程

它的工作流程可以概括为“拦截-查询-替换”三部曲：

  1. 文本拦截（Hooking）：XUA通过BepInEx、IPA等插件框架注入到游戏进程。它利用Harmony或MonoMod等技术，在游戏引擎（Unity）渲染文本到屏幕的关键函数上“打钩子”（Hook）。当游戏调用这些函数显示“こんにちは”（你好）时，XUA能第一时间截获这个原始字符串。
  2. 翻译查询（Translation Lookup）：截获文本后，XUA首先检查本地翻译缓存（位于Translation文件夹下的_AutoGeneratedTranslations.txt等文件）。如果找到了该原文对应的翻译，直接使用。如果没找到，则根据你的配置，将原文发送给指定的在线翻译服务（Endpoint），如Google Translate，获取翻译结果，并自动将原文-译文对保存到本地缓存文件。这就是“自动翻译”的由来。
  3. 实时替换（Replacement）：拿到翻译文本（无论是缓存还是在线获取的）后，XUA会修改游戏即将渲染的文本内容，将“こんにちは”替换成“你好”，并显示在屏幕上。整个过程是实时的，延迟通常极低，用户感知不到。

2.2 关键组件与目录结构

安装XUA后，你的游戏目录下通常会生成一个BepInEx文件夹，核心内容在BepInEx\plugins\XUnity.AutoTranslator里。理解这个结构对后续配置和问题排查很有帮助：

BepInEx/ └── plugins/ └── XUnity.AutoTranslator/ ├── Config.ini # 核心配置文件，所有行为由此定义 ├── Translation/ # 翻译相关文件核心目录 │ ├── en/ # 目标语言目录，如`en`代表翻译成英文 │ │ └── Text/ │ │ ├── _AutoGeneratedTranslations.txt # 自动生成的翻译缓存 │ │ ├── _Substitutions.txt # 文本替换规则（如人名、专有名词） │ │ └── （其他手动创建的翻译文件）.txt │ └── Texture/ # 图片翻译（替换）目录 └── translators/ # 可选，放置自定义翻译器DLL的目录
  • Config.ini：这是插件的大脑。所有功能开关、翻译服务配置、性能调优、路径设置都在这里。我们后续的绝大部分操作都是围绕修改这个文件。
  • Translation/{Lang}/Text/：这是翻译文本的仓库。_AutoGeneratedTranslations.txt是插件自动填充的，严禁手动修改（因为会被覆盖）。你可以创建新的.txt文件（如MyManualTranslations.txt）来放置精心校对过的翻译，它们的优先级高于自动生成的文件。
  • Texture/：用于存放替换游戏内图片（如UI图标、带文字的图片）的资源。

2.3 支持的翻译服务（Endpoint）

XUA的强大之处在于其可扩展的翻译后端支持。默认或通过额外配置，它可以接入多种服务：

  • GoogleTranslate (默认)：免费，无需API Key，但可能受网络环境影响。这是最常用的选择。
  • GoogleTranslateLegitimate：使用官方Google Cloud Translation API，需要付费API Key，稳定且配额高。
  • BaiduTranslate：百度翻译API，国内访问速度快，需要申请App ID和密钥。
  • DeepL：翻译质量公认较高，尤其是欧洲语言，需要API Key（有免费额度）。
  • BingTranslateLegitimate：微软Azure翻译服务，需要API Key。
  • Yandex.Translate：俄罗斯的翻译服务，对小语种支持可能不错。
  • Custom：自定义端点，允许开发者接入任何符合其API规范的翻译服务。

对于绝大多数个人用户，GoogleTranslate（免费版）或BaiduTranslate（国内用户）已经足够。选择哪个，主要取决于你的网络环境和对翻译质量的偏好。

3. 从零开始：安装与基础配置实战

理论说再多不如动手做一遍。下面我们以最流行的插件框架BepInEx为例，演示完整的安装配置流程。

3.1 环境准备与插件安装

第一步：确认游戏与框架兼容性首先，你的游戏必须是基于Unity引擎开发的。通常，游戏根目录下会有UnityPlayer.dll或GameAssembly.dll（IL2CPP编译）等文件。其次，游戏需要能运行BepInEx。大多数Unity游戏都支持，尤其是单机游戏。

第二步：安装BepInEx

  1. 前往BepInEx的GitHub发布页，下载对应你游戏架构（x86或x64）的版本。通常下载BepInEx_x64_5.4.22.0.zip这样的文件。
  2. 将压缩包内所有文件解压到游戏的根目录（即和游戏主.exe文件同一层）。
  3. 首次运行游戏，BepInEx会自动完成初始化，并在根目录生成完整的BepInEx文件夹结构。

第三步：安装XUnity.AutoTranslator

  1. 前往XUA的GitHub发布页，下载XUnity.AutoTranslator-BepInEx-5.x-{VERSION}.zip（确保版本与BepInEx 5兼容）。
  2. 将压缩包内的plugins文件夹合并到游戏目录的BepInEx\plugins里。通常，你会得到BepInEx\plugins\XUnity.AutoTranslator这个目录。
  3. 再次运行游戏，如果安装成功，游戏启动时在命令行窗口（或游戏内按F1/F2等快捷键调出的控制台）应该能看到[XUnity.AutoTranslator]相关的加载日志。

注意：如果游戏没有控制台窗口，你可能需要额外安装BepInEx的BepInEx.Console或BepInEx.Debug插件来启用日志输出，这对于初期调试至关重要。

3.2 核心配置文件（Config.ini）详解与调优

安装完成后，打开BepInEx\plugins\XUnity.AutoTranslator\Config.ini。这个文件看起来参数很多，但新手只需关注几个关键区块。

[Behaviour] 区块 - 核心行为

[Behaviour] # 翻译服务，默认为GoogleTranslate。如果想用百度，改为`BaiduTranslate` Endpoint=GoogleTranslate # 源语言（游戏原始语言），插件通常能自动检测，如`ja`(日语) Language=ja # 目标语言（你想翻译成的语言），如`zh-CN`(简体中文) DestinationLanguage=zh-CN # 是否启用自动翻译。如果只想用本地翻译文件，可以设为False EnableTranslation=True # 输出自动翻译文件的路径 OutputFile=Translation\{Lang}\Text\_AutoGeneratedTranslations.txt
  • Language和DestinationLanguage必须使用标准的语言代码。常见的有：ja(日),en(英),zh-CN(简中),zh-TW(繁中),ko(韩),ru(俄)。

[Text] 区块 - 文本处理

[Text] # 最大翻译字符数，超过的文本不会被翻译。防止翻译超长文本（如代码）拖慢游戏。 MaxCharactersPerTranslation=1000 # 是否启用文本批量处理，将多个短句合并为一个请求发送，提高效率。 EnableBatching=True
  • MaxCharactersPerTranslation非常重要！有些游戏会把整个脚本文件当做一个文本加载，如果不设上限，插件会试图翻译几万字符的“文本”，导致卡死或翻译API报错。保持默认的1000或更低（如400）是安全的选择。

[UI] 区块 - 字体与显示

[UI] # 是否启用UI自动重设大小。翻译后文本可能更长，这个选项会尝试调整文本框大小以防文字溢出。 EnableUIResizing=True # 强制所有UI组件重设大小，更激进，但可能引起布局错乱。 ForceUIResizing=False # 覆盖字体（针对UGUI）。当游戏原字体不支持目标语言字符（如中文）时，指定一个系统字体或自定义字体文件。 OverrideFont= # 后备字体（针对TextMeshPro）。解决TMP字体缺字问题，优先级最高。 FallbackFontTextMeshPro=
  • 中文用户最常遇到的问题是“口口口”乱码，这通常是因为游戏字体不含中文字形。FallbackFontTextMeshPro是解决TMP UI乱码的利器。你可以将其设置为一个包含中文的TMP字体资源名，例如Fonts & Materials/LiberationSans SDF Fallback（如果游戏自带），或者自己制作并导入字体AssetBundle。

配置翻译服务API（以百度翻译为例）如果你想使用需要认证的翻译服务，如百度翻译，需要在Config.ini中配置API信息。

  1. 前往百度翻译开放平台注册并创建通用翻译API应用，获取App ID和密钥。
  2. 在Config.ini中找到[Baidu]区块（如果没有，可以手动添加）：
    [Baidu] BaiduAppId=你的App ID BaiduAppSecret=你的密钥
  3. 将[Behaviour]区块中的Endpoint改为BaiduTranslate。
  4. 保存文件，重启游戏。

3.3 首次运行与基础验证

完成基础配置后，启动游戏。进入一个有大量文本的场景（如开始菜单、对话）。

  1. 观察控制台日志：你应该能看到类似[Info] XUnity.AutoTranslator: Initialized successfully.和[Info] XUnity.AutoTranslator: Endpoint: GoogleTranslate的日志。当游戏文本出现时，会有[Info] Translating: [原文] -> [译文]的日志。
  2. 使用热键测试：
    • ALT+0：打开翻译端点选择菜单。你可以在这里实时切换不同的翻译服务（如果配置了多个）。
    • ALT+T：全局切换翻译的开启/关闭。这是最常用的热键，用于快速对比翻译前后的效果。
    • ALT+R：重新加载所有翻译文件。当你手动修改了Translation目录下的.txt文件后，按此键无需重启游戏即可生效。
  3. 检查缓存文件：玩几分钟后，退出游戏。打开Translation\{目标语言}\Text\_AutoGeneratedTranslations.txt，你应该能看到插件自动记录下来的原文和译文对。这个文件会随着游戏进程不断增长。

至此，一个基础的、可用的实时游戏翻译环境就已经搭建完成了。你已经可以无障碍游玩大部分文本驱动的游戏了。

4. 进阶实战：精细化配置与问题排查

基础功能能用，但想用得爽、用得稳，就需要深入一些进阶配置和问题处理技巧。

4.1 解决中文乱码与字体问题

“口口口”问题是中文用户的第一大敌。其根本原因是游戏使用的字体（Font Asset）不包含中文字符集。

解决方案A：使用后备字体（TextMeshPro - 推荐）对于使用TextMeshPro（TMP）的现代Unity游戏，FallbackFontTextMeshPro是最优雅的解决方案。

  1. 寻找字体资源：有些游戏模组作者会制作好包含中文的TMP字体AssetBundle。你可以在游戏社区或模组网站搜索“游戏名+ 字体补丁”或“TMP Chinese font”。下载后，将.assets或.bundle文件放入游戏根目录。
  2. 配置：在Config.ini的[UI]区块，设置FallbackFontTextMeshPro为字体资源的名称（不含路径和扩展名）。例如，如果你下载的文件叫chinese_font.assets，就设置为chinese_font。如果字体资源在AssetBundle内，可能需要指定内部路径，如customfonts/chinese。
  3. 重启游戏测试。

解决方案B：覆盖字体（传统UGUI）对于使用传统UGUI Text的游戏，可以使用OverrideFont。

  1. 使用系统字体：你可以直接指定一个系统中已安装的、包含中文的字体名，如Microsoft YaHei（微软雅黑）。但这种方式不稳定，并非所有游戏环境都能成功加载系统字体。
  2. 使用自定义字体AssetBundle：和TMP类似，需要找到或制作UGUI字体AssetBundle，然后指定其名称。

实操心得：如果游戏同时使用了TMP和UGUI，优先配置FallbackFontTextMeshPro，它对TMP的兼容性最好。对于UGUI，如果OverrideFont无效，可以尝试在游戏社区寻找专门的“外挂字体”Mod，它们通常通过更底层的方式注入字体。

4.2 管理翻译缓存与制作手动翻译包

自动翻译虽然方便，但质量参差不齐，尤其是专有名词、角色名、技能名等。我们可以利用XUA的翻译文件优先级系统，创建高质量的手动翻译。

翻译文件优先级与创建XUA会读取Translation\{Lang}\Text\目录下所有.txt文件（包括子目录）。优先级规则是：后加载的文件优先级高于先加载的，手动创建的文件优先级高于自动生成的文件(_开头的文件)。_AutoGeneratedTranslations.txt总是最后加载，优先级最低。

因此，最佳实践是：

  1. 永不直接修改_AutoGeneratedTranslations.txt，因为游戏运行时它会被插件重写。
  2. 创建你自己的翻译文件，例如Manual_GameTerms.txt、Character_Names.txt。
  3. 文件格式：每行一条翻译，格式为原文=译文。例如：
    魔王=Demon King 勇者=Hero 回復薬=Healing Potion
  4. 将你的文件放在Translation\zh-CN\Text\目录下。插件启动时会加载它们，并且你的手动翻译会覆盖自动生成的或缓存中的低质量翻译。

使用正则表达式（Regex）处理复杂文本游戏有时会将变量和文本拼接在一起，例如獲得 金幣 x 100。直接翻译“獲得 金幣 x 100”很难覆盖“獲得 金幣 x 50”等情况。这时可以用正则表达式。

  1. 在翻译文件中（不要放在_AutoGeneratedTranslations.txt里），使用r:前缀定义正则翻译：
    r:"^獲得 金幣 x ([0-9]+)$"="获得金币 x $1"
    这个规则会将“獲得 金幣 x 100”翻译为“获得金币 x 100”，其中的([0-9]+)匹配数字，$1在译文中引用这个数字。

使用替换文件（Substitutions）进行预处理对于经常被翻译服务误翻的固定词汇，可以在翻译前进行替换。编辑Translation\{Lang}\Text\_Substitutions.txt（如果不存在就创建）：

莉雅=莉娅 聖劍=圣剑

这样，在发送给在线翻译前，“莉雅”会被替换成“莉娅”，避免翻译成“利亚”等奇怪译名。

4.3 性能优化与高级配置

游戏翻译可能会带来性能开销，尤其是在配置不当或翻译大量文本时。

关键性能配置项

[Behaviour] # 启用批处理，将多个短文本合并为一个请求，大幅减少网络请求次数。 EnableBatching=True # 使用静态翻译表。插件内置了一个小型英日词典，对于常见简单词汇直接本地查询，不请求网络。 UseStaticTranslations=True [Text] # 如前所述，限制单次翻译文本长度，避免翻译整本小说。 MaxCharactersPerTranslation=400 # 对于在线免费API，建议设为400以下以防被封 # 延迟时间（毫秒），在发送翻译请求前等待。给UI一点喘息时间，避免卡顿。 DelayAfterTranslation=0 [Http] # 用户代理，某些API可能需要特定的User-Agent。 UserAgent=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36
  • EnableBatching是提升流畅度的最关键设置，务必开启。
  • 将MaxCharactersPerTranslation设为400是一个安全且高效的值，既能处理长对话，又不会触发翻译服务的限流。

处理翻译服务限流与错误免费翻译API通常有调用频率限制。如果遇到翻译失败或游戏卡顿：

  1. 检查日志中是否有大量Failed to translate或网络超时错误。
  2. 尝试增加[Behaviour]区块下的MaxConcurrency（最大并发数，默认可能较高）或调整[Text]下的DelayAfterTranslation（增加等待时间，如50毫秒）。
  3. 考虑切换更稳定的翻译服务，或者配置付费API（如Google Cloud或DeepL），它们有更高的配额和更稳定的服务质量。

4.4 常见问题排查实录（FAQ与解决方案）

即使配置正确，在实际使用中也可能遇到各种问题。下面是我踩过坑后总结的排查清单。

问题1：插件安装后游戏无法启动或立刻闪退。

  • 可能原因：BepInEx版本与游戏不兼容，或XUA插件版本与BepInEx版本不匹配。
  • 解决方案：
    1. 确认游戏是否支持BepInEx。查看游戏社区是否有其他Mod成功运行。
    2. 尝试使用更旧或更新的BepInEx版本。
    3. 确保下载的XUA插件包与你的BepInEx主版本匹配（BepInEx 5.x 用-BepInEx-5.x-的包）。
    4. 查看BepInEx\LogOutput.log或Windows事件查看器，寻找崩溃前的错误信息。

问题2：游戏文本没有变化，按ALT+T也没反应。

  • 可能原因A：插件未成功加载或翻译服务未配置。
  • 排查：检查游戏启动时控制台是否有XUA加载成功的日志。按ALT+0看是否能调出端点选择菜单。
  • 可能原因B：游戏使用IL2CPP编译，且文本钩子不完整。
  • 排查：查看日志中是否有[Warning] Text hook may not be complete for IL2CPP...之类的警告。
  • 解决方案：尝试使用XUnity.AutoTranslator发布页提供的AutoTranslator.IL2CPP.BruteForceFix辅助插件。将其DLL文件同样放入BepInEx\plugins目录。

问题3：翻译出现了，但是“口口口”乱码。

  • 可能原因：字体缺失，如上文所述。
  • 排查步骤：
    1. 确认游戏UI是UGUI还是TextMeshPro。可以通过观察字体边缘是否特别清晰（TMP通常更锐利）来判断，或查看游戏文件。
    2. 在Config.ini中正确配置FallbackFontTextMeshPro或OverrideFont。
    3. 寻找该游戏专用的中文字体Mod。

问题4：翻译延迟很高，文字先显示原文，过一会儿才变成译文。

  • 可能原因：网络延迟或翻译服务响应慢。
  • 解决方案：
    1. 开启EnableBatching。
    2. 适当增加DelayAfterTranslation，但这治标不治本。
    3. 考虑使用本地翻译缓存。多玩一会儿，让插件积累缓存，下次遇到相同文本会瞬间显示。
    4. 切换更快的翻译节点或服务（如从Google国际版切换到Baidu）。

问题5：某些UI元素（如其他Mod的窗口）没有被翻译。

  • 可能原因：IMGUI（Immediate Mode GUI）翻译默认被禁用。
  • 解决方案：在Config.ini中设置[Behaviour]下的EnableIMGUI=True。注意，这可能会轻微影响性能，并可能与其他IMGUI Mod产生冲突。

问题6：自动生成的翻译文件_AutoGeneratedTranslations.txt变得巨大，影响加载速度。

  • 解决方案：定期清理。你可以安全地删除这个文件，插件会重新生成。更好的做法是，将确认无误的翻译行剪切到你自己的手动翻译文件中（如Manual_Good.txt），然后删除_AutoGeneratedTranslations.txt中对应的行或直接清空整个文件。插件会优先使用你手动文件中的翻译。

5. 高阶应用：图片翻译、资源重定向与开发者接口

对于追求完美体验的玩家或Mod开发者，XUA还提供了更底层的功能。

5.1 图片翻译（纹理替换）

这个功能允许你用翻译好的图片替换游戏内的原版图片（比如菜单按钮、带文字的图标）。

  1. 启用功能：在Config.ini中设置[Texture]区块下的EnableTextureTranslation=True和EnableTextureDumping=True。
  2. 启动游戏，进入有目标图片的场景。插件会将游戏加载的纹理图片自动导出到Translation\Texture目录，文件名包含哈希值用于标识，如button_start [ABCD1234-EF567890].png。
  3. 编辑图片：用图像处理软件（如Photoshop、GIMP）打开导出的图片，将上面的外文修改为目标语言，保持图片尺寸和格式不变，保存。
  4. 替换：将修改后的图片放回原目录（可以修改文件名，但必须保留[哈希值]部分）。重启游戏，对应的游戏内图片就应该被替换了。
  5. 重要提示：完成图片替换后，务必将EnableTextureDumping改回False，否则每次运行游戏都会重新导出所有纹理，严重拖慢加载速度并占用磁盘空间。

5.2 资源重定向（Resource Redirector）简介

这是XUA依赖的一个强大底层库（XUnity.ResourceRedirector.dll）。它允许Mod在游戏加载资源（如图片、音频、文本资产）时动态修改或替换它们。XUA的文本和图片翻译功能都是基于此实现的。

对于高级用户或Mod制作者，你可以利用这个API为游戏制作更复杂的Mod，例如：

  • 替换游戏内的音频文件。
  • 修改3D模型或材质。
  • 动态修改游戏脚本（TextAsset）。

这需要一定的C#和Unity Mod开发知识。你可以参考官方文档的“Implementing a Resource Redirector”部分，通过注册钩子（Hook）来拦截和修改加载流程中的资源。

5.3 为其他Mod提供翻译支持

如果你在开发自己的游戏Mod，并且希望它的UI也能被XUA翻译，有两种方法：

  1. 自动支持：只要你的Mod使用标准的Unity UI（UGUI或TMP），并且没有特殊处理，XUA在启用IMGUI翻译后通常能自动捕获文本。
  2. 主动集成：在你的Mod代码中，可以主动调用XUA提供的AutoTranslator.Default.TranslateAsyncAPI来查询翻译，实现更可控的翻译效果。
  3. 避免干扰：如果你的Mod不希望被XUA翻译，可以给你包含文本的GameObject命名为包含XUAIGNORE的字符串，这样XUA就会忽略它。

6. 维护、备份与社区资源

最后，分享一些长期使用的心得。

翻译文件的维护与备份你的Translation目录下的手动翻译文件是宝贵的劳动成果。定期将其备份到云盘或其他位置。当游戏更新或重装系统后，只需将备份的Translation文件夹复制回原位，即可恢复所有精心校对的翻译。

利用社区资源许多热门游戏都有玩家社区维护的XUA翻译包。你可以在GitHub、游戏论坛或Mod发布站（如Nexus Mods）搜索“游戏名+ XUnity AutoTranslator Patch”。这些翻译包通常包含了大量高质量的手动翻译和可能需要的字体文件，能极大提升开箱即用的体验。下载后，将其内容合并到你自己的Translation目录即可。

保持插件更新关注XUA的GitHub发布页，新版本可能会修复bug、增加对新游戏或新Unity版本的支持、或提供新的功能。更新时，注意阅读更新日志，有时配置文件的格式会有变动。

经过以上从原理到实战，从安装到排错的全流程梳理，相信你已经从“游戏语言障碍”的困扰中彻底解放出来了。XUnity.AutoTranslator就像一把万能钥匙，为你打开了无数非母语游戏的大门。剩下的，就是享受游戏的乐趣了。如果在使用中遇到任何本文未覆盖的奇特问题，不妨去项目的GitHub Issues页面看看，或者在有经验的玩家社区提问，那里通常有热心的朋友愿意帮忙。