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
DialogChoiceSelectedcủ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. ServiceChatcũ đã 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
Hội thoại NPC hoạt động thế nào
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:
- Người chơi đi tới NPC và bấm E ở lời nhắc Talk của nó. Sự kiện
Triggeredcủa lời nhắc chạy trên server cùng với người chơi đó. - 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ó. - 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.
- 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.
- 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.
| Thành phần | Nằm ở đâu | Làm gì |
|---|---|---|
Rig Guide | Workspace, trong thư mục tên NPCs | Chí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 DialogueData | ReplicatedStorage | Mọ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 DialogueService | ServerScriptService | Thê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 DialogueEvent | ReplicatedStorage (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 DialogueClient | StarterPlayer, StarterPlayerScripts | Vẽ 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 DialogueItems | Vậ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. |
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
- 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
Rigsẽ xuất hiện trong Workspace. Rig R6 cũng chạy được với cùng các script. - Đổ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. - 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ó.
- 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. - 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ênTorchvới một Part không anchor tênHandle, đâ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.
-- 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âustart. textlà lời NPC nói.choiceslà các nút của người chơi, theo thứ tự. Hộp thoại có chỗ cho bốn nút.nextnê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ộtnexthoặcfailNextnê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.actionnêu tên việc server làm, từ bảngACTIONStrong DialogueService: ở đây làHealhoặcGiveItem.itemdùng cho GiveItem: đây là tên Tool trong ServerStorage, DialogueItems.failNextlà câu thoại hiện thay chonextkhi 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ó.
| Câu thoại | Guide nói | Cá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.
-- 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ó.
| Thiết lập | Giá trị ở đây | Thay đổi gì |
|---|---|---|
TALK_DISTANCE | 12 | Ngườ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_CHOICES | 0.3 | Khoả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_SECONDS | 30 | Mỗ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:
| Kiểm tra | Code | Nếu không qua |
|---|---|---|
| Người chơi đang trong cuộc hội thoại | conversations[player] | Cú click bị bỏ qua. |
| Lựa chọn là số nguyên | typeof và math.floor | Bị 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 X | choiceIndex == 0 | Cuộ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) | isClose | Cuộ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ất | conversation.lastChoice | Cù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 đọc | line.choices[choiceIndex] | Bị bỏ qua. |
| Hành động đã thành công | mỗi hành động trả về true hoặc false | Câ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.
-- 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ùngTextScaled, thu nhỏ chữ để vừa nhãn của nó trên màn hình điện thoại nhỏ, cònUITextSizeConstraintkhông cho chữ lớn quá 20 pixel trên màn hình lớn.UIGridLayoutxếp các lựa chọn thành hai hàng hai cột.ResetOnSpawnlà 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
MaxVisibleGraphemesquyế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ớiutf8.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
lineNumberngă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ị.
Activatedchạ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 khiPreferredInputcho biết người chơi dùng tay cầm, script chọn lựa chọn đầu tiên bằngGuiService.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:
- Thêm vào
ACTIONSmột mục tênStartQuest. Kiểm tra trước, thay đổi sau: nếuplayer:GetAttribute("Quest")đã được đặt, trả vềfalse; nếu không, gọiplayer:SetAttribute("Quest", "Cave")và trả vềtrue. - Trong DialogueData, đặt cho lựa chọn
action = "StartQuest", một câunextcho trường hợp thành công và một câufailNextcho trường hợp thất bại, ví dụ "You are already on a quest." - 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ệnDialogueService: no action named StartQuest, và cuộc hội thoại chuyển sang câufailNext.
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 đề.
| Hướng dẫn khác | Vấn đề | Hướng dẫn này |
|---|---|---|
Dùng object Dialog, và Script server lắng nghe DialogChoiceSelected để trao thưởng | Tà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ừ LocalScript | Thay đổ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 theo | Kẻ 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ạt | Hướ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ặp | Hà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 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 ra | startConversation 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 NaN | Bị 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ại | Không bao giờ được đọc | Server 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ép | Một cú click mỗi 0.3 giây cho mỗi cuộc hội thoại | Cá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ện | Khô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ốc | Mỗi lần một cái | Server 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áu | Một lần hồi máu mỗi 30 giây | Thờ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ây | Server 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ới | Có 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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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ó.
- 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.
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.
- 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
- Roblox Creator Docs: Proximity prompts (bằng tiếng Anh). tạo lời nhắc, MaxActivationDistance và RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (bằng tiếng Anh). lời nhắc hoạt động ở đâu, chữ và phím mặc định, Triggered và kiểm tra tầm nhìn
- Roblox Creator Docs: Securing the client-server boundary (bằng tiếng Anh). ProximityPrompt như một bề mặt tấn công, kiểm tra khoảng cách và quyền
- Roblox Engine API: Dialog (bằng tiếng Anh). BehaviorType và sự kiện DialogChoiceSelected chỉ chạy trên client
- Roblox Engine API: TextChatService:DisplayBubble (bằng tiếng Anh). bong bóng lời thoại cho NPC từ script client
- Roblox Creator Docs: Customize bubble chat (bằng tiếng Anh). bong bóng NPC và BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (bằng tiếng Anh). văn bản hiển thị nào cần lọc
- Roblox Creator Docs: UI animation and tweens (bằng tiếng Anh). hiệu ứng máy đánh chữ bằng MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (bằng tiếng Anh). Backspace làm gì với tool
- Roblox Engine API: UserInputService.PreferredInput (bằng tiếng Anh). cách nhận biết người chơi dùng tay cầm
- Roblox Creator Docs: Rig Generator (bằng tiếng Anh). chèn rig R15 hoặc R6
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.