马塞利翻译器

马塞利翻译器

游戏和模组UI的后台机器翻译,游戏从不等待。Google、Google Cloud、DeepL、LibreTranslate、缓存、术语表、长文本完整翻译,MCM为俄语或英语。仅英文行;模组名称保持不变。Bannerlord 1.4.8。

Marcelli Translator 文字跨越一切边界。 《骑马与砍杀 II:霸主》 ✦ Steam


在游戏过程中实时机器翻译游戏及其模组。游戏从不停顿:先显示原文,一两秒后翻译替换它。默认:英语 → 俄语。

✨ 功能

  • 🌐 即时翻译游戏和模组
  • 📜 也翻译长文本——长篇编年史、信件和百科条目会整段翻译,逐段处理,保留名称和标记不变
  • 🔌 单个 DLL:无外部程序,无开放端口
  • 🧠 4 种翻译器:Google Free(无需密钥)、Google Cloud、DeepL、LibreTranslate;免费 Google 作为备用
  • 💾 缓存和词汇表——不会重复翻译
  • 🛡️ 不处理名称、模组名称和启动器
  • ⚙️ MCM 菜单支持英文或俄文,跟随游戏语言;无 MCM 时所有设置在一个文件中
  • ⏯️ 在 MCM 中即时开关翻译——无需重启
  • 🔐 密钥永远不会出现在日志中

📦 前置要求

  • Harmony——必需
  • Mod Configuration Menu(+ ButterLib、UIExtenderEx)——可选,用于设置菜单

🔧 安装 通过 Vortex 安装,或将压缩包解压到游戏目录 …\Mount & Blade II Bannerlord\(压缩包内已包含 Modules\MarcelliTranslator),在启动器中于 Harmony 和 MCM 之后启用。 更新时替换整个文件夹——设置、缓存和词汇表会保留。

🤝 兼容性 可与任何模组一起使用,并翻译它们的文本。为启动器声明了加载顺序。可添加到进行中的战役。

[spoiler=🧠 如何选择翻译器及获取密钥]

  • GoogleFree(默认)——无需密钥。非官方免费 Google 端点:可能被限流,此时模组会自动暂停。
  • GoogleCloud——官方 API:console.cloud.google.com → 启用“Cloud Translation API” → 密钥 AIza…;每月 500,000 字符免费。
  • DeepL——通常更自然。DeepL API Free(deepl.com/pro-api):每月 500,000 字符,密钥以 :fx 结尾。
  • LibreTranslate——开源,可在自己的电脑上运行(例如 http://localhost:5000)。

切换翻译器不会清除缓存。密钥以明文存储——切勿分享 MTR_settings.ini 或 MCM 密钥页面截图。 [/spoiler]

[spoiler=⚙️ 设置:MCM 和文件]

  • MCM:选项 → 模组选项 → “Marcelli Translator”。“测试连接”翻译一个短语;“清除缓存”会先询问确认。
  • 无 MCM 时:Documents\Mount and Blade II Bannerlord\Configs\MarcelliTranslator\MTR_settings.ini——更改在几秒内生效,即使在游戏中。
  • 关闭翻译:MCM 中的“启用翻译”复选框(即时生效,缓存保留)或文件中 TranslationEnabled=false。 [/spoiler]

[spoiler=📖 词汇表] 文件 MTR_glossary.txt,行格式为原文=译文。适用于所有翻译器——方便处理名称、头衔和术语。 文件 MTR_corrections.txt:你自己的翻译修正,行格式为错误=正确。如果翻译器有误,写下正确的内容。 [/spoiler]

[spoiler=💾 缓存和日志]

  • MTR_cache.tsv——所有翻译,可用记事本编辑(UTF-8)。清除时保留副本为 MTR_cache.tsv.bak。
  • MTR.log / MTR.log.old——当前和上次运行的日志。不含密钥,可以安全发送。 [/spoiler]

[spoiler=🚫 不会被翻译的内容] 模组名称和 id 及其缩写(RBM、MCM、BLSE…)、含未解析 {=id} 键的字符串、启动器和模组自身的文本。名称在翻译后的句子中保持原样。仅发送看起来像英语的行。 [/spoiler]

[spoiler=❓ 常见问题和故障排除]

  • 翻译停止显示——免费 Google 正在限流;模组会自动等待,或选择其他翻译器。
  • DLL 无法加载——右键 MarcelliTranslator.dll → 属性 → “解除锁定”。
  • 报告问题——设置 LogLevel=Debug,复现问题,发送 MTR.log(崩溃后还需 MTR.log.old)、你的翻译器和模组列表。切勿发送 MTR_settings.ini——它包含你的密钥。 [/spoiler]

🔮 计划

  • 📖 现成的卡拉迪亚名称和头衔词汇表
  • 🗂️ 直接在 MCM 菜单中选择翻译语言
  • 🧩 与热门模组的兼容性检查

📜 权限

  • 🎨 制作本模组未使用其他模组的资源。
  • 🚫 禁止转载到其他网站。
  • 🛠️ 修改需获得作者许可。
  • 🎮 禁止移植到其他游戏。
  • 🖼️ 资源使用需获得许可。
  • 💰 不允许用于付费模组。
  • ⭐ 使用我资源的模组不得获取捐赠点数。
  • 🌍 欢迎翻译——需注明作者并附上原版链接。

作者:Mark Marcelli · 美术:Lifa Marcelli


🇷🇺 俄语

Marcelli Translator Слова пересекают любые границы. 《骑马与砍杀 II:霸主》 ✦ Steam


游戏和模组的实时机器翻译,在游戏进行中直接生效。游戏从不停顿:先看到原文,一两秒后显示译文。默认从英语翻译为俄语。

✨ 模组功能

  • 🌐 即时翻译游戏和模组
  • 📜 也翻译长文本——长篇编年史、信件和百科条目会整段翻译,逐段处理,保留名称和标记不变
  • 🔌 单个 DLL:无外部程序,无开放端口
  • 🧠 4 种翻译器:Google Free(无需密钥)、Google Cloud、DeepL、LibreTranslate;备用为免费 Google
  • 💾 缓存和术语表——已翻译过的不会重复翻译
  • 🛡️ 不修改名称、模组名称和启动器
  • ⚙️ MCM 菜单支持俄语和英语——根据游戏语言;无 MCM 时全部在文件中配置
  • ⏯️ 在 MCM 中直接开关翻译——即时生效,无需重启
  • 🔐 密钥永远不会出现在日志中

📦 前置要求

  • Harmony——必需
  • Mod Configuration Menu(+ ButterLib、UIExtenderEx)——可选,用于设置菜单

🔧 安装 通过 Vortex 安装,或将压缩包解压到游戏目录 …\Mount & Blade II Bannerlord\(压缩包内已包含 Modules\MarcelliTranslator),在启动器中于 Harmony 和 MCM 之后启用。 更新时替换整个文件夹——设置、缓存和术语表会保留。

🤝 兼容性 可与任何模组一起使用,并翻译它们的文本。为启动器声明了加载顺序。可添加到进行中的战役。

[spoiler=🧠 选择哪种翻译器及获取密钥]

  • GoogleFree(默认)——无需密钥。非官方免费 Google 地址:可能被限流,此时模组会自动暂停。
  • GoogleCloud——官方 API:console.cloud.google.com → 启用“Cloud Translation API” → 密钥 AIza…;每月 500,000 字符免费。
  • DeepL——通常更自然。DeepL API Free(deepl.com/pro-api):每月 500,000 字符,密钥以 :fx 结尾。
  • LibreTranslate——开源,可在自己的电脑上运行(例如 http://localhost:5000)。

更换翻译器不会清除缓存。密钥以明文存储——切勿展示 MTR_settings.ini 和 MCM 密钥页面。 [/spoiler]

[spoiler=⚙️ 设置:MCM 和文件]

  • MCM:设置 → 模组设置 → “Marcelli Translator”。“测试连接”翻译一个短语,“清除缓存”会要求确认。
  • 无 MCM 时:Documents\Mount and Blade II Bannerlord\Configs\MarcelliTranslator\MTR_settings.ini——更改在几秒内生效,即使在游戏中。
  • 关闭翻译:MCM 中的“启用翻译”复选框(即时生效,缓存保留)或文件中 TranslationEnabled=false。 [/spoiler]

[spoiler=📖 术语表] 文件 MTR_glossary.txt,行格式为原文=译文。适用于所有翻译器——方便处理名称、头衔和术语。 文件 MTR_corrections.txt——你自己的翻译修正,行格式为原译=正确:如果翻译器有误,写下正确的内容。 [/spoiler]

[spoiler=💾 缓存和日志]

  • MTR_cache.tsv——所有翻译,可用记事本编辑(UTF-8)。清除时保留副本为 MTR_cache.tsv.bak。
  • MTR.log / MTR.log.old——当前和上次运行的日志。不含密钥,可以发送。 [/spoiler]

[spoiler=🚫 不会被翻译的内容] 模组名称和 id 及其缩写(RBM、MCM、BLSE…)、含未解析 {=id} 键的字符串、启动器和模组自身的文本。翻译短语中的名称保持原样。仅翻译看起来像英语的行。 [/spoiler]

[spoiler=❓ 问题和故障]

  • 翻译停止显示——免费 Google 临时限制了请求;模组会自动等待或选择其他翻译器。
  • DLL 无法加载——右键 MarcelliTranslator.dll → 属性 → “解除锁定”。
  • 报告问题——设置 LogLevel=Debug,复现问题,发送 MTR.log(崩溃后还需 MTR.log.old)、所选翻译器和模组列表。切勿发送 MTR_settings.ini——其中包含密钥。 [/spoiler]

🔮 未来计划

  • 📖 现成的卡拉迪亚名称和头衔术语表
  • 🗂️ 直接在 MCM 菜单中选择翻译语言
  • 🧩 与热门模组的兼容性检查

📜 权限

  • 🎨 制作本模组未使用其他模组的资源。
  • 🚫 禁止转载到其他网站。
  • 🛠️ 修改需获得作者许可。
  • 🎮 禁止移植到其他游戏。
  • 🖼️ 资源使用需获得许可。
  • 💰 不允许用于付费模组。
  • ⭐ 使用我资源的模组不得获取捐赠点数。
  • 🌍 允许翻译——需注明作者并附上原版链接。

作者:Mark Marcelli · 美术:Lifa Marcelli