XUnity.AutoTranslator游戏实时翻译插件：从安装配置到离线词典的完整指南

1. 项目概述：为什么我们需要游戏翻译工具？

如果你是一个喜欢玩各种独立游戏、视觉小说或者小众作品的玩家，肯定遇到过这样的困境：一款游戏口碑极佳，玩法独特，但偏偏没有官方中文。面对满屏的英文、日文或者其他语言，查字典查到头晕，剧情看得一知半解，游戏体验大打折扣。直接等汉化组？有些冷门作品可能永远等不到。这时候，一个能实时翻译游戏内文本的工具，就成了拯救游戏体验的“神器”。

XUnity.AutoTranslator（后文简称AutoTranslator）正是这样一个在玩家社区中口口相传的“神器”。它不是一个独立的软件，而是一个基于BepInEx插件框架开发的Unity游戏模组（Mod）。它的核心功能非常直接：拦截游戏运行时显示的文字，调用在线翻译API（如谷歌翻译、百度翻译、DeepL等）进行实时翻译，然后将翻译结果“贴”回游戏界面，让你几乎感觉不到延迟就能看到中文。我最初接触它是因为一款非常冷门的日系RPG，汉化无望，硬啃又太累，AutoTranslator让我顺利通关并深深爱上了那个故事。

网络上关于它的讨论很多，但信息比较零散。新手常会卡在“AI翻译.json怎么装进游戏里”、“xunity.autotranslator下载后怎么用”这类基础问题上。这篇文章，我就以一个资深Mod使用者和游戏爱好者的身份，带你从零开始，彻底搞懂AutoTranslator。不止是安装，我们会深入它的配置逻辑、翻译优化技巧、常见问题排查，让你不仅能“用上”，更能“用好”，真正高效地享受外语游戏的乐趣。

2. 核心工具链与环境搭建

在开始翻译游戏之前，我们需要搭建一个基础环境。AutoTranslator本身是“寄生”在BepInEx这个Unity游戏模组加载器上的，所以我们的准备工作是环环相扣的。

2.1 BepInEx：模组世界的基石

你可以把BepInEx理解为一个“游戏模组操作系统”。对于使用Unity引擎开发的游戏（市面上绝大多数独立游戏都是），BepInEx能在游戏启动时率先加载，为后续所有模组提供一个稳定、规范的运行环境。没有它，像AutoTranslator这样的插件根本无法被游戏识别和执行。

安装步骤与要点：

1. 确定游戏位数：首先，找到你的游戏根目录（通常包含GameName.exe的那个文件夹）。右键查看GameName.exe的属性，在“兼容性”或“详细信息”标签页里，确认它是32位还是64位应用程序。这一步至关重要，下载错误版本的BepInEx会导致无法启动。
2. 下载对应版本：前往BepInEx的GitHub发布页。对于大部分较新的Unity游戏，直接下载BepInEx_x64_版本号.zip（64位）或BepInEx_x86_版本号.zip（32位）的稳定版即可。
3. 部署文件：将下载的ZIP包解压，把里面的所有文件和文件夹（通常是BepInEx文件夹、winhttp.dll、doorstop_config.ini等）直接复制到游戏根目录。如果系统询问是否覆盖或合并文件夹，选择“是”。
4. 首次运行验证：双击启动游戏。如果安装成功，游戏启动时你会看到命令行窗口一闪而过（这是BepInEx在加载），游戏根目录下会生成BepInEx文件夹，并且里面会有plugins、config等子文件夹。首次运行后，关闭游戏。

注意：有些游戏可能有反作弊或特殊的文件校验，安装BepInEx后无法启动。这种情况需要寻找针对该游戏的特定BepInEx补丁或使用其他加载器，但这属于进阶问题，绝大多数单机游戏不会有此限制。

2.2 获取与放置XUnity.AutoTranslator

AutoTranslator本身以插件（.dll文件）的形式存在。你需要根据你的游戏类型（普通Unity游戏还是“恋活”“AI少女”等ILLUSION系游戏）选择对应的版本。

实操流程：

1. 下载插件：从GitHub的Releases页面下载最新版本的XUnity.AutoTranslator-BepInEx-版本号.zip。如果你玩的是ILLUSION系的游戏，则需要专门下载标有-Illusion-版本的ZIP包，这两个版本的底层钩子（Hook）不同，混用会导致翻译失效或游戏崩溃。
2. 解压与放置：将下载的ZIP包解压。你会看到类似这样的结构：

   BepInEx/ ├── plugins/ │ └── XUnity.AutoTranslator/ │ ├── AutoTranslator.dll │ └── Translation/ └── config/ └── AutoTranslatorConfig.ini

   你需要做的，是将解压出的BepInEx文件夹整体拖入游戏根目录，与之前安装BepInEx时生成的文件夹合并。确保AutoTranslator.dll最终位于游戏根目录\BepInEx\plugins\XUnity.AutoTranslator\路径下。
3. 关键文件说明：
   • AutoTranslator.dll：核心插件文件。
   • AutoTranslatorConfig.ini：翻译器的所有设置都在这，我们接下来会详细调教它。
   • Translation/文件夹：用于存放离线词典和缓存文件，非常重要。

2.3 翻译引擎的选择与配置

安装好插件只是搭好了舞台，翻译引擎才是台上的演员。AutoTranslator支持多种引擎，我们需要在配置文件中指定。

打开配置文件：用记事本、Notepad++或VSCode等文本编辑器打开游戏根目录\BepInEx\config\AutoTranslatorConfig.ini。

找到并修改引擎配置：在文件中找到[General]段落下的Endpoint配置项。默认可能是GoogleTranslate或BaiduTranslate。你可以根据网络环境和翻译质量偏好进行修改。

主流引擎对比与配置方法：

以配置百度翻译为例：

1. 注册百度云账号并开通“通用翻译API”服务。
2. 在管理控制台创建应用，获取App ID和密钥。
3. 在AutoTranslatorConfig.ini中设置：

   [General] Endpoint=BaiduTranslate BaiduAppId=你的App ID BaiduAppSecret=你的密钥

4. 保存文件。

个人心得：对于大多数用户，我建议首选GoogleTranslate（如果网络允许），它的综合性价比最高。如果游戏是日文，且你追求更地道的翻译，可以尝试BaiduTranslate（需配置Key）或Papago（针对韩文）。DeepL和ChatGPT属于“发烧友”选择，在翻译一些文学性强的游戏文本时优势明显，但需要一定的成本和配置能力。

3. 配置文件深度解析与优化

AutoTranslatorConfig.ini是这个工具的大脑。默认配置能用，但优化后体验天差地别。我们来逐一拆解关键参数。

3.1 基础行为控制

[General] # 语言设置：从什么语言翻译成什么语言 SourceLanguage=ja # 源语言，例如 ja(日文), en(英文), ko(韩文) DestinationLanguage=zh-CN # 目标语言，zh-CN(简体中文) # 覆盖模式：当本地有翻译文本时，是否用在线翻译覆盖 OverrideExistingTranslations=false

• SourceLanguage/DestinationLanguage：务必填对。很多游戏是日英双语，如果你设SourceLanguage=en去玩日版游戏，翻译会一塌糊涂。不确定游戏语言时，可以先用auto让翻译引擎自动检测，但可能增加延迟和错误。
• OverrideExistingTranslations：建议保持false。这样当你在Translation文件夹中放置了精心校对的离线翻译文件（如*.txt或*.json）后，插件会优先使用这些本地翻译，而不是每次都用可能出错的在线翻译覆盖它。这是保证翻译质量稳定的关键。

3.2 翻译触发与延迟优化

游戏文本瞬息万变，如何平衡翻译速度和系统负担是关键。

[General] # 自动翻译的延迟（秒）。文本出现后等待多久才发送翻译请求。 DelaySeconds=0.5 # 是否启用缓存。强烈建议开启，重复文本不再请求翻译，极大提升速度。 EnableTranslationCache=true

• DelaySeconds：这个参数非常实用。设置一个0.3-1秒的延迟，可以避免在游戏快速滚屏（如对话连点）时，瞬间发起大量无效的翻译请求，导致API限额被快速消耗或翻译队列堵塞。对于视觉小说这类文本显示稳定的游戏，可以设小一点（如0.3）；对于动作游戏UI，可以设大一点（如0.8）。
• EnableTranslationCache：务必设为true。开启后，翻译过的文本会以*.cache文件形式保存在Translation文件夹。下次遇到相同原文，直接读取缓存，速度极快，且能节省API调用次数。

3.3 文本处理与正则表达式

游戏文本常夹杂代码、颜色标签（如<color=red>），直接翻译会破坏格式。AutoTranslator提供了强大的文本预处理功能。

[General] # 是否翻译富文本（HTML/UBB标签）。关闭可以避免翻译到标签内部。 TranslateRichTextTags=false [TextProcessing] # 使用正则表达式匹配并“保护”特定文本不被翻译 RegexProtectionPatterns=^\\d+$, ^[A-Z]{2,}$, \\[.*?\\]

• TranslateRichTextTags：通常设为false。否则翻译器可能试图翻译<color=red>里的red，导致游戏渲染出错。
• RegexProtectionPatterns：这是高手向配置。你可以用正则表达式告诉插件：“匹配这些模式的文本，跳过不要翻译”。例如：
  • ^\d+$：保护纯数字（如物品ID、血量值）。
  • ^[A-Z]{2,}$：保护全大写的缩写（如UI中的“HP”、“MP”、“EXP”）。
  • \[.*?\]：保护中括号内的所有内容（常见于游戏指令或特殊标识）。 合理设置保护规则，能极大提升翻译结果的整洁度和可用性。

3.4 字体与显示渲染

翻译出来了，但显示乱码或字体难看怎么办？

[Font] # 是否启用字体替换。如果游戏原字体不支持中文，必须开启。 EnableFontReplacement=true # 替换后的字体名称。使用系统已安装的字体名。 FontName=Microsoft YaHei UI # 字体大小调整（相对于原字体） FontSize=16

• EnableFontReplacement：如果游戏内翻译的中文显示为方框“□□□”，说明游戏原字体字库不含中文，必须将此设为true。
• FontName：填写你系统里有的中文字体名。推荐Microsoft YaHei UI（微软雅黑UI，Win系统自带，清晰）、SimHei（黑体）或KaiTi（楷体）。你也可以下载“思源黑体”、“方正准圆”等字体安装到系统后，在这里填写字体文件名（不含后缀）。
• FontSize：可以微调翻译文本的大小，使其与原UI更协调。

4. 高级应用：离线词典与翻译缓存管理

依赖在线翻译总有网络波动或翻译不准的时候。打造一个属于自己的离线词典库，是提升体验的终极方案。这也是解决“ai翻译.json怎么装进游戏里”这个问题的核心。

4.1 离线词典的格式与创建

AutoTranslator的离线词典支持多种格式，最常用的是txt和json。

1. TXT格式（最简单直观）：在Translation文件夹下，创建一个以游戏语言代码命名的文本文件，例如ja.txt（日文原文）或zh-CN.txt（中文译文）。格式为一行原文，一行译文，空行分隔。

原文句子1 翻译句子1 原文句子2 翻译句子2

你可以手动将游戏中查到的生涩句子，或在线翻译不准的句子，按此格式添加进去。插件会优先使用这里的翻译。

2. JSON格式（结构化，功能强大）：这才是“ai翻译.json”的正确打开方式。JSON格式可以承载更复杂的信息，比如上下文。

{ "Entries": [ { "Key": "これは剣です。", "Value": "这是一把剑。", "Context": "ItemDescription" // 可选：上下文标识，避免同一原文在不同场景翻译错误 }, { "Key": "おはよう、主人公！", "Value": "早上好，主角！" } ] }

你可以将网络上下载的汉化补丁（如果是文本形式的），或利用其他工具导出的游戏文本，转换成这种JSON格式，放入Translation文件夹。插件启动时会自动加载。

如何“装进游戏里”？很简单，无论你得到的是.txt还是.json文件，只需将它们直接复制到游戏根目录\BepInEx\Translation\文件夹下即可。无需修改配置，插件会自动识别并加载。文件名最好能体现内容，如ManualPatch_ja.txt或Community_Translate.json。

4.2 翻译缓存的妙用与共享

开启缓存后，Translation文件夹下会生成*.cache文件。这不仅仅是加速，它还是一个宝贵的“翻译成果库”。

• 备份与迁移：当你重装游戏或换电脑时，把整个Translation文件夹备份下来。在新环境安装好AutoTranslator后，将备份的文件夹覆盖回去，之前翻译过的所有文本都无需再次请求在线翻译，立刻可用。
• 社区共享：你可以将自己的*.cache文件分享给其他玩同一款游戏的朋友。他们放入自己的Translation文件夹后，就能直接享用你已经翻译好的内容，省时省力。这也是很多游戏社区里“共享翻译缓存”的由来。
• 手动编辑缓存：缓存文件本质也是一种文本格式。如果你发现某句缓存翻译不准，可以直接用文本编辑器打开对应的.cache文件（注意备份），搜索原文并进行修改，保存后游戏内就会显示你修改后的译文。

4.3 结合OCR实现“全屏翻译”

AutoTranslator主要翻译游戏“内存”中的文本。但对于一些无法被直接截取文本的游戏（如某些使用特殊图形字体的，或纯图片化的文字），可以配合OCR（光学字符识别）工具实现“曲线救国”。

一种可行的联动方案：

1. 使用Textractor、VNR等带有OCR功能的视觉小说翻译工具，或者独立的OCR软件（如天若OCR、Capture2Text）。
2. 配置OCR工具识别游戏窗口的特定区域。
3. 将OCR识别出的文本，通过一些脚本或中间件（如Translator++这类游戏翻译辅助工具），模拟或导入到AutoTranslator的翻译流程中。
4. 这属于非常高阶的用法，需要一定的技术动手能力，但它极大地扩展了AutoTranslator的适用范围。

5. 实战问题排查与性能调优

工具用起来，总会遇到各种稀奇古怪的问题。这里我总结了一份“踩坑实录”，希望能帮你快速排雷。

5.1 翻译完全不生效

这是最让人头疼的问题。请按以下顺序检查：

1. 检查BepInEx是否成功加载：运行游戏后，查看游戏根目录下是否生成了BepInEx\LogOutput.log文件。用记事本打开，搜索XUnity.AutoTranslator或AutoTranslator。如果能看到相关的加载成功信息，说明插件已运行。如果没有，回到第一步重装BepInEx。
2. 检查插件路径：确认AutoTranslator.dll文件在BepInEx\plugins\XUnity.AutoTranslator\下，且没有放在子文件夹里。
3. 检查配置文件：确认AutoTranslatorConfig.ini中的Endpoint设置正确。如果使用了百度等需要Key的引擎，确认App ID和密钥填写无误（注意不要有多余空格）。
4. 检查游戏语言：确认SourceLanguage设置与游戏实际语言一致。尝试改为auto看是否有效。
5. 查看游戏日志：AutoTranslator会在BepInEx\LogOutput.log中记录详细错误。常见的错误有“Invalid API key”（API密钥错误）、“Network error”（网络连接失败）等。根据日志提示修正。

5.2 翻译延迟高或漏翻

1. 调整DelaySeconds：如果是在文本密集出现的场景（如快速对话），适当增大延迟（如从0.5调到1.0）可以减少拥堵，让翻译队列更顺畅。
2. 开启并利用缓存：确保EnableTranslationCache=true。首次游玩新场景时翻译会慢一些，等缓存建立后，再次游玩会非常流畅。
3. 检查API限额：免费翻译API通常有每秒或每日请求次数限制。如果短时间内请求太多，会被暂时限制。在配置文件中可以找到MaxConcurrentTranslations（最大并发数，默认5）和MaxCharactersPerTranslation（每次最大字符数，默认150）等参数，适当调低可以避免触发限制，但会减慢整体速度，需要权衡。
4. 网络问题：如果使用GoogleTranslate且网络不稳定，可以尝试更换为BaiduTranslate或使用网络加速工具。

5.3 中文显示为方框（乱码）

这是字体问题，按前述方法配置[Font]段落。

1. 确认EnableFontReplacement=true。
2. 确认FontName填写的是正确的系统字体名。可以在系统字体文件夹（C:\Windows\Fonts）里查看字体文件的“名称”属性。
3. 有些游戏引擎版本特殊，可能需要额外的字体Mod（FontMod）配合。如果更换字体名无效，可以去游戏社区搜索“游戏名+字体补丁”。

5.4 游戏崩溃或闪退

1. 版本兼容性：确保你下载的AutoTranslator版本与BepInEx版本、游戏Unity引擎版本大致兼容。过于陈旧的插件可能不支持新游戏。
2. 插件冲突：如果你还安装了其他BepInEx插件，可能是冲突导致。尝试暂时移除其他插件，只保留AutoTranslator，看游戏是否稳定。
3. ILLUSION游戏专用：务必使用标有-Illusion-的专用版本！使用通用版会导致钩子错误，极易崩溃。
4. 查看崩溃日志：游戏根目录或BepInEx文件夹下可能会生成error.log或crash.dmp文件，这是排查崩溃原因的关键。

5.5 性能优化建议

• 固态硬盘（SSD）：将游戏安装在SSD上，能显著加快缓存文件的读写速度，提升翻译加载效率。
• 定期清理缓存：Translation文件夹下的*.cache文件会随时间增长。如果文件过大（超过几百MB），可以定期备份后删除旧的缓存文件，让插件重新生成，有时能解决一些奇怪的缓存错误。
• 关闭不必要的翻译端点：在配置文件中，除了你使用的Endpoint，其他引擎的配置项（如BaiduAppId,OpenAIApiKey等）如果没用，就留空或注释掉，保持配置文件简洁。

折腾这些配置和排查问题的过程，本身也是玩Mod的乐趣之一。当你终于调教好一切，看着原本天书般的游戏界面变成熟悉的母语，那种成就感是无与伦比的。AutoTranslator不仅仅是一个工具，它更像是一把钥匙，为你打开了无数扇原本因语言障碍而紧闭的游戏世界之门。从按部就班的安装，到深入配置的调优，再到打造个人离线词库，每一步都让你对游戏的理解和控制更深一层。记住，最宝贵的往往不是那个完美的默认配置，而是你在解决“为什么翻译不了这句话”、“怎么让这个UI显示更舒服”的过程中，积累下来的经验和那个量身定制的Translation文件夹。