Neocortex Logo

如何在 Godot 中构建 AI NPC | 2026 指南

2026 年如何在 Godot 中构建 AI NPC:HTTPRequest 与模型 API、Neocortex Godot SDK、借助 NobodyWho 运行本地模型,以及 Player2 插件。

Sercan AltundasFounder of Neocortex

· 阅读约 9 分钟

2026 年如何在 Godot 中构建 AI NPC:HTTPRequest 与模型 API、Neocortex Godot SDK、借助 NobodyWho 运行本地模型,以及 Player2 插件。

在 Godot 中构建 AI NPC,就是把玩家说的话发送给语言模型,再把回复显示出来或朗读出来:可以通过 Godot 自带的 HTTPRequest 节点和模型 API,可以通过角色 SDK,也可以通过在玩家电脑上运行模型的插件。Godot 本身没有 AI 角色功能,因此每种方式都需要添加 GDScript 或插件。

本指南面向想让角色用自己的语言回答、而不是从对话树中读出台词的 Godot 4 开发者。内容包括四种方式:HTTPRequest 加模型 API、Neocortex Godot SDK、借助 NobodyWho 运行本地模型,以及 Player2 AI NPC 插件。每种方式都包括步骤、所需条件和费用,之后是对比表、适用于所有方法的建议,以及常见问题。

在 Godot 中构建 AI NPC 的 4 种方式

四种方式都从场景中的一个节点开始,该节点代表角色,同时有一个供玩家输入的控件,比如 LineEdit 或麦克风。它们的区别在于模型运行在哪里、由谁付费,以及你需要编写多少 GDScript。

方法 1:HTTPRequest 与模型 API

这条路线只使用 Godot 自带的功能。HTTPRequest 节点是"能够发送 HTTP 请求的节点",因此脚本可以把玩家的台词发送给模型服务商,并读取回答。我们以 OpenAI Responses API 为例。

所需条件: 模型服务商的 API 密钥和一些 GDScript。

  1. 创建 API 密钥。 对于 OpenAI,在 platform.openai.com/api-keys 创建。
  2. 添加 HTTPRequest 节点。 将其设为 NPC 场景的子节点,并把它的 request_completed 信号连接到 NPC 脚本中的一个函数。
  3. 编写角色设定。 保存一个系统指令字符串,包含角色的名字、身份、语气和限制。
  4. 发送台词。 构建一个 JSON 请求体,包含模型、指令和玩家的消息,然后调用 request(),地址为 https://api.openai.com/v1/responses,请求头为 Authorization: Bearer <key> 和 Content-Type: application/json,方法为 POST,并附上请求体。
  5. 读取回复。 在 request_completed 处理函数中,将响应体解析为 JSON,并把文字放入 NPC 上方的 Label 或 RichTextLabel 中。
  6. 保留对话历史。 把最近几轮对话存放在 Array 中,并随每次请求一起发送;否则模型在两次调用之间会忘记一切。
  7. 添加附加功能。 语音、口型同步和动作需要你自己完成:语音需要额外的 API 调用,把回复转换为游戏行为的规则也要自己制定。
  8. 妥善保管密钥。 Godot 文档建议使用 TLS,并提醒不要发送敏感信息。导出的游戏中的密钥可以被读取,因此在发布前,请在服务商前面放置你自己的服务器。

费用: Godot 免费。你需要按服务商的每 token 费率付费。

不足之处: 记忆、语音、动作、安全性以及密钥服务器,全部需要你自己构建和维护。

方法 2:Neocortex Godot SDK

Neocortex 是我们自己的产品,阅读本节时请记住这一点。你在浏览器中的可视化编辑器里设计角色,然后通过一个开源插件(Apache 2.0)在 Godot 中使用。性格、知识、情感、语音和动作都是编辑器中的节点;在 Godot 中,你添加现成的节点即可。完整列表见 Godot AI NPC 页面。

所需条件: Godot 4.7 或更高版本,以及一个带有 API 密钥的 Neocortex 账户。

  1. 创建角色。 在仪表盘中打开 Characters,点击 Create New Character,输入名称并点击 Create。在节点编辑器中构建角色。
  2. 在浏览器中测试。 点击编辑器右上角的 Play。
  3. 创建 API 密钥。 在仪表盘中打开 API Keys。
  4. 安装插件。 从 https://github.com/neocortex-link/neocortex-godot-sdk/releases/latest 下载最新版本,并将 addons/neocortex-godot-sdk 复制到项目的 addons 文件夹中。
  5. 启用插件。 打开 Project > Project Settings > Plugins,并启用 Neocortex。将你的 API 密钥粘贴到 Neocortex 面板中。
  6. 一步添加聊天。 选择 Project > Tools > Neocortex > Complete Text Chat 或 Complete Voice Chat。这会在场景中添加一个可用的聊天;在 Inspector 的下拉菜单中选择角色。
  7. 接入游戏。 使用 NeocortexSmartAgent 节点承载角色,NeocortexAudioReceiver 接收麦克风,NeocortexFaceAnimator 基于 ARKit 风格的混合形状进行口型同步,NeocortexInteractable 用于让角色了解的物体,NeocortexEventLogger 用于记录发生过的事件。编辑器中的动作节点会发送动作名称,你的 GDScript 可以据此执行操作。
  8. 打开示例。 Neocortex 面板中可以打开七个示例场景和一个启动器:Text Chat、Audio Chat、Actions、Interactables、Group Chat、Usage Gating 和 Quiz Show。

需要了解的限制: 录音在 29 秒时停止,短于 0.15 秒的声音不会被发送,聊天请求在 30 秒后超时。

费用: Starter 每月 €9,Pro €29,Team €99(按年计费),或按月计费为 €11、€35 和 €119。商业使用需要 Pro 或 Team 套餐。参见价格。

不足之处: 角色运行在我们的云端,因此游戏需要联网。导出的游戏会包含 API 密钥,因此请为其设置用量限制。群组聊天需要 Pro 或 Team 套餐,测验功能需要 Team 套餐,而且我们的文档并未列出所有导出目标。

开始使用

方法 3:借助 NobodyWho 运行本地模型

NobodyWho 是一个开源推理引擎,可在玩家的电脑上运行语言模型,并提供 Godot 插件。它的自述文件称,它"不需要 API 密钥",也没有隐藏费用。

所需条件: Godot 4.6 或更新版本(依据其 Godot 文档),以及一个 GGUF 格式的模型。

  1. 安装。 在 Godot 中打开 AssetLib 标签,搜索 NobodyWho,下载并导入时勾选 Ignore asset root。或者从发布版本中把 addons/nobodywho 复制到项目中。重新启动或重新加载编辑器。
  2. 选择模型。 任何 GGUF 模型都可以使用。自述文件建议先使用 Qwen3 0.6B;远程模型会在首次使用时下载并缓存。
  3. 创建聊天。 在脚本中调用 await NobodyWhoChat.create(<model path>, {})。
  4. 提问。 调用 chat.ask(<player text>),并 await 结果的 completed()。文档说明,应当立即 await 返回的值。
  5. 设定角色。 按照 NobodyWho 文档中 Chat 部分的说明,为聊天设置角色指令。
  6. 检查目标平台。 NobodyWho 支持 Godot 的桌面和 Android 导出,不支持 iOS 或网页导出。

费用: 根据 EUPL-1.2 许可可免费用于商业用途。如果你修改了 NobodyWho 自身的代码,这些修改必须开源。

不足之处: 回复速度和质量取决于玩家的硬件和模型大小,模型还会增加下载体积。引擎列出了语音功能;在计划使用之前,请确认 Godot 绑定是否提供这些功能。

方法 4:Player2 AI NPC 插件

Player2 是一款桌面应用,为游戏和模组提供本地 API。它的 Godot 插件"使用 Player2 应用提供的免费 AI API",并在应用运行时自动连接。

所需条件: Godot 4.5(Asset Library 中列出的版本)、一个 Player2 开发者客户端 ID,以及 Player2 应用。

  1. 安装插件。 从 Godot Asset Library 或 GitHub 获取,并将 addons 文件夹拖入你的项目。
  2. 添加客户端 ID。 在 player2.game/profile/developer 创建一个,并在 Project Settings > Player2 > Game Key 下输入。
  3. 添加 NPC 节点。 在场景中添加一个 Player2 AI NPC 节点,并编辑该代理的描述。
  4. 连接聊天。 用玩家的文字调用节点的 chat 函数,并把它的 chat_received 信号连接到显示回复的部分。调用 notify 可以告诉代理世界中发生的事件。
  5. 添加语音。 在 Character Config 中设置 Voice ID,或添加一个 Player2TTS 节点;如需语音输入,添加 Player2STT,并在 Project Settings > Audio 下启用音频输入。
  6. 运行 Player2。 打开 Player2 应用;插件会自动连接。

费用: 根据 Player2 页面的说明,创作者可免费使用。插件采用 GPLv3 许可。

不足之处: Player2 的网站说明,其本地 API 需要应用保持打开,因此要考虑没有该应用的玩家会遇到什么情况。请核对你的项目是否符合 GPLv3 许可。

四种方法对比

因素HTTPRequest 与 APINeocortex SDKNobodyWhoPlayer2 插件
角色在哪里定义GDScript 中的字符串浏览器中的可视化节点编辑器你的 GDScriptGodot 中的节点描述
模型在哪里运行服务商的云端Neocortex 云端玩家的设备通过 Player2 应用
Godot 版本4.x,需 HTTPRequest4.7 或更高4.6 或更高列出 4.5
语音自行构建已包含,支持口型同步引擎中列出TTS 和 STT 节点
插件许可无需许可Apache 2.0EUPL-1.2GPLv3
起始费用服务商的 token 费率每月 €9 起免费创作者免费
所需技能GDScript、HTTP、服务器复制插件、添加节点GDScript、模型选择添加节点

HTTPRequest 提供完全的控制,但代码量最大。NobodyWho 是离线路线,受限于玩家的硬件。Neocortex 将角色保存在托管的编辑器中,并提供语音、口型同步和示例。Player2 是添加速度最快的节点,但依赖于它的应用。

让 Godot 效果更好的建议

以下习惯适用于所有方法。

  1. 不要把密钥放进导出文件。 导出项目中的任何内容都可能被读取。把含有密钥的设置文件排除在版本控制之外,并使用服务器或按玩家、按角色设置的用量限制。
  2. 让玩家看到 NPC 已经听到了。 在请求开始的瞬间切换到"思考中"动画或显示标签,这样等待回复时游戏看起来不会像是卡住了。
  3. 告诉角色周围的场景。 每条消息都附上附近的物体和最近的事件,这样 NPC 就能谈论它所在的房间。
  4. 让 GDScript 做最终的动作决定。 保留一个角色可以请求的动作的简短列表,并在执行前用代码逐一检查。
  5. 剧情使用对话树。 把推动故事的台词保留在脚本化的对话插件中,其余部分交给 AI 角色。我们的 Godot 插件文章列出了脚本化部分的插件。

为 Godot 选择合适的方法

如果你不想使用插件,希望完全控制每个请求,并且可以为密钥运行一个小型服务器,那么 HTTPRequest 与模型 API 适合你。

如果你希望在浏览器中可视化设计角色、进行测试,并在 Godot 4.7 中获得语音、口型同步、动作和示例,那么 Neocortex SDK 适合你。同一个角色也可以用于 Unity 和 Unreal Engine。

如果游戏必须在桌面或 Android 上离线运行,并且没有持续的运行成本,那么 NobodyWho 适合你。

如果你的玩家已经在使用 Player2 应用,或者你正在制作原型并希望步骤最少,那么 Player2 插件适合你。

更多选择请参阅 Godot 最佳 AI NPC 工具;如果你还在选择引擎,请参阅 Godot 与 Unity 对比。

常见问题

我可以免费在 Godot 中构建 AI NPC 吗?

可以。NobodyWho 免费,并在本地运行模型;Player2 对创作者免费。你自己调用的模型 API 则按 token 收费。

Godot 内置 AI NPC 吗?

没有。Godot 提供了用于网络请求的 HTTPRequest 节点,但没有语言模型或角色系统。我们的 Godot AI 文章介绍了引擎周边已有的工具。

我需要哪个 Godot 版本?

Neocortex 需要 Godot 4.7 或更高版本,NobodyWho 需要 4.6 或更新版本,Player2 插件列出的是 4.5。HTTPRequest 是 Godot 4 的一部分。

Godot 的 AI NPC 可以离线运行吗?

可以,使用本地模型即可,例如桌面或 Android 上的 NobodyWho。包括 Neocortex 在内的云端方案需要联网。

Neocortex Godot SDK 是开源的吗?

是的。它以 Apache 2.0 许可发布,源代码位于 GitHub 的 neocortex-link/neocortex-godot-sdk。欢迎在那里提交错误报告和建议。

Godot 的 AI NPC 能在网页导出中使用吗?

取决于所用的方法。NobodyWho 不支持网页导出。对于 Godot 之外的浏览器游戏,Neocortex 还提供 Web SDK。

相关文章

继续阅读