1. 项目概述为什么我们需要XUnity Auto Translator如果你是一个独立游戏开发者或者在一个小团队里负责本地化工作那么你肯定对Unity游戏的多语言翻译又爱又恨。爱的是它能帮你打开全球市场恨的是这个过程往往繁琐、重复而且容易出错。传统的做法是什么在代码里写死一堆if-else判断或者维护一个巨大的Excel表格每次更新文本都像在走钢丝生怕哪里漏掉一个逗号导致游戏里出现“口口口”或者直接崩溃。这就是XUnity Auto Translator以下简称XUAT诞生的背景。它不是一个官方工具而是一个由社区驱动的、功能强大的插件。简单来说它的核心目标就一个自动化地拦截、翻译和替换Unity游戏运行时显示的文本。这意味着你不需要反编译游戏不需要修改游戏原始的代码和资源文件就能实现实时翻译。对于玩家社区来说它是汉化补丁的神器对于开发者而言它则是进行本地化测试、快速制作多语言原型甚至是处理遗留项目本地化的绝佳工具。我第一次接触XUAT是在处理一个老旧的Unity项目时那个项目的UI文本散落在上百个Prefab和脚本里手动提取和替换几乎是不可能完成的任务。XUAT救了我。它通过“劫持”Unity的文本渲染流程在文本被绘制到屏幕前的那一刻用你提供的翻译字典进行替换。整个过程对游戏本身是透明的稳定且高效。2. 核心原理与架构拆解它到底是怎么工作的要玩转XUAT不能只停留在“怎么用”的层面理解其工作原理能让你在遇到问题时快速定位甚至进行高级定制。它的架构可以概括为“一个核心两条路径”。2.1 核心机制文本“钩子”HookXUAT的核心是一个运行在游戏进程内的“注入式”插件。它利用Mono或IL2CPP运行时提供的机制将自身代码“注入”到游戏进程中。一旦成功注入它就开始寻找Unity引擎中负责文本显示的关键函数例如TextMeshProUGUI.SetText、Text.set_text等。找到后它会将自己的处理函数“挂钩”到这些函数上。这个过程可以想象成在邮局Unity引擎的派信流程中安插了一个翻译员XUAT。每当有信件原始文本需要派送显示到屏幕时翻译员会先截获这封信查看自己的翻译手册翻译文件如果手册里有对应的译文就把信件内容换成译文然后再继续派送。游戏本身完全不知道信件被调包了它只负责派送“最终拿到手的信件”。2.2 两条翻译路径离线与在线XUAT提供了两种主要的翻译方式对应不同的使用场景。路径一离线翻译基于文件这是最常用、最稳定的方式。XUAT会生成或读取一个特定格式的翻译文件通常是.txt或.po格式。这个文件里存储着“原文译文”的键值对。当游戏运行时XUAT拦截到文本后会立刻在这个本地字典里查找匹配项。如果找到瞬间完成替换如果找不到文本则保持原样。优点速度快零延迟不依赖网络翻译质量完全可控由翻译者决定。缺点需要预先准备好完整的翻译文件。对于动态生成的文本如玩家名字、随机事件描述如果原文没有预先收录则无法翻译。适用场景游戏汉化组制作发布补丁开发者进行正式的本地化发布。路径二在线翻译基于API这种方式更“智能”但也更复杂。XUAT在拦截到未知文本即离线文件中没有的文本时会将其通过HTTP请求发送到你配置的在线翻译API如Google Translate、DeepL、百度翻译等。获取到翻译结果后再替换显示同时可以选择将这次翻译的结果缓存到本地文件供后续使用。优点能处理未预见的动态文本自动化程度高适合快速预览或填充初版翻译。缺点依赖网络有延迟尤其是长文本需要API密钥可能有费用翻译质量取决于第三方服务在剧情关键处可能产生滑稽的错误。适用场景开发者快速评估游戏内容量为早期测试版生成基础翻译处理一些极其零散的、难以抓取的UI文本。注意在线翻译API的使用涉及服务条款和费用。例如Google Cloud Translate API不是免费的需要绑定信用卡并创建项目。滥用或配置不当可能导致高额账单。对于玩家汉化用途强烈建议仅使用离线翻译模式以避免法律和经济风险。2.3 插件组成与工作流一个典型的XUAT工作环境包含以下部分BepInEx这是一个Unity游戏的通用插件框架。XUAT通常作为BepInEx的一个插件Plugin运行。BepInEx负责基础的注入、插件管理和配置。XUnity.AutoTranslator核心插件本体包含文本拦截、翻译逻辑、文件管理等功能。翻译文件位于游戏目录下的Translation文件夹内按语言代码如zh-CN、ja组织。配置文件(AutoTranslatorConfig.ini)控制XUAT的所有行为比如启用哪种翻译方式、在线API的端点、是否启用缓存、排除哪些组件不翻译等。工作流简述游戏启动 → BepInEx加载 → XUAT插件初始化 → 读取配置 → 加载离线翻译文件 → 挂钩Unity文本函数 → 游戏运行文本被拦截 → 查询离线/在线翻译 → 替换文本 → 显示到屏幕。3. 实战部署从零开始配置你的第一个翻译项目理论讲完我们动手。假设我们要为一款名为“MyFantasyGame”的Unity游戏制作中文翻译。这里以最常见的基于BepInEx的部署方式为例。3.1 环境准备与工具选择首先你需要确定游戏使用的Unity版本和后端。现代Unity游戏大多使用IL2CPP后端以提升性能和安全性这与老旧的Mono后端在插件注入方式上有所不同。查看游戏版本检查游戏根目录下是否有UnityPlayer.dll和GameAssembly.dll。如果两者都有通常是IL2CPP如果只有前者可能是Mono。选择BepInEx版本根据游戏架构x86/x64和后端Mono/IL2CPP去BepInEx的GitHub Releases页面下载对应的版本。对于IL2CPP的64位游戏你需要的是BepInEx_unity_xxxx_x64_xxxx.zip这类标注了IL2CPP和x64的包。除了BepInEx和XUAT插件本身我强烈建议准备以下工具文本编辑器如VSCode、Notepad用于编辑翻译文件.txt和配置文件.ini。文件对比工具如Beyond Compare、WinMerge。当游戏更新翻译文件需要合并时这个工具能救命。Unity资源查看工具可选如AssetStudio。用于直接查看游戏资源包内的文本辅助翻译和验证。3.2 步步为营的安装流程步骤1安装BepInEx框架下载正确的BepInEx包并解压。将解压出的所有文件和文件夹BepInExdoorstop_config.iniwinhttp.dll等复制到游戏的可执行文件.exe所在目录。首次运行游戏。如果安装成功游戏目录下会生成完整的BepInEx文件夹结构包括pluginsconfigpatchers等子文件夹。关闭游戏。步骤2安装XUnity Auto Translator插件下载XUAT插件通常是一个.zip或.7z文件。将插件包内的Translation文件夹和BepInEx文件夹合并到游戏根目录。通常你需要把插件包里的BepInEx/plugins下的文件复制到你游戏目录的BepInEx/plugins下。确认BepInEx/plugins目录下存在XUnity.AutoTranslator相关的DLL文件如XUnity.AutoTranslator-BepInEx-5.4.xx.xx.dll。步骤3关键配置详解现在来到最重要的环节配置BepInEx/config/AutoTranslatorConfig.ini。这个文件控制一切。[General] ; 是否启用插件 Enabledtrue ; 目标语言代码简体中文 Languagezh-CN ; 是否在游戏内显示翻译状态F10开启 ShowTranslationGUItrue [Service] ; 翻译服务类型。Offline表示仅使用离线文件 ; 如果想用在线翻译可改为GoogleTranslate、BaiduTranslate等但需要配置下方Endpoint FallbackEndpointOffline [Text] ; 最大文本长度超长的文本如整本书可能不会被翻译避免性能问题 MaxCharactersPerTranslation500 ; 是否翻译TextMeshPro文本现代UI必备 EnableTextMeshProSupporttrue ; 是否翻译UGUI Text文本传统UI EnableUGUITextSupporttrue [Behaviour] ; 是否自动转储未翻译的文本到文件用于收集待翻译内容 EnableTranslationScopingtrue ; 转储文件的格式TXT更易读 DumpModeTxt步骤4创建与管理翻译文件在游戏根目录的Translation文件夹下创建一个以目标语言代码命名的子文件夹例如zh-CN。在该文件夹内创建一个Text文件夹。在Text文件夹内你可以创建多个.txt文件来组织翻译。例如UI.txt存放所有用户界面文本。Subtitles.txt存放所有对话字幕。Items.txt存放物品名称和描述。翻译文件的格式非常简单每行一条格式为原文译文。Welcome to the Adventure!欢迎来到冒险世界 Press [Enter] to start.按[Enter]键开始。 Health: {0}生命值{0} ; 注意{0}是占位符必须保留实操心得建议在游戏内开启ShowTranslationGUI然后进行游戏。GUI会显示当前拦截到的原文。你可以一边玩一边把屏幕上出现的原文和你想好的译文记录到对应的TXT文件里。这是最直接的“抓取-翻译”循环。3.3 测试与验证配置完成后启动游戏。如果一切正常游戏启动时BepInEx会在控制台或生成的日志文件BepInEx/LogOutput.log中输出加载信息确认XUAT插件已加载。进入游戏主菜单如果原本是英文的按钮、标题变成了中文恭喜你离线翻译成功了按F10默认可以调出翻译GUI查看当前翻译状态、未翻译的文本数量等。4. 高级技巧与疑难排坑实录基础配置只是开始要想让翻译工作流畅高效避免各种“坑”你需要下面这些进阶知识和技巧。4.1 翻译文件管理的艺术随着游戏进程深入翻译文件会越来越大。如何高效管理分而治之不要把所有翻译堆在一个Generated.txt里。按照游戏模块UI、任务、对话、系统、场景或资源包来划分文件。XUAT会加载Text文件夹下所有的.txt文件所以拆分不影响功能却极大提升了可维护性。版本控制使用Git等工具管理你的翻译文件夹。每次游戏更新前备份你的Translation/zh-CN文件夹。游戏更新后先用空翻译文件跑一遍让XUAT生成新的Generated.txt然后用对比工具将新旧Generated.txt对比把新增的原文合并到你的手工翻译文件中并检查是否有旧译文因原文改动而失效。处理特殊字符与格式富文本标签Unity的TextMeshPro支持colorredText/color这样的标签。翻译时标签必须原封不动地保留或正确迁移。例如color#FF0000Danger!/color翻译为color#FF0000危险/color。换行符TXT文件中直接换行即可。如果原文有\n译文中也应保留或根据语言习惯调整位置。占位符像{0}{1:HP}这类代码中的字符串格式化占位符绝对不能翻译或改变顺序。你的任务是翻译它周围的文字。4.2 在线翻译API的谨慎使用如果你决定使用在线翻译作为辅助请务必小心。配置示例以Google Translate为例[Service] FallbackEndpointGoogleTranslate [GoogleTranslate] ; 这里填写你的Google Cloud API密钥 GoogleAPIKeyYOUR_ACTUAL_API_KEY_HERE费用与限制所有主流翻译API都采用按字符数计费的模式。虽然个人使用量通常很小但务必在云平台设置预算警报防止意外。免费额度用完后费用可能迅速攀升。质量陷阱机器翻译对游戏术语、文化梗、角色特有语气词的处理往往很糟糕。它只能作为初稿生成器。永远不要直接使用未经审校的机器翻译作为最终版本尤其是对于角色驱动型游戏。4.3 常见问题与解决方案速查表以下是我在多个项目中踩过的坑和解决方案问题现象可能原因排查与解决步骤游戏启动崩溃或BepInEx日志报错1. BepInEx版本与游戏不兼容。2. XUAT插件版本与BepInEx版本不匹配。3. 游戏反作弊系统阻止注入。1. 确认游戏架构x86/x64和后端Mono/IL2CPP更换BepInEx版本。2. 查看XUAT插件发布页面的说明确认其支持的BepInEx核心版本。3. 对于有反作弊的在线游戏切勿尝试这违反用户协议且可能导致封号。XUAT仅适用于单机或本地多人游戏。插件已加载但游戏内文本毫无变化1. 目标语言配置错误。2. 翻译文件路径或格式错误。3. 文本组件类型未启用支持。1. 检查Language配置项确保是zh-CN而非zh或Chinese。2. 检查Translation/zh-CN/Text文件夹是否存在且内部TXT文件编码为UTF-8。3. 确认配置中EnableTextMeshProSupport和EnableUGUITextSupport已设为true。部分文本翻译了部分没翻译1. 原文未收录在翻译文件中。2. 文本是图片的一部分图文字。3. 文本通过非常规方式动态生成如Shader。1. 开启EnableTranslationScoping游玩未翻译的部分然后在Translation/zh-CN/下找到新生成的_AutoGeneratedTranslations.txt将缺失的条目复制到你的手工文件。2. 图片文字无法通过此插件翻译需要修改游戏资源这超出了XUAT的范围。3. 这类文本通常无法被拦截需要考虑其他修改方式。翻译后出现乱码或“口口口”字体缺失对应语言的字符集。这是Unity字体渲染的经典问题。你需要让游戏加载一个包含中文字符的字体。有时可以通过替换游戏字体文件实现但这属于更深层次的游戏修改。一个变通方案是使用XUAT的“字体补丁”功能如果该游戏版本支持或寻找社区已经制作好的字体Mod。在线翻译不起作用1. API密钥错误或未启用。2. 网络连接问题。3. 请求频率超限。1. 仔细检查云平台如Google Cloud Console中Translate API是否已启用密钥是否有权限。2. 查看BepInEx日志通常会有详细的HTTP错误码输出。3. 免费API有QPS限制可以尝试在配置中增加[Service]下的Delay参数来降低请求频率。4.4 性能优化与调试心得控制翻译范围在配置文件中你可以使用[Text]章节下的ExcludedComponents或ExcludedPaths来排除不需要翻译的UI元素。例如排除那些纯数字显示、版本号等可以减少不必要的拦截和查询提升性能。善用缓存即使主要使用离线翻译也可以开启[Behaviour]下的EnableTranslationCachetrue。XUAT会将解析过的翻译缓存在内存中对重复出现的文本如“确定”按钮能进一步提升速度。日志是你的朋友遇到任何诡异问题第一件事就是打开BepInEx/LogOutput.log文件。XUAT的日志非常详细从加载的插件版本、读取的翻译文件数量到每一次文本拦截和替换的成功与否都有记录。根据错误信息搜索能解决90%的问题。5. 超越基础自动化流程与团队协作当翻译项目变得庞大一个人力不从心时就需要引入一些自动化工具和协作方法。5.1 利用Python脚本自动化处理你可以编写简单的Python脚本用于自动格式化翻译文件去除多余空格、检查是否有遗漏的等号、将单引号统一为双引号等。提取增量文本比较新旧游戏版本生成的Generated.txt自动输出新增的、需要翻译的原文列表。机器翻译预处理将待翻译的原文列表通过API批量翻译生成一个初稿文件供人工审校。# 示例一个简单的去重和排序脚本 import sys def clean_translation_file(file_path): with open(file_path, r, encodingutf-8) as f: lines f.readlines() # 去重保留最后一个出现的 unique_lines {} for line in lines: line line.strip() if in line: key, _ line.split(, 1) unique_lines[key] line # 排序 sorted_lines sorted(unique_lines.values()) with open(file_path .cleaned.txt, w, encodingutf-8) as f: f.write(\n.join(sorted_lines)) if __name__ __main__: clean_translation_file(sys.argv[1])5.2 团队协作与版本管理对于大型游戏的汉化一个团队是必须的。制定规范统一术语表如“Health”统一译为“生命值”而非“血量”或“健康值”、翻译风格指南角色口吻、字体使用规范。使用协作平台虽然直接共享TXT文件也可以但更推荐使用专业的本地化管理平台或至少是Git。Git可以清晰记录每个人的修改方便回滚和合并。可以为每个翻译文件设置负责人。建立审校流程翻译 → 交叉审校 → 终审 → 集成测试。在游戏内实际测试翻译效果至关重要很多上下文相关的错误只有在实际游玩时才能发现。XUnity Auto Translator是一个强大而灵活的工具它降低了Unity游戏本地化的技术门槛。从玩家自制汉化补丁到开发者的内部本地化测试它的应用场景非常广泛。核心在于理解其“运行时拦截替换”的原理并善用离线文件这一稳定可靠的基石。在线翻译API是一把双刃剑能提供便利但也带来质量、成本和稳定性的风险需谨慎使用。最后无论是用XUAT还是其他任何工具本地化的本质都是“文化适配”而不仅仅是文字转换。一个好的翻译需要理解游戏的世界观、角色的性格和故事的语境。工具负责解决“能不能翻”的技术问题而翻译者则要解决“翻得好不好”的艺术问题。当你看到自己翻译的文本完美地融入游戏为其他玩家带来无障碍的体验时那种成就感才是这个过程中最宝贵的收获。
1. 项目概述为什么我们需要XUnity Auto Translator如果你是一个独立游戏开发者或者在一个小团队里负责本地化工作那么你肯定对Unity游戏的多语言翻译又爱又恨。爱的是它能帮你打开全球市场恨的是这个过程往往繁琐、重复而且容易出错。传统的做法是什么在代码里写死一堆if-else判断或者维护一个巨大的Excel表格每次更新文本都像在走钢丝生怕哪里漏掉一个逗号导致游戏里出现“口口口”或者直接崩溃。这就是XUnity Auto Translator以下简称XUAT诞生的背景。它不是一个官方工具而是一个由社区驱动的、功能强大的插件。简单来说它的核心目标就一个自动化地拦截、翻译和替换Unity游戏运行时显示的文本。这意味着你不需要反编译游戏不需要修改游戏原始的代码和资源文件就能实现实时翻译。对于玩家社区来说它是汉化补丁的神器对于开发者而言它则是进行本地化测试、快速制作多语言原型甚至是处理遗留项目本地化的绝佳工具。我第一次接触XUAT是在处理一个老旧的Unity项目时那个项目的UI文本散落在上百个Prefab和脚本里手动提取和替换几乎是不可能完成的任务。XUAT救了我。它通过“劫持”Unity的文本渲染流程在文本被绘制到屏幕前的那一刻用你提供的翻译字典进行替换。整个过程对游戏本身是透明的稳定且高效。2. 核心原理与架构拆解它到底是怎么工作的要玩转XUAT不能只停留在“怎么用”的层面理解其工作原理能让你在遇到问题时快速定位甚至进行高级定制。它的架构可以概括为“一个核心两条路径”。2.1 核心机制文本“钩子”HookXUAT的核心是一个运行在游戏进程内的“注入式”插件。它利用Mono或IL2CPP运行时提供的机制将自身代码“注入”到游戏进程中。一旦成功注入它就开始寻找Unity引擎中负责文本显示的关键函数例如TextMeshProUGUI.SetText、Text.set_text等。找到后它会将自己的处理函数“挂钩”到这些函数上。这个过程可以想象成在邮局Unity引擎的派信流程中安插了一个翻译员XUAT。每当有信件原始文本需要派送显示到屏幕时翻译员会先截获这封信查看自己的翻译手册翻译文件如果手册里有对应的译文就把信件内容换成译文然后再继续派送。游戏本身完全不知道信件被调包了它只负责派送“最终拿到手的信件”。2.2 两条翻译路径离线与在线XUAT提供了两种主要的翻译方式对应不同的使用场景。路径一离线翻译基于文件这是最常用、最稳定的方式。XUAT会生成或读取一个特定格式的翻译文件通常是.txt或.po格式。这个文件里存储着“原文译文”的键值对。当游戏运行时XUAT拦截到文本后会立刻在这个本地字典里查找匹配项。如果找到瞬间完成替换如果找不到文本则保持原样。优点速度快零延迟不依赖网络翻译质量完全可控由翻译者决定。缺点需要预先准备好完整的翻译文件。对于动态生成的文本如玩家名字、随机事件描述如果原文没有预先收录则无法翻译。适用场景游戏汉化组制作发布补丁开发者进行正式的本地化发布。路径二在线翻译基于API这种方式更“智能”但也更复杂。XUAT在拦截到未知文本即离线文件中没有的文本时会将其通过HTTP请求发送到你配置的在线翻译API如Google Translate、DeepL、百度翻译等。获取到翻译结果后再替换显示同时可以选择将这次翻译的结果缓存到本地文件供后续使用。优点能处理未预见的动态文本自动化程度高适合快速预览或填充初版翻译。缺点依赖网络有延迟尤其是长文本需要API密钥可能有费用翻译质量取决于第三方服务在剧情关键处可能产生滑稽的错误。适用场景开发者快速评估游戏内容量为早期测试版生成基础翻译处理一些极其零散的、难以抓取的UI文本。注意在线翻译API的使用涉及服务条款和费用。例如Google Cloud Translate API不是免费的需要绑定信用卡并创建项目。滥用或配置不当可能导致高额账单。对于玩家汉化用途强烈建议仅使用离线翻译模式以避免法律和经济风险。2.3 插件组成与工作流一个典型的XUAT工作环境包含以下部分BepInEx这是一个Unity游戏的通用插件框架。XUAT通常作为BepInEx的一个插件Plugin运行。BepInEx负责基础的注入、插件管理和配置。XUnity.AutoTranslator核心插件本体包含文本拦截、翻译逻辑、文件管理等功能。翻译文件位于游戏目录下的Translation文件夹内按语言代码如zh-CN、ja组织。配置文件(AutoTranslatorConfig.ini)控制XUAT的所有行为比如启用哪种翻译方式、在线API的端点、是否启用缓存、排除哪些组件不翻译等。工作流简述游戏启动 → BepInEx加载 → XUAT插件初始化 → 读取配置 → 加载离线翻译文件 → 挂钩Unity文本函数 → 游戏运行文本被拦截 → 查询离线/在线翻译 → 替换文本 → 显示到屏幕。3. 实战部署从零开始配置你的第一个翻译项目理论讲完我们动手。假设我们要为一款名为“MyFantasyGame”的Unity游戏制作中文翻译。这里以最常见的基于BepInEx的部署方式为例。3.1 环境准备与工具选择首先你需要确定游戏使用的Unity版本和后端。现代Unity游戏大多使用IL2CPP后端以提升性能和安全性这与老旧的Mono后端在插件注入方式上有所不同。查看游戏版本检查游戏根目录下是否有UnityPlayer.dll和GameAssembly.dll。如果两者都有通常是IL2CPP如果只有前者可能是Mono。选择BepInEx版本根据游戏架构x86/x64和后端Mono/IL2CPP去BepInEx的GitHub Releases页面下载对应的版本。对于IL2CPP的64位游戏你需要的是BepInEx_unity_xxxx_x64_xxxx.zip这类标注了IL2CPP和x64的包。除了BepInEx和XUAT插件本身我强烈建议准备以下工具文本编辑器如VSCode、Notepad用于编辑翻译文件.txt和配置文件.ini。文件对比工具如Beyond Compare、WinMerge。当游戏更新翻译文件需要合并时这个工具能救命。Unity资源查看工具可选如AssetStudio。用于直接查看游戏资源包内的文本辅助翻译和验证。3.2 步步为营的安装流程步骤1安装BepInEx框架下载正确的BepInEx包并解压。将解压出的所有文件和文件夹BepInExdoorstop_config.iniwinhttp.dll等复制到游戏的可执行文件.exe所在目录。首次运行游戏。如果安装成功游戏目录下会生成完整的BepInEx文件夹结构包括pluginsconfigpatchers等子文件夹。关闭游戏。步骤2安装XUnity Auto Translator插件下载XUAT插件通常是一个.zip或.7z文件。将插件包内的Translation文件夹和BepInEx文件夹合并到游戏根目录。通常你需要把插件包里的BepInEx/plugins下的文件复制到你游戏目录的BepInEx/plugins下。确认BepInEx/plugins目录下存在XUnity.AutoTranslator相关的DLL文件如XUnity.AutoTranslator-BepInEx-5.4.xx.xx.dll。步骤3关键配置详解现在来到最重要的环节配置BepInEx/config/AutoTranslatorConfig.ini。这个文件控制一切。[General] ; 是否启用插件 Enabledtrue ; 目标语言代码简体中文 Languagezh-CN ; 是否在游戏内显示翻译状态F10开启 ShowTranslationGUItrue [Service] ; 翻译服务类型。Offline表示仅使用离线文件 ; 如果想用在线翻译可改为GoogleTranslate、BaiduTranslate等但需要配置下方Endpoint FallbackEndpointOffline [Text] ; 最大文本长度超长的文本如整本书可能不会被翻译避免性能问题 MaxCharactersPerTranslation500 ; 是否翻译TextMeshPro文本现代UI必备 EnableTextMeshProSupporttrue ; 是否翻译UGUI Text文本传统UI EnableUGUITextSupporttrue [Behaviour] ; 是否自动转储未翻译的文本到文件用于收集待翻译内容 EnableTranslationScopingtrue ; 转储文件的格式TXT更易读 DumpModeTxt步骤4创建与管理翻译文件在游戏根目录的Translation文件夹下创建一个以目标语言代码命名的子文件夹例如zh-CN。在该文件夹内创建一个Text文件夹。在Text文件夹内你可以创建多个.txt文件来组织翻译。例如UI.txt存放所有用户界面文本。Subtitles.txt存放所有对话字幕。Items.txt存放物品名称和描述。翻译文件的格式非常简单每行一条格式为原文译文。Welcome to the Adventure!欢迎来到冒险世界 Press [Enter] to start.按[Enter]键开始。 Health: {0}生命值{0} ; 注意{0}是占位符必须保留实操心得建议在游戏内开启ShowTranslationGUI然后进行游戏。GUI会显示当前拦截到的原文。你可以一边玩一边把屏幕上出现的原文和你想好的译文记录到对应的TXT文件里。这是最直接的“抓取-翻译”循环。3.3 测试与验证配置完成后启动游戏。如果一切正常游戏启动时BepInEx会在控制台或生成的日志文件BepInEx/LogOutput.log中输出加载信息确认XUAT插件已加载。进入游戏主菜单如果原本是英文的按钮、标题变成了中文恭喜你离线翻译成功了按F10默认可以调出翻译GUI查看当前翻译状态、未翻译的文本数量等。4. 高级技巧与疑难排坑实录基础配置只是开始要想让翻译工作流畅高效避免各种“坑”你需要下面这些进阶知识和技巧。4.1 翻译文件管理的艺术随着游戏进程深入翻译文件会越来越大。如何高效管理分而治之不要把所有翻译堆在一个Generated.txt里。按照游戏模块UI、任务、对话、系统、场景或资源包来划分文件。XUAT会加载Text文件夹下所有的.txt文件所以拆分不影响功能却极大提升了可维护性。版本控制使用Git等工具管理你的翻译文件夹。每次游戏更新前备份你的Translation/zh-CN文件夹。游戏更新后先用空翻译文件跑一遍让XUAT生成新的Generated.txt然后用对比工具将新旧Generated.txt对比把新增的原文合并到你的手工翻译文件中并检查是否有旧译文因原文改动而失效。处理特殊字符与格式富文本标签Unity的TextMeshPro支持colorredText/color这样的标签。翻译时标签必须原封不动地保留或正确迁移。例如color#FF0000Danger!/color翻译为color#FF0000危险/color。换行符TXT文件中直接换行即可。如果原文有\n译文中也应保留或根据语言习惯调整位置。占位符像{0}{1:HP}这类代码中的字符串格式化占位符绝对不能翻译或改变顺序。你的任务是翻译它周围的文字。4.2 在线翻译API的谨慎使用如果你决定使用在线翻译作为辅助请务必小心。配置示例以Google Translate为例[Service] FallbackEndpointGoogleTranslate [GoogleTranslate] ; 这里填写你的Google Cloud API密钥 GoogleAPIKeyYOUR_ACTUAL_API_KEY_HERE费用与限制所有主流翻译API都采用按字符数计费的模式。虽然个人使用量通常很小但务必在云平台设置预算警报防止意外。免费额度用完后费用可能迅速攀升。质量陷阱机器翻译对游戏术语、文化梗、角色特有语气词的处理往往很糟糕。它只能作为初稿生成器。永远不要直接使用未经审校的机器翻译作为最终版本尤其是对于角色驱动型游戏。4.3 常见问题与解决方案速查表以下是我在多个项目中踩过的坑和解决方案问题现象可能原因排查与解决步骤游戏启动崩溃或BepInEx日志报错1. BepInEx版本与游戏不兼容。2. XUAT插件版本与BepInEx版本不匹配。3. 游戏反作弊系统阻止注入。1. 确认游戏架构x86/x64和后端Mono/IL2CPP更换BepInEx版本。2. 查看XUAT插件发布页面的说明确认其支持的BepInEx核心版本。3. 对于有反作弊的在线游戏切勿尝试这违反用户协议且可能导致封号。XUAT仅适用于单机或本地多人游戏。插件已加载但游戏内文本毫无变化1. 目标语言配置错误。2. 翻译文件路径或格式错误。3. 文本组件类型未启用支持。1. 检查Language配置项确保是zh-CN而非zh或Chinese。2. 检查Translation/zh-CN/Text文件夹是否存在且内部TXT文件编码为UTF-8。3. 确认配置中EnableTextMeshProSupport和EnableUGUITextSupport已设为true。部分文本翻译了部分没翻译1. 原文未收录在翻译文件中。2. 文本是图片的一部分图文字。3. 文本通过非常规方式动态生成如Shader。1. 开启EnableTranslationScoping游玩未翻译的部分然后在Translation/zh-CN/下找到新生成的_AutoGeneratedTranslations.txt将缺失的条目复制到你的手工文件。2. 图片文字无法通过此插件翻译需要修改游戏资源这超出了XUAT的范围。3. 这类文本通常无法被拦截需要考虑其他修改方式。翻译后出现乱码或“口口口”字体缺失对应语言的字符集。这是Unity字体渲染的经典问题。你需要让游戏加载一个包含中文字符的字体。有时可以通过替换游戏字体文件实现但这属于更深层次的游戏修改。一个变通方案是使用XUAT的“字体补丁”功能如果该游戏版本支持或寻找社区已经制作好的字体Mod。在线翻译不起作用1. API密钥错误或未启用。2. 网络连接问题。3. 请求频率超限。1. 仔细检查云平台如Google Cloud Console中Translate API是否已启用密钥是否有权限。2. 查看BepInEx日志通常会有详细的HTTP错误码输出。3. 免费API有QPS限制可以尝试在配置中增加[Service]下的Delay参数来降低请求频率。4.4 性能优化与调试心得控制翻译范围在配置文件中你可以使用[Text]章节下的ExcludedComponents或ExcludedPaths来排除不需要翻译的UI元素。例如排除那些纯数字显示、版本号等可以减少不必要的拦截和查询提升性能。善用缓存即使主要使用离线翻译也可以开启[Behaviour]下的EnableTranslationCachetrue。XUAT会将解析过的翻译缓存在内存中对重复出现的文本如“确定”按钮能进一步提升速度。日志是你的朋友遇到任何诡异问题第一件事就是打开BepInEx/LogOutput.log文件。XUAT的日志非常详细从加载的插件版本、读取的翻译文件数量到每一次文本拦截和替换的成功与否都有记录。根据错误信息搜索能解决90%的问题。5. 超越基础自动化流程与团队协作当翻译项目变得庞大一个人力不从心时就需要引入一些自动化工具和协作方法。5.1 利用Python脚本自动化处理你可以编写简单的Python脚本用于自动格式化翻译文件去除多余空格、检查是否有遗漏的等号、将单引号统一为双引号等。提取增量文本比较新旧游戏版本生成的Generated.txt自动输出新增的、需要翻译的原文列表。机器翻译预处理将待翻译的原文列表通过API批量翻译生成一个初稿文件供人工审校。# 示例一个简单的去重和排序脚本 import sys def clean_translation_file(file_path): with open(file_path, r, encodingutf-8) as f: lines f.readlines() # 去重保留最后一个出现的 unique_lines {} for line in lines: line line.strip() if in line: key, _ line.split(, 1) unique_lines[key] line # 排序 sorted_lines sorted(unique_lines.values()) with open(file_path .cleaned.txt, w, encodingutf-8) as f: f.write(\n.join(sorted_lines)) if __name__ __main__: clean_translation_file(sys.argv[1])5.2 团队协作与版本管理对于大型游戏的汉化一个团队是必须的。制定规范统一术语表如“Health”统一译为“生命值”而非“血量”或“健康值”、翻译风格指南角色口吻、字体使用规范。使用协作平台虽然直接共享TXT文件也可以但更推荐使用专业的本地化管理平台或至少是Git。Git可以清晰记录每个人的修改方便回滚和合并。可以为每个翻译文件设置负责人。建立审校流程翻译 → 交叉审校 → 终审 → 集成测试。在游戏内实际测试翻译效果至关重要很多上下文相关的错误只有在实际游玩时才能发现。XUnity Auto Translator是一个强大而灵活的工具它降低了Unity游戏本地化的技术门槛。从玩家自制汉化补丁到开发者的内部本地化测试它的应用场景非常广泛。核心在于理解其“运行时拦截替换”的原理并善用离线文件这一稳定可靠的基石。在线翻译API是一把双刃剑能提供便利但也带来质量、成本和稳定性的风险需谨慎使用。最后无论是用XUAT还是其他任何工具本地化的本质都是“文化适配”而不仅仅是文字转换。一个好的翻译需要理解游戏的世界观、角色的性格和故事的语境。工具负责解决“能不能翻”的技术问题而翻译者则要解决“翻得好不好”的艺术问题。当你看到自己翻译的文本完美地融入游戏为其他玩家带来无障碍的体验时那种成就感才是这个过程中最宝贵的收获。
)
