Half-Life 2 AI NPC 模组:语音指挥的小队与同伴
在 Source SDK 2013 上规划 Half-Life 2 AI NPC 模组:一支可以用语音指挥的反抗军小队、一位会回应你的同伴、安全屋的剧情节点,以及一个问答终端。
Neocortex TeamThe team behind Neocortex
· 阅读约 6 分钟

Half-Life 2 的小队 AI 会听你的按键操作,而世界里的人们只会说剧本允许的话。反抗军会跟随你,但你无法对他们下达任何指令;市民会说话,却从不谈论刚刚发生的事。 Half-Life 2 AI NPC 模组可以同时解决这两个问题:反抗军会对你大声说出的命令作出反应,一位同伴会谈论你刚刚幸存的那场战斗,剧情场景也会随着玩家的选择而改变。Neocortex 提供 AI 角色、对话流程、问答以及设备端语音指令,Source SDK 2013 则为你提供把它们接入游戏的代码。
截图:Half-Life 2 © Valve
为反抗军小队下达语音命令
Half-Life 2 本来就允许你把小队派到某个位置,再把他们召回。语音命令则用说话取代按键:"往前"、"就地守住"、"躲到车后面"、"在我这里集合"。
在 Neocortex 控制台中,你可以将命令集设计为角色、动作和对象:角色为"squad",动作有"move"、"hold"和"cover",对象则包括"me"、"car"和"door"等。玩家可以自然地说话,模组会立即收到匹配的命令,包括一句话中的多个动作和数量,例如:"你们两个看住门,其他人跟我走"。你的代码再把它们映射到现有的小队代码上。
它支持按键通话或始终监听,支持多种语言,并在玩家的机器上运行,因此命令可以在激烈交火中即时生效,无需经过云端往返。
Voice Commands 是一款授权 SDK:联系我们获取 Voice Commands 授权。
实例:Mara Venn 与安全屋
同伴。 创建一个原创同伴,例如 Mara Venn,她曾是一名战地医护人员,在她的诊所关闭后加入了抵抗组织。你的模组会将玩家的问题,连同游戏已知的信息一起发送:附近的物体(路障、弹药箱、电台),以及最近发生的事件("两名小队成员倒下"、"玩家走了左边的隧道"、"生命值低于 30")。Mara 会用语音回答,每一行台词都带有情绪标签,并且可以返回动作,例如递上医疗包,或打开玩家询问的那扇门。
小队会互相反驳。 群聊功能(Pro 和 Team 套餐)让最多六个角色共享同一段对话,因此整支小队都可以为下一步行动争论不休。
地下室。 Mara 会带玩家前往一处地下室安全屋,在那里玩家必须赢得一位戒备心很重的小组长的信任,他才会告诉你离开城市的路线。对话流程定义了各个节点:自我介绍、证明你站在哪一边、达成交易、告知路线。无论玩家怎样措辞,角色都会引导对话经过这些节点,而 API 会返回诸如 TRUST_EARNED 或 ROUTE_SHARED 之类的检查点关键词。你的模组会据此打开隐藏的门,或生成带你离开的向导。
终端。 角落里有一台终端,用来对新兵进行训练:应避开哪些敌方单位、如何向小队发出信号、应该携带哪些补给。Neocortex 问答引擎(Team 套餐)负责出题和计分,连续答对还可以奖励玩家弹药或一条捷径。
截图:Half-Life 2 © Valve
用于 Half-Life 2 AI NPC 模组的 Source SDK 2013 分支
Half-Life 2 运行在 Source 引擎上。模组是一个文件夹,包含自己的 gameinfo.txt、内容文件,以及两个基于 Valve 代码构建的 C++ 库:一个服务器 DLL,负责 NPC AI、小队和游戏逻辑;一个客户端 DLL,负责 HUD、VGUI 面板和本地特效。在做其他事情之前,先选定基础版本:
| 基础版本 | 包含内容 | 状态 |
|---|---|---|
Source SDK 2013 singleplayer 分支 | Half-Life 2 单人游戏代码 | 自 2015 年以来没有代码更新;可在 32 位 Source SDK Base 2013 Singleplayer 上运行 |
Source SDK 2013 master 分支 | 多人游戏代码 | 2025 年 2 月更新,加入了 Team Fortress 2 游戏代码和 64 位构建;Valve 仍在维护 |
| Mapbase | 社区维护的单人模组基础版本 | 8.0 版于 2025 年 7 月发布,新增实体、修复以及用于地图脚本的 VScript 实现 |
对于上文那样的剧情模组,请从 singleplayer 分支或 Mapbase 开始。
从 Source DLL 调用 Neocortex
SDK 头文件包含 Steamworks HTTP 接口,不过许多模组作者会改用 libcurl。无论哪种方式,都应在工作线程上执行请求,并将结果传回游戏主循环。下面是客户端或服务器 DLL 中使用 libcurl 发起聊天请求的示例:
// bodyJson: {"characterIds":["CHARACTER_ID"],"message":"Where now?","playerId":"player-1",
// "sessionId":"","events":[{"priority":1,"content":"Two squad members down"}]}
std::string AskCompanion(const std::string& apiKey, const std::string& bodyJson)
{
std::string response;
CURL* curl = curl_easy_init();
curl_slist* headers = curl_slist_append(nullptr, "Content-Type: application/json");
headers = curl_slist_append(headers, ("x-api-key: " + apiKey).c_str());
curl_easy_setopt(curl, CURLOPT_URL, "https://api.neocortex.link/v3/chat");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, bodyJson.c_str());
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, AppendToString); // appends bytes to response
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_perform(curl);
curl_slist_free_all(headers);
curl_easy_cleanup(curl);
return response; // sessionId, lines with emotions, actions and flowState
}模组读取游戏状态,并将其与玩家的消息一起通过 /v3/chat 发送给 Neocortex 角色,将回复以字幕形式显示,从 /v3/audio/generate 或 /v3/audio/stream 播放语音,并执行角色返回的动作。对话流程会在同一回复中返回检查点关键词(flowState),问答引擎通过 /v3/quiz 运行,设备端语音指令则将口语短语转换为游戏动作,无需经过云端往返,Neocortex Voice Commands 运行在玩家的机器上。
在界面方面,客户端 DLL 中的 VGUI 面板可以显示字幕和问答界面。Source 的隐藏字幕和声音脚本是为预先编写好的台词设计的,因此实时的 AI 回复通常需要自己的字幕面板,生成的音频则保存为文件,并通过引擎播放。
发布前须知:Source 1 SDK 许可
Source 1 SDK 许可只允许你免费分发模组;免费模组可以发布到 Steam 上。请将 AI NPC 模组保持为单人游戏,不要违反规定在多人服务器上使用它们,并让每位玩家使用自己的 Neocortex API 密钥。
从空白地图到会说话的小队
- 设置 Source SDK 2013。 剧情模组选择
singleplayer分支或 Mapbase,编译后启动一张空白测试地图。 - 在 Neocortex 控制台中设计你的角色:一位同伴、一位带有对话流程的小组长、一个终端问答,以及小队的命令集。
- 在工作线程上从游戏 DLL 调用 API,并复用每条回复中的
sessionId。 - 将 API 密钥保存在配置文件中,由玩家自行填写,切勿硬编码在你分享的模组里。
- 接入字幕、语音和动作,然后将语音命令映射到现有的小队代码上。
- 在单人模式下对一张地图进行测试,然后再扩展到完整战役。
若想了解语音命令在模组中如何工作,请阅读游戏模组的设备端语音命令。关于 GoldSrc,可参阅我们的 Half-Life AI NPC 模组指南;关于 Source 沙盒服务器,可参阅 Garry's Mod AI NPC 与问答插件一文。在第一张地图编译完成之前,你今天就可以在 Neocortex 浏览器编辑器中测试 Mara 和她的小队。
工具版本和链接核对于 2026 年 10 月。模组工具变化频繁,请查看各项目页面以获取最新版本。
常见问题
能在 Half-Life 2 中加入 AI NPC 吗?
可以。Half-Life 2 模组基于 Valve 的 Source SDK 2013 构建,它提供完整的 C++ 游戏代码,因此模组可以调用网络 API 并根据回复采取行动。Neocortex 提供 AI 角色、它的语音以及它返回的动作,由你的模组负责执行。
应该使用 Source SDK 2013 的单人分支还是多人分支?
剧情模组通常从单人分支或基于它的社区版本(例如 Mapbase)开始。多人分支在 2025 年获得了包含 64 位支持的大型更新,并且仍在维护,但其代码面向多人游戏。Neocortex 两者都能配合使用,因为它是一个普通的网络 API。
能用语音指挥 Half-Life 2 的反抗军吗?
可以,借助模组即可实现。Half-Life 2 本身已有小队指挥代码,模组可以通过语音触发它。Neocortex Voice Commands 在玩家的电脑上匹配自然短语,因此"往前"、"就地守住"和"集合"能即时且离线地传达到你的代码。
能售卖带有 AI 角色的 Half-Life 2 模组吗?
不能。Source 1 SDK 许可只允许你免费分发模组,不过免费模组可以发布到 Steam 上。你可以在浏览器编辑器中构建和测试免费模组中的 Neocortex 部分。






