XUnity.AutoTranslator 5步上手指南：Unity游戏自动翻译插件的完整实战教程

XUnity.AutoTranslator 5步上手指南：Unity游戏自动翻译插件的完整实战教程

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

打开心仪已久的日文RPG，却对着满屏假名干瞪眼；蹲守的独立游戏只有英文版，剧情全靠连蒙带猜——这是无数玩家的共同痛点。XUnity.AutoTranslator是一款开源的 Unity 游戏自动翻译插件，它能在游戏运行时实时捕获屏幕文本并调用在线翻译服务，几分钟就能让外语游戏以母语呈现，堪称游戏本地化的"平民解决方案"。

从一个深夜的"看不懂"说起

先讲一个真实的场景。小张是独立游戏的忠实玩家，某天他购入了一款好评如潮的日式RPG，结果开场的角色名、物品栏、技能描述全是日文。他试过开着网页翻译边玩边查，一晚上只推进了半小时剧情，游戏体验支离破碎。

三天后，他装上了 XUnity.AutoTranslator，同样一款游戏，字幕、菜单、对话框里的日文自动变成了中文，甚至不需要手动切换任何界面。他感叹："原来不是我不适合玩外语游戏，而是缺少一把合适的钥匙。"

这个插件的价值在于三点：实时性（文本出现即翻译）、全面性（覆盖多种 Unity 文本框架）、可维护性（翻译结果可手动修正并沉淀为本地文件）。接下来，我们一步步把它装进你的游戏。

选型：为什么不用翻译器、不用汉化补丁，而用插件

动手之前，先看清市面上几种方案的区别，这决定了你后续的体验上限。

为什么社区老玩家倾向插件方案？因为汉化补丁依赖作者持续更新，而 XUnity.AutoTranslator 把"翻译权"交给了玩家自己：

• 游戏内文本被钩子直接捕获，不依赖截图识别，准确率更高；
• 翻译服务可自由切换（Google、Bing、DeepL、百度等），免费付费随心选；
• 每次翻译结果会写入本地缓存文件，相同文本不会重复请求，还能手动改写成"完美版"。

它的工作链路可以概括为：游戏文本 → 文本钩子捕获 → 翻译端点服务 → 本地缓存回写 → 界面显示译文。理解了这条链路，后面的配置就全都顺理成章了。

安装前的3个判断：别急着下载

安装方式有很多种，选错反而会带来麻烦。动手前先回答三个问题：

1. 你的游戏有没有装 Mod 管理器？如果已经装了 BepInEx，就选 BepInEx 版本，避免与现有环境冲突；什么都没装，就选独立的 ReiPatcher 版本。
2. 游戏是 Mono 还是 IL2CPP？现代不少 Unity 游戏用 IL2CPP 编译，需要对应的 BepInEx 6 / IL2CPP 专用包。
3. 你的游戏是否被官方保护或反作弊限制？联机游戏慎用，这类工具只推荐用于单机体验。

5步装好你的Unity游戏翻译插件

第1步：锁定你的安装包版本

仓库 Release 页面提供了多个分发包，对应关系如下：

第2步：把压缩包解压到游戏根目录

以最常见的 ReiPatcher 方式为例：将压缩包直接解压到游戏根目录，确保SetupReiPatcherAndAutoTranslator.exe和其他游戏 exe 放在同一层。BepInEx 方式则是把 DLL 按目录结构放进BepInEx/plugins等对应位置。

第3步：运行安装程序或直接启动游戏

ReiPatcher 方式运行安装程序后，会生成一个"（Patch and Run）.lnk"快捷方式，用它能完成首次补丁注入。BepInEx 方式则直接启动游戏即可，插件会自动加载。

第4步：让游戏跑一遍，生成配置文件

首次启动后，插件会在游戏目录下自动创建AutoTranslator文件夹，里面是Config.ini和空的翻译目录。这一遍别急着关游戏，让它生成好默认配置再说。

第5步：修改语言并验证翻译

用记事本打开Config.ini，把目标语言改成你的母语，然后重启游戏：

[Service] Endpoint=GoogleTranslate [General] Language=zh-CN FromLanguage=ja

看到界面上的日文变成中文，说明安装成功。如果部分文本没翻译，别慌，后面的"翻车急救"一节有完整排查清单。

💡 想从源码自己编译？可以克隆仓库后打开XUnity.AutoTranslator.sln用 Visual Studio 构建：

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

首次配置：把翻译从"能用"调到"好用"

翻译服务端点怎么选

这是决定翻译质量和稳定性的关键。下表是常用端点速查：

新手建议从GoogleTranslate起步，跑通全流程后再根据质量切换。免费端点偶尔会失效，属正常现象，换一个即可。

语言参数的两个坑

• Language是目标语言，填你的母语代码（如zh-CN）；
• FromLanguage是源语言，建议明确填游戏原语言（如日文游戏填ja），不要轻易用auto——自动检测在多语言混排的界面文本上经常翻车。

合理限制，保护翻译服务与游戏性能

[Behaviour] MaxCharactersPerTranslation=200 EnableBatching=True

• MaxCharactersPerTranslation：超过该长度的文本不翻译，默认 200 是质量和性能的平衡点，不宜盲目调大；
• EnableBatching：把多条请求合并发送，能显著降低请求次数，建议保持开启。

记住这组快捷键，体验翻倍

💡 实用技巧：感觉"某句话没翻译"，先按 ALT + U 手动钩一下，再按 ALT + R 重载，八成能救回来。

三类玩家的实用场景方案

场景一：剧情党——只想顺畅玩懂主线

追求"装上即用"，改动越少越好：

1. 端点用免费的 GoogleTranslate 或 BingTranslate；
2. 语言参数只动Language和FromLanguage；
3. 保持默认的文本框架设置，不额外折腾。

这样配置下，对话、任务说明、道具名都能自动翻译，代价是偶尔遇到不太通顺的机翻句子——这正是场景二和场景三要解决的。

场景二：中文玩家——解决"方块字"和机翻味

翻译成中文后经常遇到两个问题：字体不支持显示和机翻生硬。

• 字体问题：游戏自带字体可能不含中文字形，译文显示为方框。在配置中指定一个中文字体文件即可：

[Behaviour] OverrideFont=C:\path\to\your\font.ttf

• 机翻生硬：把端点换成百度翻译（中文质量更对口），或在翻译目录下手动修正关键名词，让常用术语固定下来。

• 长文本溢出：中文比日文占空间，开启自动缩放能缓解 UI 撑破问题：

[Behaviour] EnableUIResizing=True ResizeUILineSpacingScale=0.80

场景三：模组玩家与汉化志愿者——沉淀自己的翻译库

玩 Mod 多的玩家，最头疼的是 Mod 界面文本翻译不到。先开启 IMGUI 文本框架：

[TextFrameworks] EnableIMGUI=True

再为特定 Mod 提供专属翻译。在翻译目录下创建Plugins文件夹，以 Mod 的 DLL 文件名（不含扩展名）建子目录，放入同名翻译文件：

Translation/zh-CN/Text/Plugins/MyModName.txt

文件开头加上#enable fallback指令，可以让该 Mod 的专属翻译在缺失时回退到通用翻译，两全其美。

高频翻车现场与急救手册

翻车一：装好了却毫无翻译

按顺序排查，90% 的案例都能解决：

1. 看游戏日志确认插件是否加载成功；
2. 检查Config.ini的Endpoint是否留空或拼写错误；
3. 确认Language与FromLanguage是否填反了；
4. 按 ALT + U 手动钩文本，确认是不是自动钩子没生效；
5. 某些文本框架默认关闭（如 TextMesh、IMGUI），按需在[TextFrameworks]里打开。

翻车二：翻译结果狗屁不通

• 先把FromLanguage从auto改成明确的源语言；
• 换一个翻译端点对比效果；
• 人名、地名等专有名词用替换文件（Substitutions）固定，避免每次都被乱翻。

翻车三：游戏变卡、掉帧明显

• 调低MaxCharactersPerTranslation；
• 关闭游戏用不到的文本框架（EnableIMGUI=False等）；
• 保持批处理和缓存开启，减少网络请求频率。

翻车四：一翻译就崩溃或逻辑错乱

部分游戏会读取屏幕文本来驱动逻辑。此时开启兼容模式即可：

[Behaviour] TextGetterCompatibilityMode=True

判断方法很简单：如果 ALT + T 切回原文后功能恢复正常，基本就是需要开这个选项。

进阶玩法：正则、替换与翻译作用域

用正则处理"动态文本"

游戏里大量文本是"模板+变量"结构，比如シンプルリング 1、シンプルリング 2。逐条翻译太低效，一条正则就能覆盖：

r:"^シンプルリング ([0-9]+)$"=简约戒指 $1

以r:开头的是标准正则；以sr:开头的是"拆分正则"，适合把组合文本先拆开再逐段翻译，例如把01 シンプルリング拆成编号和名称分别处理：

sr:"^([0-9]{2}) ([\S\s]+)$"=$1 $2

⚠️ 注意：正则不要滥用，尽量精确匹配、控制范围，否则会拖慢翻译匹配性能；且正则在自动生成文件（下划线开头的文件）里不生效。

用替换文件固定术语

在_Substitutions.txt中可定义"翻译前替换"，适合纠正服务端经常翻错的人名地名。支持变量写法，替换后翻译结果会保留变量：

私は{{A}}=I am {{A}}

用作用域让翻译只作用于指定场景

如果同一句文本在不同场景应译成不同意思，可开启作用域功能：

[Behaviour] EnableTranslationScoping=True

在翻译文件中用指令限定生效范围：

#set level 1,2,3 这个区域内的翻译只在1、2、3号场景生效 #unset level 1,2,3

更深度的玩法：资源重定向与贴图翻译

在Config.ini中开启[ResourceRedirector]相关选项后，可以把游戏加载的字体、TextAsset 等资源重定向到本地文件，实现"替换字体、修改文本资源"级别的定制。贴图翻译则支持把游戏内图片导出、PS 后放回Translation/{Lang}/Texture目录实现替换——这是汉化组做"图内文字汉化"的常见手段，但会带来明显性能开销，按需开启即可。

收尾行动清单：从今天开始动手

回顾全文，你的落地路线可以这样安排：

新手路线（今天就能完成）

• 判断游戏是否已装 Mod 管理器，锁定对应安装包
• 解压安装并跑一遍游戏生成配置
• 修改Language/FromLanguage，用默认端点验证翻译
• 记熟 ALT + T / ALT + U / ALT + R 三个快捷键

进阶路线（本周内完成）

• 对比 2-3 个翻译端点，选出最适合你语言对的服务
• 为常用游戏配置中文字体与 UI 缩放
• 用替换文件固定专有名词，建立自己的术语表

发烧友路线（长期经营）

• 用正则和拆分正则批量优化动态文本
• 为常用 Mod 建立插件专属翻译并开启 fallback
• 学习资源重定向与贴图翻译，参与社区翻译协作

最后提醒一句：这个项目迭代活跃，新版本常带来新端点支持、性能优化和文本框架适配。定期关注项目 Release 与社区讨论，把你踩过的坑、写好的翻译文件分享出去——每一个玩家贡献的翻译，都会让下一个外语游戏玩家少走一段弯路。祝你今晚就能玩上"看得懂"的那款游戏。

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