Half-Life AI NPC模组:会说话的科学家与语音指令
用HL SDK或Xash3D FWGS制作Half-Life AI NPC模组:可以对话的科学家和守卫、守卫的语音指令,以及黑山安全问答。
Neocortex TeamThe team behind Neocortex
· 阅读约 7 分钟

如果你能向黑山研究所的科学家提出一个真正的问题,他会告诉你什么?在原版游戏中,答案是没有任何新内容:每个科学家和保安都只有几句录好的台词。 Half-Life AI NPC模组改变了这一点。你的游戏DLL会把玩家说的话发送给AI角色,并以语音和字幕的形式播放回复。借助Neocortex,你还能获得用于脚本化剧情节拍的对话流、问答引擎,以及用于守卫的设备端语音指令。
截图:Half-Life © Valve
Valve的SDK与Xash3D FWGS对比
目前有两套代码库在使用,Half-Life AI NPC模组在两者上都能运行:
| Valve的Half-Life SDK | Xash3D FWGS,搭配 hlsdk-portable | |
|---|---|---|
| 它是什么 | 客户端和服务端库的官方源代码 | 与Half-Life兼容的开源引擎,外加FWGS跨平台版本的SDK |
| 运行环境 | GoldSrc | Windows、Linux、BSD和Android;hlsdk-portable可为GoldSrc和Xash3D构建 |
| 状态 | Valve最后一次更新是在2024年10月,以配合当月的Steam补丁 | 积极开发中 |
| 构建方式 | 客户端和服务端DLL | 使用CMake或waf构建相同的DLL,可选错误修复,以及若干社区模组作为独立分支保存 |
| 游戏数据 | 你的Steam版本 | 来自你自己游戏副本的valve文件夹 |
Valve的SDK许可证只允许免费分发模组。
GoldSrc模组内部
Half-Life运行在GoldSrc上。模组是位于valve旁边的一个文件夹,包含你的地图、模型、声音,以及两个编译好的C++库:服务端DLL负责游戏逻辑、NPC AI和触发器;客户端DLL负责HUD、特效和本地声音。
GoldSrc没有内置HTTP客户端,因此你的模组需要链接一个:Windows上使用 WinHTTP,如果你还要支持Linux或Xash3D移植版,则使用 libcurl。请在工作线程中发送请求,并将结果交回游戏循环,这样在等待回复的过程中游戏就不会卡住。
字幕方面,可以在客户端DLL中绘制自定义HUD元素,或者从服务端发送一条 game_text 消息,快速上手。语音方面,请求WAV音频,将其保存到模组的声音文件夹中,并在客户端播放;如有需要,先将其转换为引擎支持的格式。
认识角色阵容
Dr. Ilse Marek与Officer Dale Ruiz
为游戏编写你自己的角色阵容,而不是复用原版游戏的角色。Dr. Ilse Marek是一位睡眠不足的光谱学研究员,已经三天没有离开过实验室。Officer Dale Ruiz在同一个检查站工作了九年,对电车时刻表有自己的看法。
在Neocortex编辑器中为每个角色设置Personality(性格)、Emotion(情绪)设置和Knowledge base(知识库):实验室流程、关于测试舱的传闻,以及谁欠了谁钱。
你的模组会在每条消息中附带上下文:附近的物体(实验室的门、视网膜扫描仪、医疗充能器),以及最近发生的事件(“灯刚刚坏了”、“玩家拿着撬棍”)。角色会以语音回答,每句台词都带有情绪标签(如CURIOUS或ANGRY),你可以把它映射到面部表情或动画上;它还能返回一个动作,例如 { "name": "OPEN_DOOR", "targetId": "lab_door_03" }。随后你的游戏DLL会触发这扇门,效果与玩家按下按钮完全相同。
听从语音命令的守卫
经典的Half-Life守卫在玩家按下使用键时,本来就会跟随玩家。语音指令可以让玩家通过说话做同样的事:“跟我来”、“在这里等”、“开门”。
在Neocortex控制台中,你可以将指令集设计为执行者、动作和对象:执行者为“guard”,动作为“follow”、“wait”和“open”,对象为“me”和“door”。玩家可以自然地说话,模组会立即收到匹配的指令,包括一句话中的多条指令:“Ruiz,开门然后在这里等”会被识别为两条指令。它支持按键通话或持续监听,支持多种语言,并在玩家的电脑上运行,无需经过云端往返。
Voice Commands是一款授权SDK:联系我们申请Voice Commands许可证。
安全官与入职问答
把入职培训室变成一个游戏。安全官角色会运行一个在Neocortex控制台中构建的简短问答:样本逃逸时应如何处理、哪种徽章颜色代表有辐射权限、什么时候可以在走廊里跑步。
问答引擎(Team套餐)负责提问、检查玩家的答案并记录分数。通过的话,你的模组会为玩家打开通往下一个区域的门;没通过的话,安全官会让你回去重新观看安全幻灯片。
截图:Half-Life © Valve
Neocortex负责的部分
- 对话。 模组读取游戏状态(谁在附近、刚刚发生了什么),并把它与玩家的消息一起通过
/v3/chat发送给Neocortex角色。模组以字幕显示回复,通过/v3/audio/generate或/v3/audio/stream播放语音,并执行角色返回的动作。 - 对话流。 分支式剧情节拍,例如说服一位科学家打开储藏室。角色会引导玩家完成这些节拍,API则返回检查点关键词,供模组做出反应。
- 问答。 问答引擎通过
/v3/quiz运行一问一答的游戏,包括计分。 - 语音指令。 设备端语音指令把说出的短语转换为游戏动作,无需经过云端往返。Neocortex Voice Commands在玩家的电脑上运行。
角色在可视化节点编辑器中构建(Personality、Emotion、Knowledge、World、Objects、Actions、Voice等),在你写下一行C++之前就可以在浏览器中测试。如果想了解我们与其他AI角色工具的对比,请查看 我们的对比。
能销售Half-Life AI NPC模组吗?
不能。Valve的Half-Life SDK许可证允许你以源代码和二进制形式分发模组,但仅限免费;如需商业用途,需要联系Valve。
请将AI NPC模组限定为单人游戏,不要违反规则在多人服务器上使用,并让每位玩家使用自己的Neocortex API密钥。
你的第一张地图,分步指南
- 设置SDK。 克隆Valve的halflife SDK或hlsdk-portable,并为一个空白测试模组构建客户端和服务端DLL。
- 在Neocortex控制台中设计角色: 一位科学家、一位守卫、一位带有问答的安全官,以及守卫的指令集。
- 为游戏DLL添加HTTP客户端,并在工作线程中调用
/v3/chat,复用每条回复中的sessionId。 - 将API密钥保存在配置文件中,由玩家自行填写,绝不要硬编码在你分享的模组里。
- 接入字幕、语音和动作,然后为守卫添加语音指令。
- 在单人模式下,先在一张小地图上测试,再围绕它构建完整的战役。
想进一步了解?请阅读 游戏模组的设备端语音指令 的工作原理,或在我们的 Half-Life 2 AI NPC模组 指南中看看同样的思路如何应用于Source引擎。我们所有逐款游戏的指南都收录在 AI NPC与语音指令模组 索引中,它们都以同样的方式开始:先有一个Neocortex角色,在浏览器中测试,然后才写C++。
工具版本和链接核对于2026年10月。模组工具变化频繁,请查看各项目页面以获取最新版本。
常见问题
能为Half-Life添加AI NPC吗?
可以。Half-Life模组是基于Valve的Half-Life SDK构建的C++游戏DLL,因此模组可以把玩家的话发送到Web API,并播放回复。Neocortex提供AI角色、它的语音以及它返回的动作,而你的模组负责在游戏中执行这些内容。
2026年制作Half-Life模组需要什么?
GitHub上的Valve halflife SDK、C++编译器,以及Steam版的Half-Life。许多模组制作者还会使用Xash3D FWGS和hlsdk-portable分支,以便为更多平台构建。要添加AI NPC对话,请创建一个Neocortex账户,并在浏览器中设计你的角色。
Half-Life模组可以使用语音指令吗?
可以。模组可以监听麦克风,并把说出的短语映射为游戏代码,例如告诉守卫跟随你。Neocortex Voice Commands在玩家的电脑上完成监听和匹配,因此指令可以离线工作,并即时响应。
能销售带有AI NPC的Half-Life模组吗?
不能。Valve的Half-Life SDK许可证只允许免费分发你的模组,任何商业用途都需要联系Valve。你可以在浏览器编辑器中构建和测试免费模组的Neocortex部分。
AI NPC模组能在Xash3D FWGS上运行吗?
可以。Xash3D FWGS是一个与Half-Life兼容的开源引擎,hlsdk-portable可以为GoldSrc和Xash3D构建游戏代码。Neocortex是普通的Web API,因此同一份模组代码可以在任一引擎上调用它。






