XUnity.AutoTranslator 翻译插件使用指南从安装到精通的中文无障碍游戏方案【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator周末晚上小林下载了一款好评如潮的日本独立游戏。像素画面精致、BGM 动人可当主角说出第一句对白时他愣住了——满屏日文。屏幕翻译工具要反复切窗口翻译一段话要等好几秒玩到第三章他就放弃了。这个场景是否似曾相识XUnity.AutoTranslator 正是为解决这类困境而生的开源翻译插件它直接寄生在 Unity 游戏进程内部截获游戏吐出的每一句文本实时交给在线翻译服务处理再把译文写回游戏界面。你不需要手动输入任何文本游戏里看到的每一句话都会自动变成你的母语。本文将带你在 30 分钟内完成从安装到首次成功翻译的完整流程并介绍新手、进阶、老手三个阶段的实用玩法。一、有它和没它差别到底有多大与其听我描述不如看一组直观对比对比维度没有 XUnity.AutoTranslator使用 XUnity.AutoTranslator 之后翻译方式手动复制粘贴、切窗口翻译游戏内自动完成全程无感实时性对话结束后才能翻译文本出现即翻译支持逐字滚动覆盖范围只能翻截图或剪贴板对话、菜单、道具、系统提示全覆盖术语一致性每次翻译结果飘忽不定可自定义词典与正则规则结果沉淀翻译完就丢自动缓存到本地越用越准一句话总结前者是看完一页翻一页的笨办法后者是打开即母语的沉浸体验。二者在体验上的差距正是这款插件存在的全部理由。二、动手前的环境清单开始之前先花两分钟确认你的环境是否满足条件。这份清单比任何长篇说明都实用一台能跑目标游戏的电脑Windows / Linux / macOS 均可插件不挑系统。一款基于 Unity 引擎的游戏游戏目录下有*_Data文件夹或UnityPlayer.dll/GameAssembly.dll等文件基本可以判定为 Unity 游戏。一个插件管理器BepInEx推荐新手、MelonLoader、IPA、UnityInjector四选一先装好。稳定的网络连接插件需要联网调用翻译服务离线环境无法工作。一个可用的翻译源内置的 GoogleTranslate、BingTranslate、DeepLTranslate 开箱即用无需注册追求稳定可选用需要 API Key 的服务。拿不准你的游戏是不是 Unity 引擎在游戏安装目录里搜一下UnityPlayer.dll找得到就是。三、一次完整的首次体验30 分钟跑通最小闭环下面以 BepInEx 方案为例走一遍从拿到文件到看到中文的完整路径。整个流程不超过 30 分钟。第 1 步获取项目源码在终端执行下面的命令把项目克隆到本地git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator第 2 步准备插件文件在仓库的src目录下你可以看到按插件框架拆分好的工程XUnity.AutoTranslator.Plugin.BepInEx、XUnity.AutoTranslator.Plugin.MelonMod等。用对应框架的工程编译出 dll或直接使用发布页提供的预编译包。以 BepInEx 为例最终的游戏目录结构长这样游戏根目录/ ├── BepInEx/ │ ├── core/ │ │ └── XUnity.Common.dll │ ├── plugins/ │ │ ├── XUnity.ResourceRedirector/ │ │ └── XUnity.AutoTranslator/ │ │ ├── XUnity.AutoTranslator.Plugin.Core.dll │ │ ├── XUnity.AutoTranslator.Plugin.BepInEx.dll │ │ └── Translators/ │ │ └── GoogleTranslate.dll │ └── Translation/ ← 翻译缓存与手动词典都在这里 └── 游戏主程序.exe这段结构图说明一件事核心库放进core插件本体和翻译器放进plugins翻译文本目录由插件自动创建。目录名一个都不能改。第 3 步启动并验证直接运行游戏。首次启动后插件会在BepInEx/Translation/{语言}/Text/下自动生成配置文件与翻译缓存文件。这时游戏里出现的对话应该已经被替换成目标语言了。第 4 步用快捷键做健康检查游戏运行中按下ALT 0打开翻译聚合界面ALT T可以在原文与译文之间来回切换。能切换成功说明文本钩子已经生效最小闭环跑通。四、三个高频配置项立刻提升体验配置文件AutoTranslatorConfig.ini在首次启动后自动生成。下面三个配置是绝大多数玩家的必调项看懂它们就够用一阵子了。1. 设定语言对最重要[General] Languagezh-CN ; 想翻译成什么语言就填什么 FromLanguageja ; 游戏原文是什么语言就填什么这段配置的作用是告诉插件从哪种语言翻到哪种语言。多数游戏建议明确填写原文语言而不是依赖auto自动检测——自动检测在部分服务上并不稳定。2. 打开更多文本框架[TextFrameworks] EnableUGUITrue ; 现代 Unity UI绝大多数游戏默认开启 EnableTextMeshProTrue ; 新版文字组件很多独立游戏在用 EnableTextMeshFalse ; 3D 空间漂浮文字需要时再开 EnableIMGUIFalse ; 旧式即时模式 UI拖慢性能按需开启TextMesh和IMGUI默认关闭是有原因的它们要么是 3D 漂浮文本容易误伤要么是拖慢帧率的旧架构。遇到部分文字没翻译时优先来这里打开对应开关试试。3. 控制翻译行为[Behaviour] MaxCharactersPerTranslation200 ; 单条文本最大字符数超过则不翻 MinDialogueChars20 ; 少于该字符数的文本不视为对话 EnableBatchingTrue ; 合并多个请求减少对服务端的打扰 EnableUIResizingTrue ; 译文变长后自动微调 UI 框体这三个数值决定了翻什么、怎么翻、翻多快。例如EnableBatching开启后支持批量接口的翻译源会合并请求既省流量又降低被封风险。五、用户旅程新手、进阶、老手的三条不同路径同样的工具三个阶段的人该关注的东西完全不同。新手先让它跑起来新手的唯一目标是看到中文。照着第三节的流程走完即可无需碰任何高级配置。遇到个别句子没翻译先检查FromLanguage是否填对、网络是否通畅这两点解决了大部分没反应的问题。此时不妨把EnableIMGUI打开——很多游戏的 Mod 菜单是 IMGUI 写的开着它连 Mod 界面一起翻译。进阶手动词典与缓存文件的妙用当自动翻译的质量开始让你皱眉时就该接触手动翻译了。插件会把所有翻译结果写入Text/_AutoGeneratedTranslations.txt这个文件遵循最低优先级原则——也就是说只要你在其他 txt 文件里给出了同一句话的翻译就会覆盖自动结果。具体做法把_AutoGeneratedTranslations.txt中不满意的词条剪切到新文件MyTerms.txt手工改成你想要的样子保存后按ALT R热重载游戏里立刻生效。再进一步用替换文件_Substitutions.txt处理总是被翻错的专有名词。把常见误译写进去插件会先在本地完成替换再决定要不要请求翻译服务# 把主角名字固定下来避免每次翻译都不一样 シンジ真嗣老手正则与拆分规则的进阶组合对文本形态复杂、经常拼接显示的 ADV 游戏老手会用到正则翻译。翻译文件中以r:开头的是正则规则用于匹配无法精确命中的文本r:^シンプルリング ([0-9])$Simple Ring $1如果游戏把多段文本拼在一起显示单条正则往往力不从心这时可以用拆分正则Splitter Regex先把长文本按规则拆开再逐段查词库性能和准确率都能兼顾。记得把正则规则放进以_开头的自动生成文件以外的文件里否则不会生效。六、高频问题速查表遇到问题先查表多数情况不用求助他人现象可能原因解决办法翻译完全没生效插件路径不对或框架不匹配核对插件文件是否在plugins目录确认游戏用的框架与插件一致部分文字没翻译对应文本框架被禁用在[TextFrameworks]打开EnableTextMesh/EnableIMGUI等开关游戏应用翻译后卡死或崩溃文本获取器兼容性问题把TextGetterCompatibilityMode设为True再试连续翻译失败后插件自动停摆触发防刷保护机制按ALT Q重启插件先排查网络或服务端问题再恢复最后一条值得展开插件内置了十几条防刷机制单次请求上限、串行发送、失败自动停机等目的是避免把翻译服务打爆。它自动停机恰恰说明网络或服务端出了问题优先解决问题本身而不是反复重启。七、进阶玩法与生态扩展能力接入你自己的翻译源插件支持自定义翻译端点。内置的CustomTranslate允许你指定任意 HTTP 地址作为翻译服务插件会以from、to、text三个参数发起 GET 请求。更进一步你可以实现自己的ITranslateEndpoint接口独立发布翻译器——社区里已有接入本地大模型Ollama的第三方端点质量相当不错。文本钩子覆盖 UGUI、NGUI、TextMeshPro、FairyGUI、Utage 等多个主流框架Mod 文本也能翻译。社区资源跟着老玩家走仓库内src/Translators目录收纳了 Google、Bing、DeepL、百度、Papago、彩云小译、ezTrans 等十余种翻译器实现还有针对特定游戏如恋活 Koikatsu的专用资源重定向工程。遇到拿不准的配置去对应游戏的翻译讨论区搜一搜往往早有答案。未来方向向本地与智能进化社区正在把翻译端点推向离线与智能本地大模型翻译插件已在活跃开发中开源模型部署后无需联网即可工作基于上下文的术语统一、社区共享翻译库也在持续完善。这意味着翻译质量的上限会不断被刷新。八、写在最后把选择权交回给你回到开头小林的困境。他缺的不是一款好游戏而是一道把语言隔阂拆掉的门——XUnity.AutoTranslator 就是这道门自动化的文本钩取、可持久化的翻译缓存、从零配置到正则定制的完整阶梯让它既能服务首次接触的新手也经得起老玩家的打磨。现在轮到你了按第三节的流程跑通第一次翻译把Language设成你的母语然后用ALT T在原文与译文之间来回切换——当你看到那句熟悉的开场白以母语浮现时这篇指南的使命就完成了。剩下的交给你的游戏旅程。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考