1. 项目概述XUnity翻译器到底是什么如果你是一个喜欢玩各种独立游戏尤其是那些来自海外、没有官方中文支持的Unity游戏玩家那么“XUnity翻译器”这个名字你大概率不会陌生。简单来说它不是一个单一的软件而是一个由社区驱动的、功能强大的游戏实时翻译框架。它的核心是XUnity.AutoTranslator一个能够“注入”到Unity游戏进程中实时拦截游戏文本、调用翻译服务、再将翻译结果“画”回游戏画面的工具。而“XUnity翻译器”这个更广泛的概念通常指的是围绕XUnity.AutoTranslator构建的一整套解决方案包括各种翻译插件比如对接DeepL、谷歌、百度、ChatGPT等在线API的或者像我们这次要重点聊的、对接本地大模型的、配置方法以及疑难排解经验。我最初接触它是因为想玩一款只有日文版的视觉小说游戏。机翻网页插件对游戏内嵌文本无能为力手动截图OCR又繁琐到令人绝望。直到发现了XUnity这套方案才真正打开了新世界的大门。它解决的痛点非常明确为没有官方本地化的Unity游戏提供一种近乎“原生”的实时字幕体验。你可以把它理解为一个高度定制化的“外挂”字幕组只不过翻译引擎由你决定。网络上关于它的信息比较零散新手容易在部署、配置、尤其是故障排除环节卡住。常见的报错如“保存此条目时发生错误。查看翻译器故障排除获取更多信息。”就足以劝退很多人。所以这篇指南的目标就是帮你系统性地打通从零到精通的整个链路重点会深入讲解如何利用本地大模型如Sakura、Qwen获得质量更高、更稳定的翻译体验并彻底解决那些令人头疼的配置问题。2. 核心架构与方案选型为什么是本地大模型在开始动手之前理解XUnity翻译器的核心工作流和不同方案的优劣至关重要。这决定了你后续体验的翻译质量、响应速度和隐私安全。2.1 XUnity.AutoTranslator 工作流解析XUnity.AutoTranslator后文简称XUA是整个系统的基石。它的工作流程可以拆解为以下几步注入与挂钩通过BepInEx或ReiPatcher等Unity Mod框架将XUA的DLL文件加载到游戏进程中。文本拦截XUA会监控Unity引擎的文本渲染调用当游戏要显示一段文字时XUA能先“截获”这段原始文本比如日文或英文。翻译请求XUA将截获的文本按照配置发送给指定的“翻译器”Translator。翻译器是一个独立的插件模块。结果接收与渲染翻译器将翻译结果中文返回给XUAXUA再调用Unity的渲染接口将翻译后的文本绘制在游戏界面的对应位置覆盖或替换原文。整个过程是动态、实时的。关键在于第三步的“翻译器”。官方和社区提供了多种翻译器插件主要分为两类在线API翻译器和本地大模型翻译器。2.2 在线API vs. 本地大模型关键决策点很多新手教程会教你配置百度、谷歌的免费API这确实是最快的上手方式。但我强烈建议如果你追求更好的体验尤其是翻译ACG动画、漫画、游戏内容应该优先考虑本地大模型方案。下表对比了核心差异特性维度在线API如百度/谷歌翻译本地大模型如Sakura/Qwen翻译质量通用性强但针对游戏术语、口语、文化梗适配差常出现生硬直译。专精优化。例如Sakura模型针对日文轻小说、游戏文本进行了深度训练能更好处理人称、语气词、专有名词。响应速度依赖网络延迟不稳定。快速连续翻译可能触发风控导致失败。依赖本地硬件首次加载模型慢但翻译时延迟极低且稳定无网络波动。隐私安全需发送游戏文本到第三方服务器存在隐私泄露风险。完全本地运行所有文本不出本地安全可控。成本免费额度有限高频使用需付费。一次性硬件投入主要看GPU后续无持续费用。配置复杂度相对简单主要就是申请API密钥。较复杂需部署本地模型服务如Text-Generation-WebUI。稳定性受服务商策略影响API可能变更或失效。自建服务稳定性掌握在自己手中。实操心得早期我用百度翻译经常遇到角色名字被音译成奇怪的中文或者句子结构完全不符合中文阅读习惯严重出戏。切换到本地Sakura模型后虽然需要折腾一下部署但翻译质量提升是颠覆性的尤其是对于日式RPG和视觉小说它能很好地保留原文的语感和风格。因此本指南将聚焦于本地大模型方案即使用Text-Generation-WebUI后文简称TGW作为翻译后端并通过Xunity-TGW这个桥梁插件将其与XUA连接起来。这是目前平衡质量、速度和隐私的最佳实践。3. 环境准备部署你的本地翻译大脑这一步是基础也是最容易出错的环节。我们需要搭建两个核心部分XUnity.AutoTranslator 和 Text-Generation-WebUI。3.1 第一步为游戏注入XUnity.AutoTranslatorXUA本身不直接翻译它负责“抓文本”和“显示结果”。你需要根据游戏使用的Mod框架来安装它。确定游戏Mod框架BepInEx目前绝大多数Unity游戏Mod的标准目录下通常有BepInEx文件夹。ReiPatcher较老的框架目录下可能有ReiPatcher或游戏启动器会提及。如果不确定可以去游戏社区或论坛搜索“[游戏名] BepInEx”来确认。安装XUnity.AutoTranslator前往XUA的官方发布页如GitHub Releases下载对应版本的压缩包。对于BepInEx将压缩包内的BepInEx文件夹直接合并到游戏根目录。核心插件路径通常是游戏根目录\BepInEx\plugins\XUnity.AutoTranslator。对于ReiPatcher将文件解压到游戏根目录确保ReiPatcher文件夹结构正确。安装成功后首次运行游戏会在相应配置目录生成AutoTranslatorConfig.ini文件。这是所有设置的枢纽。注意事项务必下载与游戏架构x86/x64和Unity版本兼容的XUA版本。如果游戏启动崩溃首先检查Mod框架和XUA版本是否匹配。3.2 第二步部署Text-Generation-WebUI与模型TGW是一个强大的本地大模型加载和交互界面我们将用它来运行翻译模型。获取TGW一键包对于新手最推荐使用社区维护的“一键包”比如在B站等平台搜索“Text-Generation-WebUI 一键包”。这些包通常集成了所有依赖解压即用避免了复杂的Python环境配置问题。下载翻译模型日文翻译首选Sakura-13B-LNovel系列模型。这是针对日文轻小说、游戏文本微调的顶尖模型翻译质量远超通用模型。前往HuggingFace下载其GGUF格式的量化版如q4_K_M.gguf平衡了质量和显存占用。对于大多数ACG翻译Sakura-13B-LNovel-v0.9b-GGUF版本是甜点选择。英文翻译首选Qwen系列模型。Qwen1.5或Qwen2的7B/14B型号的GGUF版本在英文翻译上表现非常出色且效率高。通义千问团队对模型的多语言能力优化得很好。将下载好的.gguf模型文件放入TGW一键包的models文件夹内。启动与配置TGW运行一键包中的启动脚本如start_windows.bat。在TGW的Web界面默认http://127.0.0.1:7860中从“Model”标签页加载你下载的GGUF模型。关键一步启用API。在TGW的“Session”或“Parameters”设置中找到“Enable API”或“--api”选项务必勾选或启用。这是XUA能与TGW通信的前提。加载模型成功后TGW的API地址通常是http://127.0.0.1:5000注意API端口默认是5000而WebUI界面是7860别搞混了。实操心得模型文件很大几个GB到十几个GB确保你的硬盘有足够空间。首次加载模型可能需要几分钟请耐心等待命令行窗口显示加载完成。如果显存不足比如小于8GB务必选择量化等级更高的GGUF模型如q5_K_M或q4_K_M它们对显存要求更低。4. 核心桥梁配置Xunity-TGW插件现在我们有了一头XUA和一尾TGW需要用Xunity-TGW这个插件把它们连接起来。这个插件本质上是一个自定义的XUA翻译器它知道如何向TGW的API发送请求并解析回复。获取插件从项目的GitHub页面如HunterShenSmzh/Xunity-TGW的 Releases 或 Code 页面下载TGWTranslator.dll文件。放置插件BepInEx用户将TGWTranslator.dll放入游戏根目录\BepInEx\plugins\XUnity.AutoTranslator\Translators\目录下。如果Translators文件夹不存在就手动创建一个。ReiPatcher用户放入游戏根目录\游戏名_Data\Managed\Translators\目录下。配置XUA核心文件用文本编辑器如Notepad打开之前生成的AutoTranslatorConfig.ini。找到[Service]部分修改为[Service] EndpointTGWTranslator # 指定使用我们刚放入的翻译器 FallbackEndpoint # 备用翻译器可留空或设置一个在线API找到[General]部分设置语言[General] Languagezh-CN # 目标语言简体中文 FromLanguageja # 源语言日文 (如果是英文游戏则改为 en)解决字体显示问题非常关键Unity游戏字体可能不包含完整的中文字符集导致翻译后显示方框“□□□”。必须在配置中指定一个系统已安装的、包含中文的字体。在AutoTranslatorConfig.ini中找到或添加[Behaviour]部分添加以下行[Behaviour] OverrideFontMicrosoft YaHei UI # 使用你系统里有的中文字体如“微软雅黑 UI”、“SimHei” OverrideFontTextMeshProarialuni_sdf_u2018关于arialuni_sdf_u2018这是Unity TextMeshPro 字体图集的一种命名约定。你需要从游戏文件或网络资源中找到这个字体文件通常是一个.asset或.bytes文件并将其解压后直接放在游戏根目录。更稳妥的做法是如果指定了OverrideFont后仍有部分文字显示为方框再尝试寻找并放置这个文件。完成以上步骤后启动游戏。在游戏中按默认快捷键Alt0应该能呼出XUA的翻译器选择面板。如果一切正常你应该能看到TGWTranslator这个选项并且可以选中它。5. 高级调试与备用方案实战理想情况下第4步完成后就能畅玩中文游戏了。但现实往往骨感“保存此条目时发生错误”或翻译器选项为灰色不可选的情况太常见了。别慌我们有一套完整的排查流程。5.1 故障排查流程图与核心检查点当翻译不工作时请按以下顺序排查游戏内按Alt0无反应 ├── XUA未正确安装 → 检查BepInEx/ReiPatcher日志确认XUA插件已加载。 ├── 快捷键冲突 → 在AutoTranslatorConfig.ini中修改[General]下的KeyToggleVisible。 └── 翻译器面板出现但TGWTranslator为灰色/报错 ├── TGWTranslator.dll未放对位置 → 严格对照第4.2节路径检查。 ├── TGW服务未启动或API未启用 → 确认TGW已加载模型且命令行窗口显示API正在运行端口5000。 ├── 防火墙/网络阻止连接 → 暂时关闭防火墙测试或检查TGW是否绑定到了127.0.0.1。 └── 配置文件错误 → 检查Endpoint拼写、语言代码是否正确。5.2 终极备用方案Custom URL 中转如果上述检查都无误但TGWTranslator插件就是无法正常工作特别是某些特定游戏或系统环境我们可以启用项目提供的备用方案——Custom URL 中转。这个方案的本质是运行一个本地的中转程序Translate.exe它作为“中间人”接收XUA的请求再转发给TGW的API最后将结果返回给XUA。下载中转程序从Xunity-TGW项目的UseCustomURLSolution文件夹中找到Translate.exe。运行并配置双击运行Translate.exe它会打开一个命令行窗口。程序会提示你输入TGW的API地址。注意这里要输入的是完整的Chat Completions接口地址通常是http://127.0.0.1:5000/v1/chat/completions。如果你使用了类似kaggle或ngrok的内网穿透工具则需输入其提供的隧道地址。输入后回车程序会监听在本地的6000端口并打印就绪信息。务必保持这个窗口不要关闭。修改XUA配置打开AutoTranslatorConfig.ini。将[Service]部分修改为[Service] EndpointCustomTranslate # 使用内置的CustomTranslate端点 FallbackEndpoint在文件末尾添加[Custom]部分如果不存在[Custom] Urlhttp://127.0.0.1:6000/translate # 指向我们刚刚启动的中转程序重启游戏此时在游戏内按Alt0翻译器应选择Custom。这个方案绕过了直接的DLL插件调用通过HTTP协议通信兼容性极强是解决疑难杂症的杀手锏。避坑技巧Translate.exe窗口可能会被误关。你可以写一个简单的批处理文件(.bat)来运行它并在批处理文件中最后加一行pause这样关闭前会提示防止误操作。5.3 翻译质量微调TGW API参数优化连接成功后翻译质量可能还不尽如人意。这时我们需要调整TGW端的生成参数。通过TGW的Web界面http://127.0.0.1:7860访问API的Chat选项卡或直接修改其启动参数可以显著影响结果Temperature温度控制随机性。对于翻译建议设置较低的值如0.1-0.3让输出更确定、更忠实于原文。Max New Tokens最大生成长度确保设置得足够大如512以防长句子被截断。停止词可以添加\n,。,,等让模型在合适的位置结束生成。系统提示词这是提升质量的关键在TGW的聊天界面或在Translate.exe同目录下的配置文件中如果支持可以设置系统提示词。例如你是一个专业的日文游戏翻译助手。请将用户的日文对话翻译成流畅、自然、符合中文玩家习惯的简体中文。保留专有名词如人名、地名、技能名不翻译除非有广泛接受的译名。注意对话的语境和角色语气。通过精心设计的提示词你可以引导模型产出更专业的游戏翻译。6. 性能优化与长期维护心得一套系统搭建起来只是开始如何让它运行得更流畅、更稳定才是长期享受游戏的关键。1. 模型与硬件的平衡 如果你的GPU显存有限例如6GB或8GB运行13B的模型可能比较吃力导致翻译延迟高甚至爆显存。此时有两种选择选择更小的模型例如Qwen2.5-7B-Instruct它在7B尺寸上中英翻译能力非常强。使用CPU推理在TGW启动参数中加入--cpu完全利用CPU和内存运行模型。虽然速度慢于GPU但对硬件要求最低且稳定性极高。对于非动作类游戏延迟在可接受范围内。2. 翻译缓存机制 XUA会自动将翻译过的文本及其结果保存在Translation文件夹下的文本文件中。这意味着同一句台词第二次出现时会直接读取缓存无需再次请求模型极大提升速度并节省资源。要善用这个机制定期备份这个文件夹当你重装系统或换电脑时可以直接复用无需重新翻译整个游戏。3. 游戏更新后的适配 游戏更新可能会改变文件结构导致Mod失效。更新后如果翻译不工作了通常只需要重新验证或安装对应新游戏版本的BepInEx/XUA。将你原来的AutoTranslatorConfig.ini和Translation缓存文件夹复制回新的配置路径。大部分情况下你的个人配置和翻译缓存都能得以保留。4. 社区资源利用 对于一些热门游戏很可能已经有玩家社区制作了专门的翻译补丁或整合包。这些补丁可能直接包含了预翻译的文本文件你只需要安装XUA框架并载入这些文本就能获得即装即用的完美体验完全跳过实时翻译的步骤。在相关游戏论坛、贴吧或GitHub上搜索“[游戏名] XUnity 汉化”可能会有惊喜。折腾XUnity翻译器的过程就像为自己心爱的游戏亲手打造一副最合适的“眼镜”。从最初的磕磕绊绊到后来能游刃有余地针对不同游戏调整模型和参数这种成就感远超单纯使用一个现成的工具。它不仅仅是一个翻译方案更是一把钥匙打开了无数未被官方发现的文化宝库。希望这份指南能帮你扫清入门路上的所有障碍顺利踏入这个充满乐趣的自定义汉化世界。如果在实践中遇到本指南未覆盖的特定问题记住核心思路查看日志BepInEx的日志文件通常在游戏根目录\BepInEx\LogOutput.log、确认通信TGW的API是否真的在响应、检查配置每一个字符都不要错绝大多数问题都能在这三步中找到答案。 XUnity翻译器实战：本地大模型为Unity游戏实现高质量实时汉化
1. 项目概述XUnity翻译器到底是什么如果你是一个喜欢玩各种独立游戏尤其是那些来自海外、没有官方中文支持的Unity游戏玩家那么“XUnity翻译器”这个名字你大概率不会陌生。简单来说它不是一个单一的软件而是一个由社区驱动的、功能强大的游戏实时翻译框架。它的核心是XUnity.AutoTranslator一个能够“注入”到Unity游戏进程中实时拦截游戏文本、调用翻译服务、再将翻译结果“画”回游戏画面的工具。而“XUnity翻译器”这个更广泛的概念通常指的是围绕XUnity.AutoTranslator构建的一整套解决方案包括各种翻译插件比如对接DeepL、谷歌、百度、ChatGPT等在线API的或者像我们这次要重点聊的、对接本地大模型的、配置方法以及疑难排解经验。我最初接触它是因为想玩一款只有日文版的视觉小说游戏。机翻网页插件对游戏内嵌文本无能为力手动截图OCR又繁琐到令人绝望。直到发现了XUnity这套方案才真正打开了新世界的大门。它解决的痛点非常明确为没有官方本地化的Unity游戏提供一种近乎“原生”的实时字幕体验。你可以把它理解为一个高度定制化的“外挂”字幕组只不过翻译引擎由你决定。网络上关于它的信息比较零散新手容易在部署、配置、尤其是故障排除环节卡住。常见的报错如“保存此条目时发生错误。查看翻译器故障排除获取更多信息。”就足以劝退很多人。所以这篇指南的目标就是帮你系统性地打通从零到精通的整个链路重点会深入讲解如何利用本地大模型如Sakura、Qwen获得质量更高、更稳定的翻译体验并彻底解决那些令人头疼的配置问题。2. 核心架构与方案选型为什么是本地大模型在开始动手之前理解XUnity翻译器的核心工作流和不同方案的优劣至关重要。这决定了你后续体验的翻译质量、响应速度和隐私安全。2.1 XUnity.AutoTranslator 工作流解析XUnity.AutoTranslator后文简称XUA是整个系统的基石。它的工作流程可以拆解为以下几步注入与挂钩通过BepInEx或ReiPatcher等Unity Mod框架将XUA的DLL文件加载到游戏进程中。文本拦截XUA会监控Unity引擎的文本渲染调用当游戏要显示一段文字时XUA能先“截获”这段原始文本比如日文或英文。翻译请求XUA将截获的文本按照配置发送给指定的“翻译器”Translator。翻译器是一个独立的插件模块。结果接收与渲染翻译器将翻译结果中文返回给XUAXUA再调用Unity的渲染接口将翻译后的文本绘制在游戏界面的对应位置覆盖或替换原文。整个过程是动态、实时的。关键在于第三步的“翻译器”。官方和社区提供了多种翻译器插件主要分为两类在线API翻译器和本地大模型翻译器。2.2 在线API vs. 本地大模型关键决策点很多新手教程会教你配置百度、谷歌的免费API这确实是最快的上手方式。但我强烈建议如果你追求更好的体验尤其是翻译ACG动画、漫画、游戏内容应该优先考虑本地大模型方案。下表对比了核心差异特性维度在线API如百度/谷歌翻译本地大模型如Sakura/Qwen翻译质量通用性强但针对游戏术语、口语、文化梗适配差常出现生硬直译。专精优化。例如Sakura模型针对日文轻小说、游戏文本进行了深度训练能更好处理人称、语气词、专有名词。响应速度依赖网络延迟不稳定。快速连续翻译可能触发风控导致失败。依赖本地硬件首次加载模型慢但翻译时延迟极低且稳定无网络波动。隐私安全需发送游戏文本到第三方服务器存在隐私泄露风险。完全本地运行所有文本不出本地安全可控。成本免费额度有限高频使用需付费。一次性硬件投入主要看GPU后续无持续费用。配置复杂度相对简单主要就是申请API密钥。较复杂需部署本地模型服务如Text-Generation-WebUI。稳定性受服务商策略影响API可能变更或失效。自建服务稳定性掌握在自己手中。实操心得早期我用百度翻译经常遇到角色名字被音译成奇怪的中文或者句子结构完全不符合中文阅读习惯严重出戏。切换到本地Sakura模型后虽然需要折腾一下部署但翻译质量提升是颠覆性的尤其是对于日式RPG和视觉小说它能很好地保留原文的语感和风格。因此本指南将聚焦于本地大模型方案即使用Text-Generation-WebUI后文简称TGW作为翻译后端并通过Xunity-TGW这个桥梁插件将其与XUA连接起来。这是目前平衡质量、速度和隐私的最佳实践。3. 环境准备部署你的本地翻译大脑这一步是基础也是最容易出错的环节。我们需要搭建两个核心部分XUnity.AutoTranslator 和 Text-Generation-WebUI。3.1 第一步为游戏注入XUnity.AutoTranslatorXUA本身不直接翻译它负责“抓文本”和“显示结果”。你需要根据游戏使用的Mod框架来安装它。确定游戏Mod框架BepInEx目前绝大多数Unity游戏Mod的标准目录下通常有BepInEx文件夹。ReiPatcher较老的框架目录下可能有ReiPatcher或游戏启动器会提及。如果不确定可以去游戏社区或论坛搜索“[游戏名] BepInEx”来确认。安装XUnity.AutoTranslator前往XUA的官方发布页如GitHub Releases下载对应版本的压缩包。对于BepInEx将压缩包内的BepInEx文件夹直接合并到游戏根目录。核心插件路径通常是游戏根目录\BepInEx\plugins\XUnity.AutoTranslator。对于ReiPatcher将文件解压到游戏根目录确保ReiPatcher文件夹结构正确。安装成功后首次运行游戏会在相应配置目录生成AutoTranslatorConfig.ini文件。这是所有设置的枢纽。注意事项务必下载与游戏架构x86/x64和Unity版本兼容的XUA版本。如果游戏启动崩溃首先检查Mod框架和XUA版本是否匹配。3.2 第二步部署Text-Generation-WebUI与模型TGW是一个强大的本地大模型加载和交互界面我们将用它来运行翻译模型。获取TGW一键包对于新手最推荐使用社区维护的“一键包”比如在B站等平台搜索“Text-Generation-WebUI 一键包”。这些包通常集成了所有依赖解压即用避免了复杂的Python环境配置问题。下载翻译模型日文翻译首选Sakura-13B-LNovel系列模型。这是针对日文轻小说、游戏文本微调的顶尖模型翻译质量远超通用模型。前往HuggingFace下载其GGUF格式的量化版如q4_K_M.gguf平衡了质量和显存占用。对于大多数ACG翻译Sakura-13B-LNovel-v0.9b-GGUF版本是甜点选择。英文翻译首选Qwen系列模型。Qwen1.5或Qwen2的7B/14B型号的GGUF版本在英文翻译上表现非常出色且效率高。通义千问团队对模型的多语言能力优化得很好。将下载好的.gguf模型文件放入TGW一键包的models文件夹内。启动与配置TGW运行一键包中的启动脚本如start_windows.bat。在TGW的Web界面默认http://127.0.0.1:7860中从“Model”标签页加载你下载的GGUF模型。关键一步启用API。在TGW的“Session”或“Parameters”设置中找到“Enable API”或“--api”选项务必勾选或启用。这是XUA能与TGW通信的前提。加载模型成功后TGW的API地址通常是http://127.0.0.1:5000注意API端口默认是5000而WebUI界面是7860别搞混了。实操心得模型文件很大几个GB到十几个GB确保你的硬盘有足够空间。首次加载模型可能需要几分钟请耐心等待命令行窗口显示加载完成。如果显存不足比如小于8GB务必选择量化等级更高的GGUF模型如q5_K_M或q4_K_M它们对显存要求更低。4. 核心桥梁配置Xunity-TGW插件现在我们有了一头XUA和一尾TGW需要用Xunity-TGW这个插件把它们连接起来。这个插件本质上是一个自定义的XUA翻译器它知道如何向TGW的API发送请求并解析回复。获取插件从项目的GitHub页面如HunterShenSmzh/Xunity-TGW的 Releases 或 Code 页面下载TGWTranslator.dll文件。放置插件BepInEx用户将TGWTranslator.dll放入游戏根目录\BepInEx\plugins\XUnity.AutoTranslator\Translators\目录下。如果Translators文件夹不存在就手动创建一个。ReiPatcher用户放入游戏根目录\游戏名_Data\Managed\Translators\目录下。配置XUA核心文件用文本编辑器如Notepad打开之前生成的AutoTranslatorConfig.ini。找到[Service]部分修改为[Service] EndpointTGWTranslator # 指定使用我们刚放入的翻译器 FallbackEndpoint # 备用翻译器可留空或设置一个在线API找到[General]部分设置语言[General] Languagezh-CN # 目标语言简体中文 FromLanguageja # 源语言日文 (如果是英文游戏则改为 en)解决字体显示问题非常关键Unity游戏字体可能不包含完整的中文字符集导致翻译后显示方框“□□□”。必须在配置中指定一个系统已安装的、包含中文的字体。在AutoTranslatorConfig.ini中找到或添加[Behaviour]部分添加以下行[Behaviour] OverrideFontMicrosoft YaHei UI # 使用你系统里有的中文字体如“微软雅黑 UI”、“SimHei” OverrideFontTextMeshProarialuni_sdf_u2018关于arialuni_sdf_u2018这是Unity TextMeshPro 字体图集的一种命名约定。你需要从游戏文件或网络资源中找到这个字体文件通常是一个.asset或.bytes文件并将其解压后直接放在游戏根目录。更稳妥的做法是如果指定了OverrideFont后仍有部分文字显示为方框再尝试寻找并放置这个文件。完成以上步骤后启动游戏。在游戏中按默认快捷键Alt0应该能呼出XUA的翻译器选择面板。如果一切正常你应该能看到TGWTranslator这个选项并且可以选中它。5. 高级调试与备用方案实战理想情况下第4步完成后就能畅玩中文游戏了。但现实往往骨感“保存此条目时发生错误”或翻译器选项为灰色不可选的情况太常见了。别慌我们有一套完整的排查流程。5.1 故障排查流程图与核心检查点当翻译不工作时请按以下顺序排查游戏内按Alt0无反应 ├── XUA未正确安装 → 检查BepInEx/ReiPatcher日志确认XUA插件已加载。 ├── 快捷键冲突 → 在AutoTranslatorConfig.ini中修改[General]下的KeyToggleVisible。 └── 翻译器面板出现但TGWTranslator为灰色/报错 ├── TGWTranslator.dll未放对位置 → 严格对照第4.2节路径检查。 ├── TGW服务未启动或API未启用 → 确认TGW已加载模型且命令行窗口显示API正在运行端口5000。 ├── 防火墙/网络阻止连接 → 暂时关闭防火墙测试或检查TGW是否绑定到了127.0.0.1。 └── 配置文件错误 → 检查Endpoint拼写、语言代码是否正确。5.2 终极备用方案Custom URL 中转如果上述检查都无误但TGWTranslator插件就是无法正常工作特别是某些特定游戏或系统环境我们可以启用项目提供的备用方案——Custom URL 中转。这个方案的本质是运行一个本地的中转程序Translate.exe它作为“中间人”接收XUA的请求再转发给TGW的API最后将结果返回给XUA。下载中转程序从Xunity-TGW项目的UseCustomURLSolution文件夹中找到Translate.exe。运行并配置双击运行Translate.exe它会打开一个命令行窗口。程序会提示你输入TGW的API地址。注意这里要输入的是完整的Chat Completions接口地址通常是http://127.0.0.1:5000/v1/chat/completions。如果你使用了类似kaggle或ngrok的内网穿透工具则需输入其提供的隧道地址。输入后回车程序会监听在本地的6000端口并打印就绪信息。务必保持这个窗口不要关闭。修改XUA配置打开AutoTranslatorConfig.ini。将[Service]部分修改为[Service] EndpointCustomTranslate # 使用内置的CustomTranslate端点 FallbackEndpoint在文件末尾添加[Custom]部分如果不存在[Custom] Urlhttp://127.0.0.1:6000/translate # 指向我们刚刚启动的中转程序重启游戏此时在游戏内按Alt0翻译器应选择Custom。这个方案绕过了直接的DLL插件调用通过HTTP协议通信兼容性极强是解决疑难杂症的杀手锏。避坑技巧Translate.exe窗口可能会被误关。你可以写一个简单的批处理文件(.bat)来运行它并在批处理文件中最后加一行pause这样关闭前会提示防止误操作。5.3 翻译质量微调TGW API参数优化连接成功后翻译质量可能还不尽如人意。这时我们需要调整TGW端的生成参数。通过TGW的Web界面http://127.0.0.1:7860访问API的Chat选项卡或直接修改其启动参数可以显著影响结果Temperature温度控制随机性。对于翻译建议设置较低的值如0.1-0.3让输出更确定、更忠实于原文。Max New Tokens最大生成长度确保设置得足够大如512以防长句子被截断。停止词可以添加\n,。,,等让模型在合适的位置结束生成。系统提示词这是提升质量的关键在TGW的聊天界面或在Translate.exe同目录下的配置文件中如果支持可以设置系统提示词。例如你是一个专业的日文游戏翻译助手。请将用户的日文对话翻译成流畅、自然、符合中文玩家习惯的简体中文。保留专有名词如人名、地名、技能名不翻译除非有广泛接受的译名。注意对话的语境和角色语气。通过精心设计的提示词你可以引导模型产出更专业的游戏翻译。6. 性能优化与长期维护心得一套系统搭建起来只是开始如何让它运行得更流畅、更稳定才是长期享受游戏的关键。1. 模型与硬件的平衡 如果你的GPU显存有限例如6GB或8GB运行13B的模型可能比较吃力导致翻译延迟高甚至爆显存。此时有两种选择选择更小的模型例如Qwen2.5-7B-Instruct它在7B尺寸上中英翻译能力非常强。使用CPU推理在TGW启动参数中加入--cpu完全利用CPU和内存运行模型。虽然速度慢于GPU但对硬件要求最低且稳定性极高。对于非动作类游戏延迟在可接受范围内。2. 翻译缓存机制 XUA会自动将翻译过的文本及其结果保存在Translation文件夹下的文本文件中。这意味着同一句台词第二次出现时会直接读取缓存无需再次请求模型极大提升速度并节省资源。要善用这个机制定期备份这个文件夹当你重装系统或换电脑时可以直接复用无需重新翻译整个游戏。3. 游戏更新后的适配 游戏更新可能会改变文件结构导致Mod失效。更新后如果翻译不工作了通常只需要重新验证或安装对应新游戏版本的BepInEx/XUA。将你原来的AutoTranslatorConfig.ini和Translation缓存文件夹复制回新的配置路径。大部分情况下你的个人配置和翻译缓存都能得以保留。4. 社区资源利用 对于一些热门游戏很可能已经有玩家社区制作了专门的翻译补丁或整合包。这些补丁可能直接包含了预翻译的文本文件你只需要安装XUA框架并载入这些文本就能获得即装即用的完美体验完全跳过实时翻译的步骤。在相关游戏论坛、贴吧或GitHub上搜索“[游戏名] XUnity 汉化”可能会有惊喜。折腾XUnity翻译器的过程就像为自己心爱的游戏亲手打造一副最合适的“眼镜”。从最初的磕磕绊绊到后来能游刃有余地针对不同游戏调整模型和参数这种成就感远超单纯使用一个现成的工具。它不仅仅是一个翻译方案更是一把钥匙打开了无数未被官方发现的文化宝库。希望这份指南能帮你扫清入门路上的所有障碍顺利踏入这个充满乐趣的自定义汉化世界。如果在实践中遇到本指南未覆盖的特定问题记住核心思路查看日志BepInEx的日志文件通常在游戏根目录\BepInEx\LogOutput.log、确认通信TGW的API是否真的在响应、检查配置每一个字符都不要错绝大多数问题都能在这三步中找到答案。