Bannerlord AI NPC 模组:会谈判的领主与战场语音命令
用 Neocortex 制作 Bannerlord AI NPC 模组:会谈判的领主、战场语音命令、和谈对话和纹章问答,并附 Warband 模组作者的注意事项。
Neocortex TeamThe team behind Neocortex
· 阅读约 7 分钟

一位库拉伊特贵族听到你邀请他加入军队,他会权衡这件事与他家族的旧怨,然后开出自己的条件。 在原版游戏中,这场交涉只是一个简短的菜单加上一次说服判定,与卡拉迪亚大陆上的其他对话没有区别。 Bannerlord AI NPC 模组改变了这一点:你开口说话或打字,领主会以角色的口吻回答,记得你挑起的那场战争,并根据你们达成的协议采取行动。Neocortex 为你的模组提供 AI 角色、Conversation Flows、问答和在本地运行的语音命令,帮你完成这一切。
截图:Mount & Blade II: Bannerlord © TaleWorlds Entertainment
Bannerlord 还是 Warband:两条路线
这两款游戏需要不同的做法,差别主要在于网络代码应该放在哪里。
Bannerlord:全部放在模组内部。 Bannerlord 模组就是普通的 .NET 程序,因此模组可以像任何桌面应用一样,用 HttpClient 调用网络 API。代价是你需要自己编写和维护 C# 代码,不过大多数模组所依赖的社区库可以提供帮助。
Warband:模组加配套应用。 Warband 模组使用 Python Module System 编写,它会把你的脚本编译为引擎加载的文本文件。许多现代模组运行在 WSE2(Warband Script Enhancer 2)上,这是一个引擎替代品,增加了操作、触发器、性能优化和错误修复。 Module System 脚本并不是为网络请求或麦克风输入而设计的,因此需要将模组与玩家 PC 上的一个小型配套应用配对。该应用与 Neocortex 通信并运行语音命令,然后把回复和匹配的命令传给模组。代价是需要发布第二个程序,而且两者如何交换消息取决于你的设置,因此请查看 WSE2 的操作列表,确认你的版本支持哪些功能。
本指南其余部分以 Bannerlord 路线为准。
Bannerlord 模组技术栈
Bannerlord 模组就是一个模块:位于 Modules 下的一个文件夹,包含一个 SubModule.xml 和一个或多个 C# 程序集。你的代码运行在一个子模块类中,该类挂接游戏的生命周期。
大多数模组所依赖的社区技术栈,都是积极维护中的:
- Harmony(GitHub)在运行时修补游戏方法,例如将一段对话转交给你自己的代码处理。
- BLSE(GitHub),即 Bannerlord Software Extender,是 BUTRLoader 的延续,带有扩展的启动器。Xbox PC 版本必需,在 Steam、GOG 和 Epic 上则为可选。
- ButterLib(GitHub)提供共享的开发工具,例如快捷键、日志和存档辅助功能。
- UIExtenderEx(GitHub)让多个模组修改标准界面而互不冲突,你可以借助它添加字幕面板或聊天框。
- MCM(Mod Configuration Menu)为你的模组提供游戏内设置页面,是存放玩家 API 密钥和按键说话绑定的好地方。
TaleWorlds 在 Steam 上提供官方 Modding Kit,包含场景和资源编辑器,文档位于 moddocs.bannerlord.com,并附有 API 参考。 社区的 Bannerlord 模组文档介绍了如何制作第一个 C# 模组,以及 Gauntlet(即你用于字幕的 XML 和 ViewModel 界面系统)。 在语音播放方面,模组通过随模组一同打包的 .NET 音频库播放返回的音频。
在卡拉迪亚值得构建的场景
会谈判的领主和酒馆老板
想象一下 Pravend 的一位酒馆老板,他知道楼上喝酒的是哪些流浪汉,并会为一条消息讨价还价。或者想象那位库拉伊特贵族,正在权衡你的提议与家族的旧怨。
你的模组会在每条消息中发送关键信息:关系、王国当前的战争、你钱袋里的金币、你上一场战斗。
角色会回复文字,并附带一个用于脸部和语气的情绪标签,以及由你的代码执行的动作,例如 { "name": "JOIN_ARMY", "targetId": "lord_derthert" } 或 SHARE_RUMOR。
说服系统依然担任裁判;对话只是不再像一个菜单。由于在 Pro 和 Team 套餐中最多可以有六个角色共享同一段对话,因此在领主大厅里召开战争会议也没有问题。
在战场上高声下达的命令
Bannerlord 已经有一套很深的命令系统。语音命令让你用嘴而不是功能键来下达命令。 你以角色(“infantry”、“archers”、“cavalry”、“everyone”)、动作(“charge”、“hold position”、“follow”、“advance”、“fall back”)和对象(“me”、“that hill”)来设计命令集。
说出“cavalry charge”或“archers hold position”,模组就会收到一条干净的命令,并将其转换为对应的命令。 “Archers hold, cavalry charge”会被识别为两条命令。匹配在玩家的 PC 上完成,因此命令在冲锋仍然关键的时刻就能生效。
基于 Conversation Flow 的和谈
使者场景很适合用 Conversation Flow 实现。使者会沿着检查点引导谈话:问候、提出条款、同意纳贡,然后签署和约或谈判破裂。
每条回复都带有一个 flowState 关键词,你的模组会据此做出反应:收到 PEACE_SIGNED 时,执行战役自带的和平动作;收到 TALKS_COLLAPSED 时,战争继续,使者怒气冲冲地离开。
传令官的问答
市政厅里的传令官可以主持一场关于纹章、文化和历史的问答:“哪种文化拥有 Fian Champions?”或“谁统治 Vlandia?” 问答引擎(Team 套餐)负责题目、计分和排行榜,你的模组则可以向获胜者发放声望或一匹战马作为奖励。
截图:Mount & Blade II: Bannerlord © TaleWorlds Entertainment
将 Neocortex 接入模组
| 场景 | 模组调用的接口 | 返回的内容 |
|---|---|---|
| 领主、酒馆老板 | 带有战役状态的 /v3/chat | 用于 Gauntlet 字幕面板的台词、情绪标签、动作 |
| 语音台词 | /v3/audio/generate 或 /v3/audio/stream | 待播放的语音音频 |
| 和谈 | Conversation Flow 上的 /v3/chat | 模组可响应的检查点关键词 |
| 传令官问答 | /v3/quiz | 题目、计分、排行榜 |
| 战场命令 | 玩家电脑上的 Neocortex Voice Commands 库 | 匹配的命令,无需云端往返 |
角色在可视化节点编辑器中构建,包含性格、情绪、知识、世界和声音节点,因此你可以给一位领主提供一份他家族历史的文本文件,让他从中取材。 如果你正在权衡各种选择,我们的对比页面列出了 Neocortex 与其他 AI 角色平台的区别。
多人游戏、EULA 与公平游戏
请将模组限定在单人战役和自定义战斗中,保持免费且非商业用途,并遵守 TaleWorlds EULA 以及你发布模组所在网站的规则。 不要在多人游戏中使用语音或 AI 功能,这违反相关规定。每位玩家都应使用自己的 Neocortex API 密钥。
六步完成你的第一个 Bannerlord AI NPC 模组
- 搭建技术栈。 安装 Harmony、ButterLib、UIExtenderEx 和 MCM;如果你的玩家使用 BLSE,也需安装它;然后构建一个基础的 C# 模组。
- 在 Neocortex 控制台中设计角色阵容。 包括一位领主、一位酒馆老板、一个使者流程和一组纹章问题。先在浏览器中测试。
- 为阵型和命令设计战场命令集。 每个动作配几个示例短语。
- 从模组中连接。 在主线程之外调用
/v3/chat,复用sessionId,并将返回的动作映射到战役代码。 - 将 API 密钥保存在配置文件或玩家填写的 MCM 设置中,切勿硬编码进共享的模组里。
- 在单人战役中使用按键说话进行测试,然后再尝试常开监听。
Voice Commands 是一款授权 SDK:联系我们获取 Voice Commands 授权。
想进一步了解语音控制?请阅读我们关于游戏模组的本地语音命令的文章,或在我们的 AI NPC 和语音命令模组索引中浏览其他游戏指南,从 Skyrim 到 RimWorld 都有。你的第一位 Neocortex 领主,只需要一个账户就能开始。
工具版本和链接核对于 2026 年 10 月。模组工具更新频繁,请查看各项目页面以获取最新版本。
常见问题
能在 Mount & Blade II: Bannerlord 中加入 AI NPC 吗?
可以。Bannerlord 模组是 C# 模块,可以用 Harmony 修补游戏,并调用网络 API。Neocortex 角色随后就能以领主或酒馆老板的口吻,按角色回答,并附带由你的模组执行的动作。
能在 Bannerlord 中用语音下达战斗命令吗?
模组可以监听麦克风,将语音转换为玩家用键盘下达的同一种阵型命令。Neocortex Voice Commands 在玩家的 PC 上离线匹配“cavalry charge”之类的短语,并将要执行的命令交给你的模组。
Bannerlord AI 模组需要 BLSE 吗?
Xbox PC 版本必需 BLSE,在 Steam、GOG 和 Epic 上为可选项,许多模组会与 Harmony、ButterLib、UIExtenderEx 和 MCM 一起使用它。Neocortex 模组只需要一个能够发出 HTTP 请求的 C# 模块。
Mount & Blade: Warband 能使用 AI 对话吗?
可以,但需要一个辅助程序。Warband 模组使用 Python Module System 构建,通常运行在 WSE2 上;玩家 PC 上的一个小型配套应用负责网络调用和麦克风。该应用与 Neocortex 通信,并把回复和命令传给模组。
用 Neocortex 制作一个 Bannerlord AI NPC 模组要花多少钱?
你可以在浏览器中设计和测试角色,付费套餐每月 €9 起。Voice Commands 是一款授权 SDK,因此在发布语音控制功能之前,请先联系我们获取授权。






