Hướng dẫn · Hệ thống game

Cách làm hội thoại NPC trong Roblox Studio

Hội thoại NPC trong Roblox gồm ba phần: một lời nhắc để bắt đầu nói chuyện, một hộp thoại hiện lời NPC và các nút trả lời của người chơi, và một script quyết định mỗi câu trả lời dẫn tới đâu. Trong hướng dẫn này chúng ta dựng cả ba: bạn viết cuộc hội thoại dưới dạng một bảng đơn giản, người chơi bấm E để nói chuyện, và mọi thứ một câu trả lời mang lại (hồi máu, vật phẩm) đều do server trao, không phải thiết bị của người chơi.

Cập nhật ngày 20 tháng 11, 202626 phút đọcTác giả:

Tóm tắt

Đặt model NPC vào thư mục NPCs trong Workspace và viết cuộc hội thoại của nó trong một ModuleScript trong ReplicatedStorage: mỗi câu thoại có lời của NPC và danh sách lựa chọn dẫn tới câu thoại khác. Một Script trong ServerScriptService thêm cho mỗi NPC một ProximityPrompt ("Talk"), nhớ mỗi người chơi đang ở câu thoại nào và gửi câu đó qua một RemoteEvent. Một LocalScript hiện chữ và một nút cho mỗi lựa chọn, và chỉ gửi ngược lại số thứ tự của nút được bấm.

  • Trao phần thưởng trên server. Sự kiện DialogChoiceSelected của object Dialog có sẵn chỉ chạy trên client, nên Script server không bao giờ nghe thấy nó, còn việc hồi máu hay trao vật phẩm trong LocalScript chỉ thay đổi bản sao game của người chơi đó.
  • Hiện bong bóng lời thoại bằng TextChatService:DisplayBubble(npc.Head, text) từ LocalScript. Service Chat cũ đã bị deprecated, thay vào đó dùng TextChatService.
  • Câu thoại do bạn tự viết không cần lọc. Quy tắc của Roblox: lọc mọi văn bản hiển thị mà bạn không trực tiếp kiểm soát, ví dụ những gì người chơi nhập.
Trong trang này
  1. Cách hoạt động
  2. 1. Thêm NPC
  3. 2. Hội thoại
  4. 3. Script server
  5. 4. Hộp thoại
  6. Hành động riêng
  7. Hướng dẫn khác
  8. Giới hạn bảo vệ
  9. 5. Kiểm tra
  10. Mở rộng
  11. Common errors
  12. Với RoCode
  13. Câu hỏi thường gặp
  14. Nguồn và tài liệu đọc thêm

Hội thoại NPC hoạt động thế nào

Minh họaMỗi câu thoại hiện dần trong hộp thoại trong khi toàn bộ câu hiện trong bong bóng, các lựa chọn xuất hiện khi câu đã hiện xong, và server trao Torch khi bạn chọn "Got anything for the cave?".

Một NPC biết nói hoạt động được trong game thật được chia giữa server và thiết bị của từng người chơi. Thiết bị vẽ hộp thoại và các nút. Server, bên duy nhất có thể tin được, biết mỗi người chơi đang đọc câu thoại nào và quyết định mỗi câu trả lời làm gì. Một lượt hội thoại diễn ra như sau:

  1. Người chơi đi tới NPC và bấm E ở lời nhắc Talk của nó. Sự kiện Triggered của lời nhắc chạy trên server cùng với người chơi đó.
  2. Script server kiểm tra người chơi đủ gần, ghi nhớ rằng họ đang ở câu thoại tên start, và chỉ gửi cho người chơi này nội dung câu đó cùng nhãn các lựa chọn của nó.
  3. LocalScript cho câu thoại hiện dần trong hộp thoại, hiện bong bóng trên NPC, rồi thêm một nút cho mỗi lựa chọn.
  4. Người chơi click, chạm hoặc chọn một lựa chọn. Chỉ số thứ tự của nó được gửi về server.
  5. Server tìm số đó trên câu thoại mà nó biết người chơi đang đọc, thực hiện hành động của lựa chọn nếu có (hồi máu, vật phẩm), rồi gửi câu thoại tiếp theo hoặc đóng hộp thoại.
Một NPC biết nói gồm những gì
Thành phầnNằm ở đâuLàm gì
Rig GuideWorkspace, trong thư mục tên NPCsChính là NPC. Tên của nó chọn cuộc hội thoại và hiện trên lời nhắc.
ModuleScript DialogueDataReplicatedStorageMọi câu NPC có thể nói, các lựa chọn dưới mỗi câu và nơi mỗi lựa chọn dẫn tới.
Script DialogueServiceServerScriptServiceThêm lời nhắc Talk, nhớ mỗi người chơi đang ở câu thoại nào, kiểm tra từng cú click và thực hiện hành động.
RemoteEvent DialogueEventReplicatedStorage (DialogueService tạo nó)Mang từng câu thoại tới người chơi, và số thứ tự lựa chọn đã chọn về lại server.
LocalScript DialogueClientStarterPlayer, StarterPlayerScriptsVẽ hộp thoại, cho câu thoại hiện dần, hiện bong bóng và các nút lựa chọn.
Tool Torch (tùy chọn)ServerStorage, trong thư mục tên DialogueItemsVật phẩm mà một lựa chọn trao. Không có gì trong ServerStorage được gửi tới người chơi.
Explorer khi NPC đã sẵn sàng. Khi game chạy, DialogueService thêm một RemoteEvent tên DialogueEvent vào ReplicatedStorage và một ProximityPrompt Talk tên TalkPrompt vào HumanoidRootPart của mỗi NPC.
Workspace
  NPCs Folder new
    Guide Model new
      Humanoid Humanoid
      HumanoidRootPart Part
      Head, UpperTorso, LowerTorso ... (các phần cơ thể)
ReplicatedStorage
  DialogueData ModuleScript new
ServerScriptService
  DialogueService Script new
ServerStorage
  DialogueItems Folder new
    Torch Tool new
      Handle Part new
StarterPlayer
  StarterPlayerScripts
    DialogueClient LocalScript new

Bước 1: thêm NPC

  1. Trên tab Avatar hoặc Home, bấm Character để mở Rig Generator. Chọn R15, kiểu cơ thể và phong cách. Một rig tên Rig sẽ xuất hiện trong Workspace. Rig R6 cũng chạy được với cùng các script.
  2. Đổi tên nó thành Guide. Tên này quan trọng: DialogueService tìm cuộc hội thoại theo tên model, và lời nhắc hiện tên đó cho người chơi.
  3. Mở rộng rig, chọn HumanoidRootPart của nó và bật Anchored trong cửa sổ Properties. Part đã anchor không bao giờ di chuyển do vật lý, nên NPC đứng yên ở chỗ bạn đặt, và người chơi không đẩy được nó.
  4. Rê chuột lên Workspace trong Explorer, bấm nút + và chèn một Folder tên NPCs. Kéo Guide vào đó và đặt rig ở chỗ người chơi có thể đi tới.
  5. Tùy chọn, cho lựa chọn trao vật phẩm: rê chuột lên ServerStorage và chèn một Folder tên DialogueItems. Đặt vào đó một Tool tên Torch với một Part không anchor tên Handle, đây là part nhân vật cầm trên tay. Một PointLight bên trong Handle sẽ khiến nó phát sáng.

Tên phân biệt chữ hoa chữ thường, nên hãy gõ NPCs, Guide, DialogueItems và Torch đúng như trên. NPC có thể là bất kỳ model nào có Humanoid và HumanoidRootPart, kể cả model từ Toolbox, miễn là nó nằm ngay trong thư mục NPCs.

Bước 2: viết cuộc hội thoại

Rê chuột lên ReplicatedStorage, chèn một ModuleScript tên DialogueData và dán đoạn code này vào. Nó không có logic, chỉ có lời thoại và liên kết giữa chúng, nên đây là file bạn sẽ sửa nhiều nhất.

ModuleScript trong ReplicatedStorage tên là DialogueData
-- ModuleScript trong ReplicatedStorage tên là DialogueData.
-- Mọi cuộc hội thoại, theo tên NPC trong Workspace.NPCs. Mỗi câu thoại có
-- lời của NPC và các lựa chọn trả lời của người chơi. Một lựa chọn có thể dẫn tới câu khác (next),
-- kết thúc hội thoại (không có next) và yêu cầu server làm gì đó (action). Nếu server
-- không thực hiện được hành động, nó hiện câu failNext thay cho next.

export type Choice = {
	text: string,
	next: string?, -- câu thoại hiện sau lựa chọn này; nil kết thúc hội thoại
	action: string?, -- hành động server trong bảng ACTIONS của DialogueService
	item: string?, -- cho hành động GiveItem: tên Tool trong ServerStorage.DialogueItems
	failNext: string?, -- câu thoại hiện thay cho next khi không thực hiện được hành động
}

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

Các dòng export type ở đầu mô tả hình dạng của một câu thoại và một lựa chọn. Trong lúc chơi chúng không thay đổi gì; chúng mô tả dữ liệu của bạn để bộ kiểm tra kiểu có thể kiểm tra.

Các phần liên kết với nhau thế nào:

  • Mỗi NPC có một bảng đặt theo tên model của nó trong thư mục NPCs, ở đây là Guide. Mọi cuộc hội thoại bắt đầu ở câu start.
  • text là lời NPC nói. choices là các nút của người chơi, theo thứ tự. Hộp thoại có chỗ cho bốn nút.
  • next nêu tên câu thoại hiện sau lựa chọn này. Lựa chọn không có next, ví dụ "Bye!", kết thúc hội thoại. Một next hoặc failNext nêu tên câu không có trong bảng cũng kết thúc nó, kèm cảnh báo trong Output.
  • action nêu tên việc server làm, từ bảng ACTIONS trong DialogueService: ở đây là Heal hoặc GiveItem.
  • item dùng cho GiveItem: đây là tên Tool trong ServerStorage, DialogueItems.
  • failNext là câu thoại hiện thay cho next khi không thực hiện được hành động, để NPC không bao giờ tuyên bố đã hồi máu hay tặng quà khi thật ra không có.
Cuộc hội thoại của Guide, từng câu một
Câu thoạiGuide nóiCác lựa chọn và nơi chúng dẫn tới
start"Welcome to the village! What can I do for you?""Any tips?" dẫn tới tips. "I'm hurt. Can you help?" hồi máu, rồi tới healed (hoặc healTooSoon). "Got anything for the cave?" trao Torch, rồi tới torch (hoặc hasTorch). "Bye!" kết thúc hội thoại.
tips"Stay off the red bricks, and come back if you get hurt.""Anything else?" quay về start. "Thanks!" kết thúc hội thoại.
healed"There you go, good as new.""Thank you!" kết thúc hội thoại.
torch"Take this torch. The cave is dark.""Thanks!" kết thúc hội thoại.
healTooSoon"I healed you a moment ago. Come back in a little while.""OK" kết thúc hội thoại.
hasTorch"You already have my torch. Keep it lit!""Will do!" kết thúc hội thoại.

Chỉ server đọc module này. LocalScript không bao giờ require nó: server gửi từng câu thoại khi người chơi tới câu đó. Nhưng module trong ReplicatedStorage vẫn được sao chép sang thiết bị của mọi người chơi, nên nếu cuộc hội thoại có tiết lộ (ví dụ đáp án câu đố), hãy chuyển DialogueData vào ServerStorage. Sau đó ở dòng require trong DialogueService, thay ReplicatedStorage bằng ServerStorage, để cả dòng trông như sau: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.

Bước 3: thêm script server

Rê chuột lên ServerScriptService, chèn một Script tên DialogueService và dán đoạn code bên dưới vào. Đây là nơi duy nhất cuộc hội thoại tiến lên, và là nơi duy nhất trao phần thưởng.

Script trong ServerScriptService tên là DialogueService
-- Script trong ServerScriptService tên là DialogueService.
-- Thêm lời nhắc Talk cho mỗi NPC trong Workspace.NPCs và điều khiển mọi cuộc hội thoại.
-- Thiết bị của người chơi chỉ hiện chữ và gửi lại số thứ tự lựa chọn
-- mà họ đã click. Server biết mỗi người chơi đang ở câu thoại nào, kiểm tra lựa chọn
-- và khoảng cách, và chỉ server mới hồi máu hoặc trao vật phẩm.

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

-- Cùng các hình dạng như trong DialogueData, để bộ kiểm tra kiểu của Studio cũng biết chúng ở đây
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 -- stud: bán kính lời nhắc và khoảng cách người chơi phải ở gần
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30

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

-- Script này tự tạo DialogueEvent, nên đừng thêm nó bằng tay
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 -- không có nhân vật, nhân vật đã chết hoặc NPC đã biến mất
	end
	-- dư ra một chút, vì vị trí của người chơi tới server hơi trễ
	return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end

-- Server làm gì khi lựa chọn có hành động. Mỗi hàm trả về true nếu đã thực hiện.
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 -- vừa hồi máu quá gần đây
		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 -- chưa có ba lô hoặc đã có vật phẩm này
		end
		local item = template:Clone() :: Tool
		item.CanBeDropped = false -- để không ai vứt nó đi rồi xin thêm cái nữa
		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 -- đang nói chuyện rồi, NPC này không có câu "start", đã chết hoặc ở quá xa
	end
	local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
	conversations[player] = conversation
	showLine(player, conversation)
end

-- Người chơi đã click lựa chọn số choiceIndex (0 nghĩa là họ đã đóng hộp thoại)
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
		-- Quá nhanh. Gửi lại cùng câu thoại, vì sau cú click hộp thoại đã khóa
		-- các nút và nếu không sẽ chờ phản hồi mãi mãi.
		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 -- câu thoại người chơi này đang đọc không có lựa chọn như vậy
	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 -- ví dụ "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)

-- Lời nhắc Talk trên mỗi NPC
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() -- bản sao NPC mang theo lời nhắc cũ mà không ai lắng nghe
	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)

-- Đóng hộp thoại cho bất kỳ ai đã đi xa hoặc đã chết giữa cuộc hội thoại
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 tự tạo RemoteEvent DialogueEvent khi game bắt đầu, nên bạn không cần chèn gì vào ReplicatedStorage bằng tay. Nếu bạn đã tạo một RemoteEvent cùng tên, hãy xóa nó: LocalScript có thể tìm thấy cái của bạn, mà không ai trên server lắng nghe nó.

Các thiết lập ở đầu DialogueService
Thiết lậpGiá trị ở đâyThay đổi gì
TALK_DISTANCE12Người chơi phải ở gần bao nhiêu stud để lời nhắc Talk xuất hiện. Server cho phép họ đi xa thêm 4 stud trước khi đóng hộp thoại, vì vị trí của người chơi tới server hơi trễ.
MIN_SECONDS_BETWEEN_CHOICES0.3Khoảng thời gian ngắn nhất giữa hai cú click mà server chấp nhận. Với cú click nhanh hơn, thay vì phản hồi, cùng câu thoại được gửi lại.
HEAL_COOLDOWN_SECONDS30Mỗi người chơi phải chờ bao lâu giữa các lần hồi máu từ hành động Heal.

Server giữ trong conversations một bản ghi cho mỗi người chơi: họ đang nói với NPC nào, đang đọc câu thoại nào và cú click được chấp nhận gần nhất là lúc nào. Khi lời nhắc Talk được kích hoạt, startConversation chỉ tạo bản ghi này nếu người chơi chưa nói chuyện, NPC có câu start, và người chơi còn sống và ở trong bán kính. Sau đó mỗi cú click đi qua các bước kiểm tra sau:

DialogueService kiểm tra gì ở mỗi cú click
Kiểm traCodeNếu không qua
Người chơi đang trong cuộc hội thoạiconversations[player]Cú click bị bỏ qua.
Lựa chọn là số nguyêntypeof và math.floorBị bỏ qua. Chuỗi, bảng, số thập phân và NaN dừng lại ở đây.
0 nghĩa là người chơi đã bấm XchoiceIndex == 0Cuộc hội thoại kết thúc.
Còn sống và vẫn không xa quá 16 stud (12 cộng 4)isCloseCuộc hội thoại kết thúc, và hộp thoại đóng lại.
Ít nhất 0.3 giây kể từ cú click được chấp nhận gần nhấtconversation.lastChoiceCùng câu thoại được gửi lại, nên hộp thoại nhận các nút mới thay vì chờ mãi mãi.
Lựa chọn tồn tại trên câu thoại người chơi này đang đọcline.choices[choiceIndex]Bị bỏ qua.
Hành động đã thành côngmỗi hành động trả về true hoặc falseCâu failNext được hiện thay cho next.

Lời nhắc được gắn vào HumanoidRootPart của NPC, vì ProximityPrompt hoạt động khi nằm trong một part (hoặc Attachment, hoặc model có PrimaryPart) trong Workspace. RequiresLineOfSight của nó bật theo mặc định và ẩn lời nhắc mỗi khi có thứ gì chắn tầm nhìn từ camera tới part đó. Roblox loại trừ chính part của lời nhắc khỏi phép kiểm tra này, nhưng không loại trừ phần còn lại của cơ thể, mà HumanoidRootPart lại nằm bên trong thân, nên script tắt kiểm tra tầm nhìn. Lời nhắc tên là TalkPrompt, và script xóa mọi TalkPrompt đã có trên part trước khi thêm cái của mình: bản sao NPC tạo ra trong lúc chơi mang theo lời nhắc của bản gốc, mà không ai lắng nghe bản sao đó. Nếu DialogueData không có cuộc hội thoại với câu start cho tên NPC, Output hiện cảnh báo kèm tên NPC đó.

Một vòng lặp kiểm tra mọi cuộc hội thoại đang mở hai lần mỗi giây và đóng nó khi người chơi đã đi xa quá 16 stud hoặc nhân vật của họ đã chết, để người chơi chết giữa cuộc hội thoại không hồi sinh với hộp thoại còn mở. PlayerRemoving dọn cả hai bảng khi có người rời game.

Bước 4: thêm hộp thoại

Mở StarterPlayer, rê chuột lên StarterPlayerScripts, chèn một LocalScript tên DialogueClient và dán đoạn code này vào. Nó dựng hộp thoại bằng code, nên bạn không cần tự vẽ GUI.

LocalScript trong StarterPlayer > StarterPlayerScripts tên là DialogueClient
-- LocalScript trong StarterPlayer > StarterPlayerScripts tên là DialogueClient.
-- Vẽ cuộc hội thoại server gửi tới: tên NPC, câu thoại của nó hiện dần từng chữ
-- một, bong bóng trên đầu và một nút cho mỗi lựa chọn. Click vào
-- một lựa chọn chỉ gửi số thứ tự của nó; điều gì xảy ra tiếp theo do server quyết định.

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)

-- Hộp thoại dựng bằng code
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) -- cao hơn 84 pixel, để thanh công cụ của Roblox không che các lựa chọn
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 -- câu thoại dài thu nhỏ lại để vừa màn hình điện thoại nhỏ
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- và không bao giờ lớn hơn 20 pixel trên màn hình lớn
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 -- tăng với mỗi câu thoại mới, để vòng lặp hiện chữ cũ dừng lại

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 -- chỉ thay đổi trên thiết bị này
	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()

	-- Bong bóng trên NPC (DisplayBubble chỉ chạy trong LocalScript)
	local head = npc:FindFirstChild("Head")
	if head then
		TextChatService:DisplayBubble(head, text)
	end

	-- Cho câu thoại hiện dần từng chữ. Số chữ được tính từ thời gian đã trôi qua,
	-- nên tốc độ như nhau ở mọi tốc độ khung hình.
	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 -- câu thoại này đã bị thay bằng câu mới hơn hoặc bị đóng
		end
		shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
		lineLabel.MaxVisibleGraphemes = shown
	end
	lineLabel.MaxVisibleGraphemes = -1

	-- Một nút cho mỗi lựa chọn; server chỉ nhận số thứ tự của nút
	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 -- một cú click cho mỗi câu thoại
				dialogueEvent:FireServer(index)
			end
		end)
		if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
			GuiService.SelectedObject = button -- để có thể chọn lựa chọn bằng tay cầm
		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)

Màu sắc, kích thước và LETTERS_PER_SECOND bạn có thể đổi tùy thích. Hãy giữ nguyên hai handler cuối: đó là cách duy nhất hộp thoại nói chuyện với server.

Từng phần của DialogueClient làm gì:

  • Hộp thoại. Một ScreenGui với một Frame neo ở giữa phía dưới màn hình, rộng 60% và cao 34% màn hình, giới hạn ở 720 x 300 pixel bằng UISizeConstraint, để nó không giãn ra hết một màn hình rộng. Câu thoại của NPC dùng TextScaled, thu nhỏ chữ để vừa nhãn của nó trên màn hình điện thoại nhỏ, còn UITextSizeConstraint không cho chữ lớn quá 20 pixel trên màn hình lớn. UIGridLayout xếp các lựa chọn thành hai hàng hai cột. ResetOnSpawn là false, vì LocalScript này chạy một lần mỗi phiên chơi: hộp thoại bị xóa khi hồi sinh sẽ không bao giờ quay lại.
  • Hiệu ứng máy đánh chữ. Toàn bộ câu thoại được đưa vào TextLabel ngay lập tức, còn MaxVisibleGraphemes quyết định bao nhiêu ký tự được hiện; đây cũng là thuộc tính mà ví dụ máy đánh chữ của chính Roblox dùng cùng với utf8.graphemes. Roblox dàn trang chữ như thể mọi ký tự đều hiện, nên các từ không nhảy xuống dòng mới hay đổi kích thước khi xuất hiện. Script tính số ký tự cần hiện từ thời gian đã trôi qua, 45 ký tự mỗi giây, nên tốc độ như nhau ở mọi tốc độ khung hình, rồi đặt thuộc tính về -1, nghĩa là hiện tất cả.
  • Các nút. Chúng xuất hiện khi câu thoại đã hiện xong. Mỗi nút chỉ gửi số thứ tự của nó, và chỉ một lần: phép kiểm tra lineNumber ngăn cú double click gửi hai lần, và sau đó hộp thoại chờ câu thoại tiếp theo từ server.
  • Bong bóng lời thoại. TextChatService:DisplayBubble(head, text) đặt câu thoại vào một bong bóng chat phía trên Head của NPC. Roblox chỉ cho phép việc này trong script client, và bubble chat bật theo mặc định. Bong bóng do thiết bị của người chơi này vẽ, nên chỉ họ nhìn thấy.
  • Lời nhắc. Trong khi người chơi nói chuyện, bản sao lời nhắc Talk của họ (tìm theo tên TalkPrompt) bị tắt, để nó không lơ lửng đè lên cuộc hội thoại. Những người chơi khác vẫn thấy lời nhắc của mình.
  • Mọi thiết bị. Activated chạy khi click chuột, chạm trên điện thoại và nút A trên tay cầm. Tay cầm chỉ bấm được nút đang được chọn, nên khi PreferredInput cho biết người chơi dùng tay cầm, script chọn lựa chọn đầu tiên bằng GuiService.SelectedObject.
  • Nút X. Nó gửi 0, mà server hiểu là "kết thúc hội thoại", và đóng hộp thoại ngay lập tức.

Thêm hành động của riêng bạn

Một hành động là một hàm trong bảng ACTIONS ở đầu DialogueService. Nó nhận người chơi và lựa chọn, và trả về true khi đã làm xong việc. Để thêm hành động của bạn, ví dụ một nhiệm vụ mà NPC giao:

  1. Thêm vào ACTIONS một mục tên StartQuest. Kiểm tra trước, thay đổi sau: nếu player:GetAttribute("Quest") đã được đặt, trả về false; nếu không, gọi player:SetAttribute("Quest", "Cave") và trả về true.
  2. Trong DialogueData, đặt cho lựa chọn action = "StartQuest", một câu next cho trường hợp thành công và một câu failNext cho trường hợp thất bại, ví dụ "You are already on a quest."
  3. Bấm Play và chọn lựa chọn đó hai lần. Nếu tên trong DialogueData không khớp với khóa trong ACTIONS (chữ hoa chữ thường có ý nghĩa), Output sẽ hiện DialogueService: no action named StartQuest, và cuộc hội thoại chuyển sang câu failNext.

Quy tắc khi viết hành động:

  • Làm phép kiểm tra và thay đổi bên trong hành động, trên server. Thứ duy nhất thiết bị của người chơi gửi lên là số thứ tự lựa chọn.
  • Những gì hành động cần, hãy đọc từ lựa chọn (như item) hoặc từ trạng thái của chính server, nhưng không bao giờ từ remote.
  • Giới hạn mọi thứ có giá trị ngay bên trong hành động, giống như Heal giữ thời gian chờ 30 giây riêng trong lastHeal. Giới hạn 0.3 giây cho mỗi cú click chỉ làm chậm các cú click; nó không ngăn người chơi đi qua cùng một lựa chọn hết lần này tới lần khác.
  • Để mở một cửa sổ khác, ví dụ cửa hàng, hành động có thể gửi một RemoteEvent tới người chơi này và trả về true. Mọi thứ xảy ra trong cửa sổ đó vẫn cần các phép kiểm tra server riêng, như trong phần NPC bán hàng.

Các hướng dẫn hội thoại NPC khác sai ở đâu

Nếu bạn so sánh hướng dẫn này với một video hay bài đăng trên diễn đàn, đây là những điểm khác biệt quan trọng và lý do mỗi cách làm đó gây ra vấn đề.

Các cách làm thường gặp trong hướng dẫn hội thoại NPC và hướng dẫn này làm gì thay vào đó
Hướng dẫn khácVấn đềHướng dẫn này
Dùng object Dialog, và Script server lắng nghe DialogChoiceSelected để trao thưởngTài liệu của Roblox nói sự kiện này chỉ chạy phía client và sẽ không chạy trên server, nên phần thưởng không bao giờ tới.Lựa chọn tới server dưới dạng một con số, và server tự trao phần thưởng.
Trao phần thưởng từ LocalScriptThay đổi do LocalScript tạo ra chỉ ở lại trên một thiết bị đó (xem cái gì được replicate), và kẻ gian lận có thể chạy cùng đoạn code đó bất cứ lúc nào.Mọi hành động nằm trong DialogueService.
Cho NPC nói bằng game:GetService("Chat"):Chat(head, text)Service Chat đã bị deprecated, thay vào đó dùng TextChatService.TextChatService:DisplayBubble trong LocalScript.
Gửi từ client tên phần thưởng hoặc id của câu thoại tiếp theoKẻ gian lận có thể gửi bất kỳ tên vật phẩm nào hoặc nhảy thẳng tới câu thoại trao thưởng.Client chỉ gửi số thứ tự lựa chọn. Server tìm nó trên câu thoại mà nó biết người chơi đang đọc.
Không kiểm tra gì sau khi lời nhắc được kích hoạtHướng dẫn bảo mật của Roblox xếp ProximityPrompt cạnh remote như những thứ client có thể lạm dụng, và khuyên kiểm tra người chơi có đủ gần không trước khi thực hiện hành động.Khoảng cách được kiểm tra khi bắt đầu hội thoại, ở mỗi cú click và hai lần mỗi giây khi hộp thoại đang mở.
Cho chữ hiện dần bằng wait() trong vòng lặpHàm wait toàn cục đã bị deprecated, thay vào đó dùng task.wait.Tính số chữ hiện từ os.clock() và chờ bằng task.wait().

Người chơi có thể và không thể giả mạo gì

Hãy coi như kẻ gian lận kiểm soát mọi thứ trên thiết bị của họ. Họ có thể đọc LocalScript của bạn và mọi thứ trong ReplicatedStorage, gọi DialogueEvent với bất kỳ đối số nào bao nhiêu lần tùy thích và kích hoạt lời nhắc Talk từ code, như hướng dẫn bảo mật của Roblox cảnh báo. DialogueService đáp lại bằng các phép kiểm tra server cùng loại với những gì được phân tích trong phần kiểm tra đối số RemoteEvent. Đây là những gì kẻ gian lận nhận được từ đó.

Kẻ gian lận có thể thử gì và DialogueService xử lý thế nào
Kẻ gian lận thửKết quảVì sao
Kích hoạt lời nhắc Talk từ đầu kia bản đồKhông có gì xảy rastartConversation kiểm tra họ không xa quá 16 stud (12 cộng 4).
Gửi lựa chọn 99, một chuỗi, số thập phân hoặc NaNBị bỏ quaĐó không phải số nguyên, hoặc không có lựa chọn như vậy trên câu thoại họ đang đọc.
Gửi tên phần thưởng hoặc id câu thoạiKhông bao giờ được đọcServer chỉ đọc số thứ tự lựa chọn. Phần thưởng lấy từ các trường item và action trong bản sao câu thoại của server.
Click nhanh nhất mà mạng cho phépMột cú click mỗi 0.3 giây cho mỗi cuộc hội thoạiCác cú click nhanh hơn nhận lại chính câu thoại của chúng. Kết thúc và bắt đầu lại hội thoại bỏ qua được khoảng chờ này, nên Heal và GiveItem giữ giới hạn riêng.
Xin đuốc mà không nói chuyệnKhông thểVật phẩm chỉ được trao qua lựa chọn trên câu thoại mà server biết người chơi đang ở.
Gom thật nhiều đuốcMỗi lần một cáiServer trước tiên tìm Torch trong Backpack và nhân vật của họ, và đuốc đã trao không vứt đi được, nên không thể farm bằng cách vứt đi rồi xin lại.
Spam câu thoại hồi máuMột lần hồi máu mỗi 30 giâyThời gian chờ được lưu trên server cho từng người chơi, và NPC báo điều này bằng câu healTooSoon.
Đi xa và để hộp thoại mởĐóng trong vòng nửa giâyServer kiểm tra mọi cuộc hội thoại đang mở hai lần mỗi giây.
Đọc toàn bộ cuộc hội thoại, kể cả các câu họ chưa tớiCó thểDialogueData nằm trong ReplicatedStorage, vốn được sao chép sang mọi thiết bị. Hãy chuyển nó vào ServerStorage nếu điều này quan trọng (xem bước 2).

Có một giới hạn nên nói thẳng: kẻ gian lận đi tới Guide và chọn các lựa chọn sẽ nhận được đúng những gì một người chơi trung thực nhận được. Server kiểm soát tần suất và vị trí, nhưng không kiểm soát được ai. Mọi thứ hiếm, ví dụ phần thưởng mỗi người chơi chỉ nhận được một lần, cần một phép kiểm tra do server nắm giữ, như một attribute được đặt khi nhận thưởng hoặc một cờ được lưu trong kho dữ liệu.

Bước 5: kiểm tra

  1. Bấm Play (F5) và đi tới Guide. Trong phạm vi 12 stud, lời nhắc Talk với tên Guide xuất hiện. Bấm E.
  2. Hộp thoại hiện "Guide", cho câu chào hiện dần rồi hiện bốn nút. Cùng câu đó xuất hiện trong bong bóng trên đầu NPC.
  3. Chọn "Any tips?", rồi "Anything else?": bạn quay lại câu đầu tiên. Chọn "Bye!": hộp thoại đóng lại, và lời nhắc Talk quay lại.
  4. Trước tiên hãy tự gây sát thương cho mình: bấm nút chuyển Client/Server để sang Server, chọn Humanoid của nhân vật bạn trong Workspace, đặt Health bằng 50 trong cửa sổ Properties và chuyển lại sang Client. Nhân vật người chơi hồi 1% MaxHealth mỗi giây, nên hãy nói chuyện với Guide ngay và chọn "I'm hurt. Can you help?": máu nhảy lên đầy. Nói chuyện lại trong vòng 30 giây và chọn lần nữa: không hồi máu, còn Guide nói vừa hồi máu cho bạn lúc nãy.
  5. Chọn "Got anything for the cave?": Torch xuất hiện trong hotbar. Trang bị nó và bấm Backspace: nó vẫn ở trên tay. Xin lại lần nữa: không có cây đuốc thứ hai, còn Guide nói bạn đã có rồi.
  6. Bắt đầu hội thoại rồi đi xa. Hộp thoại đóng lại vào khoảng lúc bạn cách Guide 16 stud.
  7. Chọn Server & Clients trong danh sách chế độ thử, đặt 2 client và bấm Play. Cả hai người chơi có thể nói chuyện với Guide cùng lúc, mỗi người ở câu thoại riêng.
  8. Kiểm tra tay cầm bằng Controller Emulator (Controller trên tab Emulation) trong lúc playtest. Với tay cầm giả lập, đi tới gần và bấm nút của lời nhắc (mặc định là ButtonX): khi các lựa chọn xuất hiện, lựa chọn đầu tiên đã được chọn, và A sẽ bấm nó.
  9. Kiểm tra màn hình điện thoại bằng Device Simulator trong Studio (tại thời điểm viết, đây là bản beta: bật New Device Simulator trong File, Beta Features rồi khởi động lại Studio). Chọn một điện thoại, bấm Rotate cho tới khi nó nằm ngang, bấm Play, đi tới Guide và chạm vào lời nhắc Talk. Chọn "Any tips?": toàn bộ câu thoại hiện phía trên các nút lựa chọn, chữ nhỏ hơn nếu cần, và không đè lên chúng.

Trong suốt thời gian đó hãy để cửa sổ Output mở (menu Window, rồi Output). Khi các script này hoạt động bình thường, chúng không in gì, nên mọi lỗi đỏ hay cảnh báo bắt đầu bằng DialogueService: đều là vấn đề thật. Xem Lỗi thường gặp.

Cách mở rộng

Thêm NPC và hội thoại dài hơn

Thêm vào thư mục NPCs một rig khác với tên riêng, và trong DialogueData một bảng cùng tên với câu start. DialogueService thêm lời nhắc Talk cho mọi model trong thư mục có HumanoidRootPart, kể cả model được thêm trong lúc chơi; bản sao NPC nhận lời nhắc mới thay vì lời nhắc nó được sao chép kèm. Hai NPC cùng tên dùng chung một bảng. Các câu thoại có thể liên kết theo bất kỳ thứ tự nào, và một lựa chọn có thể dẫn ngược về câu trước đó, như "Anything else?". Giữ mỗi câu thoại tối đa bốn lựa chọn, vì hộp thoại xếp chúng thành hai hàng hai cột.

Câu thoại phụ thuộc vào tiến trình

Để chào người chơi quay lại theo cách khác, hãy chọn câu đầu tiên dựa vào thứ server nắm giữ. Trong startConversation, chọn nó bằng local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", kiểm tra câu đó tồn tại, giống như script kiểm tra lines.start, và dùng firstLine thay cho "start" khi tạo cuộc hội thoại. Đặt attribute trong một hành động và thêm câu welcomeBack vào bảng của Guide. Attribute chỉ tồn tại trong một phiên chơi; để nhớ người chơi giữa các lần ghé, hãy lưu một cờ trong kho dữ liệu, như trong hướng dẫn DataStore.

NPC bán hàng

Dựng cửa hàng theo hướng dẫn GUI cửa hàng, rồi thêm hành động OpenShop gửi một RemoteEvent tới người chơi này và trả về true, và để LocalScript của cửa hàng mở cửa sổ của nó khi sự kiện đó tới. Việc mua vẫn đi qua các phép kiểm tra server riêng của cửa hàng. Nếu chỉ được mua khi ở gần NPC, hãy kiểm tra khoảng cách cả bên trong handler mua hàng, vì client có thể gọi remote của cửa hàng từ bất cứ đâu.

NPC biết đi

Để Guide đi lang thang hoặc đi theo người chơi, hãy dùng hướng dẫn tìm đường cho NPC và bỏ Anchored khỏi HumanoidRootPart để nó di chuyển được. Lời nhắc Talk gắn trên part đó, nên di chuyển cùng NPC, và các phép kiểm tra khoảng cách dùng cùng part đó. Hãy tạm dừng việc đi lại khi hộp thoại đang mở, nếu không hộp thoại sẽ đóng ngay khi NPC đi xa người chơi quá 16 stud.

Chìa khóa, nhiệm vụ và phần thưởng khác

GiveItem trao bất kỳ Tool nào trong DialogueItems, nên NPC có thể đưa một chiếc chìa khóa mà cánh cửa bị khóa kiểm tra, như trong hướng dẫn cửa. Về vật phẩm làm gì đó khi dùng, ví dụ đồ ăn hồi máu, hãy đọc hướng dẫn túi đồ.

Âm thanh và camera

Với một đoạn lồng tiếng hoặc âm thanh ngắn ở mỗi câu thoại, hãy đặt một Sound vào Head của NPC và phát nó từ show trong DialogueClient. Để hướng camera vào NPC khi nó nói, hướng dẫn cutscene cho thấy cách một LocalScript nắm quyền điều khiển camera rồi trả lại.

Lỗi thường gặp và cách sửa

Hãy mở cửa sổ Output (menu Window, rồi Output) trước khi bấm Play. Phần lớn vấn đề với hội thoại đều in cảnh báo ở đó hoặc do một cái tên không khớp.

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

DialogueClient đang chờ remote mà DialogueService tạo ra, nghĩa là DialogueService chưa chạy tới chỗ đó. Hãy kiểm tra nó là Script, không phải LocalScript, nằm ngay trong ServerScriptService và không bị tắt. DialogueService trước tiên chờ DialogueData trong ReplicatedStorage và thư mục NPCs trong Workspace, nên nếu chúng thiếu hoặc sai chính tả trong tên thì nó cũng dừng lại; khi đó Output hiện cảnh báo infinite yield từ DialogueService kèm tên đó.

Lời nhắc Talk không xuất hiện trên NPC của tôi

DialogueService chỉ thêm lời nhắc cho model nằm ngay trong Workspace, NPCs và có một part tên HumanoidRootPart. Hãy kiểm tra cả hai điều kiện và đi tới gần hơn 12 stud. Rig từ Toolbox có thể không có part này, hoặc nó có thể là một object loại khác được bọc trong thư mục.

Lời nhắc xuất hiện nhưng bấm E không có tác dụng

Server không tìm thấy cuộc hội thoại cho NPC này, và khi game bắt đầu Output hiện DialogueService: no conversation with a start line for Guide in DialogueData kèm tên NPC của bạn. Bảng trong DialogueData phải có tên giống hệt model, kể cả chữ hoa, và có câu start.

Một lựa chọn đóng hộp thoại thay vì chuyển sang câu tiếp theo

Output hiện DialogueService: no line named tip for Guide in DialogueData với tên của bạn: next (hoặc failNext) của lựa chọn nêu tên một câu không có trong bảng của NPC này. Tên câu thoại phân biệt chữ hoa chữ thường, nên hãy đối chiếu chính tả với bảng, ở đây là tips.

Hộp thoại hoạt động nhưng không có bong bóng lời thoại

Bong bóng cần một part tên Head ngay trong model NPC và bubble chat được bật: trong Explorer chọn BubbleChatConfiguration dưới TextChatService và kiểm tra Enabled đã được bật. Theo mặc định nó được bật.

Output ghi DialogueService: no Tool named Torch in ServerStorage.DialogueItems

Server không tìm thấy vật phẩm. Hãy kiểm tra thư mục trong ServerStorage tên là DialogueItems và trong đó có một Tool (không phải Model hay Part) có tên giống hệt item của lựa chọn. Cho tới khi bạn sửa, Guide trả lời bằng câu hasTorch, vì hành động đã thất bại.

Output ghi DialogueService: no action named ...

action của lựa chọn không khớp với khóa nào trong bảng ACTIONS. Tên phân biệt chữ hoa chữ thường: heal không phải là Heal.

Làm với RoCode

Nếu bạn thấy mô tả NPC dễ hơn là tự dựng, RoCode có thể viết các script này thẳng vào place bạn đang mở. Đây là AI agent độc lập cho Roblox Studio, không phải của Roblox: bạn viết trong web chat, còn plugin cho Studio của nó tạo và sửa script trong Explorer của bạn.

Bạn gõ

Cho model Guide trong Workspace.NPCs biết nói: lời nhắc Talk, hộp thoại với câu thoại hiện dần và các nút lựa chọn, bong bóng trên đầu, lựa chọn hồi máu với thời gian chờ 30 giây và lựa chọn trao một lần tool Torch từ ServerStorage. Lưu cuộc hội thoại trong một ModuleScript và trao mọi phần thưởng trên server.

RoCode làm
  • Có thể xem model trước bằng Get Properties để đọc các giá trị chính, như Anchored của các part và WalkSpeed của Humanoid. Gõ / trong chat để đính kèm đường dẫn chính xác tới model
  • Viết ModuleScript DialogueData, Script DialogueService và LocalScript DialogueClient bằng Create Script
  • Nó được yêu cầu kiểm tra biên dịch từng script nó viết bằng Check Script, công cụ biên dịch script trong Studio mà không chạy nó
  • Gửi thay đổi theo từng đợt, và mỗi đợt là một điểm hoàn tác trong lịch sử của Studio

Với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, và với plugin 3.9.11 trở lên có thể điều khiển nhân vật thử nghiệm để kiểm tra game hoạt động, nhưng trong lúc chơi nó không chụp ảnh màn hình, nên hãy tự đi tới NPC và nói chuyện với nó. Nếu có gì không hoạt động đúng, hãy kể cho RoCode những gì bạn thấy: Check Output có thể đọc các dòng Server và Client từ lần playtest gần nhất của bạn. NPC biết nói là một trong nhiều hệ thống; trang cách tạo game Roblox bằng AI, mỗi prompt một hệ thống cho thấy chúng ghép lại với nhau thế nào. Cách RoCode kết nối với Studio.

Câu hỏi thường gặp

Làm sao để làm NPC biết nói trong Roblox Studio?

Thêm cho NPC một ProximityPrompt và, khi người chơi kích hoạt nó, hiện câu thoại của NPC trong hộp thoại, trong bong bóng hoặc cả hai. Ba script trong hướng dẫn này làm cả hai việc và thêm các lựa chọn trả lời. Nếu chỉ cần bong bóng, hãy gọi TextChatService:DisplayBubble(npc.Head, "Hello!") từ LocalScript khi lời nhắc được kích hoạt, như ví dụ NPC trên trang bubble chat của Roblox.

Nên chọn gì: object Dialog hay GUI hội thoại tự làm?

Object Dialog không cần code và hiện một bong bóng bấm được, đủ cho chữ trang trí. Sự kiện lựa chọn của nó chỉ chạy trên thiết bị của người chơi, nên nó không thể trao phần thưởng an toàn, và theo mặc định mỗi lúc chỉ một người chơi nói chuyện được với nó. Hộp thoại tự làm, như trong hướng dẫn này, cho phép server trao mọi phần thưởng và cho mỗi người chơi một cuộc hội thoại riêng.

Làm sao để NPC đưa vật phẩm cho người chơi?

Giữ Tool trong ServerStorage, và để một Script server clone nó vào Backpack của người chơi khi họ chọn lựa chọn đó, như hành động GiveItem làm. Kiểm tra người chơi chưa có vật phẩm đó, và tắt CanBeDropped trên bản sao để không thể vứt nó đi rồi xin lại. Không bao giờ để thiết bị của người chơi quyết định vật phẩm nào được trao.

Làm sao để làm hộp thoại có hiệu ứng máy đánh chữ?

Đặt toàn bộ câu thoại vào một TextLabel, tăng MaxVisibleGraphemes của nó từ 0 lên, mỗi lần vài ký tự, và cuối cùng đặt về -1 để hiện tất cả. Trang hiệu ứng UI của Roblox dùng cùng thuộc tính đó cùng với utf8.graphemes. DialogueClient tính số ký tự cần hiện từ thời gian đã trôi qua, 45 ký tự mỗi giây, nên tốc độ không phụ thuộc vào tốc độ khung hình.

Hai người chơi có thể nói chuyện với một NPC cùng lúc không?

Với các script trong hướng dẫn này thì có: server giữ một cuộc hội thoại cho mỗi người chơi, và mỗi người chơi chỉ thấy hộp thoại của mình. Object Dialog có sẵn thì khác: với BehaviorType mặc định là SinglePlayer, mỗi lúc chỉ một người chơi nói chuyện, còn những người khác thấy lựa chọn của người đó.

Có cần lọc chữ trong hội thoại NPC không?

Câu thoại do bạn tự viết thì không cần. Roblox giao cho bạn trách nhiệm lọc văn bản hiển thị mà bạn không trực tiếp kiểm soát, ví dụ những gì người chơi nhập, từ ghép từ các ký tự ngẫu nhiên, hoặc văn bản tải từ một trang web bên ngoài. Nếu NPC lặp lại thứ gì đó người chơi đã nhập, hãy lọc phần đó.

Nguồn và tài liệu đọc thêm

Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.

Thử RoCode trong chính game của bạn.

Mỗi ngày có credit miễn phí, không cần thẻ. Cài plugin, mô tả tính năng và xem kết quả xuất hiện trong Studio.