企业官网建设流程全解析

如何用 XUnity AutoTranslator 一键汉化 Unity 游戏：从安装到精调的完整指南

【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator

花了几十个小时玩一款日文 RPG，剧情全靠手机拍照机翻，那种体验相信不少玩家都经历过。XUnity AutoTranslator 正是为 Unity 游戏汉化这一场景而生的开源翻译插件：它能实时拦截游戏内的文本，调用在线翻译服务，把日文、英文游戏文本即时替换成中文，同时保留手动精翻的能力。本文将带你从零跑通一次完整的汉化流程，再给出按场景抄作业的配置方案，全程不需要任何编程基础。

一、它到底能解决什么问题：三类玩家的真实场景

先别急着看安装步骤，想清楚"它适合谁"能帮你省下大量试错时间。

场景一：日系 RPG / 视觉小说玩家剧情文本量大、对话密度高，靠截图翻译效率极低。XUnity AutoTranslator 支持 UGUI、NGUI、TextMeshPro、IMGUI、FairyGUI 和 Utage 等主流文本框架，绝大多数 Unity 游戏的对话、菜单、物品说明都能被自动抓取并翻译，进游戏即可看到中文。

场景二：只想玩懂机制的轻度玩家不在意翻译质量，只要"大概能看懂"。这类用户连注册翻译服务都嫌麻烦，直接用内置的免费翻译端点即可。

场景三：想认真精翻某款游戏的玩家或汉化爱好者插件会把翻译结果自动写入翻译文件，你可以手动修改、补充术语表，甚至用正则和替换规则实现精准翻译——这正是它和其他"一刀切机翻"工具最大的区别。

一个重要的能力边界：插件只负责"翻译文本并写回游戏"，在线端点本身的稳定性由第三方服务决定，免费端点随时可能失效。理解了这点，后面排障就不会慌。

二、零基础实战：5 步让第一款游戏跑起中文

以最常见的 BepInEx 安装方式为例，全程约 10 分钟。以下是完整路径，照着做就行。

第 0 步：确认游戏是 Unity 引擎在游戏目录里找到{游戏名}_Data文件夹（部分游戏叫GameAssembly.dll对应的Managed目录），存在即说明是 Unity 游戏，可继续。

第 1 步：获取项目文件

git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator

提示：源码仓库更适合学习和二次开发；实际使用建议直接获取对应框架的发布包（如XUnity.AutoTranslator-BepInEx-5.4.0.zip），里面已包含运行所需的全部依赖。

第 2 步：安装 BepInEx 与插件本体

1. 先按 BepInEx 官方说明完成框架安装，确保游戏目录出现BepInEx/文件夹；
2. 将下载的 AutoTranslator 压缩包解压到游戏根目录，使插件 dll 落入BepInEx/plugins/下，最终结构类似：
   • BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.Core.dll
   • BepInEx/plugins/XUnity.AutoTranslator/Translators/GoogleTranslate.dll

第 3 步：启动游戏生成配置文件首次启动游戏后，插件会自动在BepInEx/config/下生成AutoTranslatorConfig.ini，并在BepInEx/Translation/下创建翻译文件目录。这时先退出游戏，开始改配置。

第 4 步：修改核心配置

[General] Language=zh-CN ; 目标语言：简体中文 FromLanguage=ja ; 源语言：日语（按游戏实际语言填写） [Service] Endpoint=GoogleTranslate ; 免费端点，无需注册即可用 FallbackEndpoint= ; 可留空，或填 DeepLTranslate 做备用 [Behaviour] EnableUIResizing=True ; 译文变长时自动调整 UI 溢出方式，建议开启

第 5 步：启动验证重新启动游戏，正常情况下对话和菜单文本会陆续变为中文。按下ALT + T可以在原文和译文之间切换对照；ALT + 0可开关翻译界面。

踩坑提醒：如果某些文本没有翻译，先按ALT + U手动挂钩一次；若仍无效，多半是该文本框架默认关闭（如 IMGUI、TextMesh），去配置里把对应开关改为True。

三、关键配置速查：按场景抄作业的 3 套方案

不用背参数，对照你的需求选一套即可。

方案 A：免费快速尝鲜（默认即用）

[Service] Endpoint=GoogleTranslate [Behaviour] MaxCharactersPerTranslation=200 EnableBatching=True

适合：先确认插件在你的游戏上能跑通。Google 免费端点无需注册，代价是偶尔不稳定。

方案 B：质量优先（推荐 DeepL）

[Service] Endpoint=DeepLTranslate FallbackEndpoint=GoogleTranslate

适合：视觉小说、剧情类游戏。DeepL 的免费在线端点质量明显优于 Google，配合FallbackEndpoint在失败时自动降级，兼顾质量与稳定性。

方案 C：稳定与量足（注册类端点）

[Service] Endpoint=BingTranslateLegitimate [BingLegitimate] OcpApimSubscriptionKey=你的密钥

适合：长期汉化、文本量大的场景。Azure 文本翻译每月免费 200 万字符；Google 云翻译提供一年 300 美元试用额度（约 1500 万字符）。注意：这类端点需要先注册申请密钥，且密钥不要外泄。

提示：MaxCharactersPerTranslation默认 200，单条文本超过此长度会被忽略。对白越长翻译越慢，调大需谨慎，同时留意端点配额消耗。

四、常见疑问与排障清单：5 个高频问题

问题 1：游戏里只有部分文本被翻译了？排查步骤：按ALT + U尝试手动挂钩 → 检查[TextFrameworks]中对应框架是否开启（IMGUI、TextMesh 默认关闭）→ 确认该文本不是纹理图片。 解决：按需开启框架开关，图片类文本参考第五节纹理翻译。

问题 2：中文显示成方块/乱码？原因：游戏自带字体不含中文字形，这是汉化最常见的坑。 解决：给 TextMeshPro 配置备用字体FallbackFontTextMeshPro，或在[Behaviour]中设置OverrideFont（仅 UGUI）。可在src/XUnity.AutoTranslator.Plugin.Core/的 Fonts 目录查看字体处理相关实现。

问题 3：翻译后游戏逻辑异常（比如选错选项、功能错乱）？原因：部分游戏用"当前显示的文本"决定下一步逻辑。 解决：将[Behaviour]中TextGetterCompatibilityMode设为True，让游戏以为文本未被翻译。

问题 4：免费端点突然全部失败？原因：在线端点随时可能调整接口，属正常现象。 解决：切换其他端点或启用FallbackEndpoint；若插件因连续错误自动关闭，可在修复网络/更换节点后按ALT + Q重启插件。

问题 5：想把机翻结果改成自己的翻译？解决：编辑BepInEx/Translation/zh-CN/Text/_AutoGeneratedTranslations.txt，按原文=译文格式修改，保存后按ALT + R立即重载，无需重启游戏。该文件优先级最低，新建的其他翻译文件优先级更高。

五、进阶玩法：从机翻走向精翻

跑通机翻只是起点，这个插件真正的价值在于人工可控的翻译管线。

术语与专有名词修正在Translation/zh-CN/Text/_Substitutions.txt中加入替换规则，翻译前先替换，避免人名地名被反复翻错：

シンプルリング=Simple Ring

正则精准翻译标准正则对固定格式文本（如物品名加编号）非常有效：

r:"^シンプルリング ([0-9]+)$"=Simple Ring $1

分割正则sr:则能把组合文本拆开后分别翻译再拼回，适合处理"编号+名称"混排的界面。

翻译作用域用#set level 1,2,3或#set exe game1,game2指令，可以让特定翻译只在指定场景或指定 exe 下生效，避免多游戏共用一个翻译目录时互相冲突（需将EnableTranslationScoping设为True）。

纹理图片翻译在[Texture]中开启EnableTextureDumping=True可将游戏内图片导出到Translation/zh-CN/Texture/，用任意图像工具修改后放回同名目录即可替换。注意该功能默认关闭且对性能有影响，建议只在必要时开启。

扩展翻译端点项目在src/Translators/下按服务商分目录组织翻译器实现（如GoogleTranslate/、DeepLTranslate/、BaiduTranslate/）。如果你有自己的翻译服务，可通过CustomTranslate端点或实现ITranslateEndpoint接口接入，核心逻辑位于src/XUnity.AutoTranslator.Plugin.Core/Endpoints/。此外项目还提供恋活（Koikatsu）专用模块src/XUnity.AutoTranslator.KoikatsuResources/，可处理 Excel、TSV、剧本等资源文本，相关游戏玩家可直接受益。

六、下一步行动清单

现在你已经掌握了从安装、配置到精调的全流程。接下来按这个顺序操作即可：

1. 克隆仓库或下载对应框架的发布包（BepInEx 版最省心）；
2. 完成 BepInEx 框架安装，解压插件，启动游戏生成配置；
3. 按本文方案 A 验证翻译生效，再切换到你偏好的端点；
4. 遇到显示异常先查字体配置，遇到漏翻先查文本框架开关；
5. 有精力的话，从_Substitutions.txt开始建立自己的术语表。

XUnity AutoTranslator 最难得的地方在于：它把"实时机翻"和"人工精翻"放在同一条流水线上，让 Unity 游戏汉化从折腾变成了可以按步骤复现的操作。愿你今晚就能在游戏里看到熟悉的中文——汉化愉快。

【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator