Ringkasnya
Letakkan model NPC dalam folder NPCs di Workspace dan tulis perbualannya dalam ModuleScript dalam ReplicatedStorage: setiap baris ada teks NPC dan senarai pilihan yang membawa ke baris lain. Script dalam ServerScriptService menambah ProximityPrompt ("Talk") pada setiap NPC, mengingati baris mana yang sedang dibaca setiap pemain dan menghantarnya melalui RemoteEvent. LocalScript menunjukkan teks dan satu butang bagi setiap pilihan, dan hanya menghantar kembali nombor butang yang ditekan.
- Beri ganjaran pada pelayan. Event
DialogChoiceSelectedobjek Dialog terbina dalam hanya berlaku pada client, jadi Script pelayan tidak akan mendengarnya, dan rawatan atau item yang diberi dalam LocalScript hanya mengubah salinan game pemain itu. - Tunjukkan gelembung dengan baris NPC melalui
TextChatService:DisplayBubble(npc.Head, text)daripada LocalScript. Servis lamaChatsudah lapuk, dan TextChatService digunakan sebagai gantinya. - Baris yang anda tulis sendiri tidak perlu ditapis. Peraturan Roblox: tapis sebarang teks yang dipaparkan yang tidak anda kawal secara langsung, contohnya apa yang ditaip pemain.
Di halaman ini
Cara dialog NPC berfungsi
NPC bercakap yang berfungsi dalam game sebenar dibahagikan antara pelayan dan peranti setiap pemain. Peranti melukis tetingkap dan butang. Pelayan, satu-satunya pihak yang boleh dipercayai, tahu baris mana yang dibaca setiap pemain dan memutuskan apa yang dilakukan setiap jawapan. Satu giliran perbualan kelihatan begini:
- Pemain menghampiri NPC dan menekan E pada prompt Talk miliknya. Event
Triggeredprompt berlaku pada pelayan bersama pemain itu. - Skrip pelayan menyemak bahawa pemain cukup dekat, mengingati bahawa dia berada pada baris bernama
start, dan menghantar teks baris itu serta label pilihannya kepada pemain itu sahaja. - LocalScript menaip baris dalam tetingkap dialog, menunjukkan gelembung di atas NPC, kemudian menambah satu butang bagi setiap pilihan.
- Pemain mengklik, mengetik atau memilih satu pilihan. Hanya nombornya dihantar kembali ke pelayan.
- Pelayan mencari nombor itu pada baris yang diketahuinya sedang dibaca pemain, menjalankan tindakan pilihan itu jika ada (rawatan, item), dan menghantar baris seterusnya atau menutup tetingkap.
| Elemen | Di mana ia berada | Apa yang dibuat |
|---|---|---|
Rig Guide | Workspace, dalam folder bernama NPCs | NPC itu sendiri. Namanya memilih perbualan dan ditunjukkan pada prompt. |
ModuleScript DialogueData | ReplicatedStorage | Semua baris yang boleh diucapkan NPC, pilihan di bawah setiap baris dan ke mana setiap pilihan membawa. |
Script DialogueService | ServerScriptService | Menambah prompt Talk, mengingati baris mana setiap pemain berada, menyemak setiap klik dan menjalankan tindakan. |
RemoteEvent DialogueEvent | ReplicatedStorage (dicipta oleh DialogueService) | Membawa setiap baris kepada pemain, dan nombor pilihan yang dipilih kembali ke pelayan. |
LocalScript DialogueClient | StarterPlayer, StarterPlayerScripts | Melukis tetingkap, menaip baris, menunjukkan gelembung dan butang pilihan. |
Tool Torch (pilihan) | ServerStorage, dalam folder bernama DialogueItems | Item yang diberi oleh salah satu pilihan. Tiada apa-apa daripada ServerStorage dihantar kepada pemain. |
Workspace
NPCs Folder new
Guide Model new
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (bahagian badan)
ReplicatedStorage
DialogueData ModuleScript new
ServerScriptService
DialogueService Script new
ServerStorage
DialogueItems Folder new
Torch Tool new
Handle Part new
StarterPlayer
StarterPlayerScripts
DialogueClient LocalScript new
Langkah 1: tambah NPC
- Pada tab Avatar atau Home, tekan Character untuk membuka Rig Generator. Pilih R15, bentuk badan dan gaya. Rig bernama
Rigakan muncul dalam Workspace. Rig R6 berfungsi dengan skrip yang sama. - Namakan semula ia kepada
Guide. Nama itu penting: DialogueService mencari perbualan mengikut nama model, dan prompt menunjukkannya kepada pemain. - Kembangkan rig, pilih HumanoidRootPart miliknya dan tandakan Anchored dalam tetingkap Properties. Part anchored tidak pernah bergerak kerana fizik, jadi NPC berdiri di tempat anda meletakkannya, dan pemain tidak boleh menolaknya.
- Letakkan kursor pada Workspace dalam Explorer, tekan butang + dan masukkan Folder bernama
NPCs. Seret Guide ke dalamnya dan letakkan rig di tempat yang boleh dihampiri pemain. - Pilihan, untuk pilihan dengan item: letakkan kursor pada ServerStorage dan masukkan Folder bernama
DialogueItems. Letakkan di dalamnya Tool bernamaTorchdengan satu Part yang tidak anchored bernamaHandle, iaitu part yang dipegang watak di tangan. PointLight di dalam Handle akan membuatnya bercahaya.
Nama sensitif kepada huruf besar dan kecil, jadi taip NPCs, Guide, DialogueItems dan Torch tepat seperti yang ditunjukkan. NPC boleh jadi mana-mana model dengan Humanoid dan HumanoidRootPart, termasuk daripada Toolbox, asalkan ia berada terus dalam folder NPCs.
Langkah 2: tulis perbualan
Letakkan kursor pada ReplicatedStorage, masukkan ModuleScript bernama DialogueData dan tampal kod ini ke dalamnya. Ia tidak mengandungi logik, hanya perkataan dan hubungan antaranya, jadi fail inilah yang paling kerap anda sunting.
-- ModuleScript dalam ReplicatedStorage bernama DialogueData.
-- Semua perbualan, mengikut nama NPC dalam Workspace.NPCs. Setiap baris ada
-- teks NPC dan pilihan jawapan pemain. Pilihan boleh membawa ke baris lain (next),
-- menamatkan perbualan (tanpa next) dan meminta pelayan melakukan sesuatu (action). Jika pelayan
-- tidak dapat menjalankan tindakan, ia menunjukkan baris failNext sebagai ganti next.
export type Choice = {
text: string,
next: string?, -- baris untuk ditunjukkan selepas pilihan ini; nil menamatkan perbualan
action: string?, -- tindakan pelayan daripada jadual ACTIONS dalam DialogueService
item: string?, -- untuk tindakan GiveItem: nama Tool dalam ServerStorage.DialogueItems
failNext: string?, -- baris untuk ditunjukkan sebagai ganti next apabila tindakan gagal dijalankan
}
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
Baris export type di permulaan menerangkan rupa baris dan pilihan. Semasa game berjalan ia tidak mengubah apa-apa; ia menerangkan data anda supaya semakan jenis (type checking) boleh menyemaknya.
Cara bahagian-bahagian ini berhubung:
- Setiap NPC ada jadual yang dinamakan mengikut modelnya dalam folder NPCs, di sini
Guide. Setiap perbualan bermula dengan barisstart. textialah apa yang diucapkan NPC.choicesialah butang pemain, mengikut urutan. Tetingkap ada ruang untuk empat.nextmenamakan baris yang perlu ditunjukkan selepas pilihan ini. Pilihan tanpanext, contohnya "Bye!", menamatkan perbualan.nextataufailNextyang menamakan baris yang tiada dalam jadual juga menamatkannya, dengan amaran dalam Output.actionmenamakan apa yang dilakukan pelayan, daripada jadualACTIONSdalam DialogueService: di siniHealatauGiveItem.itemdiperlukan untuk GiveItem: ia nama Tool dalam ServerStorage, DialogueItems.failNextialah baris yang ditunjukkan sebagai gantinextapabila tindakan gagal dijalankan, supaya NPC tidak pernah mendakwa rawatan atau hadiah yang tidak berlaku.
| Baris | Guide berkata | Pilihan dan ke mana ia membawa |
|---|---|---|
start | "Welcome to the village! What can I do for you?" | "Any tips?" membawa ke tips. "I'm hurt. Can you help?" merawat, kemudian healed (atau healTooSoon). "Got anything for the cave?" memberi Torch, kemudian torch (atau hasTorch). "Bye!" menamatkan perbualan. |
tips | "Stay off the red bricks, and come back if you get hurt." | "Anything else?" kembali ke start. "Thanks!" menamatkan perbualan. |
healed | "There you go, good as new." | "Thank you!" menamatkan perbualan. |
torch | "Take this torch. The cave is dark." | "Thanks!" menamatkan perbualan. |
healTooSoon | "I healed you a moment ago. Come back in a little while." | "OK" menamatkan perbualan. |
hasTorch | "You already have my torch. Keep it lit!" | "Will do!" menamatkan perbualan. |
Modul ini hanya dibaca oleh pelayan. LocalScript tidak pernah membuat require padanya: pelayan menghantar setiap baris apabila pemain sampai kepadanya. Tetapi modul dalam ReplicatedStorage tetap disalin ke peranti setiap pemain, jadi jika perbualan mengandungi spoiler (contohnya jawapan teka-teki), pindahkan DialogueData ke ServerStorage. Kemudian dalam baris dengan require dalam DialogueService, gantikan ReplicatedStorage dengan ServerStorage, supaya seluruh baris kelihatan begini: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.
Langkah 3: tambah skrip pelayan
Letakkan kursor pada ServerScriptService, masukkan Script bernama DialogueService dan tampal kod di bawah ke dalamnya. Inilah satu-satunya tempat perbualan bergerak ke hadapan, dan satu-satunya tempat ganjaran diberi.
-- Script dalam ServerScriptService bernama DialogueService.
-- Menambah prompt Talk pada setiap NPC dalam Workspace.NPCs dan mengendalikan setiap perbualan.
-- Peranti pemain hanya menunjukkan teks dan menghantar kembali nombor pilihan
-- yang diklik. Pelayan tahu baris mana setiap pemain berada, menyemak pilihan
-- dan jarak, dan hanya pelayan yang merawat atau memberi item.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Bentuk yang sama seperti dalam DialogueData, supaya semakan jenis Studio mengenalinya di sini juga
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: jarak prompt dan sedekat mana pemain mesti kekal
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30
local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")
-- Skrip ini sendiri mencipta DialogueEvent, jadi jangan tambahkannya secara manual
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 -- tiada watak, watak sudah mati atau NPC hilang
end
-- sedikit kelonggaran, kerana kedudukan pemain sampai ke pelayan dengan sedikit kelewatan
return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end
-- Apa yang dilakukan pelayan apabila pilihan ada tindakan. Setiap satu memulangkan true jika berjaya.
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 -- dirawat terlalu baru-baru ini
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 -- belum ada Backpack atau pemain sudah memiliki item itu
end
local item = template:Clone() :: Tool
item.CanBeDropped = false -- supaya tiada siapa boleh membuangnya dan meminta satu lagi
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 -- sudah bercakap, NPC ini tiada baris "start", sudah mati atau terlalu jauh
end
local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
conversations[player] = conversation
showLine(player, conversation)
end
-- Pemain mengklik pilihan bernombor choiceIndex (0 bermaksud dia menutup tetingkap)
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
-- Terlalu pantas. Hantar baris yang sama semula, kerana tetingkap sudah mengunci
-- butang selepas klik dan jika tidak akan menunggu jawapan selama-lamanya.
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 -- pilihan ini tiada pada baris yang dibaca pemain ini
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 -- contohnya "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)
-- Prompt Talk pada setiap 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() -- salinan NPC membawa prompt lama yang tiada siapa dengar
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)
-- Tutup tetingkap untuk sesiapa yang pergi atau mati di tengah perbualan
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 sendiri mencipta RemoteEvent DialogueEvent apabila game bermula, jadi anda tidak perlu memasukkan apa-apa ke dalam ReplicatedStorage secara manual. Jika anda sudah mencipta RemoteEvent dengan nama itu, padamkannya: LocalScript mungkin menemui RemoteEvent anda, dan tiada siapa mendengarnya pada pelayan.
| Tetapan | Nilai di sini | Apa yang diubah |
|---|---|---|
TALK_DISTANCE | 12 | Berapa dekat, dalam stud, pemain perlu berada supaya prompt Talk muncul. Pelayan membenarkannya bergerak 4 stud lagi sebelum menutup tetingkap, kerana kedudukan pemain sampai ke pelayan dengan sedikit kelewatan. |
MIN_SECONDS_BETWEEN_CHOICES | 0.3 | Masa paling singkat antara dua klik yang diterima pelayan. Untuk klik yang lebih pantas, baris yang sama dihantar semula sebagai ganti jawapan. |
HEAL_COOLDOWN_SECONDS | 30 | Berapa lama setiap pemain menunggu antara rawatan daripada tindakan Heal. |
Pelayan menyimpan satu rekod bagi setiap pemain dalam conversations: NPC mana yang diajak bercakap, baris mana yang dibaca dan bila klik terakhirnya diterima. Apabila prompt Talk dicetuskan, startConversation mencipta rekod ini hanya jika pemain belum bercakap, NPC ada baris start, dan pemain masih hidup dan berada dalam jarak. Selepas itu setiap klik melalui semakan berikut:
| Semakan | Kod | Jika gagal |
|---|---|---|
| Pemain berada dalam perbualan | conversations[player] | Klik diabaikan. |
| Pilihan ialah integer | typeof dan math.floor | Diabaikan. String, jadual, pecahan dan NaN berhenti di sini. |
| 0 bermaksud pemain menekan X | choiceIndex == 0 | Perbualan tamat. |
| Masih hidup dan tidak lebih jauh daripada 16 stud (12 tambah 4) | isClose | Perbualan tamat, dan tetingkap ditutup. |
| Sekurang-kurangnya 0.3 saat sejak klik terakhir yang diterima | conversation.lastChoice | Baris yang sama dihantar semula, jadi tetingkap mendapat butang baharu dan tidak menunggu selama-lamanya. |
| Pilihan wujud pada baris yang dibaca pemain ini | line.choices[choiceIndex] | Diabaikan. |
| Tindakan berjaya | setiap tindakan memulangkan true atau false | Baris failNext ditunjukkan sebagai ganti next. |
Prompt diletakkan pada HumanoidRootPart NPC, kerana ProximityPrompt berfungsi apabila ia berada di dalam part (atau Attachment, atau model dengan PrimaryPart) dalam Workspace. RequiresLineOfSight miliknya dihidupkan secara lalai dan menyembunyikan prompt setiap kali sesuatu menghalang pandangan dari kamera ke part itu. Roblox mengecualikan part prompt itu sendiri daripada semakan ini, tetapi tidak bahagian badan yang lain, dan HumanoidRootPart berada di dalam badan, jadi skrip mematikan semakan garis pandangan. Prompt dinamakan TalkPrompt, dan skrip memadam sebarang TalkPrompt yang sudah ada pada part sebelum menambah miliknya sendiri: salinan NPC yang dibuat semasa game berjalan datang bersama prompt asal, dan tiada siapa mendengar prompt salinan itu. Jika DialogueData tidak mempunyai perbualan dengan baris start untuk nama NPC, amaran dengan nama NPC itu muncul dalam Output.
Satu gelung menyemak setiap perbualan yang terbuka dua kali sesaat dan menutupnya apabila pemain bergerak lebih jauh daripada 16 stud atau wataknya mati, supaya pemain yang mati di tengah perbualan tidak muncul semula dengan tetingkap terbuka. PlayerRemoving mengosongkan kedua-dua jadual apabila seseorang keluar.
Langkah 4: tambah tetingkap dialog
Buka StarterPlayer, letakkan kursor pada StarterPlayerScripts, masukkan LocalScript bernama DialogueClient dan tampal kod ini ke dalamnya. Ia membina tetingkap dialog dalam kod, jadi anda tidak perlu melukis GUI dengan tangan.
-- LocalScript dalam StarterPlayer > StarterPlayerScripts bernama DialogueClient.
-- Melukis perbualan yang dihantar pelayan: nama NPC, barisnya yang ditaip huruf
-- demi huruf, gelembung di atas kepala dan satu butang bagi setiap pilihan. Klik pada
-- pilihan hanya menghantar nombornya; apa yang berlaku seterusnya diputuskan pelayan.
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)
-- Tetingkap dialog yang dibina dalam kod
local gui = Instance.new("ScreenGui")
gui.Name = "Dialogue"
gui.ResetOnSpawn = false
gui.Enabled = false
local box = Instance.new("Frame")
box.AnchorPoint = Vector2.new(0.5, 1)
box.Position = UDim2.new(0.5, 0, 1, -84) -- 84 piksel lebih tinggi, supaya bar alat Roblox tidak menutup pilihan
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 -- baris panjang mengecil supaya muat pada skrin telefon yang kecil
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- dan tidak pernah melebihi 20 piksel pada skrin besar
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 -- bertambah dengan setiap baris baharu, supaya gelung menaip lama berhenti
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 -- berubah pada peranti ini sahaja
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()
-- Gelembung di atas NPC (DisplayBubble hanya berfungsi dalam LocalScript)
local head = npc:FindFirstChild("Head")
if head then
TextChatService:DisplayBubble(head, text)
end
-- Taip baris huruf demi huruf. Bilangan dikira daripada masa yang berlalu,
-- jadi kelajuannya sama pada mana-mana kadar bingkai.
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 -- baris ini diganti oleh baris lebih baharu atau penutupan
end
shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
lineLabel.MaxVisibleGraphemes = shown
end
lineLabel.MaxVisibleGraphemes = -1
-- Satu butang bagi setiap pilihan; pelayan hanya menerima nombor butang
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 -- satu klik bagi setiap baris
dialogueEvent:FireServer(index)
end
end)
if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = button -- supaya pilihan boleh dipilih dengan gamepad
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)
Warna, saiz dan LETTERS_PER_SECOND boleh anda ubah sesuka hati. Biarkan dua pengendali terakhir seperti sedia ada: itulah satu-satunya cara tetingkap berkomunikasi dengan pelayan.
Apa yang dilakukan setiap bahagian DialogueClient:
- Tetingkap. ScreenGui dengan Frame yang ditambat di bahagian bawah tengah skrin, 60% lebarnya dan 34% tingginya, dengan had 720 kali 300 piksel melalui
UISizeConstraint, supaya ia tidak meregang ke seluruh monitor lebar. Baris NPC menggunakanTextScaled, yang mengecilkan teks supaya muat dalam labelnya pada skrin telefon yang kecil, danUITextSizeConstraintmenghalangnya membesar melebihi 20 piksel pada skrin besar.UIGridLayoutmenyusun pilihan dua kali dua.ResetOnSpawnbernilai false kerana LocalScript ini berjalan sekali setiap sesi: tetingkap yang dipadam semasa respawn tidak akan kembali. - Kesan mesin taip. Seluruh baris dimasukkan ke dalam TextLabel sekali gus, dan
MaxVisibleGraphemesmenentukan berapa banyak aksara yang kelihatan; ini sifat yang sama yang digunakan oleh contoh mesin taip Roblox sendiri bersamautf8.graphemes. Roblox menyusun teks seolah-olah semua aksara kelihatan, jadi perkataan tidak melompat ke baris baharu atau berubah saiz semasa muncul. Skrip mengira berapa banyak aksara untuk ditunjukkan daripada masa yang berlalu, 45 sesaat, jadi kelajuannya sama pada mana-mana kadar bingkai, kemudian menetapkan sifat itu kepada -1, yang menunjukkan semuanya. - Butang. Ia muncul apabila baris selesai ditaip. Setiap satu hanya menghantar nombornya, dan sekali sahaja: semakan
lineNumbermenghalang klik berganda daripada menghantar dua kali, dan selepas itu tetingkap menunggu baris seterusnya daripada pelayan. - Gelembung baris.
TextChatService:DisplayBubble(head, text)meletakkan baris dalam gelembung chat di atas Head NPC. Roblox hanya membenarkan ini dalam skrip client, dan bubble chat dihidupkan secara lalai. Gelembung dilukis oleh peranti pemain ini, jadi hanya dia yang melihatnya. - Prompt. Semasa pemain bercakap, salinan prompt Talk miliknya (ditemui mengikut nama TalkPrompt) dimatikan, supaya ia tidak terapung di atas perbualan. Pemain lain masih melihat prompt mereka.
- Mana-mana peranti.
Activatedberlaku untuk klik tetikus, ketikan pada telefon dan butang A pada gamepad. Gamepad hanya boleh menekan butang yang dipilih, jadi apabilaPreferredInputmenyatakan pemain menggunakan gamepad, skrip memilih pilihan pertama melaluiGuiService.SelectedObject. - Butang X. Ia menghantar 0, yang difahami pelayan sebagai "tamatkan perbualan", dan terus menutup tetingkap.
Tambah tindakan anda sendiri
Tindakan ialah fungsi dalam jadual ACTIONS di permulaan DialogueService. Ia menerima pemain dan pilihan, dan memulangkan true apabila kerjanya selesai. Untuk menambah tindakan sendiri, contohnya quest yang diberi oleh NPC:
- Tambah entri bernama
StartQuestdalamACTIONS. Semak dahulu, kemudian ubah: jikaplayer:GetAttribute("Quest")sudah ditetapkan, pulangkanfalse; jika tidak, panggilplayer:SetAttribute("Quest", "Cave")dan pulangkantrue. - Dalam DialogueData, beri pilihan
action = "StartQuest", barisnextuntuk kejayaan dan barisfailNextuntuk kegagalan, contohnya "You are already on a quest." - Tekan Play dan pilih pilihan itu dua kali. Jika nama dalam DialogueData tidak sepadan dengan kunci dalam
ACTIONS(huruf besar dan kecil penting),DialogueService: no action named StartQuestakan muncul dalam Output, dan perbualan akan beralih ke barisfailNext.
Peraturan untuk menulis tindakan:
- Buat semakan dan perubahan di dalam tindakan, pada pelayan. Satu-satunya perkara yang dihantar peranti pemain ialah nombor pilihan.
- Baca apa yang diperlukan tindakan daripada pilihan (seperti
item) atau daripada keadaan pelayan sendiri, tetapi tidak pernah daripada remote. - Hadkan apa sahaja yang bernilai di dalam tindakan itu sendiri, sama seperti Heal menyimpan cooldown 30 saat sendiri dalam
lastHeal. Had 0.3 saat bagi setiap klik hanya memperlahankan klik; ia tidak menghalang pemain melalui pilihan yang sama berulang kali. - Untuk membuka tetingkap lain, contohnya kedai, tindakan boleh menghantar RemoteEvent kepada pemain itu dan memulangkan
true. Semua yang berlaku dalam tetingkap itu tetap memerlukan semakan pelayan sendiri, seperti dalam bahagian NPC penjual.
Di mana tutorial dialog NPC lain tersilap
Jika anda membandingkan panduan ini dengan video atau hantaran forum, berikut perbezaan penting dan sebab setiap teknik itu menimbulkan masalah.
| Tutorial | Masalah | Panduan ini |
|---|---|---|
Menggunakan objek Dialog, dan Script pelayan mendengar DialogChoiceSelected untuk memberi ganjaran | Rujukan Roblox menyatakan event ini hanya berfungsi di sebelah client dan tidak akan berlaku pada pelayan, jadi ganjaran tidak pernah sampai. | Pilihan sampai ke pelayan sebagai nombor, dan pelayan sendiri memberi ganjaran. |
| Memberi ganjaran daripada LocalScript | Perubahan yang dibuat LocalScript kekal pada satu peranti itu sahaja (lihat apa yang direplikasi), dan penipu boleh menjalankan kod yang sama bila-bila masa. | Semua tindakan berada dalam DialogueService. |
Membuat NPC bercakap melalui game:GetService("Chat"):Chat(head, text) | Servis Chat sudah lapuk, dan TextChatService digunakan sebagai gantinya. | TextChatService:DisplayBubble dalam LocalScript. |
| Menghantar nama ganjaran atau id baris seterusnya daripada client | Penipu boleh menghantar apa-apa nama item atau melompat terus ke baris yang memberi ganjaran. | Client hanya menghantar nombor pilihan. Pelayan mencarinya pada baris yang diketahuinya sedang dibaca pemain. |
| Tidak menyemak apa-apa selepas prompt dicetuskan | Panduan keselamatan Roblox meletakkan ProximityPrompt bersama remote sebagai sesuatu yang boleh disalahgunakan client, dan menasihatkan semakan sama ada pemain cukup dekat sebelum tindakan. | Jarak disemak semasa perbualan bermula, pada setiap klik dan dua kali sesaat selagi ia terbuka. |
Menaip teks melalui wait() dalam gelung | wait global sudah lapuk, dan task.wait digunakan sebagai gantinya. | Mengira bilangan huruf yang kelihatan daripada os.clock() dan menunggu melalui task.wait(). |
Apa yang boleh dan tidak boleh dipalsukan pemain
Anggap penipu mengawal segala-galanya pada perantinya. Dia boleh membaca LocalScript anda dan semua dalam ReplicatedStorage, memanggil DialogueEvent dengan apa-apa argumen sebanyak mana yang dia mahu, dan mencetuskan prompt Talk daripada kod, seperti yang diberi amaran oleh panduan keselamatan Roblox. DialogueService menjawab dengan semakan pelayan jenis yang sama seperti yang dibincangkan dalam bahagian semakan argumen RemoteEvent. Inilah yang diperoleh penipu daripadanya.
| Penipu cuba | Hasil | Sebab |
|---|---|---|
| Mencetuskan prompt Talk dari hujung peta yang lain | Tiada apa-apa berlaku | startConversation menyemak bahawa dia tidak lebih jauh daripada 16 stud (12 tambah 4). |
| Menghantar pilihan 99, string, pecahan atau NaN | Diabaikan | Ia bukan integer, atau pilihan itu tiada pada baris yang dibacanya. |
| Menghantar nama ganjaran atau id baris | Tidak pernah dibaca | Pelayan hanya membaca nombor pilihan. Ganjaran diambil daripada medan item dan action salinan baris di pelayan. |
| Mengklik sepantas yang dibenarkan rangkaian | Satu klik setiap 0.3 saat bagi setiap perbualan | Klik yang lebih pantas mendapat baris mereka sendiri semula. Menamatkan dan memulakan semula perbualan memintas penantian ini, jadi Heal dan GiveItem menyimpan had sendiri. |
| Meminta obor tanpa perbualan | Mustahil | Item hanya diberi melalui pilihan pada baris yang diketahui pelayan sedang dibaca pemain. |
| Mengumpul banyak obor | Satu pada satu masa | Pelayan mencari Torch dalam Backpack dan wataknya dahulu, dan obor yang diberi tidak boleh dibuang, jadi ia tidak boleh di-farm dengan membuang dan meminta semula. |
| Spam baris rawatan | Satu rawatan setiap 30 saat | Cooldown disimpan pada pelayan bagi setiap pemain, dan NPC memberitahunya dengan baris healTooSoon. |
| Pergi dan biarkan tetingkap terbuka | Ditutup dalam masa setengah saat | Pelayan menyemak setiap perbualan yang terbuka dua kali sesaat. |
| Membaca seluruh perbualan, termasuk baris yang belum dicapai | Boleh | DialogueData berada dalam ReplicatedStorage, yang disalin ke setiap peranti. Pindahkan ke ServerStorage jika ia penting (lihat langkah 2). |
Satu had patut dinyatakan dengan terus terang: penipu yang menghampiri Guide dan memilih pilihan mendapat tepat apa yang diperoleh pemain jujur. Pelayan mengawal berapa kerap dan dari mana, tetapi bukan siapa. Apa sahaja yang jarang, contohnya ganjaran yang hanya boleh diperoleh setiap pemain sekali, memerlukan semakan yang dimiliki pelayan, seperti atribut yang ditetapkan semasa menerimanya, atau bendera yang disimpan dalam stor data.
Langkah 5: uji
- Tekan Play (F5) dan hampiri Guide. Dalam lingkungan 12 stud, prompt Talk dengan nama Guide muncul. Tekan E.
- Tetingkap menunjukkan "Guide", menaip baris alu-aluan dan kemudian menunjukkan empat butang. Baris yang sama muncul dalam gelembung di atas kepala NPC.
- Pilih "Any tips?", kemudian "Anything else?": anda kembali ke baris pertama. Pilih "Bye!": tetingkap ditutup, dan prompt Talk kembali.
- Cederakan diri anda dahulu: tekan suis Client/Server untuk beralih ke Server, pilih Humanoid watak anda dalam Workspace, tetapkan Health kepada 50 dalam tetingkap Properties dan beralih semula ke Client. Watak pemain memulihkan 1% daripada MaxHealth setiap saat, jadi terus bercakap dengan Guide dan pilih "I'm hurt. Can you help?": nyawa melonjak ke penuh. Bercakap semula dalam masa 30 saat dan pilih sekali lagi: tiada rawatan, dan Guide berkata dia baru sahaja merawat anda.
- Pilih "Got anything for the cave?": Torch muncul dalam hotbar. Pakai dan tekan Backspace: ia kekal di tangan. Minta lagi: tiada obor kedua, dan Guide berkata anda sudah memilikinya.
- Mulakan perbualan dan berjalan pergi. Tetingkap ditutup lebih kurang apabila anda berada 16 stud dari Guide.
- Pilih Server & Clients dalam senarai lungsur mod ujian, tetapkan 2 client dan tekan Play. Kedua-dua pemain boleh bercakap dengan Guide pada masa yang sama, setiap seorang pada barisnya sendiri.
- Uji gamepad melalui Controller Emulator (Controller pada tab Emulation) semasa playtest. Dengan gamepad yang diemulasi, hampiri dan tekan butang prompt (lalai ButtonX): apabila pilihan muncul, yang pertama sudah dipilih, dan A menekannya.
- Uji skrin telefon melalui Device Simulator dalam Studio (semasa penulisan ini ia masih beta: hidupkan New Device Simulator dalam File, Beta Features dan mulakan semula Studio). Pilih telefon, tekan Rotate sehingga ia dalam orientasi landskap, tekan Play, hampiri Guide dan ketik prompt Talk. Pilih "Any tips?": seluruh baris kelihatan di atas butang pilihan, dengan teks lebih kecil jika perlu, dan tidak bertindih dengannya.
Sepanjang masa ini, biarkan tetingkap Output terbuka (menu Window, kemudian Output). Apabila skrip ini berfungsi, ia tidak mencetak apa-apa, jadi sebarang ralat merah atau amaran yang bermula dengan DialogueService: ialah masalah sebenar. Lihat Ralat biasa.
Cara mengembangkannya
Lebih banyak NPC dan perbualan lebih panjang
Tambah satu lagi rig dengan namanya sendiri dalam folder NPCs, dan dalam DialogueData, jadual dengan nama yang sama dan baris start. DialogueService menambah prompt Talk pada setiap model dalam folder yang ada HumanoidRootPart, termasuk yang ditambah semasa game berjalan; salinan NPC mendapat prompt baharu sebagai ganti prompt yang disalin bersamanya. Dua NPC dengan nama yang sama menggunakan satu jadual. Baris boleh dihubungkan dalam apa-apa urutan, dan pilihan boleh membawa kembali ke baris yang lebih awal, seperti "Anything else?". Simpan tidak lebih daripada empat pilihan pada setiap baris, kerana tetingkap menyusunnya dua kali dua.
Baris yang bergantung pada kemajuan
Untuk menyambut pemain yang kembali dengan cara berbeza, pilih baris pertama berdasarkan apa yang dimiliki pelayan. Dalam startConversation, pilih ia melalui local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", semak bahawa baris itu wujud, sama seperti skrip menyemak lines.start, dan gunakan firstLine sebagai ganti "start" semasa mencipta perbualan. Tetapkan atribut dalam tindakan dan tambah baris welcomeBack dalam jadual Guide. Atribut hidup selama satu sesi; untuk mengingati pemain antara lawatan, simpan bendera dalam stor data, seperti dalam tutorial DataStore.
NPC penjual
Bina kedai mengikut panduan GUI kedai, kemudian tambah tindakan OpenShop yang menghantar RemoteEvent kepada pemain itu dan memulangkan true, dan biarkan LocalScript kedai membuka tetingkapnya apabila event itu tiba. Pembelian masih melalui semakan pelayan kedai sendiri. Jika pembelian hanya dibenarkan berhampiran NPC, semak jarak juga di dalam pengendali pembelian, kerana client boleh memanggil remote kedai dari mana-mana.
NPC yang berjalan
Untuk membuat Guide merayau atau mengikut pemain, gunakan panduan pathfinding untuk NPC dan buang tanda Anchored pada HumanoidRootPart supaya ia boleh bergerak. Prompt Talk berada pada part ini, jadi ia bergerak bersama NPC, dan semakan jarak menggunakan part yang sama. Hentikan sementara pergerakan semasa perbualan terbuka, jika tidak tetingkap akan ditutup sebaik sahaja NPC bergerak lebih jauh daripada 16 stud dari pemain.
Kunci, quest dan ganjaran lain
GiveItem memberi mana-mana Tool daripada DialogueItems, jadi NPC boleh memberi kunci yang disemak oleh pintu berkunci, seperti dalam panduan pintu. Tentang item yang melakukan sesuatu apabila digunakan, contohnya makanan yang merawat, baca panduan inventori.
Bunyi dan kamera
Untuk klip suara atau bunyi pendek pada setiap baris, letakkan Sound dalam Head NPC dan mainkannya daripada show dalam DialogueClient. Untuk menghalakan kamera ke NPC semasa ia bercakap, panduan cutscene menunjukkan cara LocalScript mengambil alih kawalan kamera dan memulangkannya.
Ralat biasa dan cara membaikinya
Buka tetingkap Output (menu Window, kemudian Output) sebelum menekan Play. Kebanyakan masalah dialog mencetak amaran di situ atau berpunca daripada nama yang tidak sepadan.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'
DialogueClient menunggu remote yang dicipta oleh DialogueService, bermakna DialogueService tidak sampai ke tahap itu. Semak bahawa ia Script, bukan LocalScript, bahawa ia berada terus dalam ServerScriptService dan tidak dimatikan. DialogueService terlebih dahulu menunggu DialogueData dalam ReplicatedStorage dan folder NPCs dalam Workspace, jadi jika ia tiada atau ada salah ejaan pada nama, ia juga berhenti; ketika itu Output menunjukkan amaran infinite yield daripada DialogueService dengan nama tersebut.
Prompt Talk tidak muncul di atas NPC saya
DialogueService hanya menambah prompt pada model yang berada terus dalam Workspace, NPCs dan yang ada part bernama HumanoidRootPart. Semak kedua-dua syarat dan hampiri dalam lingkungan 12 stud. Rig daripada Toolbox mungkin tidak mempunyai part ini, atau mungkin objek jenis lain yang dibungkus dalam folder.
Prompt muncul, tetapi menekan E tidak berbuat apa-apa
Pelayan tidak menemui perbualan untuk NPC ini, dan apabila game bermula, Output menunjukkan DialogueService: no conversation with a start line for Guide in DialogueData dengan nama NPC anda. Jadual dalam DialogueData mesti dinamakan tepat seperti model, termasuk huruf besar, dan mengandungi baris start.
Pilihan menutup tetingkap dan tidak beralih ke baris seterusnya
Output menunjukkan DialogueService: no line named tip for Guide in DialogueData dengan nama anda: next (atau failNext) pilihan itu menamakan baris yang tiada dalam jadual NPC ini. Nama baris sensitif kepada huruf besar dan kecil, jadi bandingkan ejaan dengan jadual, di sini tips.
Tetingkap berfungsi, tetapi tiada gelembung baris
Gelembung memerlukan part bernama Head terus di dalam model NPC dan bubble chat yang dihidupkan: dalam Explorer pilih BubbleChatConfiguration di bawah TextChatService dan semak bahawa Enabled ditandakan. Secara lalai ia dihidupkan.
Output menulis DialogueService: no Tool named Torch in ServerStorage.DialogueItems
Pelayan tidak dapat mencari item. Semak bahawa folder dalam ServerStorage bernama DialogueItems dan di dalamnya ada Tool (bukan Model atau Part) dengan nama tepat seperti item pilihan itu. Sehingga anda membaikinya, Guide menjawab dengan baris hasTorch, kerana tindakan gagal.
Output menulis DialogueService: no action named ...
action pilihan tidak sepadan dengan mana-mana kunci dalam jadual ACTIONS. Nama sensitif kepada huruf besar dan kecil: heal bukan Heal.
Buat dengan RoCode
Jika lebih mudah bagi anda menerangkan NPC daripada membinanya dengan tangan, RoCode boleh menulis skrip ini terus ke dalam place yang anda buka. Ia ejen AI bebas untuk Roblox Studio, bukan daripada Roblox: anda menulis dalam chat web, dan plugin Studionya mencipta dan menyunting skrip dalam Explorer anda.
Buat model Guide dalam Workspace.NPCs boleh bercakap: prompt Talk, tetingkap dialog dengan baris yang ditaip dan butang pilihan, gelembung di atas kepala, pilihan rawatan dengan cooldown 30 saat dan pilihan yang memberi alat Torch daripada ServerStorage sekali sahaja. Simpan perbualan dalam ModuleScript dan beri semua ganjaran pada pelayan.
- Boleh mengkaji model dahulu melalui Get Properties untuk membaca nilai utama seperti Anchored pada part-partnya dan WalkSpeed pada Humanoidnya. Taip / dalam chat untuk melampirkan laluan tepat ke model
- Menulis ModuleScript DialogueData, Script DialogueService dan LocalScript DialogueClient melalui Create Script
- Ia diarahkan untuk menyemak kompil setiap skrip yang ditulis melalui Check Script, yang mengkompilnya dalam Studio tanpa menjalankannya
- Menghantar perubahan dalam kelompok, dan setiap kelompok ialah titik undo dalam sejarah Studio
Dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.11 atau lebih baharu ia boleh mengawal watak ujian untuk menyemak bahawa game berfungsi, tetapi semasa bermain ia tidak mengambil tangkapan skrin, jadi hampiri NPC dan bercakap dengannya sendiri. Jika ada yang tidak berfungsi dengan betul, beritahu RoCode apa yang anda lihat: Check Output boleh membaca baris Server dan Client daripada playtest terakhir anda. NPC bercakap ialah satu sistem daripada banyak; halaman cara buat game Roblox dengan AI, satu sistem bagi setiap prompt menunjukkan cara semuanya digabungkan. Cara RoCode bersambung ke Studio.
Soalan lazim
Bagaimana membuat NPC bercakap dalam Roblox Studio?
Tambah ProximityPrompt pada NPC dan, apabila pemain mencetuskannya, tunjukkan baris NPC dalam tetingkap dialog, dalam gelembung atau kedua-duanya. Tiga skrip daripada panduan ini melakukan kedua-duanya dan menambah pilihan jawapan. Jika anda hanya perlukan gelembung, panggil TextChatService:DisplayBubble(npc.Head, "Hello!") daripada LocalScript apabila prompt dicetuskan, seperti dalam contoh NPC pada halaman Roblox tentang bubble chat.
Mana patut dipilih: objek Dialog atau GUI dialog sendiri?
Objek Dialog tidak memerlukan kod dan menunjukkan gelembung yang boleh diklik, yang cukup untuk teks hiasan. Event pilihannya hanya berlaku pada peranti pemain, jadi ia tidak boleh memberi ganjaran dengan selamat, dan secara lalai hanya seorang pemain boleh bercakap dengannya pada satu masa. Tetingkap sendiri, seperti dalam panduan ini, membolehkan pelayan memberi setiap ganjaran dan memberi setiap pemain perbualannya sendiri.
Bagaimana memberi pemain item daripada NPC?
Simpan Tool dalam ServerStorage, dan biarkan Script pelayan mengklonnya ke Backpack pemain apabila dia memilih pilihan itu, seperti yang dilakukan tindakan GiveItem. Semak bahawa pemain belum memilikinya, dan matikan CanBeDropped pada salinan itu supaya ia tidak boleh dibuang dan diminta semula. Jangan sekali-kali biarkan peranti pemain memberitahu item mana yang perlu diberi.
Bagaimana membuat tetingkap dialog dengan kesan mesin taip?
Letakkan seluruh baris dalam TextLabel, naikkan MaxVisibleGraphemes miliknya dari 0 beberapa aksara pada satu masa, dan pada akhirnya tetapkan -1 untuk menunjukkan semuanya. Halaman Roblox tentang animasi UI menggunakan sifat yang sama bersama utf8.graphemes. DialogueClient mengira berapa banyak aksara untuk ditunjukkan daripada masa yang berlalu, 45 sesaat, jadi kelajuan tidak bergantung pada kadar bingkai.
Bolehkah dua pemain bercakap dengan satu NPC pada masa yang sama?
Dengan skrip daripada panduan ini, ya: pelayan mengendalikan satu perbualan bagi setiap pemain, dan setiap pemain hanya melihat tetingkapnya sendiri. Objek Dialog terbina dalam berfungsi secara berbeza: dengan BehaviorType lalainya, SinglePlayer, seorang pemain bercakap pada satu masa, dan yang lain melihat pilihannya.
Perlukah menapis teks dialog NPC?
Baris yang anda tulis sendiri tidak perlu. Roblox meletakkan tanggungjawab ke atas anda untuk menapis teks yang dipaparkan yang tidak anda kawal secara langsung, contohnya apa yang ditaip pemain, perkataan yang disusun daripada aksara rawak, atau teks yang dimuatkan dari laman web luar. Jika NPC mengulangi sesuatu yang ditaip pemain, tapis bahagian itu.
Sumber dan bacaan lanjut
- Roblox Creator Docs: Proximity prompts (dalam bahasa Inggeris). mencipta prompt, MaxActivationDistance dan RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (dalam bahasa Inggeris). di mana prompt berfungsi, teks dan kekunci lalainya, Triggered dan semakan garis pandangan
- Roblox Creator Docs: Securing the client-server boundary (dalam bahasa Inggeris). ProximityPrompt sebagai permukaan serangan, semakan jarak dan kebenaran
- Roblox Engine API: Dialog (dalam bahasa Inggeris). BehaviorType dan event DialogChoiceSelected hanya pada client
- Roblox Engine API: TextChatService:DisplayBubble (dalam bahasa Inggeris). gelembung baris untuk NPC daripada skrip client
- Roblox Creator Docs: Customize bubble chat (dalam bahasa Inggeris). gelembung NPC dan BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (dalam bahasa Inggeris). teks paparan mana yang perlu ditapis
- Roblox Creator Docs: UI animation and tweens (dalam bahasa Inggeris). kesan mesin taip melalui MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (dalam bahasa Inggeris). apa yang dilakukan Backspace pada alat
- Roblox Engine API: UserInputService.PreferredInput (dalam bahasa Inggeris). cara mengenal pasti pemain dengan gamepad
- Roblox Creator Docs: Rig Generator (dalam bahasa Inggeris). memasukkan rig R15 atau R6
Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.