1. 项目概述为什么我们需要XUnity Auto Translator如果你是一个喜欢玩独立游戏或者小众Unity游戏的玩家肯定遇到过这样的烦恼一款游戏玩法绝佳美术风格也对胃口但偏偏没有中文。看着满屏的英文、日文或者其他语言游玩体验大打折扣。传统的游戏汉化补丁往往需要等待汉化组的“施舍”时间不确定质量也参差不齐而且一旦游戏更新补丁就可能失效。这时候一个能让你自己动手、即时翻译游戏文本的工具就显得尤为重要。XUnity Auto Translator以下简称XUAT正是为解决这个痛点而生的神器。简单来说XUAT是一个开源的Unity游戏实时文本翻译插件。它的核心原理是“劫持”游戏运行时对文本资源的调用将原始文本比如英文截获然后通过你配置的翻译服务如谷歌翻译、百度翻译、DeepL等或者本地词典转换成你设定的目标语言如中文再“塞回”给游戏显示。整个过程几乎是实时的你看到的就是翻译后的结果。这意味着只要游戏是基于Unity引擎开发的理论上你都可以尝试用它来实现即时汉化或翻译将游戏的“语言自由”掌握在自己手中。这个工具尤其适合那些由小型团队或独立开发者制作、暂时没有官方中文支持的游戏。它不仅仅是一个“翻译器”更是一个平台允许你进行术语定制、翻译修正、甚至与其他玩家共享翻译成果。从安装配置到深度调优虽然有一定学习门槛但一旦掌握你就能为任何心仪的Unity游戏“赋予”中文这种成就感和即时的游戏体验提升是无可替代的。接下来我将以一个资深玩家的视角带你从零开始彻底玩转这个工具。2. 核心思路与工作原理解析2.1 XUAT是如何“嵌入”游戏的要理解XUAT首先要明白现代游戏是如何管理文本的。Unity游戏通常不会把每一句对话、每一个物品名称硬编码在程序里而是将它们放在一种叫做“资源包”Asset Bundle或者直接存储在游戏目录下的特定文件如.assets文件中。当游戏需要显示“Play”按钮时它会去这些资源里查找对应的文本键Key比如“UI_BUTTON_PLAY”然后根据当前系统语言设置加载对应的字符串“播放”。XUAT作为一个基于BepInEx一个Unity游戏的Mod加载框架的插件它的介入点就在这里。BepInEx会在游戏启动时将自己注入到游戏进程中。随后XUAT插件被加载。它通过一种称为“Harmony”的库对Unity内部处理文本的函数进行“打补丁”Patch。具体来说它会拦截像Localization.Get、TextMeshPro.text的赋值这类关键函数调用。当游戏试图获取或设置一段文本时XUAT的补丁代码会先一步执行。它检查这段原始文本是否已经被翻译过检查本地缓存如果没有则将其发送给配置好的翻译API获取翻译结果存储到缓存然后返回翻译后的文本给游戏。如果配置了本地词典或术语表则会优先使用本地词条进行替换。这个过程对游戏本身是透明的游戏“以为”它得到的还是原始文本但实际上玩家看到的是经过处理的译文。2.2 核心组件与数据流理解数据流能帮你更好地排查问题。整个翻译流程可以简化为以下几个核心环节文本拦截层由Harmony补丁实现负责捕获游戏引擎中流经的所有文本字符串。缓存查询层拦截到文本后首先查询“翻译缓存”通常是一个Translation.txt或数据库文件。如果该文本的翻译已存在则直接返回这能极大提升效率并避免重复调用API。预处理与术语替换层如果缓存未命中文本会进入预处理环节。这里会应用你定义的“术语表”Terminology。例如你可以规定游戏中的“Mana”永远翻译成“法力值”而不是“魔力”或“玛娜”。术语替换优先于机器翻译能保证关键名词的一致性。机器翻译层经过术语替换后的文本会被发送到你配置的翻译服务如Google Translate, Bing Translator, 或部署在本地的翻译引擎。XUAT支持多种API你需要申请相应的密钥。后处理与缓存层收到机器翻译结果后可能还会进行一些简单的后处理如调整标点然后将“原文-译文”对写入缓存文件。这样下次游戏再遇到同一句文本时就能瞬间加载无需再次联网。输出层将最终处理好的译文返回给游戏完成渲染显示。这个流程的巧妙之处在于它的可配置性和扩展性。你可以关闭机器翻译完全依赖本地词典做一个“离线翻译器”也可以精细调整术语表让翻译更符合游戏世界观甚至可以通过修改缓存文件直接进行人工校对和精翻。3. 前期准备与环境搭建3.1 工具链选择与获取工欲善其事必先利其器。使用XUAT前你需要准备一套完整的Mod加载环境。核心工具如下BepInEx这是基石。它是一个Unity游戏的通用插件加载器为XUAT提供了运行的环境。你需要下载与你的游戏架构通常是x64相匹配的BepInEx版本。通常推荐使用稳定版。XUnity Auto Translator本体插件。你需要从GitHub的发布页面下载最新的XUnity.AutoTranslator-{version}.zip文件。注意有时游戏可能需要特定版本的XUAT如果最新版不兼容可以尝试稍旧的版本。游戏本体确保你的游戏是基于Unity引擎的。如何判断一个简单的方法是查看游戏安装目录如果有UnityPlayer.dll、GameAssembly.dll等文件基本就是Unity游戏。另外游戏最好处于纯净状态没有安装其他可能冲突的Mod。注意不同游戏对BepInEx和XUAT的兼容性差异很大。对于特别新的游戏可能需要使用BepInEx的“ bleeding edge”前沿版本或特定构建。建议在动手前先去相关游戏社区或论坛搜索“游戏名 BepInEx”或“游戏名 AutoTranslator”看看其他玩家是否已经成功可以节省大量试错时间。3.2 标准安装流程详解安装过程其实就是将BepInEx和XUAT部署到游戏目录。以下是通用步骤安装BepInEx将下载的BepInEx压缩包例如BepInEx_x64_5.4.21.0.zip全部解压到游戏的根目录。游戏根目录就是包含游戏主执行文件.exe的文件夹。解压后你应该能看到BepInEx文件夹、doorstop_config.ini、winhttp.dll等文件出现在游戏根目录。首次运行游戏主程序。这会触发BepInEx进行初始化生成完整的目录结构。运行后正常关闭游戏。再次检查游戏根目录下的BepInEx文件夹里面应该自动生成了plugins、config、patchers等子文件夹。安装XUnity Auto Translator解压下载的XUnity.AutoTranslator.zip。将其中的BepInEx文件夹合并到游戏根目录的BepInEx文件夹里。通常这意味着把压缩包里的plugins子文件夹下的XUnity.AutoTranslator目录复制到游戏目录的BepInEx\plugins\下。正确的路径应该类似于你的游戏\BepInEx\plugins\XUnity.AutoTranslator\在这个目录下会有AutoTranslator.dll核心文件以及一些资源文件夹。验证安装再次启动游戏。如果一切顺利游戏启动时在命令行窗口如果BepInEx配置为显示或游戏目录下的BepInEx\LogOutput.log日志文件中你应该能看到XUnity Auto Translator相关的加载信息。更直接的验证方式是进入游戏后检查游戏安装目录下是否生成了BepInEx\Translation文件夹。这个文件夹是XUAT存放缓存和配置的地方它的出现通常意味着插件加载成功。3.3 可能遇到的“坑”与解决方案游戏启动崩溃或无反应这通常是因为BepInEx版本与游戏不兼容。尝试更换BepInEx版本更旧或更新的预览版。另外确保游戏运行库如.NET Framework, VC Redistributable已安装完整。插件未加载检查BepInEx\plugins\XUnity.AutoTranslator目录是否正确AutoTranslator.dll是否存在。查看BepInEx\LogOutput.log日志搜索“AutoTranslator”关键字看是否有加载错误信息。杀毒软件误报BepInEx的注入行为可能被某些杀毒软件视为风险。如果遇到问题尝试将游戏目录添加到杀毒软件的白名单中或暂时关闭杀毒软件进行测试。4. 核心配置与翻译引擎设置安装成功只是第一步让翻译引擎正确工作才是关键。所有配置都集中在BepInEx\config\AutoTranslatorConfig.ini这个文件中。用记事本或任何文本编辑器打开它我们来逐一攻克核心配置项。4.1 翻译服务Endpoint配置这是最重要的部分决定了你的文本由谁来翻译。XUAT支持多种服务国内用户最常用的是百度翻译和彩云小译。以配置百度翻译为例申请API前往百度翻译开放平台注册开发者账号创建通用翻译API服务获取App ID和密钥。修改配置文件在AutoTranslatorConfig.ini中找到[Service]部分。将Endpoint的值改为BaiduTranslate。在下方的[BaiduTranslate]部分如果没有就自己添加填写你的AppId和SecretKey。[Service] EndpointBaiduTranslate ... [BaiduTranslate] AppId你的百度AppId SecretKey你的百度密钥其他服务GoogleTranslate可能需要处理网络访问问题且官方API收费。非商业用途可尝试但稳定性存疑。Caiyun彩云小译国内另一优质选择翻译质量不错。配置方式类似需要去彩云科技开放平台申请令牌Token。**Offline离线**如果你只想使用本地词典不进行任何在线翻译可以设置EndpointOffline。实操心得对于国内用户百度翻译API是综合稳定性、成本和易用性的最佳选择。免费版有每月一定字符数的限额但对于个人游戏翻译通常够用。彩云小译在游戏文本的语境处理上有时更出色但免费额度可能更低。建议都申请一下在配置文件中切换测试选择翻译结果更符合你口味的那一个。4.2 基础行为与缓存配置在[General]部分有几个关键设置FromLanguage和ToLanguage设置源语言和目标语言。例如FromLanguageenToLanguagezh表示从英语翻译到中文。务必确认游戏的实际源语言如果游戏是日文这里却配了en翻译结果会惨不忍睹。MaxCharactersPerTranslation单次翻译请求的最大字符数。百度API默认限制为2000字符/次。如果游戏文本过长如大段日记超过限制的文本会被截断翻译。保持默认或根据API要求调整即可。EnableTranslation总开关必须为true。EnableBatching是否启用批处理。建议true它会把短时间内出现的多个翻译请求合并为一个减少API调用次数提高效率。缓存相关配置在[Behaviour]部分CacheMode缓存模式。WriteToLocalCache是推荐模式它会将在线翻译的结果保存到本地Translation文件夹下的Generated目录中下次直接读取速度极快且不消耗API额度。GeneratedTranslationCacheDirectory生成的翻译缓存目录保持默认即可。4.3 术语表与正则表达式实现精准翻译机器翻译最大的问题是术语不一致和上下文歧义。XUAT的术语表功能是解决这个问题的利器。创建术语表在BepInEx\Translation文件夹下如果没有就新建创建一个名为Terms.txt的文本文件。术语表的格式是原文译文每行一条。例如Potion治疗药水 Mana法力值 Critical Hit暴击 Goblin哥布林术语表支持简单的正则表达式功能强大。例如你想把所有的“Lv. 1”、“Lv. 2”统一翻译成“等级1”、“等级2”可以写Lv\.\s*(\d)等级$1。这里的$1代表了正则表达式中第一个括号捕获的内容即数字。配置加载术语表在AutoTranslatorConfig.ini的[Behaviour]部分确保EnableTranslationScopingtrue默认就是。术语表文件Terms.txt需要放在对应游戏/插件的“作用域”文件夹下。最通用的方法是放在BepInEx\Translation\zh\目录下zh对应你的目标语言代码。XUAT会自动加载该目录下的术语文件。正则表达式进阶应用处理变量文本游戏文本常包含变量如“You have obtained {0} gold.”。直接翻译会导致“{0}”位置错乱。你可以在术语表中写You have obtained (.) gold\.你获得了$1金币。。注意句点.在正则中是特殊字符需要用\.转义。忽略特定文本如果你不想翻译UI元素中的某些代码或标记可以用空译文忽略它。例如colorredcolorred这样颜色标签就不会被送入翻译API避免被破坏。注意事项术语表的加载有优先级。放在更具体作用域下的术语会覆盖通用作用域的。修改术语表后需要删除旧的翻译缓存BepInEx\Translation\zh\Generated下的对应文件或者重启游戏新的术语规则才会生效。养成随时维护术语表的习惯是提升翻译质量最有效的手段。5. 高级功能与深度调优5.1 翻译缓存管理与人工校对翻译缓存Generated文件夹下的文件是宝贵的资产。它不仅是加速器更是你进行人工校对的入口。缓存文件结构通常按游戏内资源文件的哈希或名称生成.txt文件。打开一个缓存文件你会看到类似这样的内容This is a sample text. 这是一个示例文本。每两行为一组原文和译文。人工校对你可以直接编辑这些缓存文件中的译文行。例如你觉得机器翻译的“这是一个示例文本。”不如“这是一段示例文本。”准确直接修改第二行即可。修改后保存文件。校对生效下次启动游戏XUAT会优先读取你修改过的缓存译文完全绕过在线翻译API。这意味着你可以像汉化组一样一句一句地精修游戏的全部文本并且你的修正是持久化的不受游戏更新影响除非游戏更新改变了原文。缓存迁移与共享你的缓存文件可以分享给其他玩家。他们只需要将其放入自己游戏对应的Generated目录就能获得与你一样的翻译效果。这构成了社区协作翻译的基础。5.2 处理特殊文本与UI适配游戏文本不全是简单的句子还包含富文本、图片文字、动态文本等。富文本标签Unity UI常使用color#FF0000Red Text/color这样的标签。XUAT默认会尝试保护这些标签但有时API会破坏它们。除了在术语表中固定还可以在配置中调整[Behaviour]下的TextProcessingRegexPatterns但此选项较为复杂一般玩家无需改动。图片文字图文这是XUAT的软肋。如果文字是直接做在图片纹理里的XUAT无法翻译。这需要OCR光学字符识别技术目前XUAT不原生支持。社区有尝试结合其他OCR插件的方案但复杂度极高。动态生成文本如“Player123”这种由代码拼接的玩家名通常不会被翻译也不需要翻译。字体与显示乱码翻译成中文后如果游戏字体不支持中文会显示为方框□□□。解决方法是为游戏安装中文字体。这通常需要另一个Mod如“Unity游戏通用字体修改器”或手动替换游戏字体文件属于更高级的操作需要针对特定游戏寻找方案。5.3 性能优化与故障排除翻译延迟游戏内文字出现先显示原文瞬间再变成译文这是正常的因为翻译需要时间网络请求处理。启用缓存后第二次看到同一文本就会瞬间显示。如果延迟过长检查网络或考虑换用更快的翻译端点。漏翻有些文本可能没有被插件钩住。原因可能是游戏使用了非标准的文本渲染方式或者文本在插件加载后才动态生成。可以尝试调整插件的加载时机在配置中修改InjectionMethod但风险较高或者检查日志看是否有相关错误。API限额耗尽如果突然不翻译了查看日志文件BepInEx\LogOutput.log很可能是翻译API的免费额度用完了。切换另一个API或者等待额度重置。日志是最好朋友遇到任何问题第一时间查看日志文件。搜索“Error”、“Exception”、“Failed”等关键词能快速定位问题根源。例如如果日志显示“BaiduTranslate API returned error: 54003”去百度翻译错误码表一查便知是“访问频率受限”。6. 实战案例从零汉化一款Unity游戏让我们以一个虚构的Unity独立游戏《星露谷物语》风格的游戏《Farm Fantasy》为例走一遍完整流程。环境侦察确认《Farm Fantasy》是Unity游戏查看目录有UnityPlayer.dll。在游戏社区搜索发现已有玩家成功使用BepInEx 5.4和XUAT 5.0.0版本。部署环境下载对应版本的BepInEx和XUAT按前述步骤安装到《Farm Fantasy》游戏目录。首次启动与配置启动游戏正常关闭。确认生成Translation文件夹。打开AutoTranslatorConfig.ini配置百度翻译API设置FromLanguageenToLanguagezh。二次启动与抓取再次启动游戏进入主界面和初始场景。不要急于操作四处走动打开菜单、物品栏、与NPC对话让游戏加载尽可能多的文本。此时XUAT在后台疯狂调用API并生成缓存。建立术语表游玩一段时间后退出游戏。打开BepInEx\Translation\zh\Generated查看生成的缓存文件。你会发现“Turnip”、“Parsnip”被翻译成了“萝卜”、“欧洲防风草”。你觉得“Parsnip”在游戏里叫“防风草”太拗口决定统一叫“香芹”。同时游戏里的货币“Gold”被译成了“黄金”你想改成“金币”。在BepInEx\Translation\zh\下创建Terms.txt。添加Parsnip香芹Gold金币。为了更彻底你还可以添加(\d) Gold$1金币用正则匹配“100 Gold”并替换为“100金币”。人工精修你发现一段任务描述机器翻译得生硬。找到对应的缓存文件定位到那段文字直接将译文修改得更通顺、更符合游戏语境。测试与迭代重启游戏检查术语替换和人工修改是否生效。继续游戏遇到新的翻译问题就重复步骤5和6更新术语表或缓存。分享成果当你对当前的翻译质量比较满意时可以将BepInEx\Translation\zh整个文件夹打包分享给其他玩家。他们只需要将这个文件夹解压到自己的游戏同一位置就能获得与你相同的汉化体验。通过这个循环你实际上就在扮演一个个人汉化者的角色。XUAT将汉化这个庞大的工程拆解成了可即时反馈、可迭代修改的轻松过程。7. 常见问题速查与终极技巧最后汇总一些高频问题和能极大提升体验的技巧。Q1游戏更新后翻译失效了A游戏更新可能会改变文本资源的内部标识。解决方法删除BepInEx\Translation\zh\Generated文件夹下对应游戏的旧缓存文件如果不确定可以全部删除但会丢失人工校对内容重新启动游戏让XUAT重新生成缓存。你的术语表Terms.txt和手动修改过的其他缓存文件可以保留。Q2翻译结果质量很差语句不通顺A首先确认源语言FromLanguage设置正确。其次尝试更换翻译引擎比如从百度换到彩云。最重要的是积极使用术语表。将机器翻译不准的名词、短语在术语表中固定下来能极大改善整体观感。对于长句只能依靠人工校对缓存文件。Q3如何翻译游戏内的图片按钮A静态图片按钮上的文字XUAT无能为力。动态生成的UI文本如用Unity的Text或TextMeshPro组件创建的则可以。区分方法是如果你能用鼠标选中、复制那些文字那XUAT就有机会翻译它如果是图片的一部分则不能。Q4安装后游戏无法启动或者启动即崩溃A这是最严重的问题。按顺序排查① 确认BepInEx版本与游戏兼容尝试更换版本。② 确认XUAT插件版本兼容。③ 查看BepInEx\LogOutput.log日志文件的最后几十行寻找错误堆栈信息。④ 暂时移除plugins文件夹下的其他所有Mod只留XUAT测试是否是Mod冲突。⑤ 在游戏社区寻求帮助提供你的游戏版本、BepInEx版本、XUAT版本和日志错误信息。终极技巧分而治之不要试图一次性完美汉化整个游戏。先玩遇到什么场景就优化什么场景的翻译。专注于主线任务、UI菜单和常用物品的术语体验提升最明显。备份缓存定期备份你精心校对过的Generated缓存文件夹和Terms.txt文件。这是你的劳动成果。社区力量许多热门游戏都有玩家自发组织的XUAT翻译项目在GitHub或论坛上分享术语表和缓存文件。直接使用或参考这些社区成果能省去大量初期工作。保持耐心自动翻译工具不是魔法它需要你的调教。初期可能会遇到各种奇怪翻译但随着术语表的丰富和关键句子的校对游戏体验会越来越好。这个过程本身也是一种独特的、充满成就感的游戏方式。
Unity游戏实时翻译插件XUnity Auto Translator从入门到精通
发布时间：2026/7/11 2:50:00
1. 项目概述为什么我们需要XUnity Auto Translator如果你是一个喜欢玩独立游戏或者小众Unity游戏的玩家肯定遇到过这样的烦恼一款游戏玩法绝佳美术风格也对胃口但偏偏没有中文。看着满屏的英文、日文或者其他语言游玩体验大打折扣。传统的游戏汉化补丁往往需要等待汉化组的“施舍”时间不确定质量也参差不齐而且一旦游戏更新补丁就可能失效。这时候一个能让你自己动手、即时翻译游戏文本的工具就显得尤为重要。XUnity Auto Translator以下简称XUAT正是为解决这个痛点而生的神器。简单来说XUAT是一个开源的Unity游戏实时文本翻译插件。它的核心原理是“劫持”游戏运行时对文本资源的调用将原始文本比如英文截获然后通过你配置的翻译服务如谷歌翻译、百度翻译、DeepL等或者本地词典转换成你设定的目标语言如中文再“塞回”给游戏显示。整个过程几乎是实时的你看到的就是翻译后的结果。这意味着只要游戏是基于Unity引擎开发的理论上你都可以尝试用它来实现即时汉化或翻译将游戏的“语言自由”掌握在自己手中。这个工具尤其适合那些由小型团队或独立开发者制作、暂时没有官方中文支持的游戏。它不仅仅是一个“翻译器”更是一个平台允许你进行术语定制、翻译修正、甚至与其他玩家共享翻译成果。从安装配置到深度调优虽然有一定学习门槛但一旦掌握你就能为任何心仪的Unity游戏“赋予”中文这种成就感和即时的游戏体验提升是无可替代的。接下来我将以一个资深玩家的视角带你从零开始彻底玩转这个工具。2. 核心思路与工作原理解析2.1 XUAT是如何“嵌入”游戏的要理解XUAT首先要明白现代游戏是如何管理文本的。Unity游戏通常不会把每一句对话、每一个物品名称硬编码在程序里而是将它们放在一种叫做“资源包”Asset Bundle或者直接存储在游戏目录下的特定文件如.assets文件中。当游戏需要显示“Play”按钮时它会去这些资源里查找对应的文本键Key比如“UI_BUTTON_PLAY”然后根据当前系统语言设置加载对应的字符串“播放”。XUAT作为一个基于BepInEx一个Unity游戏的Mod加载框架的插件它的介入点就在这里。BepInEx会在游戏启动时将自己注入到游戏进程中。随后XUAT插件被加载。它通过一种称为“Harmony”的库对Unity内部处理文本的函数进行“打补丁”Patch。具体来说它会拦截像Localization.Get、TextMeshPro.text的赋值这类关键函数调用。当游戏试图获取或设置一段文本时XUAT的补丁代码会先一步执行。它检查这段原始文本是否已经被翻译过检查本地缓存如果没有则将其发送给配置好的翻译API获取翻译结果存储到缓存然后返回翻译后的文本给游戏。如果配置了本地词典或术语表则会优先使用本地词条进行替换。这个过程对游戏本身是透明的游戏“以为”它得到的还是原始文本但实际上玩家看到的是经过处理的译文。2.2 核心组件与数据流理解数据流能帮你更好地排查问题。整个翻译流程可以简化为以下几个核心环节文本拦截层由Harmony补丁实现负责捕获游戏引擎中流经的所有文本字符串。缓存查询层拦截到文本后首先查询“翻译缓存”通常是一个Translation.txt或数据库文件。如果该文本的翻译已存在则直接返回这能极大提升效率并避免重复调用API。预处理与术语替换层如果缓存未命中文本会进入预处理环节。这里会应用你定义的“术语表”Terminology。例如你可以规定游戏中的“Mana”永远翻译成“法力值”而不是“魔力”或“玛娜”。术语替换优先于机器翻译能保证关键名词的一致性。机器翻译层经过术语替换后的文本会被发送到你配置的翻译服务如Google Translate, Bing Translator, 或部署在本地的翻译引擎。XUAT支持多种API你需要申请相应的密钥。后处理与缓存层收到机器翻译结果后可能还会进行一些简单的后处理如调整标点然后将“原文-译文”对写入缓存文件。这样下次游戏再遇到同一句文本时就能瞬间加载无需再次联网。输出层将最终处理好的译文返回给游戏完成渲染显示。这个流程的巧妙之处在于它的可配置性和扩展性。你可以关闭机器翻译完全依赖本地词典做一个“离线翻译器”也可以精细调整术语表让翻译更符合游戏世界观甚至可以通过修改缓存文件直接进行人工校对和精翻。3. 前期准备与环境搭建3.1 工具链选择与获取工欲善其事必先利其器。使用XUAT前你需要准备一套完整的Mod加载环境。核心工具如下BepInEx这是基石。它是一个Unity游戏的通用插件加载器为XUAT提供了运行的环境。你需要下载与你的游戏架构通常是x64相匹配的BepInEx版本。通常推荐使用稳定版。XUnity Auto Translator本体插件。你需要从GitHub的发布页面下载最新的XUnity.AutoTranslator-{version}.zip文件。注意有时游戏可能需要特定版本的XUAT如果最新版不兼容可以尝试稍旧的版本。游戏本体确保你的游戏是基于Unity引擎的。如何判断一个简单的方法是查看游戏安装目录如果有UnityPlayer.dll、GameAssembly.dll等文件基本就是Unity游戏。另外游戏最好处于纯净状态没有安装其他可能冲突的Mod。注意不同游戏对BepInEx和XUAT的兼容性差异很大。对于特别新的游戏可能需要使用BepInEx的“ bleeding edge”前沿版本或特定构建。建议在动手前先去相关游戏社区或论坛搜索“游戏名 BepInEx”或“游戏名 AutoTranslator”看看其他玩家是否已经成功可以节省大量试错时间。3.2 标准安装流程详解安装过程其实就是将BepInEx和XUAT部署到游戏目录。以下是通用步骤安装BepInEx将下载的BepInEx压缩包例如BepInEx_x64_5.4.21.0.zip全部解压到游戏的根目录。游戏根目录就是包含游戏主执行文件.exe的文件夹。解压后你应该能看到BepInEx文件夹、doorstop_config.ini、winhttp.dll等文件出现在游戏根目录。首次运行游戏主程序。这会触发BepInEx进行初始化生成完整的目录结构。运行后正常关闭游戏。再次检查游戏根目录下的BepInEx文件夹里面应该自动生成了plugins、config、patchers等子文件夹。安装XUnity Auto Translator解压下载的XUnity.AutoTranslator.zip。将其中的BepInEx文件夹合并到游戏根目录的BepInEx文件夹里。通常这意味着把压缩包里的plugins子文件夹下的XUnity.AutoTranslator目录复制到游戏目录的BepInEx\plugins\下。正确的路径应该类似于你的游戏\BepInEx\plugins\XUnity.AutoTranslator\在这个目录下会有AutoTranslator.dll核心文件以及一些资源文件夹。验证安装再次启动游戏。如果一切顺利游戏启动时在命令行窗口如果BepInEx配置为显示或游戏目录下的BepInEx\LogOutput.log日志文件中你应该能看到XUnity Auto Translator相关的加载信息。更直接的验证方式是进入游戏后检查游戏安装目录下是否生成了BepInEx\Translation文件夹。这个文件夹是XUAT存放缓存和配置的地方它的出现通常意味着插件加载成功。3.3 可能遇到的“坑”与解决方案游戏启动崩溃或无反应这通常是因为BepInEx版本与游戏不兼容。尝试更换BepInEx版本更旧或更新的预览版。另外确保游戏运行库如.NET Framework, VC Redistributable已安装完整。插件未加载检查BepInEx\plugins\XUnity.AutoTranslator目录是否正确AutoTranslator.dll是否存在。查看BepInEx\LogOutput.log日志搜索“AutoTranslator”关键字看是否有加载错误信息。杀毒软件误报BepInEx的注入行为可能被某些杀毒软件视为风险。如果遇到问题尝试将游戏目录添加到杀毒软件的白名单中或暂时关闭杀毒软件进行测试。4. 核心配置与翻译引擎设置安装成功只是第一步让翻译引擎正确工作才是关键。所有配置都集中在BepInEx\config\AutoTranslatorConfig.ini这个文件中。用记事本或任何文本编辑器打开它我们来逐一攻克核心配置项。4.1 翻译服务Endpoint配置这是最重要的部分决定了你的文本由谁来翻译。XUAT支持多种服务国内用户最常用的是百度翻译和彩云小译。以配置百度翻译为例申请API前往百度翻译开放平台注册开发者账号创建通用翻译API服务获取App ID和密钥。修改配置文件在AutoTranslatorConfig.ini中找到[Service]部分。将Endpoint的值改为BaiduTranslate。在下方的[BaiduTranslate]部分如果没有就自己添加填写你的AppId和SecretKey。[Service] EndpointBaiduTranslate ... [BaiduTranslate] AppId你的百度AppId SecretKey你的百度密钥其他服务GoogleTranslate可能需要处理网络访问问题且官方API收费。非商业用途可尝试但稳定性存疑。Caiyun彩云小译国内另一优质选择翻译质量不错。配置方式类似需要去彩云科技开放平台申请令牌Token。**Offline离线**如果你只想使用本地词典不进行任何在线翻译可以设置EndpointOffline。实操心得对于国内用户百度翻译API是综合稳定性、成本和易用性的最佳选择。免费版有每月一定字符数的限额但对于个人游戏翻译通常够用。彩云小译在游戏文本的语境处理上有时更出色但免费额度可能更低。建议都申请一下在配置文件中切换测试选择翻译结果更符合你口味的那一个。4.2 基础行为与缓存配置在[General]部分有几个关键设置FromLanguage和ToLanguage设置源语言和目标语言。例如FromLanguageenToLanguagezh表示从英语翻译到中文。务必确认游戏的实际源语言如果游戏是日文这里却配了en翻译结果会惨不忍睹。MaxCharactersPerTranslation单次翻译请求的最大字符数。百度API默认限制为2000字符/次。如果游戏文本过长如大段日记超过限制的文本会被截断翻译。保持默认或根据API要求调整即可。EnableTranslation总开关必须为true。EnableBatching是否启用批处理。建议true它会把短时间内出现的多个翻译请求合并为一个减少API调用次数提高效率。缓存相关配置在[Behaviour]部分CacheMode缓存模式。WriteToLocalCache是推荐模式它会将在线翻译的结果保存到本地Translation文件夹下的Generated目录中下次直接读取速度极快且不消耗API额度。GeneratedTranslationCacheDirectory生成的翻译缓存目录保持默认即可。4.3 术语表与正则表达式实现精准翻译机器翻译最大的问题是术语不一致和上下文歧义。XUAT的术语表功能是解决这个问题的利器。创建术语表在BepInEx\Translation文件夹下如果没有就新建创建一个名为Terms.txt的文本文件。术语表的格式是原文译文每行一条。例如Potion治疗药水 Mana法力值 Critical Hit暴击 Goblin哥布林术语表支持简单的正则表达式功能强大。例如你想把所有的“Lv. 1”、“Lv. 2”统一翻译成“等级1”、“等级2”可以写Lv\.\s*(\d)等级$1。这里的$1代表了正则表达式中第一个括号捕获的内容即数字。配置加载术语表在AutoTranslatorConfig.ini的[Behaviour]部分确保EnableTranslationScopingtrue默认就是。术语表文件Terms.txt需要放在对应游戏/插件的“作用域”文件夹下。最通用的方法是放在BepInEx\Translation\zh\目录下zh对应你的目标语言代码。XUAT会自动加载该目录下的术语文件。正则表达式进阶应用处理变量文本游戏文本常包含变量如“You have obtained {0} gold.”。直接翻译会导致“{0}”位置错乱。你可以在术语表中写You have obtained (.) gold\.你获得了$1金币。。注意句点.在正则中是特殊字符需要用\.转义。忽略特定文本如果你不想翻译UI元素中的某些代码或标记可以用空译文忽略它。例如colorredcolorred这样颜色标签就不会被送入翻译API避免被破坏。注意事项术语表的加载有优先级。放在更具体作用域下的术语会覆盖通用作用域的。修改术语表后需要删除旧的翻译缓存BepInEx\Translation\zh\Generated下的对应文件或者重启游戏新的术语规则才会生效。养成随时维护术语表的习惯是提升翻译质量最有效的手段。5. 高级功能与深度调优5.1 翻译缓存管理与人工校对翻译缓存Generated文件夹下的文件是宝贵的资产。它不仅是加速器更是你进行人工校对的入口。缓存文件结构通常按游戏内资源文件的哈希或名称生成.txt文件。打开一个缓存文件你会看到类似这样的内容This is a sample text. 这是一个示例文本。每两行为一组原文和译文。人工校对你可以直接编辑这些缓存文件中的译文行。例如你觉得机器翻译的“这是一个示例文本。”不如“这是一段示例文本。”准确直接修改第二行即可。修改后保存文件。校对生效下次启动游戏XUAT会优先读取你修改过的缓存译文完全绕过在线翻译API。这意味着你可以像汉化组一样一句一句地精修游戏的全部文本并且你的修正是持久化的不受游戏更新影响除非游戏更新改变了原文。缓存迁移与共享你的缓存文件可以分享给其他玩家。他们只需要将其放入自己游戏对应的Generated目录就能获得与你一样的翻译效果。这构成了社区协作翻译的基础。5.2 处理特殊文本与UI适配游戏文本不全是简单的句子还包含富文本、图片文字、动态文本等。富文本标签Unity UI常使用color#FF0000Red Text/color这样的标签。XUAT默认会尝试保护这些标签但有时API会破坏它们。除了在术语表中固定还可以在配置中调整[Behaviour]下的TextProcessingRegexPatterns但此选项较为复杂一般玩家无需改动。图片文字图文这是XUAT的软肋。如果文字是直接做在图片纹理里的XUAT无法翻译。这需要OCR光学字符识别技术目前XUAT不原生支持。社区有尝试结合其他OCR插件的方案但复杂度极高。动态生成文本如“Player123”这种由代码拼接的玩家名通常不会被翻译也不需要翻译。字体与显示乱码翻译成中文后如果游戏字体不支持中文会显示为方框□□□。解决方法是为游戏安装中文字体。这通常需要另一个Mod如“Unity游戏通用字体修改器”或手动替换游戏字体文件属于更高级的操作需要针对特定游戏寻找方案。5.3 性能优化与故障排除翻译延迟游戏内文字出现先显示原文瞬间再变成译文这是正常的因为翻译需要时间网络请求处理。启用缓存后第二次看到同一文本就会瞬间显示。如果延迟过长检查网络或考虑换用更快的翻译端点。漏翻有些文本可能没有被插件钩住。原因可能是游戏使用了非标准的文本渲染方式或者文本在插件加载后才动态生成。可以尝试调整插件的加载时机在配置中修改InjectionMethod但风险较高或者检查日志看是否有相关错误。API限额耗尽如果突然不翻译了查看日志文件BepInEx\LogOutput.log很可能是翻译API的免费额度用完了。切换另一个API或者等待额度重置。日志是最好朋友遇到任何问题第一时间查看日志文件。搜索“Error”、“Exception”、“Failed”等关键词能快速定位问题根源。例如如果日志显示“BaiduTranslate API returned error: 54003”去百度翻译错误码表一查便知是“访问频率受限”。6. 实战案例从零汉化一款Unity游戏让我们以一个虚构的Unity独立游戏《星露谷物语》风格的游戏《Farm Fantasy》为例走一遍完整流程。环境侦察确认《Farm Fantasy》是Unity游戏查看目录有UnityPlayer.dll。在游戏社区搜索发现已有玩家成功使用BepInEx 5.4和XUAT 5.0.0版本。部署环境下载对应版本的BepInEx和XUAT按前述步骤安装到《Farm Fantasy》游戏目录。首次启动与配置启动游戏正常关闭。确认生成Translation文件夹。打开AutoTranslatorConfig.ini配置百度翻译API设置FromLanguageenToLanguagezh。二次启动与抓取再次启动游戏进入主界面和初始场景。不要急于操作四处走动打开菜单、物品栏、与NPC对话让游戏加载尽可能多的文本。此时XUAT在后台疯狂调用API并生成缓存。建立术语表游玩一段时间后退出游戏。打开BepInEx\Translation\zh\Generated查看生成的缓存文件。你会发现“Turnip”、“Parsnip”被翻译成了“萝卜”、“欧洲防风草”。你觉得“Parsnip”在游戏里叫“防风草”太拗口决定统一叫“香芹”。同时游戏里的货币“Gold”被译成了“黄金”你想改成“金币”。在BepInEx\Translation\zh\下创建Terms.txt。添加Parsnip香芹Gold金币。为了更彻底你还可以添加(\d) Gold$1金币用正则匹配“100 Gold”并替换为“100金币”。人工精修你发现一段任务描述机器翻译得生硬。找到对应的缓存文件定位到那段文字直接将译文修改得更通顺、更符合游戏语境。测试与迭代重启游戏检查术语替换和人工修改是否生效。继续游戏遇到新的翻译问题就重复步骤5和6更新术语表或缓存。分享成果当你对当前的翻译质量比较满意时可以将BepInEx\Translation\zh整个文件夹打包分享给其他玩家。他们只需要将这个文件夹解压到自己的游戏同一位置就能获得与你相同的汉化体验。通过这个循环你实际上就在扮演一个个人汉化者的角色。XUAT将汉化这个庞大的工程拆解成了可即时反馈、可迭代修改的轻松过程。7. 常见问题速查与终极技巧最后汇总一些高频问题和能极大提升体验的技巧。Q1游戏更新后翻译失效了A游戏更新可能会改变文本资源的内部标识。解决方法删除BepInEx\Translation\zh\Generated文件夹下对应游戏的旧缓存文件如果不确定可以全部删除但会丢失人工校对内容重新启动游戏让XUAT重新生成缓存。你的术语表Terms.txt和手动修改过的其他缓存文件可以保留。Q2翻译结果质量很差语句不通顺A首先确认源语言FromLanguage设置正确。其次尝试更换翻译引擎比如从百度换到彩云。最重要的是积极使用术语表。将机器翻译不准的名词、短语在术语表中固定下来能极大改善整体观感。对于长句只能依靠人工校对缓存文件。Q3如何翻译游戏内的图片按钮A静态图片按钮上的文字XUAT无能为力。动态生成的UI文本如用Unity的Text或TextMeshPro组件创建的则可以。区分方法是如果你能用鼠标选中、复制那些文字那XUAT就有机会翻译它如果是图片的一部分则不能。Q4安装后游戏无法启动或者启动即崩溃A这是最严重的问题。按顺序排查① 确认BepInEx版本与游戏兼容尝试更换版本。② 确认XUAT插件版本兼容。③ 查看BepInEx\LogOutput.log日志文件的最后几十行寻找错误堆栈信息。④ 暂时移除plugins文件夹下的其他所有Mod只留XUAT测试是否是Mod冲突。⑤ 在游戏社区寻求帮助提供你的游戏版本、BepInEx版本、XUAT版本和日志错误信息。终极技巧分而治之不要试图一次性完美汉化整个游戏。先玩遇到什么场景就优化什么场景的翻译。专注于主线任务、UI菜单和常用物品的术语体验提升最明显。备份缓存定期备份你精心校对过的Generated缓存文件夹和Terms.txt文件。这是你的劳动成果。社区力量许多热门游戏都有玩家自发组织的XUAT翻译项目在GitHub或论坛上分享术语表和缓存文件。直接使用或参考这些社区成果能省去大量初期工作。保持耐心自动翻译工具不是魔法它需要你的调教。初期可能会遇到各种奇怪翻译但随着术语表的丰富和关键句子的校对游戏体验会越来越好。这个过程本身也是一种独特的、充满成就感的游戏方式。
