1. 项目概述当Unity游戏遇上语言壁垒作为一名在游戏本地化和Mod开发领域摸爬滚打了十多年的老玩家我深知面对一款心仪却语言不通的Unity游戏时有多痛苦。无论是日式RPG里晦涩的剧情文本还是欧美独立游戏里密集的术语语言障碍就像一堵无形的墙把无数精彩的游戏体验挡在了门外。手动汉化那需要反编译、解包、翻译、再封包不仅技术门槛高还极易因为游戏版本更新而失效对普通玩家来说几乎是不可能完成的任务。正是在这种普遍的需求下XUnity.AutoTranslator下文简称XUA应运而生。它不是一个简单的文本替换工具而是一个运行在游戏进程内的、高度智能的实时翻译插件。它的核心思路非常巧妙在游戏运行时拦截所有向UI文本组件如UGUI的Text、TextMeshPro写入的字符串将其发送到配置好的翻译服务如谷歌、百度、DeepL等获取翻译结果后再动态替换回游戏界面中。整个过程对游戏本身几乎透明玩家看到的就是即时翻译后的母语内容。这个项目在GitHub上由bbepis维护已经发展成为一个功能极其丰富、可定制性极强的成熟框架。它支持的不仅仅是文本还能处理图片资源的替换比如游戏内的日文标志图甚至允许开发者为其编写自定义的翻译器或资源重定向器。对于玩家而言它意味着“即装即用”一键解决语言问题对于Mod开发者而言它提供了一个强大的、可编程的本地化中间件。接下来我将带你彻底拆解这个神器从原理到实操从基础配置到高级玩法让你不仅能用它更能懂它、调优它。2. 核心架构与工作原理深度解析要玩转XUA必须先理解它的工作流和核心模块。它不是一个黑盒其设计体现了对Unity引擎运行机制的深刻理解。2.1 核心工作流从拦截到渲染XUA的运作可以简化为一个高效的流水线文本拦截Hooking这是第一步也是技术核心。XUA通过Harmony一个.NET函数修补库或MonoMod运行时钩子在游戏运行时动态修改Unity引擎中用于设置文本的方法例如Text.set_text、TextMeshProUGUI.SetText。当游戏代码调用这些方法试图显示“おはよう”日文“早上好”时调用会被XUA截获。文本处理与查询拦截到原始字符串后XUA不会立刻发送翻译。它先进行一系列预处理去除首尾空白字符、处理内部换行符等生成一个“标准化”的查询键。然后它按照优先级查询翻译源内存缓存检查之前是否翻译过相同的文本直接使用缓存结果这是速度最快的方式。本地翻译文件查询Translation目录下的.txt文件。用户可以手动编辑这些文件实现精准的、定制化的翻译比如专有名词、角色名。在线翻译服务如果前两者都没有命中则通过网络请求将文本发送到配置的翻译API如Google Translate。文本替换与UI适配获得翻译文本后XUA将其设置回游戏的UI组件。但问题来了英文“Good morning”和日文“おはよう”长度可能不同中文“早上好”的字体也可能不被游戏原字体支持。因此XUA内置了UI自动重设大小Auto-Resizing和字体回退Font Fallback机制确保翻译后的文本能正确显示且布局不乱。资源重定向高级功能对于游戏内嵌的图片资源如带文字的UI图XUA通过XUnity.ResourceRedirector模块可以拦截Unity的Resources.Load或AssetBundle.LoadAsset调用将游戏请求的原始纹理Texture重定向到用户准备好的、已翻译好的图片文件上。2.2 核心配置文件BepInEx/config/AutoTranslatorConfig.ini所有行为都通过这个INI格式的配置文件控制。理解关键配置项是定制化使用的基石。[General] ; 翻译服务端点例如GoogleTranslate, BingTranslate, BaiduTranslate, DeepLTranslate EndpointGoogleTranslate ; 源语言游戏文本语言 Languageja ; 目标语言想要翻译成的语言 ToLanguagezh-CN ; 在线翻译时单次请求的最大字符数。**切勿公开分发超过400的配置** MaxCharactersPerTranslation400 [Behaviour] ; 是否启用UI自动重设大小 EnableUIResizingTrue ; 是否强制对所有UI组件重设大小可能影响性能 ForceUIResizingFalse ; 是否启用文本批处理将多个短句合并为一个请求发送减少API调用次数 EnableBatchingTrue [Texture] ; 是否启用纹理图片翻译 EnableTextureTranslationFalse ; 纹理文件存储目录 TextureDirectoryTranslation\Texture ; 纹理哈希生成策略FromImageName默认性能好, FromImageData最准确性能差 TextureHashGenerationStrategyFromImageName配置心得MaxCharactersPerTranslation这是最重要的安全与合规设置。公开分享你的翻译配置或整合包时必须确保此值不大于400。这是为了遵守各大翻译API的服务条款通常对免费调用有频率和长度限制避免滥用导致API密钥被封禁。个人使用时可以根据需要调高但请务必负责。TextureHashGenerationStrategy处理游戏图片翻译时FromImageName是首选因为它基于Unity资源内部名称生成哈希速度快。但如果游戏内多个不同图片共享同一个内部名虽不常见但存在就会冲突。此时可尝试FromImageData它基于图片像素数据生成唯一哈希但会显著增加游戏启动和运行时的内存与CPU开销。2.3 支持的翻译服务与选择XUA内置了众多翻译端点你需要根据网络环境、翻译质量和需求选择端点名称是否需要API密钥特点与适用场景GoogleTranslate否最常用质量稳定但可能需要处理网络连接问题。BaiduTranslate是AppID/密钥国内访问速度快对中文支持好适合作为主要或备用方案。DeepLTranslate否免费版有限制翻译质量公认较高尤其适合欧洲语言互译。BingTranslate是订阅密钥微软服务质量不错。Custom视自定义后端而定高级用户可自建或使用第三方翻译API。选择建议对于国内用户首推配置BaiduTranslate作为主要端点并将GoogleTranslate作为备用在配置中可设置多个端点插件会按顺序尝试。配置百度翻译需要去百度翻译开放平台申请免费的通用API标准版每月有200万字符免费额度对个人玩家完全足够。3. 从零开始完整安装与配置实战理论懂了手别停。我们以最流行的Mod框架BepInEx 5.x为例演示完整流程。3.1 环境准备与插件安装确认游戏环境确保你的Unity游戏支持BepInEx 5.x。通常游戏社区或Mod网站会提供适配的BepInEx版本。安装BepInEx将BepInEx文件解压到游戏根目录即GameName.exe所在文件夹。安装XUnity.AutoTranslator从GitHub Releases页面下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip。将其解压把BepInEx文件夹内的所有内容合并到游戏根目录的BepInEx文件夹里。通常是plugins和patchers目录。首次运行与生成配置启动游戏。如果安装正确游戏启动时BepInEx控制台会显示加载日志。进入游戏主菜单后退出游戏。此时在BepInEx\config目录下会生成AutoTranslatorConfig.ini文件。3.2 基础配置实现首次实时翻译编辑配置文件用记事本或VS Code打开BepInEx\config\AutoTranslatorConfig.ini。设置语言与端点[General] ; 假设游戏是日文 Languageja ; 翻译成简体中文 ToLanguagezh-CN ; 使用谷歌翻译需能正常访问 EndpointGoogleTranslate ; 或者使用百度翻译需填写下面的AppId和密钥 ; EndpointBaiduTranslate配置百度翻译如选用[Baidu] ; 从百度翻译开放平台获取 BaiduAppId你的AppId BaiduAppSecret你的密钥启用基础功能[Behaviour] ; 启用UI自动调整防止文字溢出框外 EnableUIResizingTrue ; 启用翻译批处理提升效率 EnableBatchingTrue启动游戏测试再次启动游戏进入有文字的部分。稍等片刻首次翻译需要联网请求你应该能看到游戏内的文本逐渐被替换成中文。按默认快捷键AltT可以临时切换翻译的开启/关闭方便对比。3.3 字体配置解决中文显示方块问题这是中文用户最常遇到的坑。很多游戏自带的字体不包含中文字符集导致翻译后显示为“□□□”。解决方案替换或添加回退字体。获取中文字体文件找一个支持中文的字体例如“思源黑体”Source Han Sans。确保你有使用该字体的许可。创建字体AssetBundle针对UGUI这是比较专业的一步。你需要使用与游戏相同版本的Unity Editor将字体文件制作成AssetBundle。网上有相关教程核心步骤是创建字体素材在编辑器里打包成AB包。配置字体覆盖[Behaviour] ; 将中文字体AssetBundle文件如SourceHanSans.assets放入游戏根目录 ; 然后在此处指定文件名不含路径 OverrideFontSourceHanSans.assets使用TextMeshPro字体更推荐如果游戏使用TextMeshProTMP配置更简单因为TMP字体是跨游戏的。[Behaviour] ; 直接使用系统字体名或TMP内置字体资源名 FallbackFontTextMeshProMicrosoft YaHei UI ; 或者使用TMP自带的回退字体资源 ; FallbackFontTextMeshProFonts Materials/LiberationSans SDF Fallback实操心得对于TMP游戏优先尝试FallbackFontTextMeshPro。你可以把多个字体文件名用分号隔开形成一个回退链例如Microsoft YaHei UI, SimHei插件会按顺序尝试直到找到能显示的字形。4. 高级玩法与深度定制基础翻译跑通后你可以通过以下功能大幅提升翻译体验和精度。4.1 手动翻译与词条管理打造完美汉化自动翻译总有词不达意的时候。XUA允许你进行精细的手工修正。找到自动生成的翻译文件游戏运行并翻译过一些文本后在BepInEx\Translation\zh-CN\Text目录下假设目标语言是zh-CN会生成一个_AutoGeneratedTranslations.txt文件。这里面记录了所有被翻译过的原文和机翻结果。创建手动翻译文件不要直接修改_AutoGeneratedTranslations.txt它会被插件重写。而是新建一个.txt文件例如MyManualTranslations.txt放在同一目录下。编写翻译规则语法很简单一行一条原文译文。; 注释以分号开头 魔王Demon King 勇者Brave ; 可以使用正则表达式进行模式匹配慎用影响性能 r:^獲得 (.)$获得 $1优先级与重载手动翻译文件的优先级高于自动生成文件。如果同一原文在多个文件中有翻译插件会使用优先级最高的通常是最后加载的。你可以把_AutoGeneratedTranslations.txt里翻译不准的句子复制到你的手动文件中进行修改下次游戏加载时就会生效。按AltR可以手动重载所有翻译文件无需重启游戏。4.2 纹理翻译替换游戏内图片对于UI中的图片文字如菜单按钮、图标上的文字需要替换纹理。启用纹理转储[Texture] EnableTextureTranslationTrue EnableTextureDumpingTrue ; 首次使用时开启用于导出游戏原图 TextureDirectoryTranslation\Texture TextureHashGenerationStrategyFromImageName导出游戏纹理启动游戏遍历各个界面。插件会把检测到的纹理图片以文件名 [哈希值].png的格式保存到TextureDirectory目录下。编辑与替换用图片编辑软件如Photoshop、GIMP打开导出的PNG文件将上面的外文修改为中文保存时务必不要修改文件名中的哈希值部分。关闭转储启用翻译编辑完成后修改配置关闭转储以提升性能。[Texture] EnableTextureDumpingFalse ; 重要长期使用请关闭 EnableTextureTranslationTrue ; 保持开启以加载你修改后的图片哈希策略选择如果替换的图片不显示可能是哈希冲突。可以尝试将TextureHashGenerationStrategy改为FromImageData但这会降低性能。更优解是分析DuplicateTextureNames手动配置重复的资源名。4.3 翻译作用域与正则表达式作用域Scoping你可以让某些翻译只对特定的游戏场景Level或特定的游戏执行文件Exe生效。在翻译文件顶部使用指令#set level 5,10 この剣は強いThis sword is strong (仅在场景5和10生效) #unset level #set exe Game.exe ようこそWelcome (仅当通过Game.exe启动时生效)这常用于大型游戏避免通用翻译在特定场景引发错误。正则表达式Regex用于处理动态文本。例如游戏内提示“你获得了 10 金币”原文可能是“獲得 10 ゴールド”。使用正则可以一次性捕获所有数量sr:^獲得 ([0-9]) ゴールド$获得 $1 金币警告正则表达式虽然强大但滥用会严重拖慢游戏性能。务必精确限定匹配范围并仅在手动翻译文件中使用。5. 疑难杂症与性能优化实战记录即使配置正确在实际使用中也可能遇到各种问题。以下是我踩过坑后总结的排查清单。5.1 常见问题速查表问题现象可能原因解决方案游戏启动崩溃或黑屏BepInEx或XUA版本与游戏不兼容与其他Mod冲突。1. 确认BepInEx版本专为你的游戏编译。2. 暂时移除其他所有Mod只保留XUA测试。3. 查看BepInEx/LogOutput.log寻找错误堆栈。翻译完全不显示1. 语言配置错误。2. 翻译端点网络不通。3. 插件未正确加载。1. 检查Language和ToLanguage是否对应游戏和期望语言。2. 尝试切换翻译端点如从Google换到Baidu。3. 查看BepInEx控制台启动日志确认XUnity.AutoTranslator已加载。翻译显示为方块口口口游戏字体不支持目标语言字符。配置OverrideFontUGUI或FallbackFontTextMeshProTMP具体方法见3.3节。翻译后UI布局错乱、文字溢出翻译后文本长度远超原文。1. 确保[Behaviour]下EnableUIResizingTrue。2. 对于特定顽固组件可以创建resizer.txt文件手动调整字体大小语法UI/SomePanel/TextChangeFontSizeByPercentage(0.8)。在线翻译速度极慢或失败网络问题API调用频率受限。1. 使用本地翻译文件缓存尽可能多的词条。2. 启用EnableBatchingTrue合并请求。3. 考虑使用本地部署的翻译服务如用Custom端点对接本地运行的翻译工具。某些特定文本不被翻译1. 文本可能是图片。2. 文本由特殊插件生成被忽略。1. 开启纹理翻译并检查。2. 检查该文本是否以配置IgnoreTextStartingWith中的字符开头。3. 可能是动态生成的文本尝试调整TextGetterCompatibilityModeTrue。IL2CPP游戏翻译异常XUA对IL2CPP编译的游戏支持有限。1. 尝试使用项目提供的AutoTranslator.IL2CPP.BruteForceFix辅助插件。2. 可能需要等待游戏社区提供特定的兼容性补丁。5.2 性能优化与最佳实践最大化利用本地缓存定期将_AutoGeneratedTranslations.txt中翻译准确的条目整理到独立的手动翻译文件中。游戏运行时优先读取本地文件速度最快且能减轻在线API压力。谨慎使用正则和纹理翻译这两项功能开销较大。正则表达式应尽可能精确并放在独立文件中纹理翻译在完成后务必关闭EnableTextureDumping和EnableTextureScanOnSceneLoad。调整批处理大小MaxCharactersPerTranslation设置得越小单个请求越快但请求次数越多。通常设置在200-400之间是平衡点。EnableBatching务必开启它能将短时间内出现的多个短句合并为一个请求。管理内存使用如果启用纹理翻译且图片很多可以尝试将CacheTexturesInMemory设为False这会降低内存占用但可能导致切换场景时图片加载有轻微卡顿。按需加载翻译利用翻译作用域Scoping只为当前游玩的游戏或场景加载对应的翻译文件减少初始加载时间和内存占用。5.3 开发者集成让其他Mod也能被翻译如果你是Mod开发者希望自己的Mod界面也能被XUA翻译有两种方法自动翻译IMGUI如果你的Mod使用Unity的IMGUIOnGUI只需在配置中开启EnableIMGUITrueXUA便会尝试翻译其中的文本。提供插件专用翻译在Translation\{Lang}\Text\Plugins\目录下为你的Mod创建一个文件夹文件夹名就是你的Mod的DLL文件名不含扩展名。在这个文件夹里放置你的翻译文件如zh-CN.txt。在翻译文件中可以加入#enable fallback指令允许在找不到专用翻译时回退到通用的自动翻译。对于更深入的集成XUA提供了完整的APIXUnity.AutoTranslator.Plugin.Core允许Mod在代码中直接查询翻译或注册自己的翻译资源这为制作大型本地化Mod提供了可能。最后关于分发如果你打包了一个包含XUA和大量预翻译文件的游戏整合包请务必遵循社区规范。最重要的是不要包含任何在线翻译服务的API密钥并将MaxCharactersPerTranslation设置为400或更低。让最终用户自行配置他们自己的翻译端点这是尊重服务条款、保证项目能持续健康发展的关键。
1. 项目概述当Unity游戏遇上语言壁垒作为一名在游戏本地化和Mod开发领域摸爬滚打了十多年的老玩家我深知面对一款心仪却语言不通的Unity游戏时有多痛苦。无论是日式RPG里晦涩的剧情文本还是欧美独立游戏里密集的术语语言障碍就像一堵无形的墙把无数精彩的游戏体验挡在了门外。手动汉化那需要反编译、解包、翻译、再封包不仅技术门槛高还极易因为游戏版本更新而失效对普通玩家来说几乎是不可能完成的任务。正是在这种普遍的需求下XUnity.AutoTranslator下文简称XUA应运而生。它不是一个简单的文本替换工具而是一个运行在游戏进程内的、高度智能的实时翻译插件。它的核心思路非常巧妙在游戏运行时拦截所有向UI文本组件如UGUI的Text、TextMeshPro写入的字符串将其发送到配置好的翻译服务如谷歌、百度、DeepL等获取翻译结果后再动态替换回游戏界面中。整个过程对游戏本身几乎透明玩家看到的就是即时翻译后的母语内容。这个项目在GitHub上由bbepis维护已经发展成为一个功能极其丰富、可定制性极强的成熟框架。它支持的不仅仅是文本还能处理图片资源的替换比如游戏内的日文标志图甚至允许开发者为其编写自定义的翻译器或资源重定向器。对于玩家而言它意味着“即装即用”一键解决语言问题对于Mod开发者而言它提供了一个强大的、可编程的本地化中间件。接下来我将带你彻底拆解这个神器从原理到实操从基础配置到高级玩法让你不仅能用它更能懂它、调优它。2. 核心架构与工作原理深度解析要玩转XUA必须先理解它的工作流和核心模块。它不是一个黑盒其设计体现了对Unity引擎运行机制的深刻理解。2.1 核心工作流从拦截到渲染XUA的运作可以简化为一个高效的流水线文本拦截Hooking这是第一步也是技术核心。XUA通过Harmony一个.NET函数修补库或MonoMod运行时钩子在游戏运行时动态修改Unity引擎中用于设置文本的方法例如Text.set_text、TextMeshProUGUI.SetText。当游戏代码调用这些方法试图显示“おはよう”日文“早上好”时调用会被XUA截获。文本处理与查询拦截到原始字符串后XUA不会立刻发送翻译。它先进行一系列预处理去除首尾空白字符、处理内部换行符等生成一个“标准化”的查询键。然后它按照优先级查询翻译源内存缓存检查之前是否翻译过相同的文本直接使用缓存结果这是速度最快的方式。本地翻译文件查询Translation目录下的.txt文件。用户可以手动编辑这些文件实现精准的、定制化的翻译比如专有名词、角色名。在线翻译服务如果前两者都没有命中则通过网络请求将文本发送到配置的翻译API如Google Translate。文本替换与UI适配获得翻译文本后XUA将其设置回游戏的UI组件。但问题来了英文“Good morning”和日文“おはよう”长度可能不同中文“早上好”的字体也可能不被游戏原字体支持。因此XUA内置了UI自动重设大小Auto-Resizing和字体回退Font Fallback机制确保翻译后的文本能正确显示且布局不乱。资源重定向高级功能对于游戏内嵌的图片资源如带文字的UI图XUA通过XUnity.ResourceRedirector模块可以拦截Unity的Resources.Load或AssetBundle.LoadAsset调用将游戏请求的原始纹理Texture重定向到用户准备好的、已翻译好的图片文件上。2.2 核心配置文件BepInEx/config/AutoTranslatorConfig.ini所有行为都通过这个INI格式的配置文件控制。理解关键配置项是定制化使用的基石。[General] ; 翻译服务端点例如GoogleTranslate, BingTranslate, BaiduTranslate, DeepLTranslate EndpointGoogleTranslate ; 源语言游戏文本语言 Languageja ; 目标语言想要翻译成的语言 ToLanguagezh-CN ; 在线翻译时单次请求的最大字符数。**切勿公开分发超过400的配置** MaxCharactersPerTranslation400 [Behaviour] ; 是否启用UI自动重设大小 EnableUIResizingTrue ; 是否强制对所有UI组件重设大小可能影响性能 ForceUIResizingFalse ; 是否启用文本批处理将多个短句合并为一个请求发送减少API调用次数 EnableBatchingTrue [Texture] ; 是否启用纹理图片翻译 EnableTextureTranslationFalse ; 纹理文件存储目录 TextureDirectoryTranslation\Texture ; 纹理哈希生成策略FromImageName默认性能好, FromImageData最准确性能差 TextureHashGenerationStrategyFromImageName配置心得MaxCharactersPerTranslation这是最重要的安全与合规设置。公开分享你的翻译配置或整合包时必须确保此值不大于400。这是为了遵守各大翻译API的服务条款通常对免费调用有频率和长度限制避免滥用导致API密钥被封禁。个人使用时可以根据需要调高但请务必负责。TextureHashGenerationStrategy处理游戏图片翻译时FromImageName是首选因为它基于Unity资源内部名称生成哈希速度快。但如果游戏内多个不同图片共享同一个内部名虽不常见但存在就会冲突。此时可尝试FromImageData它基于图片像素数据生成唯一哈希但会显著增加游戏启动和运行时的内存与CPU开销。2.3 支持的翻译服务与选择XUA内置了众多翻译端点你需要根据网络环境、翻译质量和需求选择端点名称是否需要API密钥特点与适用场景GoogleTranslate否最常用质量稳定但可能需要处理网络连接问题。BaiduTranslate是AppID/密钥国内访问速度快对中文支持好适合作为主要或备用方案。DeepLTranslate否免费版有限制翻译质量公认较高尤其适合欧洲语言互译。BingTranslate是订阅密钥微软服务质量不错。Custom视自定义后端而定高级用户可自建或使用第三方翻译API。选择建议对于国内用户首推配置BaiduTranslate作为主要端点并将GoogleTranslate作为备用在配置中可设置多个端点插件会按顺序尝试。配置百度翻译需要去百度翻译开放平台申请免费的通用API标准版每月有200万字符免费额度对个人玩家完全足够。3. 从零开始完整安装与配置实战理论懂了手别停。我们以最流行的Mod框架BepInEx 5.x为例演示完整流程。3.1 环境准备与插件安装确认游戏环境确保你的Unity游戏支持BepInEx 5.x。通常游戏社区或Mod网站会提供适配的BepInEx版本。安装BepInEx将BepInEx文件解压到游戏根目录即GameName.exe所在文件夹。安装XUnity.AutoTranslator从GitHub Releases页面下载XUnity.AutoTranslator-BepInEx-{VERSION}.zip。将其解压把BepInEx文件夹内的所有内容合并到游戏根目录的BepInEx文件夹里。通常是plugins和patchers目录。首次运行与生成配置启动游戏。如果安装正确游戏启动时BepInEx控制台会显示加载日志。进入游戏主菜单后退出游戏。此时在BepInEx\config目录下会生成AutoTranslatorConfig.ini文件。3.2 基础配置实现首次实时翻译编辑配置文件用记事本或VS Code打开BepInEx\config\AutoTranslatorConfig.ini。设置语言与端点[General] ; 假设游戏是日文 Languageja ; 翻译成简体中文 ToLanguagezh-CN ; 使用谷歌翻译需能正常访问 EndpointGoogleTranslate ; 或者使用百度翻译需填写下面的AppId和密钥 ; EndpointBaiduTranslate配置百度翻译如选用[Baidu] ; 从百度翻译开放平台获取 BaiduAppId你的AppId BaiduAppSecret你的密钥启用基础功能[Behaviour] ; 启用UI自动调整防止文字溢出框外 EnableUIResizingTrue ; 启用翻译批处理提升效率 EnableBatchingTrue启动游戏测试再次启动游戏进入有文字的部分。稍等片刻首次翻译需要联网请求你应该能看到游戏内的文本逐渐被替换成中文。按默认快捷键AltT可以临时切换翻译的开启/关闭方便对比。3.3 字体配置解决中文显示方块问题这是中文用户最常遇到的坑。很多游戏自带的字体不包含中文字符集导致翻译后显示为“□□□”。解决方案替换或添加回退字体。获取中文字体文件找一个支持中文的字体例如“思源黑体”Source Han Sans。确保你有使用该字体的许可。创建字体AssetBundle针对UGUI这是比较专业的一步。你需要使用与游戏相同版本的Unity Editor将字体文件制作成AssetBundle。网上有相关教程核心步骤是创建字体素材在编辑器里打包成AB包。配置字体覆盖[Behaviour] ; 将中文字体AssetBundle文件如SourceHanSans.assets放入游戏根目录 ; 然后在此处指定文件名不含路径 OverrideFontSourceHanSans.assets使用TextMeshPro字体更推荐如果游戏使用TextMeshProTMP配置更简单因为TMP字体是跨游戏的。[Behaviour] ; 直接使用系统字体名或TMP内置字体资源名 FallbackFontTextMeshProMicrosoft YaHei UI ; 或者使用TMP自带的回退字体资源 ; FallbackFontTextMeshProFonts Materials/LiberationSans SDF Fallback实操心得对于TMP游戏优先尝试FallbackFontTextMeshPro。你可以把多个字体文件名用分号隔开形成一个回退链例如Microsoft YaHei UI, SimHei插件会按顺序尝试直到找到能显示的字形。4. 高级玩法与深度定制基础翻译跑通后你可以通过以下功能大幅提升翻译体验和精度。4.1 手动翻译与词条管理打造完美汉化自动翻译总有词不达意的时候。XUA允许你进行精细的手工修正。找到自动生成的翻译文件游戏运行并翻译过一些文本后在BepInEx\Translation\zh-CN\Text目录下假设目标语言是zh-CN会生成一个_AutoGeneratedTranslations.txt文件。这里面记录了所有被翻译过的原文和机翻结果。创建手动翻译文件不要直接修改_AutoGeneratedTranslations.txt它会被插件重写。而是新建一个.txt文件例如MyManualTranslations.txt放在同一目录下。编写翻译规则语法很简单一行一条原文译文。; 注释以分号开头 魔王Demon King 勇者Brave ; 可以使用正则表达式进行模式匹配慎用影响性能 r:^獲得 (.)$获得 $1优先级与重载手动翻译文件的优先级高于自动生成文件。如果同一原文在多个文件中有翻译插件会使用优先级最高的通常是最后加载的。你可以把_AutoGeneratedTranslations.txt里翻译不准的句子复制到你的手动文件中进行修改下次游戏加载时就会生效。按AltR可以手动重载所有翻译文件无需重启游戏。4.2 纹理翻译替换游戏内图片对于UI中的图片文字如菜单按钮、图标上的文字需要替换纹理。启用纹理转储[Texture] EnableTextureTranslationTrue EnableTextureDumpingTrue ; 首次使用时开启用于导出游戏原图 TextureDirectoryTranslation\Texture TextureHashGenerationStrategyFromImageName导出游戏纹理启动游戏遍历各个界面。插件会把检测到的纹理图片以文件名 [哈希值].png的格式保存到TextureDirectory目录下。编辑与替换用图片编辑软件如Photoshop、GIMP打开导出的PNG文件将上面的外文修改为中文保存时务必不要修改文件名中的哈希值部分。关闭转储启用翻译编辑完成后修改配置关闭转储以提升性能。[Texture] EnableTextureDumpingFalse ; 重要长期使用请关闭 EnableTextureTranslationTrue ; 保持开启以加载你修改后的图片哈希策略选择如果替换的图片不显示可能是哈希冲突。可以尝试将TextureHashGenerationStrategy改为FromImageData但这会降低性能。更优解是分析DuplicateTextureNames手动配置重复的资源名。4.3 翻译作用域与正则表达式作用域Scoping你可以让某些翻译只对特定的游戏场景Level或特定的游戏执行文件Exe生效。在翻译文件顶部使用指令#set level 5,10 この剣は強いThis sword is strong (仅在场景5和10生效) #unset level #set exe Game.exe ようこそWelcome (仅当通过Game.exe启动时生效)这常用于大型游戏避免通用翻译在特定场景引发错误。正则表达式Regex用于处理动态文本。例如游戏内提示“你获得了 10 金币”原文可能是“獲得 10 ゴールド”。使用正则可以一次性捕获所有数量sr:^獲得 ([0-9]) ゴールド$获得 $1 金币警告正则表达式虽然强大但滥用会严重拖慢游戏性能。务必精确限定匹配范围并仅在手动翻译文件中使用。5. 疑难杂症与性能优化实战记录即使配置正确在实际使用中也可能遇到各种问题。以下是我踩过坑后总结的排查清单。5.1 常见问题速查表问题现象可能原因解决方案游戏启动崩溃或黑屏BepInEx或XUA版本与游戏不兼容与其他Mod冲突。1. 确认BepInEx版本专为你的游戏编译。2. 暂时移除其他所有Mod只保留XUA测试。3. 查看BepInEx/LogOutput.log寻找错误堆栈。翻译完全不显示1. 语言配置错误。2. 翻译端点网络不通。3. 插件未正确加载。1. 检查Language和ToLanguage是否对应游戏和期望语言。2. 尝试切换翻译端点如从Google换到Baidu。3. 查看BepInEx控制台启动日志确认XUnity.AutoTranslator已加载。翻译显示为方块口口口游戏字体不支持目标语言字符。配置OverrideFontUGUI或FallbackFontTextMeshProTMP具体方法见3.3节。翻译后UI布局错乱、文字溢出翻译后文本长度远超原文。1. 确保[Behaviour]下EnableUIResizingTrue。2. 对于特定顽固组件可以创建resizer.txt文件手动调整字体大小语法UI/SomePanel/TextChangeFontSizeByPercentage(0.8)。在线翻译速度极慢或失败网络问题API调用频率受限。1. 使用本地翻译文件缓存尽可能多的词条。2. 启用EnableBatchingTrue合并请求。3. 考虑使用本地部署的翻译服务如用Custom端点对接本地运行的翻译工具。某些特定文本不被翻译1. 文本可能是图片。2. 文本由特殊插件生成被忽略。1. 开启纹理翻译并检查。2. 检查该文本是否以配置IgnoreTextStartingWith中的字符开头。3. 可能是动态生成的文本尝试调整TextGetterCompatibilityModeTrue。IL2CPP游戏翻译异常XUA对IL2CPP编译的游戏支持有限。1. 尝试使用项目提供的AutoTranslator.IL2CPP.BruteForceFix辅助插件。2. 可能需要等待游戏社区提供特定的兼容性补丁。5.2 性能优化与最佳实践最大化利用本地缓存定期将_AutoGeneratedTranslations.txt中翻译准确的条目整理到独立的手动翻译文件中。游戏运行时优先读取本地文件速度最快且能减轻在线API压力。谨慎使用正则和纹理翻译这两项功能开销较大。正则表达式应尽可能精确并放在独立文件中纹理翻译在完成后务必关闭EnableTextureDumping和EnableTextureScanOnSceneLoad。调整批处理大小MaxCharactersPerTranslation设置得越小单个请求越快但请求次数越多。通常设置在200-400之间是平衡点。EnableBatching务必开启它能将短时间内出现的多个短句合并为一个请求。管理内存使用如果启用纹理翻译且图片很多可以尝试将CacheTexturesInMemory设为False这会降低内存占用但可能导致切换场景时图片加载有轻微卡顿。按需加载翻译利用翻译作用域Scoping只为当前游玩的游戏或场景加载对应的翻译文件减少初始加载时间和内存占用。5.3 开发者集成让其他Mod也能被翻译如果你是Mod开发者希望自己的Mod界面也能被XUA翻译有两种方法自动翻译IMGUI如果你的Mod使用Unity的IMGUIOnGUI只需在配置中开启EnableIMGUITrueXUA便会尝试翻译其中的文本。提供插件专用翻译在Translation\{Lang}\Text\Plugins\目录下为你的Mod创建一个文件夹文件夹名就是你的Mod的DLL文件名不含扩展名。在这个文件夹里放置你的翻译文件如zh-CN.txt。在翻译文件中可以加入#enable fallback指令允许在找不到专用翻译时回退到通用的自动翻译。对于更深入的集成XUA提供了完整的APIXUnity.AutoTranslator.Plugin.Core允许Mod在代码中直接查询翻译或注册自己的翻译资源这为制作大型本地化Mod提供了可能。最后关于分发如果你打包了一个包含XUA和大量预翻译文件的游戏整合包请务必遵循社区规范。最重要的是不要包含任何在线翻译服务的API密钥并将MaxCharactersPerTranslation设置为400或更低。让最终用户自行配置他们自己的翻译端点这是尊重服务条款、保证项目能持续健康发展的关键。
 - 诚收名表回收平台)
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
