教程 · 游戏系统

Roblox Studio 怎么做 NPC 对话

Roblox 中的 NPC 对话由三部分组成:一个用来开始对话的提示,一个显示 NPC 台词和玩家回答按钮的窗口,以及一个决定每个回答会带来什么的脚本。本教程把这三部分都搭好:你把对话写成一张简单的表,玩家按 E 开始交谈,而回答带来的一切(治疗、物品)都由服务器发放,而不是由玩家的设备发放。

更新于 2026年11月20日阅读约 5 分钟作者

要点

把 NPC 模型放进 Workspace 中的 NPCs 文件夹,并把它的对话写在 ReplicatedStorage 中的 ModuleScript 里:每句台词都有 NPC 的文字和一组选项,选项会通向另一句台词。ServerScriptService 中的 Script 给每个 NPC 加上 ProximityPrompt("Talk"),记住每个玩家停在哪句台词上,并通过 RemoteEvent 发送它。LocalScript 显示文字和每个选项对应的按钮,并且只把被点击按钮的编号发回去。

  • 在服务端发放奖励。内置 Dialog 对象的 DialogChoiceSelected 事件只在客户端触发,所以服务端 Script 永远收不到它,而在 LocalScript 中发放的治疗或物品只会改变这个玩家那一份游戏副本。
  • 在 LocalScript 中用 TextChatService:DisplayBubble(npc.Head, text) 显示台词气泡。旧的 Chat 服务已经弃用,改用 TextChatService。
  • 你自己写的台词不需要过滤。Roblox 的规则是:过滤所有显示出来的、你无法直接控制的文字,例如玩家输入的内容。
本页内容
  1. 工作原理
  2. 1. 添加 NPC
  3. 2. 对话
  4. 3. 服务端脚本
  5. 4. 对话窗口
  6. 自定义动作
  7. 其他教程
  8. 防护的边界
  9. 5. 测试
  10. 扩展
  11. Common errors
  12. 用 RoCode
  13. 常见问题
  14. 参考资料

NPC 对话的原理

示意图每句台词在窗口中逐字打出,同时整句显示在气泡里,台词打完后出现选项,当你选择 "Got anything for the cave?" 时由服务器发放 Torch。

一个能在真实游戏中运行的会说话的 NPC,是分在服务器和每个玩家的设备之间的。设备负责绘制窗口和按钮。服务器是唯一可以信任的一方,它知道每个玩家正在看哪句台词,并决定每个回答做什么。对话的一个回合是这样的:

  1. 玩家走近 NPC,在它的 Talk 提示上按 E。提示的 Triggered 事件在服务器上带着这个玩家触发。
  2. 服务端脚本检查玩家是否足够近,记下他在名为 start 的台词上,并只把这句台词的文字和选项标签发给这个玩家。
  3. LocalScript 在对话窗口中逐字打出台词,在 NPC 头顶显示气泡,然后为每个选项加一个按钮。
  4. 玩家点击、轻触或选中一个选项。回到服务器的只有它的编号。
  5. 服务器在它知道玩家正在看的那句台词上找到这个编号,如果选项有动作(治疗、物品)就执行它,然后发送下一句台词或关闭窗口。
会说话的 NPC 由哪些部分组成
部分位置作用
角色模型 GuideWorkspace,名为 NPCs 的文件夹中NPC 本身。它的名字决定用哪段对话,并显示在提示上。
ModuleScript DialogueDataReplicatedStorageNPC 可能说的所有台词,每句台词下面的选项,以及每个选项通向哪里。
Script DialogueServiceServerScriptService添加 Talk 提示,记住每个玩家在哪句台词上,检查每次点击并执行动作。
RemoteEvent DialogueEventReplicatedStorage(由 DialogueService 创建)把每句台词带给玩家,并把所选选项的编号带回服务器。
LocalScript DialogueClientStarterPlayer,StarterPlayerScripts绘制窗口,逐字打出台词,显示气泡和选项按钮。
Tool Torch(可选)ServerStorage,名为 DialogueItems 的文件夹中某个选项给出的物品。ServerStorage 中的任何东西都不会发给玩家。
NPC 完成后的 Explorer。游戏运行时,DialogueService 会在 ReplicatedStorage 中添加名为 DialogueEvent 的 RemoteEvent,并在每个 NPC 的 HumanoidRootPart 中添加名为 TalkPrompt 的 Talk ProximityPrompt。
Workspace
  NPCs Folder new
    Guide Model new
      Humanoid Humanoid
      HumanoidRootPart Part
      Head, UpperTorso, LowerTorso ... (身体部位)
ReplicatedStorage
  DialogueData ModuleScript new
ServerScriptService
  DialogueService Script new
ServerStorage
  DialogueItems Folder new
    Torch Tool new
      Handle Part new
StarterPlayer
  StarterPlayerScripts
    DialogueClient LocalScript new

第 1 步:添加 NPC

  1. 在 Avatar 或 Home 选项卡中点击 Character,打开 Rig Generator。选择 R15、体型和风格。Workspace 中会出现一个名为 Rig 的角色模型。R6 模型也能用同样的脚本。
  2. 把它重命名为 Guide。名字很重要:DialogueService 按模型名查找对话,提示也会把它显示给玩家。
  3. 展开角色模型,选中它的 HumanoidRootPart,在 Properties 窗口中勾选 Anchored。锚固的零件永远不会因为物理而移动,所以 NPC 会站在你放它的地方,玩家也推不动它。
  4. 在 Explorer 中把鼠标悬停在 Workspace 上,点击 + 按钮,插入一个名为 NPCs 的 Folder。把 Guide 拖进去,并把角色模型放在玩家能走到的地方。
  5. 可选,用于给物品的选项:把鼠标悬停在 ServerStorage 上,插入一个名为 DialogueItems 的 Folder。在里面放一个名为 Torch 的 Tool,其中有一个未锚固、名为 Handle 的 Part,这是角色拿在手里的零件。在 Handle 里放一个 PointLight 就能让它发光。

名字区分大小写,所以请完全按照所示输入 NPCs、Guide、DialogueItems 和 Torch。任何带有 Humanoid 和 HumanoidRootPart 的模型都可以当 NPC,包括来自 Toolbox 的模型,只要它直接放在 NPCs 文件夹里。

第 2 步:写对话

把鼠标悬停在 ReplicatedStorage 上,插入一个名为 DialogueData 的 ModuleScript,并把这段代码粘贴进去。里面没有逻辑,只有台词和它们之间的连接,所以这是你最常修改的文件。

ModuleScript 位置: ReplicatedStorage 名称: DialogueData
-- ReplicatedStorage 中的 ModuleScript,名为 DialogueData。
-- 所有对话,按 Workspace.NPCs 中 NPC 的名字组织。每句台词都有
-- NPC 的文字和玩家的回答选项。选项可以通向另一句台词(next),
-- 结束对话(没有 next),以及请服务器做某件事(action)。如果服务器
-- 无法执行动作,就显示 failNext 台词而不是 next。

export type Choice = {
	text: string,
	next: string?, -- 这个选项之后显示的台词;nil 结束对话
	action: string?, -- DialogueService 中 ACTIONS 表里的服务端动作
	item: string?, -- 用于 GiveItem 动作:ServerStorage.DialogueItems 中 Tool 的名字
	failNext: string?, -- 动作没能执行时代替 next 显示的台词
}

export type Line = {
	text: string,
	choices: { Choice },
}

local DialogueData: { [string]: { [string]: Line } } = {
	Guide = {
		start = {
			text = "Welcome to the village! What can I do for you?",
			choices = {
				{ text = "Any tips?", next = "tips" },
				{ text = "I'm hurt. Can you help?", next = "healed", action = "Heal", failNext = "healTooSoon" },
				{ text = "Got anything for the cave?", next = "torch", action = "GiveItem", item = "Torch", failNext = "hasTorch" },
				{ text = "Bye!" },
			},
		},
		tips = {
			text = "Stay off the red bricks, and come back if you get hurt.",
			choices = {
				{ text = "Anything else?", next = "start" },
				{ text = "Thanks!" },
			},
		},
		healed = {
			text = "There you go, good as new.",
			choices = {
				{ text = "Thank you!" },
			},
		},
		torch = {
			text = "Take this torch. The cave is dark.",
			choices = {
				{ text = "Thanks!" },
			},
		},
		healTooSoon = {
			text = "I healed you a moment ago. Come back in a little while.",
			choices = {
				{ text = "OK" },
			},
		},
		hasTorch = {
			text = "You already have my torch. Keep it lit!",
			choices = {
				{ text = "Will do!" },
			},
		},
	},
}

return DialogueData

开头的 export type 行描述了台词和选项的样子。它们在游戏运行时不会改变任何东西;它们描述你的数据,让类型检查可以检查它。

各部分之间是这样连接的:

  • 每个 NPC 都有一张表,以它在 NPCs 文件夹中的模型命名,这里是 Guide。每段对话都从 start 台词开始。
  • text 是 NPC 说的话。choices 是玩家的按钮,按顺序排列。窗口里能放四个。
  • next 指定这个选项之后显示的台词。没有 next 的选项,例如 "Bye!",会结束对话。指向表中不存在的台词的 next 或 failNext 也会结束对话,并在 Output 中给出警告。
  • action 指定服务器要做的事,来自 DialogueService 中的 ACTIONS 表:这里是 Heal 或 GiveItem。
  • item 用于 GiveItem:它是 ServerStorage、DialogueItems 中 Tool 的名字。
  • failNext 是动作没能执行时代替 next 显示的台词,这样 NPC 永远不会声称做了并没有发生的治疗或赠送。
Guide 的对话,逐句说明
台词Guide 说选项及其去向
start"Welcome to the village! What can I do for you?""Any tips?" 通向 tips。"I'm hurt. Can you help?" 进行治疗,然后到 healed(或 healTooSoon)。"Got anything for the cave?" 发放 Torch,然后到 torch(或 hasTorch)。"Bye!" 结束对话。
tips"Stay off the red bricks, and come back if you get hurt.""Anything else?" 回到 start。"Thanks!" 结束对话。
healed"There you go, good as new.""Thank you!" 结束对话。
torch"Take this torch. The cave is dark.""Thanks!" 结束对话。
healTooSoon"I healed you a moment ago. Come back in a little while.""OK" 结束对话。
hasTorch"You already have my torch. Keep it lit!""Will do!" 结束对话。

只有服务器读取这个模块。LocalScript 从不 require 它:玩家走到哪句台词,服务器就发送哪句。但 ReplicatedStorage 中的模块仍然会被复制到每个玩家的设备上,所以如果对话里有剧透(比如谜题的答案),请把 DialogueData 移到 ServerStorage。然后在 DialogueService 中带 require 的那一行把 ReplicatedStorage 换成 ServerStorage,让整行变成:local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }。

第 3 步:添加服务端脚本

把鼠标悬停在 ServerScriptService 上,插入一个名为 DialogueService 的 Script,把下面的代码粘贴进去。这是对话唯一向前推进的地方,也是唯一发放奖励的地方。

Script 位置: ServerScriptService 名称: DialogueService
-- ServerScriptService 中的 Script,名为 DialogueService。
-- 给 Workspace.NPCs 中的每个 NPC 加上 Talk 提示,并主导每段对话。
-- 玩家的设备只显示文字,并把他点击的选项编号发回来。
-- 服务器知道每个玩家在哪句台词上,检查选项和距离,
-- 并且只有它能治疗或发放物品。

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

-- 和 DialogueData 中相同的结构,让 Studio 的类型检查在这里也认识它们
type Choice = { text: string, next: string?, action: string?, item: string?, failNext: string? }
type Line = { text: string, choices: { Choice } }
local DialogueData = require(ReplicatedStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }

local TALK_DISTANCE = 12 -- 格:提示的半径,也是玩家必须保持的距离
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30

local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")

-- 这个脚本自己创建 DialogueEvent,所以不要手动添加
local dialogueEvent = Instance.new("RemoteEvent")
dialogueEvent.Name = "DialogueEvent"
dialogueEvent.Parent = ReplicatedStorage

type Conversation = { npc: Model, npcName: string, lineId: string, lastChoice: number }
local conversations: { [Player]: Conversation } = {}
local lastHeal: { [Player]: number } = {}

local function rootOf(model: Model?): BasePart?
	local root = model and model:FindFirstChild("HumanoidRootPart")
	return if root and root:IsA("BasePart") then root else nil
end

local function isClose(player: Player, npc: Model): boolean
	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	local playerRoot = rootOf(character)
	local npcRoot = rootOf(npc)
	if not (humanoid and humanoid.Health > 0 and playerRoot and npcRoot) then
		return false -- 没有角色、角色已死或者 NPC 不见了
	end
	-- 留一点余量,因为玩家的位置到达服务器时会稍有延迟
	return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end

-- 选项带有动作时服务器做什么。每个动作完成时返回 true。
local ACTIONS: { [string]: (player: Player, choice: Choice) -> boolean } = {
	Heal = function(player)
		local now = os.clock()
		if now - (lastHeal[player] or -math.huge) < HEAL_COOLDOWN_SECONDS then
			return false -- 上次治疗太近了
		end
		local character = player.Character
		local humanoid = character and character:FindFirstChildOfClass("Humanoid")
		if not (humanoid and humanoid.Health > 0) then
			return false
		end
		lastHeal[player] = now
		humanoid.Health = humanoid.MaxHealth
		return true
	end,
	GiveItem = function(player, choice)
		local itemName = choice.item
		local template = itemFolder and itemName and itemFolder:FindFirstChild(itemName)
		if not (itemName and template and template:IsA("Tool")) then
			warn(`DialogueService: no Tool named {itemName} in ServerStorage.DialogueItems`)
			return false
		end
		local backpack = player:FindFirstChildOfClass("Backpack")
		local character = player.Character
		if not backpack or backpack:FindFirstChild(itemName) or (character and character:FindFirstChild(itemName)) then
			return false -- 还没有背包,或者已经有这个物品了
		end
		local item = template:Clone() :: Tool
		item.CanBeDropped = false -- 让任何人都不能把它扔掉再要一个
		item.Parent = backpack
		return true
	end,
}

local function showLine(player: Player, conversation: Conversation)
	local line = DialogueData[conversation.npcName][conversation.lineId]
	local choiceTexts = {}
	for _, choice in line.choices do
		table.insert(choiceTexts, choice.text)
	end
	dialogueEvent:FireClient(player, "show", conversation.npc, line.text, choiceTexts)
end

local function endConversation(player: Player)
	if conversations[player] then
		conversations[player] = nil
		dialogueEvent:FireClient(player, "close")
	end
end

local function startConversation(player: Player, npc: Model)
	local npcName = npc.Name
	local lines = DialogueData[npcName]
	if conversations[player] or not (lines and lines.start) or not isClose(player, npc) then
		return -- 已经在对话中,这个 NPC 没有 "start" 台词,已死或者太远
	end
	local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
	conversations[player] = conversation
	showLine(player, conversation)
end

-- 玩家点击了编号为 choiceIndex 的选项(0 表示他关闭了窗口)
dialogueEvent.OnServerEvent:Connect(function(player: Player, choiceIndex: unknown)
	local conversation = conversations[player]
	if not conversation then
		return
	end
	if typeof(choiceIndex) ~= "number" or choiceIndex ~= math.floor(choiceIndex) then
		return
	end
	if choiceIndex == 0 or not isClose(player, conversation.npc) then
		endConversation(player)
		return
	end
	local now = os.clock()
	if now - conversation.lastChoice < MIN_SECONDS_BETWEEN_CHOICES then
		-- 太快了。再次发送同一句台词,因为窗口在点击后已经锁住了按钮,
		-- 否则会永远等待回应。
		showLine(player, conversation)
		return
	end
	conversation.lastChoice = now

	local line = DialogueData[conversation.npcName][conversation.lineId]
	local choice = line.choices[choiceIndex]
	if not choice then
		return -- 这个玩家正在看的台词上没有这个选项
	end
	local nextLine = choice.next
	if choice.action then
		local action = ACTIONS[choice.action]
		local done = false
		if action then
			done = action(player, choice)
		else
			warn(`DialogueService: no action named {choice.action}`)
		end
		if not done and choice.failNext then
			nextLine = choice.failNext -- 例如 "I healed you a moment ago"
		end
	end
	if nextLine and not DialogueData[conversation.npcName][nextLine] then
		warn(`DialogueService: no line named {nextLine} for {conversation.npcName} in DialogueData`)
		nextLine = nil
	end
	if nextLine then
		conversation.lineId = nextLine
		showLine(player, conversation)
	else
		endConversation(player)
	end
end)

-- 每个 NPC 上的 Talk 提示
local function setUpNpc(npc: Instance)
	local root = if npc:IsA("Model") then rootOf(npc) else nil
	if not (npc:IsA("Model") and root) then
		return
	end
	if not (DialogueData[npc.Name] and DialogueData[npc.Name].start) then
		warn(`DialogueService: no conversation with a start line for {npc.Name} in DialogueData`)
	end
	local leftover = root:FindFirstChild("TalkPrompt")
	if leftover then
		leftover:Destroy() -- NPC 的副本会带来一个没人监听的旧提示
	end
	local prompt = Instance.new("ProximityPrompt")
	prompt.Name = "TalkPrompt"
	prompt.ActionText = "Talk"
	prompt.ObjectText = npc.Name
	prompt.MaxActivationDistance = TALK_DISTANCE
	prompt.RequiresLineOfSight = false
	prompt.Parent = root
	prompt.Triggered:Connect(function(player: Player)
		startConversation(player, npc)
	end)
end

for _, npc in npcFolder:GetChildren() do
	setUpNpc(npc)
end
npcFolder.ChildAdded:Connect(setUpNpc)

-- 为对话中途走开或死亡的人关闭窗口
task.spawn(function()
	while true do
		task.wait(0.5)
		for player, conversation in conversations do
			if not isClose(player, conversation.npc) then
				endConversation(player)
			end
		end
	end
end)

Players.PlayerRemoving:Connect(function(player: Player)
	conversations[player] = nil
	lastHeal[player] = nil
end)

DialogueService 在游戏启动时自己创建 RemoteEvent DialogueEvent,所以不需要手动往 ReplicatedStorage 中插入任何东西。如果你已经创建了同名的 RemoteEvent,请删掉它:LocalScript 可能会找到你的那个,而服务器上没有人监听它。

DialogueService 开头的设置
设置这里的值改变什么
TALK_DISTANCE12玩家要离多近(格)才会出现 Talk 提示。服务器允许他再走远 4 格才关闭窗口,因为玩家的位置到达服务器时会稍有延迟。
MIN_SECONDS_BETWEEN_CHOICES0.3服务器接受的两次点击之间的最短时间。对更快的点击,服务器不作回应,而是再次发送同一句台词。
HEAL_COOLDOWN_SECONDS30每个玩家两次通过 Heal 动作治疗之间要等多久。

服务器在 conversations 中为每个玩家保存一条记录:他在和哪个 NPC 说话,正在看哪句台词,以及他上一次被接受的点击是什么时候。Talk 提示触发时,只有当玩家还没在对话中、NPC 有 start 台词,且玩家活着并在范围内时,startConversation 才会创建这条记录。之后每次点击都要经过这些检查:

DialogueService 在每次点击时检查什么
检查代码没通过时
玩家正在对话中conversations[player]忽略这次点击。
选项是整数typeof 和 math.floor忽略。字符串、表、小数和 NaN 都在这里被拦下。
0 表示玩家点了 XchoiceIndex == 0对话结束。
活着,并且仍在 16 格以内(12 加 4)isClose对话结束,窗口关闭。
距离上一次被接受的点击不少于 0.3 秒conversation.lastChoice再次发送同一句台词,让窗口得到新的按钮,而不是永远等待。
这个选项存在于玩家正在看的台词上line.choices[choiceIndex]忽略。
动作成功了每个动作返回 true 或 false显示 failNext 台词而不是 next。

提示挂在 NPC 的 HumanoidRootPart 上,因为 ProximityPrompt 只有放在 Workspace 中的零件(或 Attachment,或带有 PrimaryPart 的模型)里才会生效。它的 RequiresLineOfSight 默认开启,只要有东西挡住从镜头到这个零件的视线就会隐藏提示。Roblox 会把提示自己所在的零件排除在这个检查之外,但身体的其他部分不会被排除,而 HumanoidRootPart 位于躯干内部,所以脚本关闭了视线检查。提示名为 TalkPrompt,脚本在添加自己的提示之前会删除零件上已有的任何 TalkPrompt:游戏运行中复制出来的 NPC 会带着原版的提示,而复制来的提示没有人监听。如果 DialogueData 中没有这个 NPC 名字对应的、带 start 台词的对话,Output 中会出现带这个 NPC 名字的警告。

一个循环每秒两次检查每个打开的对话,当玩家走到 16 格以外或者他的角色死亡时关闭它,这样对话中途死亡的玩家不会带着打开的窗口重生。有人离开时,PlayerRemoving 会清理两张表。

第 4 步:添加对话窗口

打开 StarterPlayer,把鼠标悬停在 StarterPlayerScripts 上,插入一个名为 DialogueClient 的 LocalScript,把这段代码粘贴进去。它用代码搭建对话窗口,所以不需要手动绘制 GUI。

LocalScript 位置: StarterPlayer > StarterPlayerScripts 名称: DialogueClient
-- StarterPlayer > StarterPlayerScripts 中的 LocalScript,名为 DialogueClient。
-- 绘制服务器发来的对话:NPC 的名字,逐字打出的
-- 台词,头顶的气泡,以及每个选项对应的按钮。点击
-- 选项只发送它的编号;接下来发生什么由服务器决定。

local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TextChatService = game:GetService("TextChatService")
local UserInputService = game:GetService("UserInputService")

local dialogueEvent = ReplicatedStorage:WaitForChild("DialogueEvent") :: RemoteEvent
local player = Players.LocalPlayer

local LETTERS_PER_SECOND = 45
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)

-- 用代码搭建的对话窗口
local gui = Instance.new("ScreenGui")
gui.Name = "Dialogue"
gui.ResetOnSpawn = false
gui.Enabled = false

local box = Instance.new("Frame")
box.AnchorPoint = Vector2.new(0.5, 1)
box.Position = UDim2.new(0.5, 0, 1, -84) -- 抬高 84 像素,这样 Roblox 的工具栏不会挡住选项
box.Size = UDim2.fromScale(0.6, 0.34)
box.BackgroundColor3 = Color3.fromRGB(24, 24, 32)
box.BackgroundTransparency = 0.1
box.Parent = gui
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(0, 12)
corner.Parent = box
local sizeLimit = Instance.new("UISizeConstraint")
sizeLimit.MaxSize = Vector2.new(720, 300)
sizeLimit.Parent = box

local nameLabel = Instance.new("TextLabel")
nameLabel.Position = UDim2.fromScale(0.04, 0.04)
nameLabel.Size = UDim2.fromScale(0.8, 0.14)
nameLabel.BackgroundTransparency = 1
nameLabel.TextXAlignment = Enum.TextXAlignment.Left
nameLabel.TextColor3 = Color3.fromRGB(190, 160, 255)
nameLabel.TextScaled = true
nameLabel.FontFace = BOLD
nameLabel.Parent = box

local lineLabel = nameLabel:Clone()
lineLabel.Position = UDim2.fromScale(0.04, 0.2)
lineLabel.Size = UDim2.fromScale(0.92, 0.3)
lineLabel.TextColor3 = Color3.new(1, 1, 1)
lineLabel.TextScaled = true -- 长台词会缩小,以适应小小的手机屏幕
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- 在大屏幕上也永远不超过 20 像素
lineTextLimit.Parent = lineLabel

local closeButton = Instance.new("TextButton")
closeButton.AnchorPoint = Vector2.new(1, 0)
closeButton.Position = UDim2.new(1, -8, 0, 8)
closeButton.Size = UDim2.fromOffset(32, 32)
closeButton.BackgroundTransparency = 1
closeButton.Text = "X"
closeButton.TextColor3 = Color3.new(1, 1, 1)
closeButton.TextSize = 20
closeButton.FontFace = BOLD
closeButton.Parent = box

local choiceList = Instance.new("Frame")
choiceList.Position = UDim2.fromScale(0.04, 0.52)
choiceList.Size = UDim2.fromScale(0.92, 0.44)
choiceList.BackgroundTransparency = 1
choiceList.Parent = box
local layout = Instance.new("UIGridLayout")
layout.CellSize = UDim2.new(0.5, -6, 0.5, -6)
layout.CellPadding = UDim2.fromOffset(6, 6)
layout.SortOrder = Enum.SortOrder.LayoutOrder
layout.Parent = choiceList

gui.Parent = player:WaitForChild("PlayerGui")

local talkingTo: Model? = nil
local lineNumber = 0 -- 每来一句新台词就增加,让旧的打字循环停下

local function setPromptVisible(npc: Model?, visible: boolean)
	local root = npc and npc:FindFirstChild("HumanoidRootPart")
	local prompt = root and root:FindFirstChild("TalkPrompt")
	if prompt and prompt:IsA("ProximityPrompt") then
		prompt.Enabled = visible -- 只在这台设备上改变
	end
end

local function clearChoices()
	for _, child in choiceList:GetChildren() do
		if child:IsA("TextButton") then
			child:Destroy()
		end
	end
end

local function close()
	lineNumber += 1
	clearChoices()
	gui.Enabled = false
	setPromptVisible(talkingTo, true)
	talkingTo = nil
	GuiService.SelectedObject = nil
end

local function show(npc: Model, text: string, choices: { string })
	lineNumber += 1
	local thisLine = lineNumber
	if talkingTo ~= npc then
		setPromptVisible(talkingTo, true)
		talkingTo = npc
		setPromptVisible(npc, false)
	end
	gui.Enabled = true
	nameLabel.Text = npc.Name
	clearChoices()

	-- NPC 头顶的气泡(DisplayBubble 只能在 LocalScript 中使用)
	local head = npc:FindFirstChild("Head")
	if head then
		TextChatService:DisplayBubble(head, text)
	end

	-- 逐字打出台词。显示的数量按经过的时间计算,
	-- 所以在任何帧率下速度都一样。
	lineLabel.Text = text
	lineLabel.MaxVisibleGraphemes = 0
	local letters = 0
	for _ in utf8.graphemes(text) do
		letters += 1
	end
	local startTime = os.clock()
	local shown = 0
	while shown < letters do
		task.wait()
		if lineNumber ~= thisLine then
			return -- 这句台词被更新的台词或关闭操作取代了
		end
		shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
		lineLabel.MaxVisibleGraphemes = shown
	end
	lineLabel.MaxVisibleGraphemes = -1

	-- 每个选项一个按钮;服务器只收到按钮的编号
	for index, choiceText in choices do
		local button = Instance.new("TextButton")
		button.LayoutOrder = index
		button.BackgroundColor3 = Color3.fromRGB(124, 77, 255)
		button.TextColor3 = Color3.new(1, 1, 1)
		button.TextScaled = true
		button.FontFace = BOLD
		button.Text = choiceText
		local buttonCorner = Instance.new("UICorner")
		buttonCorner.CornerRadius = UDim.new(0, 8)
		buttonCorner.Parent = button
		button.Parent = choiceList
		button.Activated:Connect(function()
			if lineNumber == thisLine then
				lineNumber += 1 -- 每句台词只能点击一次
				dialogueEvent:FireServer(index)
			end
		end)
		if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
			GuiService.SelectedObject = button -- 让选项可以用手柄选择
		end
	end
end

closeButton.Activated:Connect(function()
	dialogueEvent:FireServer(0)
	close()
end)

dialogueEvent.OnClientEvent:Connect(function(kind: string, npc: Model?, text: string?, choices: { string }?)
	if kind == "show" and npc and text and choices then
		show(npc, text, choices)
	elseif kind == "close" then
		close()
	end
end)

颜色、尺寸和 LETTERS_PER_SECOND 可以随意修改。最后两个处理函数请保持原样:它们是窗口和服务器通信的唯一方式。

DialogueClient 的每个部分做什么:

  • 窗口。一个 ScreenGui,里面有一个固定在屏幕底部中央的 Frame,占屏幕宽度的 60%、高度的 34%,并通过 UISizeConstraint 限制在 720 x 300 像素以内,这样它不会在宽屏显示器上拉满整个屏幕。NPC 的台词使用 TextScaled,在小小的手机屏幕上会缩小文字以适应自己的标签,而 UITextSizeConstraint 不让它在大屏幕上超过 20 像素。UIGridLayout 把选项排成两行两列。ResetOnSpawn 为 false,因为这个 LocalScript 每次会话只运行一次:重生时被删掉的窗口就再也回不来了。
  • 打字机效果。整句台词一次性放进 TextLabel,由 MaxVisibleGraphemes 决定显示多少个字符;这正是 Roblox 自己的打字机示例配合 utf8.graphemes 使用的属性。Roblox 按所有字符都可见来排版文字,所以单词在出现时不会跳到新的一行,也不会改变大小。脚本按经过的时间计算要显示多少个字符,每秒 45 个,所以在任何帧率下速度都一样,最后把属性设为 -1,显示全部内容。
  • 按钮。台词打完后才出现。每个按钮只发送自己的编号,并且只发送一次:lineNumber 检查防止双击发送两次,之后窗口等待服务器发来下一句台词。
  • 台词气泡。TextChatService:DisplayBubble(head, text) 把台词放进 NPC 的 Head 上方的聊天气泡。Roblox 只允许在客户端脚本中这样做,而气泡聊天(bubble chat)默认开启。气泡由这个玩家的设备绘制,所以只有他能看到。
  • 提示。玩家在对话时,他那一份 Talk 提示(按名字 TalkPrompt 找到)会被关闭,这样它不会悬在对话上方。其他玩家仍然能看到他们自己的提示。
  • 任何设备。Activated 在鼠标点击、手机轻触和手柄 A 键时都会触发。手柄只能按下被选中的按钮,所以当 PreferredInput 表明玩家在用手柄时,脚本通过 GuiService.SelectedObject 选中第一个选项。
  • X 按钮。它发送 0,服务器把它理解为“结束对话”,并立即关闭窗口。

添加你自己的动作

动作是 DialogueService 开头的 ACTIONS 表中的一个函数。它接收玩家和选项,完成任务后返回 true。要添加你自己的动作,比如 NPC 发布的任务:

  1. 在 ACTIONS 中添加一个名为 StartQuest 的条目。先检查,再修改:如果 player:GetAttribute("Quest") 已经设置,返回 false;否则调用 player:SetAttribute("Quest", "Cave") 并返回 true。
  2. 在 DialogueData 中给选项设置 action = "StartQuest",一个成功时的 next 台词,以及一个失败时的 failNext 台词,例如 "You are already on a quest."
  3. 点击 Play,把这个选项选两次。如果 DialogueData 中的名字和 ACTIONS 中的键不一致(区分大小写),Output 中会出现 DialogueService: no action named StartQuest,对话会转到 failNext 台词。

编写动作的规则:

  • 在动作内部、在服务器上进行检查和修改。玩家设备发送的唯一东西就是选项编号。
  • 动作需要的东西从选项中读取(比如 item)或者从服务器自己的状态中读取,永远不要从 Remote 中读取。
  • 在动作内部限制一切有价值的东西,就像 Heal 在 lastHeal 中维护自己 30 秒的冷却。每次点击 0.3 秒的限制只是放慢点击速度;它并不能阻止玩家一遍又一遍地走同一个选项。
  • 要打开另一个窗口,比如商店,动作可以向这个玩家发送一个 RemoteEvent 并返回 true。在那个窗口里发生的一切仍然需要自己的服务端检查,就像 NPC 商人 部分讲的那样。

其他 NPC 对话教程错在哪里

如果你在把本教程和某个视频或论坛帖子作比较,下面是重要的区别,以及每种做法会带来问题的原因。

NPC 对话教程中的常见做法,以及本教程的替代做法
其他教程问题本教程
使用 Dialog 对象,并让服务端 Script 监听 DialogChoiceSelected 来发放奖励Roblox 参考文档说这个事件只在客户端起作用,在服务器上不会触发,所以奖励永远不会到达。选项以数字的形式到达服务器,由服务器自己发放奖励。
在 LocalScript 中发放奖励LocalScript 做出的改动只留在那一台设备上(见 哪些内容会复制),而且作弊者可以随时运行同样的代码。所有动作都在 DialogueService 中。
通过 game:GetService("Chat"):Chat(head, text) 让 NPC 说话Chat 服务已经弃用,改用 TextChatService。在 LocalScript 中使用 TextChatService:DisplayBubble。
从客户端发送奖励名称或下一句台词的 id作弊者可以发送任何物品名称,或者直接跳到发放奖励的那句台词。客户端只发送选项编号。服务器在它知道玩家正在看的那句台词上找到它。
提示触发后什么都不检查Roblox 的安全指南把 ProximityPrompt 和 Remote 并列为客户端可以滥用的东西,并建议在执行动作前检查玩家是否足够近。在对话开始时、每次点击时,以及对话打开期间每秒两次检查距离。
在循环中用 wait() 打字全局 wait 已经弃用,改用 task.wait。用 os.clock() 计算可见字母的数量,并用 task.wait() 等待。

玩家能伪造什么,不能伪造什么

假设作弊者控制着他设备上的一切。他可以读取你的 LocalScript 和 ReplicatedStorage 中的所有内容,用任何参数、任意多次地调用 DialogueEvent,还能通过代码触发 Talk 提示,Roblox 的安全指南对此有过提醒。DialogueService 用和 RemoteEvent 参数校验 中同类的服务端检查来应对。下面是作弊者能从中得到什么。

作弊者可能尝试什么,以及 DialogueService 如何应对
作弊者尝试结果原因
从地图另一头触发 Talk 提示什么都不会发生startConversation 检查他是否在 16 格以内(12 加 4)。
发送选项 99、字符串、小数或 NaN被忽略它不是整数,或者他正在看的台词上没有这个选项。
发送奖励名称或台词 id从不被读取服务器只读取选项编号。奖励来自服务器那份台词副本中的 item 和 action 字段。
以网络允许的最快速度点击每段对话每 0.3 秒一次点击更快的点击得到的是原来那句台词。结束并重新开始对话可以绕过这个等待,所以 Heal 和 GiveItem 维护着自己的限制。
不对话就要火把不可能物品只会根据服务器知道玩家所在的那句台词上的选项发放。
攒一大堆火把一次只能有一个服务器先在他的 Backpack 和角色中查找 Torch,而发出的火把无法扔掉,所以没法靠扔掉再要来刷火把。
反复刷治疗台词每 30 秒治疗一次冷却按玩家保存在服务器上,NPC 会用 healTooSoon 台词告诉他。
走开并让窗口保持打开半秒之内关闭服务器每秒两次检查每个打开的对话。
读取整段对话,包括他还没走到的台词可以DialogueData 在 ReplicatedStorage 中,会被复制到每台设备上。如果这很重要,把它移到 ServerStorage(见 第 2 步)。

有一个限制值得直说:走到 Guide 面前并选择选项的作弊者,得到的东西和诚实玩家完全一样。服务器控制的是频率和位置,而不是身份。任何稀有的东西,例如每个玩家只能领取一次的奖励,都需要一个由服务器掌握的检查,比如领取时设置的属性,或者保存在数据存储中的标志。

第 5 步:测试

  1. 点击 Play(F5)并走近 Guide。在 12 格以内会出现带有 Guide 名字的 Talk 提示。按 E。
  2. 窗口显示 "Guide",打出欢迎台词,然后显示四个按钮。同一句台词出现在 NPC 头顶的气泡中。
  3. 选择 "Any tips?",然后选 "Anything else?":你回到了第一句台词。选择 "Bye!":窗口关闭,Talk 提示重新出现。
  4. 先给自己造成伤害:点击 Client/Server 切换按钮切到 Server,在 Workspace 中选中你角色的 Humanoid,在 Properties 窗口中把 Health 设为 50,再切回 Client。玩家角色每秒恢复 MaxHealth 的 1%,所以请马上和 Guide 对话并选择 "I'm hurt. Can you help?":生命值一下子回满。30 秒内再次对话并再选一次:没有治疗,Guide 说他刚刚才治疗过你。
  5. 选择 "Got anything for the cave?":Torch 出现在快捷栏中。装备它并按 Backspace:它仍然留在手里。再要一次:没有第二个火把,Guide 说你已经有了。
  6. 开始对话然后走开。大约在你离 Guide 16 格时,窗口会关闭。
  7. 在测试模式下拉列表中选择 Server & Clients,设为 2 个客户端,点击 Play。两个玩家可以同时和 Guide 对话,各自停在自己的台词上。
  8. 在试玩测试中用 Controller Emulator(Emulation 选项卡中的 Controller)测试手柄。用模拟手柄走近并按下提示按钮(默认是 ButtonX):选项出现时,第一个已经被选中,按 A 就能按下它。
  9. 用 Studio 中的 Device Simulator 测试手机屏幕(撰写本文时它还是测试版:在 File、Beta Features 中开启 New Device Simulator 并重启 Studio)。选择一款手机,点击 Rotate 直到它变成横屏,点击 Play,走近 Guide 并轻触 Talk 提示。选择 "Any tips?":整句台词显示在选项按钮上方,必要时字号会变小,不会和按钮重叠。

整个过程中都保持 Output 窗口打开(Window 菜单,然后选 Output)。这些脚本正常工作时不会输出任何东西,所以任何红色错误或以 DialogueService: 开头的警告都是真正的问题。请看 常见错误。

如何扩展

更多 NPC 和更长的对话

在 NPCs 文件夹中再加一个有自己名字的角色模型,并在 DialogueData 中加一张同名、带 start 台词的表。DialogueService 会给文件夹中每个带 HumanoidRootPart 的模型加上 Talk 提示,包括游戏运行中添加的模型;NPC 的副本会得到一个新的提示,而不是它复制来的那个。两个同名的 NPC 使用同一张表。台词可以按任意顺序连接,选项也可以通回更早的台词,比如 "Anything else?"。每句台词最多放四个选项,因为窗口把它们排成两行两列。

随进度变化的台词

要用不同的方式欢迎回来的玩家,就根据服务器掌握的信息选择第一句台词。在 startConversation 中用 local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start" 选出它,像脚本检查 lines.start 那样检查这句台词是否存在,并在创建对话时用 firstLine 代替 "start"。在某个动作中设置这个属性,并在 Guide 的表中加上 welcomeBack 台词。属性只在一次会话中有效;要在多次访问之间记住玩家,请把标志保存到数据存储中,就像 DataStore 教程 那样。

NPC 商人

按照 商店 GUI 教程 搭建商店,然后添加一个 OpenShop 动作,向这个玩家发送 RemoteEvent 并返回 true,再让商店的 LocalScript 在收到这个事件时打开自己的窗口。购买仍然经过商店自己的服务端检查。如果只能在 NPC 旁边购买,也要在购买处理函数中检查距离,因为客户端可以在任何地方调用商店的 Remote。

会走动的 NPC

要让 Guide 四处走动或跟随玩家,请参考 NPC 寻路教程,并取消 HumanoidRootPart 的 Anchored,让它能移动。Talk 提示挂在这个零件上,所以会跟着 NPC 一起移动,距离检查也使用同一个零件。对话打开时请暂停行走,否则只要 NPC 离玩家超过 16 格,窗口就会关闭。

钥匙、任务和其他奖励

GiveItem 可以发放 DialogueItems 中的任何 Tool,所以 NPC 可以给出一把锁着的门会检查的钥匙,就像 门的教程 中那样。关于使用时会产生效果的物品,例如能治疗的食物,请看 背包教程。

声音和镜头

要给每句台词配上语音片段或短音效,把一个 Sound 放进 NPC 的 Head,并在 DialogueClient 的 show 中播放它。要在 NPC 说话时把镜头对准它,过场动画教程 展示了 LocalScript 如何接管镜头控制并把它交还。

常见错误与解决办法

点击 Play 之前先打开 Output 窗口(Window 菜单,然后选 Output)。对话的大多数问题都会在那里输出警告,或者是由某个对不上的名字引起的。

Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'

DialogueClient 在等待由 DialogueService 创建的 Remote,这说明 DialogueService 没有运行到那里。检查它是 Script 而不是 LocalScript,直接放在 ServerScriptService 中,并且没有被禁用。DialogueService 会先等待 ReplicatedStorage 中的 DialogueData 和 Workspace 中的 NPCs 文件夹,所以它们缺失或名字拼错也会让它停住;这时 Output 会显示来自 DialogueService、带有那个名字的 infinite yield 警告。

我的 NPC 上方没有出现 Talk 提示

DialogueService 只给直接位于 Workspace、NPCs 中并且有名为 HumanoidRootPart 的零件的模型添加提示。检查这两个条件,并走到 12 格以内。来自 Toolbox 的角色模型可能没有这个零件,或者它可能是包在文件夹里的其他类型的对象。

提示出现了,但按 E 没有反应

服务器没有找到这个 NPC 的对话,游戏启动时 Output 会显示带有你的 NPC 名字的 DialogueService: no conversation with a start line for Guide in DialogueData。DialogueData 中的表必须和模型同名,包括大小写,并且包含 start 台词。

选项关闭了窗口,而不是转到下一句台词

Output 显示带有你的名字的 DialogueService: no line named tip for Guide in DialogueData:选项的 next(或 failNext)指向了这个 NPC 的表中不存在的台词。台词名区分大小写,所以请对照表核对拼写,这里是 tips。

窗口能用,但没有台词气泡

气泡需要一个直接位于 NPC 模型里、名为 Head 的零件,并且要开启气泡聊天:在 Explorer 中选中 TextChatService 下的 BubbleChatConfiguration,检查 Enabled 是否勾选。它默认是开启的。

Output 显示 DialogueService: no Tool named Torch in ServerStorage.DialogueItems

服务器找不到这个物品。检查 ServerStorage 中的文件夹是否名为 DialogueItems,以及里面是否有一个名字与选项的 item 完全一致的 Tool(不是 Model 也不是 Part)。在你修好之前,Guide 会用 hasTorch 台词回答,因为动作失败了。

Output 显示 DialogueService: no action named ...

选项的 action 和 ACTIONS 表中的任何键都不匹配。名字区分大小写:heal 不是 Heal。

用 RoCode 来做

如果你觉得描述 NPC 比手动搭建更简单,RoCode 可以把这些脚本直接写进你打开的场景。它是独立的 Roblox Studio AI 代理,并非 Roblox 出品:你在网页聊天里写下需求,它的 Studio 插件就会在你的 Explorer 中创建和修改脚本。

你输入

让 Workspace.NPCs 中的 Guide 模型会说话:Talk 提示,带逐字打出的台词和选项按钮的对话窗口,头顶的气泡,一个冷却 30 秒的治疗选项,以及一个只发放一次 ServerStorage 中 Torch 工具的选项。把对话保存在 ModuleScript 中,所有奖励都在服务端发放。

RoCode 的操作
  • 可以先用 Get Properties 查看模型,读取关键值,例如它的零件上的 Anchored 和它的 Humanoid 的 WalkSpeed。在聊天中输入 / 可以附上模型的准确路径
  • 用 Create Script 编写 ModuleScript DialogueData、Script DialogueService 和 LocalScript DialogueClient
  • 它被要求用 Check Script 检查自己写的每个脚本能否编译,Check Script 会在 Studio 中编译而不运行
  • 分批发送改动,每一批都是 Studio 历史记录中的一个撤销点

使用插件 3.9 及以上时,RoCode 可以运行简短的试玩测试并读取错误;使用插件 3.9.11 及以上时,它可以操控一个测试角色来检查游戏是否正常运行,但它在游戏过程中不会截图,所以请亲自走到 NPC 面前和它对话。如果有什么不对,把你看到的告诉 RoCode:Check Output 可以读取你上一次试玩测试中的 Server 和 Client 输出行。会说话的 NPC 只是众多系统之一;怎么用 AI 做 Roblox 游戏,每个提示词一个系统 这一页展示了它们如何组合在一起。RoCode 如何连接到 Studio。

常见问题

Roblox Studio 里怎么做会说话的 NPC?

给 NPC 加一个 ProximityPrompt,玩家触发它时,在对话窗口、气泡或两者中显示 NPC 的台词。本教程的三个脚本两者都做了,还加上了回答选项。如果只需要气泡,就在提示触发时从 LocalScript 调用 TextChatService:DisplayBubble(npc.Head, "Hello!"),就像 Roblox 气泡聊天页面上的 NPC 示例那样。

选 Dialog 对象还是自己做对话 GUI?

Dialog 对象不需要代码,并会显示一个可点击的气泡,对装饰性的文字来说够用了。它的选择事件只在玩家设备上触发,所以无法安全地发放奖励,而且默认同一时间只有一个玩家可以和它说话。像本教程这样自己做窗口,可以让服务器发放每个奖励,并让每个玩家拥有自己的对话。

怎么让 NPC 给玩家一个物品?

把 Tool 放在 ServerStorage 中,当玩家选择那个选项时,让服务端 Script 把它克隆进玩家的 Backpack,就像 GiveItem 动作那样。检查玩家是否已经有了,并关闭副本的 CanBeDropped,这样就不能扔掉再要一个。永远不要让玩家的设备决定发放哪个物品。

怎么做带打字机效果的对话框?

把整句台词放进 TextLabel,让它的 MaxVisibleGraphemes 从 0 开始每次增加几个字符,最后设为 -1 显示全部。Roblox 的 UI 动画页面配合 utf8.graphemes 使用同一个属性。DialogueClient 按经过的时间计算要显示多少个字符,每秒 45 个,所以速度不受帧率影响。

两个玩家能同时和同一个 NPC 对话吗?

用本教程的脚本可以:服务器为每个玩家维护一段对话,每个玩家只看到自己的窗口。内置的 Dialog 对象不同:在它默认的 BehaviorType(SinglePlayer)下,一次只有一个玩家说话,其他人会看到他的选项。

NPC 的对话文字需要过滤吗?

你自己写的台词不需要。Roblox 要求你负责过滤你无法直接控制的显示文字,例如玩家输入的内容、由随机字符拼成的词,或者从外部网站加载的文字。如果 NPC 会复述玩家输入的东西,就过滤那一部分。

参考资料

代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。

在你自己的游戏里试试 RoCode。

每天有免费额度,无需绑定银行卡。安装插件,描述你想要的功能,然后看看它在 Studio 里做了什么。