1. 项目概述为什么你需要XUnity.AutoTranslator如果你是一个喜欢玩各种独立游戏、视觉小说或者小众PC游戏的玩家那你一定遇到过这个让人头疼的问题游戏没有官方中文。面对满屏的英文、日文或者其他语言即使你外语水平不错那种磕磕绊绊、需要频繁查词典的体验也足以消磨掉大半的游戏乐趣。更别提那些文本量巨大的RPG或者剧情向作品了完全就是一场阅读理解考试。XUnity.AutoTranslator以下简称AutoTranslator就是为了解决这个痛点而生的。它不是一个独立的软件而是一个基于BepInEx框架的Unity游戏通用翻译插件。简单来说它就像一个“外挂”的实时翻译器能够拦截游戏运行时显示在屏幕上的文本调用你指定的在线翻译服务如谷歌翻译、百度翻译、DeepL等然后将翻译结果“贴”回游戏界面让你实现近乎实时的游戏内文本地化。我最初接触它是因为一款非常冷门的日系RPG官方明确表示不会推出中文版社区汉化也遥遥无期。在尝试了各种笨办法后AutoTranslator成了我的救命稻草。经过一番折腾和配置我终于能让游戏以流畅的中文进行下去了。这个过程并不像双击安装一个.exe文件那么简单它涉及到运行环境搭建、插件配置、翻译引擎选择等多个环节任何一个步骤出错都可能导致翻译失效。网上虽然有一些零散的教程但要么过于简略要么版本过时让新手望而却步。所以我决定写下这篇终极指南。这不仅仅是一个“点击这里然后点击那里”的步骤列表。我会带你深入理解AutoTranslator的工作原理解释每一个配置项背后的意义分享我在配置不同游戏时踩过的坑和总结出的技巧。无论你是完全没接触过Mod的新手还是有一定基础想优化翻译体验的玩家这篇指南都能帮你从零开始搭建起一套稳定、高效且高度可定制的游戏实时翻译方案。我们的目标很明确让任何没有官方中文的游戏都能在你手中变成“中文版”。2. 核心原理与准备工作理解翻译是如何发生的在动手安装之前我们有必要花几分钟了解一下AutoTranslator到底是怎么工作的。这能让你在后续遇到问题时不再是盲目地尝试而是能有的放矢地进行排查。2.1 AutoTranslator的工作原理拆解你可以把AutoTranslator想象成一个坐在游戏和你的屏幕之间的“同声传译员”。它的工作流程可以分解为以下几个核心步骤文本拦截Hook这是所有工作的起点。AutoTranslator依赖于BepInEx框架。BepInEx是一个强大的Unity游戏模组加载器它能在游戏启动时将自己的代码“注入”到游戏进程中。AutoTranslator作为BepInEx的一个插件会利用这个能力去“钩住”HookUnity引擎中负责在屏幕上渲染文本的函数。当游戏调用这些函数准备显示一段文字时AutoTranslator就能第一时间截获这段原始文本。文本处理与缓存查询截获文本后插件不会立刻去翻译。它先会做几件事修剪多余的空格、检查这段文本是否是一串无意义的代码或特殊符号比如“NEW_ITEM_001”这类内部标识符。然后它会查询本地缓存。这个缓存文件通常是一个Translation.txt存储了你之前已经翻译好的文本。如果找到了完全匹配的原文和译文插件就会直接使用缓存的结果这能极大提升响应速度并减少对翻译API的调用。调用翻译API如果缓存中没有找到AutoTranslator才会将这段文本发送给你预先配置好的在线翻译服务。这里就是配置的关键所在你可以选择谷歌、百度、DeepL等多个引擎。插件会按照你设定的格式向该服务的API发起网络请求。结果显示与缓存收到翻译服务返回的结果后插件会对其进行一些后处理比如调整标点符号以适应中文习惯然后替换掉游戏原本要渲染的文本让你在屏幕上看到翻译后的内容。同时它会把“原文-译文”这对组合写入本地缓存文件。下次游戏再出现同一段文本时就可以直接从缓存读取实现瞬间翻译。整个流程的核心依赖有两个BepInEx提供注入和Hook能力和稳定的网络连接用于调用在线翻译API。理解了这个流程你就会明白为什么安装BepInEx是必须先做的步骤以及为什么翻译延迟有时是网络问题。2.2 必要工具与环境准备工欲善其事必先利其器。在下载AutoTranslator之前我们需要为它搭建好舞台。1. 确认游戏信息首先你需要知道你的游戏是否是使用Unity引擎开发的。绝大多数独立游戏和视觉小说都是。一个简单的判断方法是在游戏根目录下寻找名为“UnityPlayer.dll”或“GameAssembly.dll”的文件如果存在基本就是Unity游戏。AutoTranslator只对Unity游戏有效。2. 下载并安装BepInEx这是AutoTranslator运行的基础。请务必访问BepInEx的官方GitHub发布页面下载。这里有一个关键点你需要选择与你的游戏架构匹配的版本。大多数现代游戏通常是64位x64。你应该下载BepInEx_x64_版本号.zip。一些较老的游戏可能是32位x86。你需要下载BepInEx_x86_版本号.zip。下载后将压缩包内的所有文件解压到你的游戏根目录。什么是游戏根目录就是包含游戏主执行文件.exe的那个文件夹。解压后你应该能看到一个BepInEx文件夹和其他几个.dll、.cfg文件与游戏.exe在同一级目录。3. 首次运行游戏以初始化BepInEx完成解压后直接运行一次游戏。你可能会看到一个控制台窗口闪过游戏可能会比平时启动慢一点。运行几十秒后正常关闭游戏。这个步骤的目的是让BepInEx完成对游戏的初始适配它会在BepInEx文件夹内生成必要的配置文件和plugins等子文件夹。如果没有这一步直接放入AutoTranslator插件可能会不生效。注意有些游戏启动了但BepInEx控制台窗口一闪而过就消失了这可能是杀毒软件或Windows Defender的实时保护拦截了DLL注入。请暂时关闭它们或将游戏目录添加到杀毒软件的白名单中。这是新手遇到插件不生效的最常见原因之一。4. 下载XUnity.AutoTranslator前往AutoTranslator的官方发布页面如GitHub Releases下载最新版本的XUnity.AutoTranslator-BepInEx-版本号.zip。同样确保你下载的是用于BepInEx的版本而不是其他模组框架的。准备工作到此完成。现在你的游戏根目录下应该有一个已经初始化好的BepInEx文件夹。接下来我们就要把翻译插件这个“主角”请上台了。3. 插件安装与基础配置详解安装过程本身并不复杂但细节决定成败。这一步我们会将AutoTranslator部署到位并进行最基础的、能让它运行起来的配置。3.1 安装插件到正确位置解压你下载的XUnity.AutoTranslator-BepInEx-版本号.zip文件。将解压后得到的Translation文件夹和XUnity.AutoTranslator.dll、XUnity.AutoTranslator.BepInEx.ini等文件整体复制到游戏根目录下的BepInEx\plugins文件夹内。最终你的路径结构应该类似于你的游戏根目录/ ├── Game.exe ├── BepInEx/ │ ├── core/ │ ├── plugins/ │ │ └── XUnity.AutoTranslator/ (这是一个文件夹) │ │ ├── Translation/ │ │ │ ├── ab.txt │ │ │ └── ... │ │ ├── XUnity.AutoTranslator.dll │ │ ├── XUnity.AutoTranslator.BepInEx.ini │ │ └── ... │ └── config/ ├── UnityPlayer.dll └── ...重要检查点确保XUnity.AutoTranslator.dll这个文件位于BepInEx/plugins/目录下而不是更深或更浅的层级。这是BepInEx加载插件的标准位置。3.2 理解并修改核心配置文件安装完成后先别急着启动游戏。AutoTranslator的强大和灵活几乎全部体现在它的配置文件里。我们需要先对其进行初步设置。配置文件就是刚才复制过来的XUnity.AutoTranslator.BepInEx.ini有时可能只是.cfg本质相同。用任何文本编辑器如记事本、Notepad、VSCode打开这个文件。你会看到大量以#开头的注释行和许多配置项。不要被吓到我们初期只需要关注几个关键项。1. 启用插件与设置语言找到以下配置段确保它们如下设置[General] # 是否启用自动翻译器。必须为True。 Enabled True # 目标语言代码。这里设置为你希望游戏翻译成的语言。 # zh-CN 简体中文 zh-TW 繁体中文 ja 日语 en 英语等。 Language zh-CN将Enabled设为True是废话但检查一下没错。Language是你最重要的设置之一决定了翻译的目标语言。2. 选择并配置翻译端点重中之重这是整个配置的核心决定了你使用哪个翻译服务。配置文件里通常预置了多个“端点”Endpoint但大部分被注释掉了。你需要启用一个并注释掉其他。以配置**谷歌翻译免费但需要稳定网络**为例[GoogleTranslate] # 是否启用此端点 Enabled True # 源语言自动检测 SourceLanguage auto找到[GoogleTranslate]这个段落将Enabled设为True。同时确保其他翻译端点如[BaiduTranslate]、[DeepLTranslate]等的Enabled是False或被#注释掉。为什么首选谷歌翻译对于新手来说谷歌翻译的免费、无需注册、支持语言广泛是其最大优点。虽然在某些网络环境下可能不稳定但作为入门和测试是最方便的选择。3. 配置缓存与延迟[General] # 略... # 是否启用翻译缓存。强烈建议开启可极大提升重复文本的加载速度。 EnableTranslationCache True # 自动翻译的延迟时间秒。游戏启动后等待多久开始翻译。 # 对于加载较慢的游戏可以适当调高比如5-10秒。 AutoTranslatorDelay 2 # 是否在游戏启动时自动翻译所有文本。 AutoTranslateOnStartup TrueEnableTranslationCache True务必开启。它会在本地生成Translation\zh-CN\*.txt这样的缓存文件下次玩游戏时已翻译过的文本会瞬间显示。AutoTranslatorDelay如果游戏启动时有很长的开场动画或加载过程可以设大一点避免插件在游戏资源未完全加载时就开始工作导致错误。AutoTranslateOnStartup建议开启这样一进游戏就能看到翻译效果。完成以上三步基础配置后保存并关闭配置文件。3.3 首次运行与效果验证现在启动你的游戏。请密切观察控制台窗口如果BepInEx控制台窗口正常出现并保持打开状态这是一个好迹象。你会在里面看到类似[Info] XUnity.AutoTranslator initialized successfully.的日志。游戏内效果进入游戏主菜单或开始新游戏观察界面上的文字。如果配置正确你应该能看到英文或其他源语言文本在短暂闪烁或直接被替换成中文。生成缓存文件玩几分钟后正常关闭游戏。然后去检查BepInEx\plugins\XUnity.AutoTranslator\Translation\zh-CN\这个路径假设你目标语言是zh-CN。你应该能看到一些以数字或字母命名的.txt文件如ab.txt。用记事本打开你会看到里面是“原文译文”的键值对。这说明缓存机制工作正常。如果游戏内没有任何翻译效果怎么办第一步检查BepInEx控制台窗口是否有红色错误信息。常见的错误是“无法连接到翻译服务”。第二步确认配置文件是否保存特别是[GoogleTranslate]的Enabled是否为True且其他端点被禁用。第三步可能是网络问题。谷歌翻译在某些地区访问不稳定。此时你可以考虑切换到下一个章节我们会详细讲解的备用翻译引擎如百度翻译。至此你已经完成了AutoTranslator从安装到基础运行的全过程。游戏里的文字应该已经变成了中文。但这只是开始要获得更流畅、更准确的体验我们还需要进行深度优化和问题排查。4. 翻译引擎深度配置与优化方案基础配置能让你“用上”翻译但要想“用好”就必须根据自身网络环境和需求选择合适的翻译引擎并进行优化。谷歌翻译虽方便但延迟高、偶尔抽风也是事实。本节将深入讲解百度翻译、DeepL等备选方案的配置以及如何提升翻译质量。4.1 主流翻译引擎配置指南方案一百度翻译API国内用户首选百度翻译是国内访问速度最快、最稳定的选择之一但它需要申请免费的API密钥。注册与获取密钥访问百度翻译开放平台官网注册开发者账号。登录后在“管理控制台”创建一个“通用翻译”应用。你将获得一个App ID和一个Secret Key。这两个值需要保密。修改配置文件打开XUnity.AutoTranslator.BepInEx.ini。将[GoogleTranslate]部分的Enabled设为False。找到[BaiduTranslate]部分取消注释并修改如下[BaiduTranslate] Enabled True SourceLanguage auto # 填写你从百度平台获取的App ID和密钥 BaiduAppId 你的AppId BaiduAppSecret 你的SecretKey优势与注意速度极快几乎无延迟。免费额度为每月100万字符对于游戏翻译完全够用。注意保管好密钥不要泄露。方案二DeepL API追求高质量翻译DeepL的翻译质量尤其是对欧洲语言公认比谷歌和百度更好。但它不是免费的。获取API密钥访问DeepL官网注册账号并订阅其API服务有免费试用额度之后按使用量收费。在账户设置中获取你的Auth Key。修改配置文件[DeepLTranslate] Enabled True SourceLanguage auto # 填写你的DeepL API认证密钥 DeepLAuthKey 你的AuthKey # 使用免费版API还是专业版API根据你的订阅选择。 DeepLIsPro False适用场景如果你玩的游戏是日语或西欧语言德、法、西等且对剧情文本的准确性和文学性有较高要求DeepL是值得投资的选择。方案三使用代理解决谷歌翻译网络问题如果你坚持使用谷歌翻译但网络不佳可以尝试在配置中为其设置代理。[GoogleTranslate] Enabled True SourceLanguage auto # 设置代理服务器地址和端口需要你有一个可用的HTTP代理 WebProxy http://127.0.0.1:10809注意此方法需要你本地运行有可用的HTTP代理服务且稳定性取决于代理本身。对于大多数国内用户直接切换为百度翻译是更简单可靠的选择。4.2 提升翻译质量的进阶技巧翻译引擎只是工具如何用好它同样重要。1. 利用“假名”文件进行术语修正AutoTranslator支持一个强大的功能Replacement替换和Fake假名文件。你可以手动指定某些特定词汇或短语的翻译覆盖引擎的翻译结果。操作在Translation\zh-CN\目录下创建一个名为Fake.txt的文件如果不存在。在里面按格式写入Original Text你想要的翻译 Enemy敌人 Potion治疗药水 “Attack”“攻击”保存后重启游戏。当游戏中出现“Enemy”时将直接显示“敌人”而不是引擎翻译的“敌人”或“敌军”。这对于统一游戏内专有名词技能名、物品名、角色名特别有用。2. 调整文本分割与合并策略游戏文本有时会被拆分成碎片导致翻译引擎得到不完整的句子翻译出奇怪的结果。你可以在配置文件中调整[TextFrameworks] # 尝试合并被分割的短句有助于提升翻译连贯性 EnableTextPreprocessing True # 合并文本的最大长度阈值可根据情况调整 MaxCharactersPerSegment 200开启文本预处理并适当调整分段长度可以让翻译引擎看到更完整的语境从而给出更准确的翻译。3. 处理特殊格式文本如RPGMaker游戏一些使用特定引擎如RPGMaker的游戏其文本可能带有控制代码如颜色代码\c[1]。AutoTranslator默认会尝试忽略这些代码进行翻译。如果发现翻译后代码失效导致显示异常可以在配置中调整正则表达式过滤规则但这属于高级内容。一个更简单的方法是在社区如GitHub Issues或相关游戏论坛搜索是否有针对该游戏的特定AutoTranslator配置补丁。4.3 性能与兼容性调优1. 管理缓存文件随着游戏进程缓存文件会越来越大。定期清理旧的、不再使用的缓存文件可以避免插件加载缓存时变慢。你可以安全地删除Translation\zh-CN\下除了Fake.txt如果你创建了之外的所有.txt文件。插件会在下次游戏时重新生成它们。对于长期游玩的游戏保留缓存能提升体验。2. 应对游戏更新游戏更新后原有的缓存文件可能因为文本标识符改变而失效导致翻译消失。此时最彻底的方法是删除整个Translation\zh-CN\文件夹或里面的所有.txt缓存文件。确保AutoTranslator插件本身更新到最新版本如果游戏引擎大更新。重新启动游戏让插件从头开始构建新的缓存。3. 多游戏管理如果你在多个游戏中使用AutoTranslator每个游戏的配置和缓存都是独立的存放在各自游戏的BepInEx\plugins\XUnity.AutoTranslator目录下互不干扰。你可以为每个游戏微调配置例如为网络状况不同的游戏选择不同的翻译端点。通过本章的优化你的游戏翻译应该已经从“能用”进阶到“好用”了。翻译速度更快准确度更高专有名词也更统一。接下来我们将面对实际操作中最可能遇到的各种问题并给出解决方案。5. 常见问题排查与实战技巧实录即使按照指南一步步操作也难免会遇到一些“坑”。这一章是我在长期使用和帮助他人配置过程中总结出的最常见问题及其解决方案以及一些能极大提升体验的实战技巧。5.1 故障排查清单从易到难当你发现翻译不工作时请按以下顺序排查问题1游戏启动后完全没有任何翻译效果BepInEx控制台也没出现。可能原因BepInEx未正确安装或被杀毒软件拦截。解决方案确认BepInEx文件是否解压到了游戏根目录与.exe同级而不是某个子文件夹。首次运行游戏生成BepInEx文件夹后再放入AutoTranslator插件。关闭杀毒软件/Windows Defender的实时保护或将游戏整个目录添加到白名单。重新运行游戏。问题2BepInEx控制台出现并显示插件加载但游戏内无翻译。可能原因A配置文件错误或未生效。解决方案A用记事本再次打开XUnity.AutoTranslator.BepInEx.ini检查[General]下的Enabled和Language是否正确。检查你启用的翻译端点如[GoogleTranslate]的Enabled是否为True并且确保没有多个端点同时被启用应只启用一个。重要检查配置文件编码。有时用非标准编辑器保存后编码可能变成UTF-8 with BOM导致插件无法识别。建议使用Notepad在“编码”菜单中转换为“UTF-8无BOM格式编码”后保存。可能原因B网络问题无法连接翻译API。解决方案B观察BepInEx控制台是否有连续的“Failed to translate...”或网络超时错误。如果用的是谷歌翻译尝试在浏览器中访问translate.google.com测试网络连通性。最有效的解决方式切换到百度翻译API。国内网络环境下百度翻译的可用性远高于谷歌。问题3翻译时有时无或大量文本未被翻译。可能原因A游戏文本渲染方式特殊AutoTranslator的默认钩子Hook未能捕获。解决方案A在配置文件中尝试启用备用钩子。找到[Hook]或[TextFrameworks]部分尝试将EnableIMGUI、EnableUGUI、EnableTextMeshPro等选项从False改为True一次只改一个测试。不同游戏使用不同的UI系统启用对应的钩子可能有效。在AutoTranslator的GitHub页面或相关游戏社区搜索该游戏名称看是否有其他玩家分享特定的配置或插件版本。可能原因B缓存文件冲突或损坏。解决方案B尝试重命名或删除Translation\zh-CN\文件夹让插件重新生成缓存。问题4翻译结果出现乱码、问号或奇怪符号。可能原因字体缺失或编码问题。解决方案确保系统安装了完整的语言包并且非Unicode程序的语言设置为中文简体。少数情况下游戏自身字体不支持中文。这是一个硬伤AutoTranslator无法解决。需要寻找该游戏的“字体Mod”来替换游戏内字体为中文字体。5.2 高级实战技巧与心得技巧1分场景管理翻译缓存对于流程极长的RPG游戏一个巨大的缓存文件可能会在加载时引起轻微卡顿。你可以利用AutoTranslator的“按场景分割缓存”功能。在配置文件中设置[General] # ...其他设置 EnablePerSceneCache True这样插件会为每个游戏场景如“第一章森林”、“主城”创建独立的缓存文件加载更精准管理也更方便。技巧2手动编辑缓存进行精修打开Translation\zh-CN\下的缓存.txt文件你可以直接修改“原文译文”的行。例如你觉得某句台词的机器翻译生硬可以手动改成更符合语境的翻译。保存后下次游戏就会使用你修改后的版本。这是实现“个人定制化汉化”的终极手段。技巧3处理“漏翻”的动态文本有些文本不是静态的而是程序拼接的如“你击败了10个敌人”。AutoTranslator可能只翻译了“你击败了”和“敌人”数字“10”是变量。对于这种通常无法通过简单配置解决。如果非常影响体验可以尝试在Fake.txt中为完整的静态短语添加替换规则但效果有限。技巧4与其他Mod的兼容性AutoTranslator通常与其他修改游戏内容的Mod兼容良好因为它们修改的是不同层面。但如果你安装了其他也修改UI文本的Mod可能会冲突。排查方法是使用“二分法”禁用所有其他Mod只开启AutoTranslator看是否工作然后逐一启用其他Mod找到冲突的元凶。BepInEx的日志会提供线索。技巧5日志是你的最佳助手当遇到任何疑难杂症时第一件事就是打开BepInEx控制台仔细阅读里面的日志信息Log。错误信息Error、警告信息Warning通常会明确指出问题所在比如“无法解析配置第XX行”、“翻译API返回错误403无效密钥”。学会阅读日志你就能自己解决90%的问题。配置AutoTranslator的过程就像是在为你的游戏搭建一个私人的实时翻译官。从最初的安装磕绊到熟练切换引擎、优化缓存、手动修正译文你会发现这不仅是一个技术活更是一个让心爱游戏变得亲切的过程。当看到原本陌生的世界因你的调试而清晰起来那种成就感正是折腾的乐趣所在。记住社区是你强大的后盾遇到无法解决的问题时带着你的日志截图去GitHub的Issues页面或相关的玩家论坛提问通常都能得到热情的帮助。现在去享受你的中文游戏之旅吧。