Tutorial · Sistem permainan

Cara buat dialog NPC dalam Roblox Studio

Dialog NPC dalam Roblox terdiri daripada tiga bahagian: prompt untuk memulakan perbualan, tetingkap yang menunjukkan kata-kata NPC dan butang dengan jawapan pemain, dan skrip yang memutuskan ke mana setiap jawapan membawa. Dalam panduan ini kita bina ketiga-tiganya: anda menulis perbualan sebagai jadual ringkas, pemain menekan E untuk bercakap, dan apa sahaja yang diberi oleh sesuatu jawapan (rawatan, item) diberi oleh pelayan, bukan oleh peranti pemain.

Dikemas kini 20 November 202620 minit bacaanDitulis oleh

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 DialogChoiceSelected objek 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 lama Chat sudah 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
  1. Cara ia berfungsi
  2. 1. Tambah NPC
  3. 2. Perbualan
  4. 3. Skrip pelayan
  5. 4. Tetingkap dialog
  6. Tindakan sendiri
  7. Tutorial lain
  8. Had perlindungan
  9. 5. Ujian
  10. Pengembangan
  11. Common errors
  12. Dengan RoCode
  13. Soalan lazim
  14. Sumber dan bacaan lanjut

Cara dialog NPC berfungsi

IlustrasiSetiap baris ditaip dalam tetingkap sementara keseluruhannya kelihatan dalam gelembung, pilihan muncul apabila baris selesai ditaip, dan pelayan memberi Torch apabila anda memilih "Got anything for the cave?".

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:

  1. Pemain menghampiri NPC dan menekan E pada prompt Talk miliknya. Event Triggered prompt berlaku pada pelayan bersama pemain itu.
  2. 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.
  3. LocalScript menaip baris dalam tetingkap dialog, menunjukkan gelembung di atas NPC, kemudian menambah satu butang bagi setiap pilihan.
  4. Pemain mengklik, mengetik atau memilih satu pilihan. Hanya nombornya dihantar kembali ke pelayan.
  5. 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.
Komponen NPC bercakap
ElemenDi mana ia beradaApa yang dibuat
Rig GuideWorkspace, dalam folder bernama NPCsNPC itu sendiri. Namanya memilih perbualan dan ditunjukkan pada prompt.
ModuleScript DialogueDataReplicatedStorageSemua baris yang boleh diucapkan NPC, pilihan di bawah setiap baris dan ke mana setiap pilihan membawa.
Script DialogueServiceServerScriptServiceMenambah prompt Talk, mengingati baris mana setiap pemain berada, menyemak setiap klik dan menjalankan tindakan.
RemoteEvent DialogueEventReplicatedStorage (dicipta oleh DialogueService)Membawa setiap baris kepada pemain, dan nombor pilihan yang dipilih kembali ke pelayan.
LocalScript DialogueClientStarterPlayer, StarterPlayerScriptsMelukis tetingkap, menaip baris, menunjukkan gelembung dan butang pilihan.
Tool Torch (pilihan)ServerStorage, dalam folder bernama DialogueItemsItem yang diberi oleh salah satu pilihan. Tiada apa-apa daripada ServerStorage dihantar kepada pemain.
Explorer apabila NPC sudah siap. Apabila game berjalan, DialogueService menambah RemoteEvent bernama DialogueEvent dalam ReplicatedStorage dan ProximityPrompt Talk bernama TalkPrompt dalam HumanoidRootPart setiap NPC.
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

  1. Pada tab Avatar atau Home, tekan Character untuk membuka Rig Generator. Pilih R15, bentuk badan dan gaya. Rig bernama Rig akan muncul dalam Workspace. Rig R6 berfungsi dengan skrip yang sama.
  2. Namakan semula ia kepada Guide. Nama itu penting: DialogueService mencari perbualan mengikut nama model, dan prompt menunjukkannya kepada pemain.
  3. 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.
  4. 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.
  5. Pilihan, untuk pilihan dengan item: letakkan kursor pada ServerStorage dan masukkan Folder bernama DialogueItems. Letakkan di dalamnya Tool bernama Torch dengan satu Part yang tidak anchored bernama Handle, 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
-- 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 baris start.
  • text ialah apa yang diucapkan NPC. choices ialah butang pemain, mengikut urutan. Tetingkap ada ruang untuk empat.
  • next menamakan baris yang perlu ditunjukkan selepas pilihan ini. Pilihan tanpa next, contohnya "Bye!", menamatkan perbualan. next atau failNext yang menamakan baris yang tiada dalam jadual juga menamatkannya, dengan amaran dalam Output.
  • action menamakan apa yang dilakukan pelayan, daripada jadual ACTIONS dalam DialogueService: di sini Heal atau GiveItem.
  • item diperlukan untuk GiveItem: ia nama Tool dalam ServerStorage, DialogueItems.
  • failNext ialah baris yang ditunjukkan sebagai ganti next apabila tindakan gagal dijalankan, supaya NPC tidak pernah mendakwa rawatan atau hadiah yang tidak berlaku.
Perbualan Guide, baris demi baris
BarisGuide berkataPilihan 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
-- 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 di permulaan DialogueService
TetapanNilai di siniApa yang diubah
TALK_DISTANCE12Berapa 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_CHOICES0.3Masa paling singkat antara dua klik yang diterima pelayan. Untuk klik yang lebih pantas, baris yang sama dihantar semula sebagai ganti jawapan.
HEAL_COOLDOWN_SECONDS30Berapa 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:

Apa yang disemak DialogueService pada setiap klik
SemakanKodJika gagal
Pemain berada dalam perbualanconversations[player]Klik diabaikan.
Pilihan ialah integertypeof dan math.floorDiabaikan. String, jadual, pecahan dan NaN berhenti di sini.
0 bermaksud pemain menekan XchoiceIndex == 0Perbualan tamat.
Masih hidup dan tidak lebih jauh daripada 16 stud (12 tambah 4)isClosePerbualan tamat, dan tetingkap ditutup.
Sekurang-kurangnya 0.3 saat sejak klik terakhir yang diterimaconversation.lastChoiceBaris yang sama dihantar semula, jadi tetingkap mendapat butang baharu dan tidak menunggu selama-lamanya.
Pilihan wujud pada baris yang dibaca pemain iniline.choices[choiceIndex]Diabaikan.
Tindakan berjayasetiap tindakan memulangkan true atau falseBaris 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
-- 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 menggunakan TextScaled, yang mengecilkan teks supaya muat dalam labelnya pada skrin telefon yang kecil, dan UITextSizeConstraint menghalangnya membesar melebihi 20 piksel pada skrin besar. UIGridLayout menyusun pilihan dua kali dua. ResetOnSpawn bernilai 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 MaxVisibleGraphemes menentukan berapa banyak aksara yang kelihatan; ini sifat yang sama yang digunakan oleh contoh mesin taip Roblox sendiri bersama utf8.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 lineNumber menghalang 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. Activated berlaku untuk klik tetikus, ketikan pada telefon dan butang A pada gamepad. Gamepad hanya boleh menekan butang yang dipilih, jadi apabila PreferredInput menyatakan pemain menggunakan gamepad, skrip memilih pilihan pertama melalui GuiService.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:

  1. Tambah entri bernama StartQuest dalam ACTIONS. Semak dahulu, kemudian ubah: jika player:GetAttribute("Quest") sudah ditetapkan, pulangkan false; jika tidak, panggil player:SetAttribute("Quest", "Cave") dan pulangkan true.
  2. Dalam DialogueData, beri pilihan action = "StartQuest", baris next untuk kejayaan dan baris failNext untuk kegagalan, contohnya "You are already on a quest."
  3. 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 StartQuest akan muncul dalam Output, dan perbualan akan beralih ke baris failNext.

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.

Teknik biasa dalam tutorial dialog NPC dan apa yang dibuat panduan ini sebagai gantinya
TutorialMasalahPanduan ini
Menggunakan objek Dialog, dan Script pelayan mendengar DialogChoiceSelected untuk memberi ganjaranRujukan 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 LocalScriptPerubahan 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 clientPenipu 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 dicetuskanPanduan 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 gelungwait 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.

Apa yang boleh dicuba penipu dan apa yang dibuat DialogueService terhadapnya
Penipu cubaHasilSebab
Mencetuskan prompt Talk dari hujung peta yang lainTiada apa-apa berlakustartConversation menyemak bahawa dia tidak lebih jauh daripada 16 stud (12 tambah 4).
Menghantar pilihan 99, string, pecahan atau NaNDiabaikanIa bukan integer, atau pilihan itu tiada pada baris yang dibacanya.
Menghantar nama ganjaran atau id barisTidak pernah dibacaPelayan hanya membaca nombor pilihan. Ganjaran diambil daripada medan item dan action salinan baris di pelayan.
Mengklik sepantas yang dibenarkan rangkaianSatu klik setiap 0.3 saat bagi setiap perbualanKlik 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 perbualanMustahilItem hanya diberi melalui pilihan pada baris yang diketahui pelayan sedang dibaca pemain.
Mengumpul banyak oborSatu pada satu masaPelayan 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 rawatanSatu rawatan setiap 30 saatCooldown disimpan pada pelayan bagi setiap pemain, dan NPC memberitahunya dengan baris healTooSoon.
Pergi dan biarkan tetingkap terbukaDitutup dalam masa setengah saatPelayan menyemak setiap perbualan yang terbuka dua kali sesaat.
Membaca seluruh perbualan, termasuk baris yang belum dicapaiBolehDialogueData 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

  1. Tekan Play (F5) dan hampiri Guide. Dalam lingkungan 12 stud, prompt Talk dengan nama Guide muncul. Tekan E.
  2. Tetingkap menunjukkan "Guide", menaip baris alu-aluan dan kemudian menunjukkan empat butang. Baris yang sama muncul dalam gelembung di atas kepala NPC.
  3. Pilih "Any tips?", kemudian "Anything else?": anda kembali ke baris pertama. Pilih "Bye!": tetingkap ditutup, dan prompt Talk kembali.
  4. 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.
  5. 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.
  6. Mulakan perbualan dan berjalan pergi. Tetingkap ditutup lebih kurang apabila anda berada 16 stud dari Guide.
  7. 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.
  8. 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.
  9. 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.

Anda tulis

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.

RoCode buat
  • 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

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.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.