Neocortex Logo

Garry's Mod AI NPC 插件:智能 NPC 与问答主持人

用 Lua 构建 Garry's Mod AI NPC 插件:面向沙盒和角色扮演服务器的智能 NPC、带排行榜的多人问答节目主持人,以及语音指令。

Neocortex TeamThe team behind Neocortex

· 阅读约 6 分钟

用 Lua 构建 Garry's Mod AI NPC 插件:面向沙盒和角色扮演服务器的智能 NPC、带排行榜的多人问答节目主持人,以及语音指令。

Garry's Mod 的 AI NPC 插件是一个 Lua 插件,它通过游戏内置的 HTTP() 函数,把玩家说的话发送给 AI 角色,并根据回复采取行动。Garry's Mod 服务器靠玩家自己发明的玩法活下去,而那些只会站在原地的 NPC 则是一次浪费的机会。 借助 Neocortex,沙盒和角色扮演服务器可以拥有真正会说话的角色:会讨价还价的店主、为全服主持游戏的问答节目主持人,以及听从语音指令的帮手。Neocortex 提供 AI 角色、Conversation Flow、问答引擎和设备端语音指令;Lua 则负责把它们连接到你的服务器上。

Garry's Mod 游戏内截图 截图:Garry's Mod © Valve

哪些在服务器运行,哪些在客户端运行

Garry's Mod 插件是由 Lua 脚本和内容组成的文件夹,可以安装在 garrysmod/addons 中,也可以通过 Steam 创意工坊订阅。Lua 运行在两个环境中,AI NPC 插件可以干净地在两者之间划分职责。Garry's Mod 维基记录了每个函数。

工作运行环境工具
NPC、实体、游戏逻辑服务器Lua 实体
调用 Neocortex,保管 API 密钥服务器HTTP()、http.Fetch、http.Post
将回复发送给玩家从服务器到客户端net 库
字幕和 HUD客户端chat.AddText 或自定义 HUD 面板
语音播放客户端sound.PlayURL
语音指令客户端玩家电脑上的 Neocortex Voice Commands

有几个细节很重要。HTTP() 会使用 URL、方法、请求头、请求体和回调函数发起一个异步请求;http.Fetch 和 http.Post 则为简单场景封装了它。成功回调同样会在出现错误状态码时触发,因此务必检查状态码。sound.PlayURL 用于播放外部声音文件,所以请通过你控制的一个小型端点提供生成的语音,客户端可以在完全看不到 API 密钥的情况下进行流式播放。原生模块(服务器端为 gmsv_,客户端为 gmcl_)应放在 garrysmod/lua/bin 中,并通过 require 加载,但它们无法通过创意工坊插件安装,因此任何原生组件都需要由玩家或服务器所有者单独安装。

玩家可以对话的角色扮演 NPC

在角色扮演服务器上,为城市配置一组角色:一位会讨价还价、并记得谁赖过账的店主,一位了解服务器世界观的酒保,一位会对玩家的举报做出反应的警局调度员。在 Neocortex 编辑器中,每个角色都设有 Personality、Emotion 设置和 Knowledge 知识库,例如你的服务器规则、地图上的地点以及你的经济系统。

玩家对 NPC 按下使用键,然后在聊天中输入。你的插件会把消息连同附近的物体(店铺柜台、自动售货机、监狱的门)以及近期事件(“一名玩家被逮捕”“银行警报正在响”)一并发送。角色会在每一行回复中附带情绪标签,并返回 { "name": "OPEN_DOOR", "targetId": "jail_door" } 这样的行为,由插件在服务器上执行。

群聊(Pro 和 Team 套餐)可以让最多六个角色同时参与一段对话,因此一群 NPC 可以同时与一名玩家争论。Conversation Flow 可以引导更长的场景,例如角色扮演中的抢劫行动简报,并返回插件会做出反应的检查点关键词(flowState)。

举办一场问答之夜

问答引擎(Team 套餐)可以把一个舞台、几个抢答器和一块计分板变成服务器活动:

  1. 你在 Neocortex 控制台中构建题目集:可以是服务器的问答之夜、面向新角色扮演玩家的世界观测验,或者是新玩家在获得工作前必须通过的规则检查。
  2. 舞台上的主持人 NPC 宣布本轮开始。
  3. 玩家在聊天中作答,插件通过 /v3/quiz 将每个答案转发给问答引擎。
  4. 主持人宣布谁答对了,问答引擎负责计分和排行榜。
  5. 两轮之间,你的插件会在 HUD 面板上显示排名。

Garry's Mod 游戏内截图 截图:Garry's Mod © Valve

听从语音指令的帮手

为每位玩家配备一个会听指令的帮手 NPC:“跟着我”“在这里等”“守住门口”“带两箱货来”。在 Neocortex 控制台中,你可以将指令集设计为角色、行为和对象:角色为“helper”,行为为“follow”“wait”“guard”和“bring”,对象为“me”“door”和“crate”。

玩家可以自然地说话,插件会立即收到匹配的指令,包括一句话中的多个行为和数量。它支持按键说话或始终监听,支持多种语言,并且无需经过云端往返。由于它在玩家的电脑上运行,客户端会将匹配好的指令发送到服务器。

Voice Commands 是一个授权 SDK:联系我们获取 Voice Commands 授权。

Garry's Mod AI NPC 插件代码

所有涉及 API 的操作都在服务器端运行。服务器读取游戏状态,并通过 /v3/chat 将其与玩家的消息一同发送给 Neocortex 角色,然后以字幕形式显示回复,通过 /v3/audio/generate 或 /v3/audio/stream 播放语音,并执行角色返回的行为:

-- Server realm only: the key stays in garrysmod/data and never reaches players.
local apiKey = string.Trim(file.Read("neocortex_key.txt", "DATA") or "")
local function AskNPC(ply, text, sessionId, onReply)
    HTTP({
        url = "https://api.neocortex.link/v3/chat",
        method = "POST", type = "application/json",
        headers = { ["x-api-key"] = apiKey },
        body = util.TableToJSON({
            characterIds = { "CHARACTER_ID" },
            message = text,
            playerId = ply:SteamID64(),
            sessionId = sessionId or ""
        }),
        success = function(code, body)
            local data = util.JSONToTable(body)
            if code == 200 and data then onReply(data) end -- data.sessionId, data.messages
        end,
        failed = function(reason) print("[Neocortex] " .. reason) end
    })
end

AI NPC 的使用规则

Garry's Mod 服务器有各自的规则,因此请只在你拥有的服务器上,或在服务器所有者同意的情况下运行 AI NPC 插件,并告知玩家他们正在与 AI 对话。发布时请遵守 Steam 创意工坊的规则,并确保每位服务器所有者使用自己的 Neocortex API 密钥。添加每位玩家的冷却时间,防止有人刷屏 NPC。

写给服务器所有者的结论

五个步骤即可让你从一个空文件夹走到一个会说话的 NPC:

  1. 创建一个插件文件夹,包含一个服务器端的 Lua 文件和一个可生成的 NPC 实体。
  2. 在 Neocortex 控制台中设计你的角色:一个店主,一个带题目集的问答主持人,以及一套帮手的指令集。
  3. 在服务器上使用 HTTP() 调用 /v3/chat 和 /v3/quiz,并使用 net 库将回复发送给玩家。
  4. 将 API 密钥保存在服务器端的配置文件中,绝不放在客户端 Lua 或创意工坊上传的文件里。
  5. 在公开服务器运行前,先与朋友在本地监听服务器上测试。

从店主开始。一个角色、一次 HTTP() 调用和一个聊天钩子,就足以向你的玩家展示 Neocortex NPC 能做什么,而问答节目则建立在同一套服务器代码之上。要了解语音指令如何在玩家的电脑上运行,请阅读游戏模组的设备端语音指令。如果是引擎层面的 Source 模组,请参阅我们的Half-Life 2 AI NPC 模组指南。

工具版本和链接核查于 2026 年 10 月。模组工具变化频繁,请查看各项目页面以获取最新版本。

常见问题

能为 Garry's Mod 添加 AI NPC 吗?

可以。Garry's Mod 插件使用 Lua 编写,游戏内置了 HTTP() 函数,因此服务器端的插件可以把玩家说的话发送给 AI 角色,并根据回复采取行动。Neocortex 提供角色、它的声音以及它返回的行为。

Garry's Mod 插件能调用网络 API 吗?

可以。全局的 HTTP() 函数以及 http.Fetch 和 http.Post 辅助函数,可以从服务器或客户端发起异步请求。对于 AI NPC 插件,请在服务器端进行调用,这样你的 Neocortex API 密钥就不会泄露给玩家。

如何在 Garry's Mod 服务器上举办问答节目?

生成一个主持人 NPC,将玩家在聊天中的答案转发给问答引擎,并在 HUD 面板上显示分数。Neocortex 问答引擎负责题目、计分和排行榜,因此你的插件只需处理舞台和聊天。

Garry's Mod 的 NPC 能听懂语音指令吗?

可以,需要一个客户端组件。Neocortex Voice Commands 运行在每位玩家的电脑上,可以把“跟着我”或“守住门口”之类的说法转换为指令,插件会立即接收这些指令,并且可以离线运行。由于它运行在玩家的电脑上,玩家需要在安装创意工坊插件的同时安装语音部分。

我应该在 Garry's Mod 服务器的哪里保存 API 密钥?

只保存在服务器端,例如服务器数据文件夹中的一个文件,由你的插件在启动时读取。绝不要把密钥放在客户端 Lua 或创意工坊上传的文件中,因为每位玩家都会下载这些文件。

相关文章

继续阅读