1. 项目概述为什么Unity游戏翻译是个“技术活”如果你是一个喜欢玩各种独立游戏或者小众海外游戏的玩家肯定遇到过这样的场景游戏本身质量上乘玩法独特但偏偏没有中文。面对满屏的英文、日文或者其他语言查字典查得头晕眼花游戏体验大打折扣。对于开发者而言想要为自己的游戏添加多语言支持又觉得从代码层面重构UI和文本系统工程量巨大尤其是对于已经上线或者使用大量动态文本的游戏。这时候一个能在运行时“无侵入”地翻译游戏文本的工具就成了刚需。XUnity.AutoTranslator后文简称AutoTranslator正是为解决这个问题而生的神器。它不是一个简单的词典替换工具而是一个运行在Unity游戏内部的、高度可配置的实时翻译插件。它的核心原理是“劫持”Unity游戏渲染到屏幕上的文本在文本被绘制之前将其替换为翻译后的内容。这意味着你几乎不需要修改游戏的一行源代码就能让游戏“说”中文。网上有很多教程但要么过于简略只讲“怎么装”要么过于深入牵扯到底层Hook原理让新手望而却步。这篇内容的目标就是让你在理解其核心工作机制的基础上真正“精通”这个工具。从如何为不同游戏PC、Android、甚至WebGL安装到深度配置翻译引擎如Google、Bing、DeepL乃至本地AI模型再到处理那些令人头疼的乱码、漏翻、崩溃问题我会结合我处理过的大量实际案例把踩过的坑和总结的技巧一次性讲透。无论你是想畅玩无中文的游戏的玩家还是寻求快速本地化方案的开发者这都是一份能让你少走弯路的实战指南。2. 核心机制拆解AutoTranslator是如何“无痕”翻译的在深入操作之前我们必须先搞懂AutoTranslator是怎么工作的。知其然更要知其所以然这能帮助你在遇到各种诡异问题时快速定位根源。2.1 文本“钩子”Hook原理Unity游戏最终显示在屏幕上的所有文本无论是UGUI的Text/TextMeshPro还是旧版GUI、NGUI其底层都会调用特定的渲染函数。AutoTranslator的核心就是一个运行在游戏进程内的“注入式”插件通过BepInEx、MelonLoader等Mod框架加载。它利用Harmony这样的库对Unity引擎中负责文本渲染的关键函数如TextGenerator.GetCharacters、TextMeshPro.SetText等进行“打补丁”Patch。这个过程可以简单理解为游戏原本要执行“函数A在坐标(X,Y)绘制字符串Hello World”。AutoTranslator在游戏启动时将自己的一个监听函数“挂钩”到了函数A的入口。当游戏调用函数A时会先经过AutoTranslator的监听函数。监听函数会检查这个“Hello World”是否需要翻译根据配置的白名单、黑名单、正则表达式等。如果需要它就向配置的翻译服务如Google Translate API发起请求获得“你好世界”然后将这个翻译后的字符串替换掉原字符串再交给游戏原本的函数A去执行绘制。于是屏幕上显示的就是中文了。注意这种“运行时替换”的方式决定了翻译的生效范围仅限于游戏运行时。它不会永久修改游戏文件关闭插件或游戏后一切恢复原样。这也意味着所有翻译都需要在游戏运行过程中实时或预加载完成。2.2 翻译流程与缓存机制一次完整的翻译请求并非每次显示文本都发生那样效率太低且容易触发翻译API的速率限制。AutoTranslator设计了高效的缓存机制。文本捕获Hook函数捕获到游戏试图渲染的文本。预处理对文本进行修剪空格、处理富文本标签如colorred、匹配正则规则等操作提取出真正需要翻译的“纯净”文本段。查缓存在本地缓存文件通常是Translation.txt中查找该“纯净”文本是否已有翻译记录。如果有直接使用缓存结果跳至第6步。翻译请求若缓存未命中则将文本发送至配置的翻译服务端在线API或本地服务。接收与后处理接收翻译结果并进行必要的后处理比如还原富文本标签格式、处理特殊字符等。替换与渲染将处理好的翻译文本替换原文本交给Unity渲染。写入缓存将“原文本 - 翻译文本”这对映射关系追加写入本地缓存文件。下次游戏再遇到相同文本就直接走缓存了速度极快。这个流程解释了为什么游戏刚启动时翻译可能会有些卡顿在建立缓存而玩了一段时间后就会非常流畅。你的Translation.txt文件就是宝贵的翻译成果库。2.3 关键配置文件解析AutoTranslator的行为几乎完全由配置文件驱动。理解这几个文件你就掌握了配置的钥匙。BepInEx/config/AutoTranslatorConfig.ini(或类似路径)主配置文件。这是大脑决定翻译行为。[Service]节选择翻译引擎如GoogleTranslate, Bing, DeepL, Papago等及其端点、API密钥。[General]节设置是否启用翻译、源语言和目标语言如en-zh、缓存行为等。[TextFrameworks]节选择要Hook的文本框架UGUI, TextMeshPro等通常全开即可。[Speech]节配置语音合成TTS相关非必需。Translation.txt翻译缓存文件。这是心脏存储所有已翻译的文本对。格式通常是原文本翻译文本。这个文件会随着游戏进行不断增长。你可以手动编辑它来修正错误的翻译也可以分享给他人。AutoTranslator文件夹下的其他.ini文件细分规则文件。这是四肢用于精细控制。Regex.ini使用正则表达式来匹配和替换复杂文本模式。例如游戏内的“LV. 10”你想翻译成“等级 10”就可以用正则规则。Substitution.ini简单的单词或短语替换优先级最高。适合翻译一些UI固定术语如“OK”-“确定”或在API无法访问时提供基础翻译。Fix.ini用于修正翻译后出现的排版、标点、乱码等问题。例如将全角逗号“”替换为半角“,”。3. 实战部署针对不同游戏平台的安装指南理论说完我们动手。安装AutoTranslator的步骤因游戏使用的Mod加载器不同而差异巨大。以下是三种最常见情况的详细流程。3.1 针对使用BepInEx框架的PCWindows游戏这是最普遍的情况。大量Unity游戏使用BepInEx作为Mod加载器。确认游戏环境查看游戏根目录下是否有BepInEx文件夹。如果有winhttp.dll、doorstop_config.ini等文件基本可以确定。下载核心组件从GitHub发布页下载最新版XUnity.AutoTranslator-BepInEx-版本号.zip。同时根据游戏使用的Unity版本可能需要下载对应的XUnity.ResourceRedirector资源重定向器用于处理AssetBundle等复杂情况。通常建议一并下载安装。安装将压缩包内的所有文件解压到游戏根目录即存在Game.exe和BepInEx文件夹的目录。确保文件结构正确通常BepInEx文件夹下会新增plugins和config等子目录。如果提示文件覆盖选择“是”。首次运行与配置启动游戏。如果安装成功游戏启动时控制台或游戏内按F12可能调出的日志窗口会显示AutoTranslator的加载信息。首次运行后关闭游戏。此时会在BepInEx/config目录下生成AutoTranslatorConfig.ini等配置文件。用记事本等文本编辑器打开AutoTranslatorConfig.ini找到[General]节将Language和DestinationLanguage分别设置为en假设游戏原语言是英文和zh目标中文。在[Service]节将Endpoint设置为一个可用的免费在线翻译服务例如GoogleTranslate注意可能需要配置备用地址因为某些服务在国内访问不稳定。验证重新启动游戏观察游戏内文本是否变为中文。打开物品栏、对话界面查看翻译是否生效。实操心得很多新手在这一步失败是因为游戏根目录找错了。真正的根目录是包含游戏主执行文件.exe和UnityPlayer.dll的目录而不是某个子目录如Game_Data。另外如果游戏启动崩溃首先检查BepInEx版本是否与游戏兼容以及AutoTranslator的版本是否匹配你的BepInEx版本如5.x版本。3.2 针对Android手游IL2CPP安卓手游的翻译是难点因为大部分手游发布时使用IL2CPP将C#代码编译为C并进行了代码混淆传统的基于Mono的Mod注入方式失效。这里需要用到专门为IL2CPP设计的加载器。准备工具ZArchiver或MT管理器用于在手机上解压、修改APK文件。目标游戏的APK文件。下载XUnity.AutoTranslator-BepInEx-IL2CPP-版本号.zip。必须确认是IL2CPP版本。下载对应的BepInEx-IL2CPP框架包。解包与注入此操作需要一定的动手能力并建议在PC上进行再用手机安装使用APK编辑工具如APK Easy Tool解包APK。将BepInEx-IL2CPP的文件按照其说明放入APK的lib/arm64-v8a或armeabi-v7a目录并修改libmain.so的加载逻辑通常通过修改libil2cpp.so或使用libloader.so。这是一个关键且易错的步骤具体操作需参考BepInEx-IL2CPP项目的详细文档不同游戏可能有细微差别。将AutoTranslator-IL2CPP的plugins和config文件夹内容放入APK内对应的assets或files目录结构中。重新打包并签名APK安装到手机。配置由于手机文件系统访问限制配置文件路径可能不同。通常AutoTranslator会在手机内部存储的Android/data/游戏包名/files目录下生成或读取配置文件。你需要一个文件管理器来修改这些ini文件。翻译缓存Translation.txt也会生成在这里。选择翻译服务手机游戏强烈建议使用离线翻译引擎或部署在局域网内的本地翻译API服务如用一台电脑搭建LibreTranslate。因为频繁访问境外在线API在移动网络下可能延迟高、不稳定且耗电。踩坑记录安卓IL2CPP翻译的成功率并非100%严重依赖游戏本身是否使用了标准的Unity文本组件以及IL2CPP的混淆强度。一些高度定制或 heavily obfuscated 的游戏可能无法Hook成功。此外修改APK存在违反游戏用户协议的风险请仅用于个人学习研究。3.3 针对Unity WebGL游戏WebGL游戏运行在浏览器中无法直接注入原生插件。AutoTranslator for WebGL采用了一种“覆盖”方案。原理WebGL版本实际上是一个修改过的Unity WebGL加载器模板。它通过拦截浏览器的XMLHttpRequest和WebSocket等网络请求来捕获游戏加载的文本资源如JSON、XML并在资源到达游戏之前进行替换。部署方法你需要有游戏的WebGL构建文件通常是一个包含index.html,Build文件夹的网站。用AutoTranslator WebGL版本提供的template.json和覆盖脚本替换原游戏Build文件夹下的模板文件。修改index.html引入翻译引擎的JavaScript库如配Google Translate JS API或指向你自己搭建的翻译代理服务器。局限性这种方式只能翻译在游戏初始化时通过网络请求加载的静态文本资源。对于运行时动态生成的文本如玩家名字、聊天内容无能为力。配置也更为复杂需要前端开发知识。4. 翻译引擎深度配置从在线API到本地AI默认的在线翻译服务可能受限。本节带你配置更稳定、更强大的翻译后端。4.1 使用免费在线APIGoogle、Bing、DeepL以配置Google Translate为例其他类似打开AutoTranslatorConfig.ini。找到[Service]节确保配置如下[Service] TypeGoogleTranslate EndpointGoogleTranslate处理访问限制由于网络原因你可能无法直接访问。解决方案有使用公共镜像将Endpoint改为一些公开的Google Translate镜像地址例如https://translate.google.cn/translate_a/single注意此类镜像不稳定且可能有安全风险。使用代理在配置文件中AutoTranslator支持配置HTTP/HTTPS代理。你可以设置一个可用的代理服务器地址和端口。[Service] ...其他配置... Proxy127.0.0.1:7890 # 替换为你的代理地址和端口使用第三方聚合服务有些开源项目提供了聚合多个翻译API的服务你可以自行搭建。4.2 搭建本地翻译服务推荐稳定方案这是最可靠、无网络依赖的方案。推荐使用LibreTranslate一个开源的机器翻译引擎。安装LibreTranslate可以通过Docker一键部署。docker run -ti --rm -p 5000:5000 libretranslate/libretranslate配置AutoTranslator[Service] TypeCustom Endpointhttp://localhost:5000/translate你需要根据LibreTranslate的API格式在AutoTranslatorConfig.ini中调整请求体和解析响应的参数。通常需要设置RequestTemplate和ResponseTemplate。例如RequestTemplate{q:{0},source:{1},target:{2}} ResponseTemplate{% raw %}{{result.0.translatedText}}{% endraw %}优点完全离线翻译质量尚可速度取决于本地硬件无次数限制隐私安全。4.3 集成本地AI大模型高阶玩法对于追求极致翻译质量尤其是游戏特有的俚语、文化梗的用户可以接入本地运行的AI大模型如通过Ollama运行的qwen、llama系列模型或text-generation-webui。部署本地AI API使用Ollama运行一个翻译专用的小模型并启用其API接口。ollama run qwen:7b # API 默认运行在 11434 端口配置AutoTranslator这需要将Type设为Custom并精心构造一个符合AI模型API格式的请求。[Service] TypeCustom Endpointhttp://localhost:11434/api/generate RequestTemplate{model:qwen:7b,prompt:请将以下英文游戏文本翻译成地道、流畅的中文保留游戏语境和风格{0},stream:false} ResponseTemplate{% raw %}{{response}}{% endraw %}注意AI模型API的响应格式千差万别ResponseTemplate需要你根据实际API返回的JSON结构来编写以正确提取出翻译文本。这需要一些JSONPath或简单的字符串处理知识。性能与质量权衡本地大模型翻译质量高能理解上下文但速度慢尤其是首次加载消耗大量CPU/GPU资源。不适合配置较低的电脑更适合用于批量预处理Translation.txt缓存文件。5. 高级技巧与疑难杂症排查即使安装成功翻译过程中也会遇到各种问题。这部分是真正的干货。5.1 翻译缓存Translation.txt的管理艺术共享与备份Translation.txt是你的劳动成果。你可以把它分享给其他玩同一款游戏的朋友他们只需将这个文件放到自己的BepInEx/config目录下就能获得完全相同的翻译体验。定期备份这个文件手动修正翻译直接用文本编辑器打开Translation.txt找到翻译不准确的条目进行修改。格式是原文译文。保存后重启游戏即可生效。这是提升翻译质量最直接的方式。清理与合并游戏更新后有些文本可能变了导致旧缓存条目失效甚至可能引起错误。可以定期用工具或手动清理明显过时或不匹配的条目。如果有多个来源的Translation.txt可以用简单的脚本按行合并、去重。编码问题确保Translation.txt以UTF-8编码保存。否则中文字符可能会显示为乱码。在Windows上用记事本保存时选择“另存为”编码选择“UTF-8”。5.2 常见问题与解决方案速查表问题现象可能原因解决方案游戏启动崩溃无任何提示1. BepInEx/AutoTranslator版本与游戏不兼容。2. 缺少依赖插件如ResourceRedirector。3. 游戏反作弊系统阻止注入。1. 尝试更换BepInEx或AutoTranslator的版本如稳定版而非预览版。2. 确保安装了所有必需的依赖插件。3. 对于有反作弊的在线游戏强烈不建议使用可能导致封号。单机游戏可尝试以特定命令行参数启动绕过。游戏能运行但文本毫无变化1. 配置文件未正确设置目标语言。2. 未启用翻译Enabledfalse。3. 文本渲染组件不在Hook列表中。1. 检查AutoTranslatorConfig.ini中的DestinationLanguage。2. 检查[General]下的Enabled。3. 尝试在[TextFrameworks]中启用所有框架TextMeshProtrue,UGUItrue等。部分文本翻译了部分没翻译特别是UI按钮1. 文本可能是图片形式非文字。2. 文本被动态拼接Hook无法捕获完整字符串。3. 该文本组件类型未被Hook。1. 无解需要修改游戏资源。2. 尝试在Regex.ini中编写匹配动态部分的正则表达式。3. 检查游戏使用的UI框架如旧版OnGUI并在配置中启用对应Hook。翻译出现乱码或奇怪符号1. 翻译API返回了错误编码。2. 游戏字体不支持中文字符。3. 富文本标签如size20被破坏。1. 尝试更换翻译服务端点。2. 这是最常见原因需要为游戏添加中文字体。使用AssetBundle修改工具或ResourceRedirector插件将游戏默认字体替换为包含中文的字体如Noto Sans CJK。3. 检查Fix.ini添加规则修复被破坏的标签格式。翻译延迟严重游戏卡顿1. 在线翻译API网络延迟高。2. 每帧翻译请求过多触发了API速率限制。3. 缓存未命中大量文本需要实时翻译。1. 换用本地翻译服务如LibreTranslate。2. 在配置中增加DelaySeconds请求间隔和MaxTranslationsPerFrame每帧最大翻译数。3. 耐心玩一段时间让缓存建立起来。也可以寻找他人分享的该游戏的完整Translation.txt缓存文件。安卓游戏安装后闪退1. IL2CPP注入失败so文件不兼容。2. 游戏有签名校验或完整性检查。3. 手机系统版本过高存在权限限制。1. 确认使用的BepInEx-IL2CPP和AutoTranslator-IL2CPP版本针对该游戏测试过。2. 尝试使用更彻底的破解版APK或学习绕过签名校验难度高。3. 检查Magisk/LSPosed等环境是否配置正确或尝试在虚拟机内运行。5.3 字体缺失问题的终极解决之道“翻译了但显示方框”十有八九是字体问题。Unity游戏通常嵌入英文字体不包含中文字形。定位游戏字体使用Unity Assets Bundle Extractor (UABE) 或 AssetStudio 等工具打开游戏的资源文件通常在GameName_Data文件夹下的.assets或resources.assets文件查找字体资源记下其名称和路径。准备中文字体获取一个支持中文的字体文件.ttf或.otf如“方正准圆_GBK.ttf”、“NotoSansCJK-Regular.ttf”。使用ResourceRedirector进行重定向这是最优雅的方法。安装XUnity.ResourceRedirector插件。在其配置目录创建重定向规则文件将游戏原字体路径映射到你准备好的中文字体文件路径。游戏加载原字体时会自动被重定向到你的中文字体。修改AssetBundle硬核使用UABE直接替换游戏资源包内的字体文件。此方法风险较高游戏更新后需重新操作。5.4 正则表达式Regex.ini实战应用Regex.ini是处理复杂文本的利器。例如游戏内伤害数字显示为“DMG: 1,234”你想翻译成“伤害: 1234”。在Regex.ini中添加规则^DMG:\s*([\d,])$伤害: $1^匹配行首。DMG:匹配原文本。\s*匹配零个或多个空白字符空格等。([\d,])用括号捕获一个或多个数字或逗号的分组。$匹配行尾。右边伤害: $1中的$1表示引用左边第一个捕获分组的内容。这样“DMG: 1,234”就会被替换为“伤害: 1,234”。如果你还想去掉逗号可以写更复杂的规则或者在Fix.ini里再加一条规则去掉所有逗号。掌握基础的正则表达式能让你应对游戏内各种格式化的数字、日期、状态文本的翻译需求。