如何用 AI 在 Roblox Studio 中制作 NPC 对话系统
在 Roblox Studio 中构建 NPC 对话系统:Dialog 对象、自定义对话树或 AI 回复,然后将选项与自由文字、行为和备用台词结合起来。
Sercan AltundasFounder of Neocortex
· 阅读约 8 分钟

Roblox Studio 中的 NPC 对话系统,是让玩家与角色交谈的代码和 GUI:谁说什么、出现哪些选项,以及每个回答之后会发生什么。大多数教程构建的是固定台词的对话树。本指南比较了三种实现方式,然后展示如何从 Neocortex 添加 AI 回复,同时保留任务所依赖的预设选项。
图片:Roblox © Roblox Corporation
在 Roblox Studio 中制作 NPC 对话的三种方式
内置的 Dialog 对象
在 NPC 的头部放入一个 Dialog 对象,并在其下添加 DialogChoice 对象。每个选项包含玩家的台词和 NPC 的回应,并且选项可以嵌套。DialogChoiceSelected 事件会告诉你的脚本玩家选了哪个选项,因此一个选项可以打开商店或开始任务。
这只需要五分钟,无需代码。不过,每个游戏的菜单外观都一样,而且每句台词都必须事先写好。
自定义对话树
大多数 Roblox 对话教程都会构建这种方式。台词保存在一个 ModuleScript 中,作为节点表,每个节点包含 NPC 的文本,以及指向其他节点的选项列表。一个 ScreenGui 以打字机效果显示文本,并配有头像和按钮。你可以完全掌控外观,并且它可以扩展到很长的对话。
限制是一样的:玩家只能说你为他们写好的内容。向铁匠问起列表之外的事情,就得不到任何回答。
AI 回复
玩家输入任何内容,服务器端的 Script 将其发送给一个 AI 角色,回复则是针对这个确切问题而生成的。Neocortex 角色拥有个性、包含你的世界观设定的知识库,以及你的游戏可以执行的行为,因此铁匠会以铁匠的身份作答。Roblox AI NPC 指南涵盖了设置步骤:允许 HTTP 请求、密钥存储,以及调用 API 的服务器脚本。
两全其美:预设选项加“随便说点什么”
你不必二选一。在实践中效果最好的对话系统,会保留你的对话树,并在它周围加入 AI:
- 为关键节点设置按钮。 “接受任务”“支付过路费”和“购买”仍然是预设选项,这样故事和经济系统不会偏离。
- 为其他一切设置文本框。 在按钮下方,一个“说点什么……”输入框会把自由文字发送给角色。玩家可以询问世界观、开玩笑、争论,并得到真正的回答。
- 让按钮也能与 AI 对话。 像“询问暴风雨的事”这样的选项,可以向 Neocortex 发送一条固定消息,因此即使是脚本化的选项,每次也会得到全新的措辞。
- 对话树中的备用台词。 如果请求失败,则播放对话树中预先写好的台词。
从 Neocortex 返回的内容
每次对 /v3/chat 的请求都会返回一个 sessionId 和一个消息列表。这就是你的对话 GUI 所需要的全部内容:
| 字段 | 包含的内容 | 你的系统如何处理 |
|---|---|---|
messages[].name | 说话的角色 | 设置名称和头像 |
messages[].lines[].text | 回复,一行或多行 | 过滤后逐字显示 |
messages[].lines[].emotion | HAPPY、ANNOYED、SCARED 等 | 选择头像或动画 |
messages[].actions | 带有 targetId 的 GIVE_ITEM 等行为 | 经服务器检查后执行 |
messages[].flowState | 来自 Conversation Flow 的检查点关键词 | 推进任务 |
sessionId | 到目前为止的对话 | 按玩家保存,以便下次恢复 |
在服务器上分发回复和行为
这个服务器函数接收回复,并将其转换为对话台词和游戏事件。它只执行你允许的列表中的行为,并且会为对话中的那一名玩家过滤每一行文本:
local ALLOWED = { OPEN_GATE = true, GIVE_ITEM = true, START_QUEST = true }
local function handleReply(player, npc, data)
for _, message in data.messages do
for _, line in message.lines do
local ok, result = pcall(TextService.FilterStringAsync, TextService, line.text, player.UserId)
if ok then
local text = result:GetNonChatStringForUserAsync(player.UserId)
DialogueLine:FireClient(player, message.name, text, line.emotion)
end
end
for _, action in message.actions or {} do
if ALLOWED[action.name] then
runAction(player, npc, action.name, action.targetId) -- your own game code
end
end
if message.flowState and message.flowState ~= "" then
onCheckpoint(player, npc, message.flowState) -- your quest code
end
end
endGetNonChatStringForUserAsync 为单个玩家过滤文本,适合私人对话窗口。如果是附近所有人都能看到的气泡,请改用 GetNonChatStringForBroadcastAsync。
用对话流程保持故事走向
自由对话很有趣,直到任务发布者忘记发布任务为止。Neocortex 编辑器中的 Conversation Flow 会设定场景应经过的步骤,例如问候、解释失踪的飞船、提供奖励,并在每个检查点返回一个 flowState 关键词。你的任务代码会监听这些关键词,因此玩家即使跑题,场景仍然能走到奖励环节。
让对话窗口体验更好
图片:Roblox © Roblox Corporation
- 打字机文本。 使用 TextLabel 上的
MaxVisibleGraphemes,每次显示过滤后台词的几个字符。这也能掩盖请求所需的半秒钟等待。 - 情绪头像。 每个 NPC 保留四到五个头像,并根据情绪标签选择其中一个。
- 思考状态。 请求进行时在窗口中显示“...”,这样即使回复较慢,也会让人觉得 NPC 在思考。
- 按距离关闭。 当玩家走开时结束对话,并将
sessionId保存在 DataStore 中,以便之后恢复。
当 AI 无法回答时的备用方案
网络请求有时会失败,对话系统必须能应对这种情况:
- 将每个请求包裹在
pcall中,并检查响应的Success。 - 为
RequestAsync设置较短的Timeout,这样玩家不会长时间盯着“...”发呆。 - 回退到对话树。 播放该节点预先写好的台词,并保持按钮可用。
- 添加冷却时间,每位玩家几秒钟,这同时也能让你远低于 Roblox 每台服务器每分钟 500 次 HTTP 请求的限制。
- 在发送前限制消息长度,这样粘贴的一大段文字不会产生任何费用。
开始构建你的 Roblox 对话系统
- 先构建 GUI: 名称、头像、文本、几个按钮和一个文本框。
- 在 ModuleScript 中编写对话树,覆盖必须发生的关键节点。
- 在 Neocortex 中设计角色,为场景配置 Conversation Flow,以及它可能返回的行为。
- 从 Roblox AI NPC 指南中添加服务器脚本,并通过
handleReply分发回复。 - 将文本框连接到 RemoteEvent,并为按钮设置固定消息或对话树节点。
- 测试失败路径:关闭 HTTP 请求,检查备用台词是否正常播放。
过滤与公平使用
Roblox 要求开发者过滤任何他们无法控制的文本,并会删除跳过过滤的体验,因此每一条 AI 台词在到达 GUI 之前都会经过 TextService。告诉玩家 NPC 是 AI。构建和测试在浏览器编辑器中完成;一款通过 Robux 盈利的游戏属于商业用途,需要 Pro 套餐(每月 €29)或 Team 套餐。
总结
把对话树留给必须发生的事情,让 Neocortex 处理玩家真正想说的一切。更多创意请阅读 Roblox 的智能 NPC 创意。如果你的项目不止于 Roblox,AI NPC 与 Yarn Spinner、Ink 和 articy:draft 的对比比较了 AI 与其他引擎的对话工具,而 AI 任务发布 NPC则深入探讨了如何保持故事节点不被打乱。
截至 2026 年 10 月核查。Neocortex 与 Roblox Corporation 没有关联。
常见问题
如何在 Roblox Studio 中制作 NPC 对话系统?
有三种方式:用于简单点击对话菜单的内置 Dialog 对象,在 ModuleScript 中配合你自己的 GUI 构建的自定义对话树,或者从服务器 Script 获取 AI 回复。使用 Neocortex,你可以结合后两种方式,使预设选项和自由输入共享同一个对话窗口。
Roblox 中的 Dialog 对象是什么?
Dialog 是一个内置对象,你将它放在 NPC 的头部,并在其下放置 DialogChoice 对象作为玩家的选项。它无需代码即可提供菜单,但外观固定。Neocortex 的回复则可以输入自定义 GUI,玩家也可以在其中输入自己的问题。
玩家能否自己输入对 Roblox NPC 的回答?
可以,前提是该 NPC 由 AI 角色驱动。客户端通过 RemoteEvent 将输入的文字发送到服务器,服务器调用 Neocortex 并过滤回复,玩家看到的就是专门针对他们所问内容而写的回答。
如何防止 AI NPC 破坏我的任务?
将影响任务的关键步骤保留为按钮,为角色设置一个会返回检查点关键词的 Conversation Flow,并且只执行服务器允许的列表中的行为。Neocortex 角色可以自由对话,但实际发生什么仍由你的游戏代码决定。
如果 AI 服务没有响应会怎样?
将请求包裹在 pcall 中,设置较短的超时时间,并回退到对话树中预先写好的台词。对话会继续进行,下一次请求会再次尝试连接 Neocortex。






