Neocortex Logo

Half-Life 2 AI NPC 模组:语音指挥的小队与同伴

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

Neocortex TeamThe team behind Neocortex

· 阅读约 6 分钟

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

Half-Life 2 的小队 AI 会听你的按键操作,而世界里的人们只会说剧本允许的话。反抗军会跟随你,但你无法对他们下达任何指令;市民会说话,却从不谈论刚刚发生的事。 Half-Life 2 AI NPC 模组可以同时解决这两个问题:反抗军会对你大声说出的命令作出反应,一位同伴会谈论你刚刚幸存的那场战斗,剧情场景也会随着玩家的选择而改变。Neocortex 提供 AI 角色、对话流程、问答以及设备端语音指令,Source SDK 2013 则为你提供把它们接入游戏的代码。

Half-Life 2 游戏内截图 截图: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 游戏内截图 截图: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 密钥。

从空白地图到会说话的小队

  1. 设置 Source SDK 2013。 剧情模组选择 singleplayer 分支或 Mapbase,编译后启动一张空白测试地图。
  2. 在 Neocortex 控制台中设计你的角色:一位同伴、一位带有对话流程的小组长、一个终端问答,以及小队的命令集。
  3. 在工作线程上从游戏 DLL 调用 API,并复用每条回复中的 sessionId。
  4. 将 API 密钥保存在配置文件中,由玩家自行填写,切勿硬编码在你分享的模组里。
  5. 接入字幕、语音和动作,然后将语音命令映射到现有的小队代码上。
  6. 在单人模式下对一张地图进行测试,然后再扩展到完整战役。

若想了解语音命令在模组中如何工作,请阅读游戏模组的设备端语音命令。关于 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 部分。

相关文章

继续阅读