
BannerLord MCP(开源开发工具)
MB2-MCP 是一个 [MCP](https://modelcontextprotocol.io) 服务器,它让 Claude Code、Codex、DeepSeek Harness 以及其他 MCP 客户端获得资深模组开发者眼中的《霸主》游戏安装视图,并提供安全工具来修改它。你用自然语言提问;代理会搜索、编写、修补并验证,然后向你展示所做的更改。
查看大图描述 [center]MB2-MCP 让你的 AI 成为《霸主》Mod 制作搭档 只需开口:AI 就会创建武器、调整兵种、编写补丁、翻译 Mod 和编辑场景。[/center]
这不是游戏模组。 请勿用 Vortex 安装,也不要放进 Modules 文件夹:MB2-MCP 是一个由你的 AI 客户端(Claude Code、Codex、DeepSeek Harness 或任何其他 MCP 客户端)启动并与之通信的工具。 免费且开源(MIT)。 最新版本、安装指南和源码:github.com/RichardBennyVolt/MB2-MCP
它是什么? MB2-MCP 是一个 MCP 服务器(MCP:让 AI 助手调用外部工具的开放协议)。把它接入你的 AI 客户端,AI 就能像经验丰富的 Mod 作者一样查看你的《霸主》安装(每件物品、每个兵种以及跨模块引用),并用安全的工具进行修改。你只需用自然语言提出需求:
- “新建一个叫 RoyalArmory 的 Mod,以帝国斯帕塔剑为基础做一把剑,售价 5000 第纳尔。”
- “把所有 26 级以上的瓦兰迪亚骑兵的单手技能提高 20——用补丁,不要覆盖原文件。”
- “把 MyMod 翻译成简体中文。”
- “在打开的编辑器场景里,城门旁边的地面上摆一排三个木桶,然后截图。”
AI 会自行搜索、编写、打补丁并校验,然后向你展示改了什么。 适合 Mod 作者、翻译和场景制作者,也适合那些因为 XML 而放弃 Mod 制作的人。
它能做什么
- 了解你的安装:检测 Steam/Epic/GOG/Xbox 版本,约一秒内索引全部模块(官方、创意工坊和你自己的);按 id、名称或属性搜索,查找引用、加载顺序和依赖。
- 安全地编辑游戏数据:创建、克隆和修改物品、兵种、英雄、家族、王国、定居点和文化;文件会自动注册到 SubModule.xml,并保留缩进、注释和编码。
- XSLT 补丁:无需复制原文件即可修改原版或其他 Mod(官方海战 DLC 使用的也是这套机制),并用游戏所用的同一 .NET 引擎预览结果。
- 像游戏一样校验:XSD、依赖、DLL、重复 id、失效引用、未注册文件——在启动游戏前捕获常见错误。
- 本地化:找出无法翻译的文本,分配 {=ids},列出未翻译字符串,写入语言文件并检查占位符。
- 场景与资产:无需打开游戏即可编辑 .xscene 场景和预制体;检查场景、FBX、贴图和 .tpac 资源包中已知会导致编辑器崩溃和卡死的原因。
- 实时场景编辑器(Modding Kit):生成、移动、旋转和缩放实体,将其贴地,执行控制台命令并截图供 AI 查看;查明编辑器卡住的原因(哪个对话框、哪条警告)。
- 实验性(0.3.0 新增,尚未在运行中的编辑器里测试):编辑器游玩模式、导航网格上的行走测试、寻路查询。
全部 43 个工具:工具参考。
默认安全
- 永不写入官方或创意工坊模块;每次文件更改都会备份,并可撤销。
- 无内置遥测;编辑器桥接仅监听 127.0.0.1,并需要随机令牌。
- 启动和退出游戏需要显式调用;可能保存或丢弃场景的对话框永远不会被自动应答——必须明确指定按钮。
- 注意:AI 读取的 Mod 文件、日志和截图会像其他工具输出一样发送给你所用 AI 客户端的模型服务商。
它做不到什么 在编辑器中打开或保存场景、首次导入新资产(FBX → .tpac)、编辑导航网格、绘制地形或植被、测试 NPC 战斗或攻城。这些仍需在编辑器或游戏中进行。
要求
- Windows 10/11 和 Node.js 18+
- Bannerlord 1.2+(已在 1.4.8 测试)
- 支持 MCP 的 AI 客户端,例如 Claude Code、Codex、DeepSeek Harness、Cursor 或 Cherry Studio(需自备;其定价适用)
- 可选:Mount & Blade II: Bannerlord – Modding Kit,用于实时编辑(Steam → 库 → 工具)
安装只需几条命令;README 中有逐步说明。
开始使用 ▶ GitHub:下载、安装指南和源码 ▶ 报告 bug / 请求功能 如果 MB2-MCP 帮你节省了时间,请给它点个 Endorse,并在 GitHub 上点个 ★ Star。欢迎留言:你会用它做什么 Mod?
中文介绍 这不是游戏模组:请勿用 Vortex 安装或放进 Modules 文件夹。MB2-MCP 是一个 MCP 服务器(MCP:让 AI 助手调用外部工具的开放协议),由你的 AI 客户端(Claude Code、Codex、DeepSeek Harness 等)启动和调用。接上它,AI 就能像资深 Mod 作者一样看懂你的《霸主》——每件物品、每个兵种、模块之间的每条引用,并用安全的方式动手修改。你只要用中文提需求:
- “新建一个叫 RoyalArmory 的 Mod,以帝国斯帕塔剑为基础做一把剑,售价 5000 第纳尔。”
- “把所有 26 级以上的瓦兰迪亚骑兵的单手技能提高 20——用补丁,不要覆盖原文件。”
- “把 MyMod 翻译成简体中文。”
- “在编辑器当前场景里,城门旁边的地面上摆一排三个木桶,然后截图。”
AI 会自己搜索、编写、打补丁、校验,最后告诉你改了什么。适合 Mod 作者、汉化组和场景作者,也适合想做 Mod 却被 XML 劝退的玩家。
能帮你做什么
- 秒懂你的游戏:识别 Steam/Epic/GOG/Xbox 版,约一秒索引全部模块(官方、创意工坊和你自己的);按 id、中文名或属性搜索,查引用、加载顺序和依赖。
- 放心改数据:新建、克隆、修改物品、兵种、英雄、家族、王国、定居点和文化;自动注册到 SubModule.xml,保留缩进、注释和编码。
- XSLT 补丁:不复制原文件就能改原版或其他 Mod(官方海战 DLC 用的也是这套机制),用与游戏相同的 .NET 组件预览结果。
- 像游戏一样校验:XSD、依赖、DLL、重复 id、失效引用、未注册文件,进游戏前先揪出常见错误。
- 汉化与本地化:找出无法翻译的文本,分配 {=id},列出未翻译条目,生成语言文件并检查占位符。
- 场景与资产:不开游戏也能编辑 .xscene 场景和预制体;检查场景、FBX、贴图和 .tpac 资源包,提前发现已知会让编辑器崩溃或卡死的问题。
- 实时场景编辑(需 Modding Kit):生成、移动、旋转、缩放实体,贴地摆放,执行控制台命令,截图给 AI 看;编辑器卡住时告诉你是哪个弹窗、哪条警告。
- 实验性(0.3.0 新增,尚未在运行中的编辑器里实测):编辑器试玩、沿导航网格的行走测试、寻路查询。
默认安全
- 永远不写入官方和创意工坊模块;每次文件修改都有备份,可以撤销。
- 无内置遥测;编辑器桥接只监听本机 127.0.0.1,并需要随机令牌。
- 启动、退出游戏都需要明确指令;会保存或丢弃场景的弹窗不会被自动处理,必须明确指定按钮。
- 提醒:AI 读到的 Mod 文件、日志和截图,会像其他工具结果一样发给你所用 AI 客户端的模型服务商。
做不到的事:在编辑器里打开或保存场景、首次导入新资产(FBX → .tpac)、编辑导航网格、刷地形和植被、测试 NPC 战斗与攻城。
需要什么:Windows 10/11 · Node.js 18+ · 《霸主》1.2 及以上(已在 1.4.8 测试)· 支持 MCP 的 AI 客户端,如 Claude Code、Codex、DeepSeek Harness、Cursor、Cherry Studio(需自备,费用以各平台为准)· 实时编辑另需 Modding Kit(Steam → 库 → 工具)。安装只要几条命令,中文 README 有逐步说明。
▶ 中文安装与使用说明 ▶ 全部 43 个工具与参数 ▶ 反馈问题 / 提需求 觉得好用请点个 Endorse,再去 GitHub 点个 ★ Star!
Not affiliated with or endorsed by TaleWorlds Entertainment.
安装说明 我的 GitHub 仓库 "https://github.com/RichardBennyVolt/MB2-MCP"
主要功能
- 浏览和搜索游戏对象、模块、依赖和引用。
- 创建和编辑模块 XML;预览 XSLT 补丁;校验数据;管理本地化。
- 处理场景文件、预制体和资产,文件编辑带备份。
- 通过可选的本地桥接连接 Modding Kit,进行实时场景编辑。
- 通过 Claude Code、Codex、DeepSeek Harness 和其他 MCP 客户端使用 43 个工具。
要求 Windows 10/11 · Node.js 18+ · Bannerlord(已在 1.4.8 测试;1.2+ 预期可用)· 可选 Mount & Blade II: Bannerlord – Modding Kit(Steam → 库 → 工具),用于实时编辑器。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。