Tutorial · Sistem game

Cara membuat dialog NPC di Roblox Studio

Dialog NPC di Roblox terdiri dari tiga bagian: prompt untuk mulai bicara, kotak yang menampilkan ucapan NPC dengan tombol untuk jawaban pemain, dan script yang memutuskan ke mana setiap jawaban mengarah. Panduan ini membuat ketiganya: kamu menulis percakapan sebagai table sederhana, pemain menekan E untuk bicara, dan apa pun yang diberikan sebuah jawaban (heal, item) diserahkan oleh server, tidak pernah oleh perangkat pemain.

Diperbarui 12 November 202619 menit bacaDitulis oleh

Singkatnya

Taruh model NPC kamu di folder bernama NPCs di Workspace dan tulis percakapannya di ModuleScript di ReplicatedStorage: setiap baris punya teks NPC dan daftar pilihan yang mengarah ke baris lain. Sebuah Script di ServerScriptService menambahkan ProximityPrompt ("Talk") ke setiap NPC, mengingat baris mana yang sedang dibaca tiap pemain dan mengirimnya dengan RemoteEvent. Sebuah LocalScript menampilkan teksnya dan satu tombol per pilihan, dan hanya mengirim balik nomor tombol yang ditekan.

  • Berikan hadiah di server. Event DialogChoiceSelected milik objek Dialog bawaan hanya terjadi di client, jadi Script server tidak pernah mendengarnya, dan heal atau item yang diberikan di LocalScript hanya mengubah salinan game milik pemain itu sendiri.
  • Tampilkan speech bubble dengan TextChatService:DisplayBubble(npc.Head, text) dari LocalScript. Service Chat yang lama sudah deprecated dan digantikan TextChatService.
  • Baris yang kamu tulis sendiri tidak perlu difilter. Aturan Roblox adalah memfilter teks tampil apa pun yang tidak kamu kendalikan secara eksplisit, seperti yang diketik pemain.
Di halaman ini
  1. Cara kerjanya
  2. 1. Tambahkan NPC
  3. 2. Percakapan
  4. 3. Script server
  5. 4. Kotak dialog
  6. Aksimu sendiri
  7. Tutorial lain
  8. Batas exploit
  9. 5. Tes
  10. Mengembangkannya
  11. Error umum
  12. Dengan RoCode
  13. Pertanyaan umum
  14. Sumber dan bacaan lanjutan

Cara kerja dialog NPC

IlustrasiSetiap baris diketik di kotak sementara seluruh barisnya tampil di speech bubble, pilihannya muncul begitu baris selesai diketik, dan server menyerahkan Torch saat kamu memilih "Got anything for the cave?".

NPC berbicara yang berfungsi di game live dibagi antara server dan perangkat setiap pemain. Perangkat menggambar kotak dan tombolnya. Server, satu-satunya sisi yang bisa kamu percaya, tahu baris mana yang sedang dibaca tiap pemain dan memutuskan apa yang dilakukan setiap jawaban. Satu giliran percakapan berjalan seperti ini:

  1. Pemain berjalan mendekati NPC dan menekan E pada prompt Talk-nya. Event Triggered milik prompt terjadi di server dengan pemain itu.
  2. Script server mengecek bahwa pemain cukup dekat, mencatat bahwa mereka ada di baris bernama start, dan mengirim teks baris itu beserta label pilihannya hanya ke pemain itu.
  3. LocalScript mengetik barisnya ke kotak dialog, menampilkan speech bubble di atas NPC, lalu menambahkan satu tombol per pilihan.
  4. Pemain mengklik, mengetuk atau memilih sebuah pilihan. Hanya nomornya yang kembali ke server.
  5. Server mencari nomor itu di baris yang diketahuinya sedang dibaca pemain, menjalankan aksi pilihan itu kalau ada (heal, item), dan mengirim baris berikutnya atau menutup kotaknya.
Bagian-bagian NPC yang berbicara
BagianTempatnyaFungsinya
Rig GuideWorkspace, di folder bernama NPCsNPC-nya. Namanya menentukan percakapannya dan ditampilkan di prompt.
ModuleScript DialogueDataReplicatedStorageSetiap baris yang bisa diucapkan NPC, pilihan di bawah setiap baris dan ke mana setiap pilihan mengarah.
Script DialogueServiceServerScriptServiceMenambahkan prompt Talk, mengingat baris mana yang sedang dibaca tiap pemain, mengecek setiap klik dan menjalankan aksinya.
RemoteEvent DialogueEventReplicatedStorage (dibuat DialogueService)Membawa setiap baris ke pemain, dan nomor pilihan yang diklik kembali ke server.
LocalScript DialogueClientStarterPlayer, StarterPlayerScriptsMenggambar kotaknya, mengetik barisnya, menampilkan speech bubble dan tombol pilihan.
Tool Torch (opsional)ServerStorage, di folder bernama DialogueItemsItem yang diberikan salah satu pilihan. Tidak ada isi ServerStorage yang dikirim ke pemain.
Explorer saat NPC selesai. Saat game berjalan, DialogueService menambahkan RemoteEvent bernama DialogueEvent ke ReplicatedStorage dan ProximityPrompt Talk bernama TalkPrompt ke HumanoidRootPart setiap NPC.
Workspace
  NPCs Folder new
    Guide Model new
      Humanoid Humanoid
      HumanoidRootPart Part
      Head, UpperTorso, LowerTorso ... (bagian tubuh)
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: Tambahkan NPC

  1. Di tab Avatar atau Home, klik Character untuk membuka Rig Generator. Pilih R15, bentuk tubuh dan gayanya. Rig bernama Rig muncul di Workspace. Rig R6 berfungsi dengan script yang sama.
  2. Ganti namanya menjadi Guide. Namanya penting: DialogueService mencari percakapan berdasarkan nama model, dan prompt menampilkannya ke pemain.
  3. Buka isi rig, pilih HumanoidRootPart-nya dan centang Anchored di jendela Properties. Part yang di-anchor tidak pernah bergerak karena fisika, jadi NPC berdiri di tempat kamu menaruhnya dan pemain tidak bisa mendorongnya.
  4. Arahkan kursor ke Workspace di Explorer, klik tombol + dan sisipkan Folder bernama NPCs. Seret Guide ke dalamnya, dan taruh rig di tempat yang bisa didatangi pemain.
  5. Opsional, untuk pilihan item: arahkan kursor ke ServerStorage dan sisipkan Folder bernama DialogueItems. Taruh Tool bernama Torch di dalamnya, dengan satu Part yang tidak di-anchor bernama Handle, yaitu part yang dipegang karakter. PointLight di dalam Handle membuatnya menyala.

Nama membedakan huruf besar dan kecil, jadi ketik NPCs, Guide, DialogueItems dan Torch persis seperti yang ditunjukkan. Model apa pun dengan Humanoid dan HumanoidRootPart bisa menjadi NPC, termasuk yang dari Toolbox, selama berada langsung di dalam folder NPCs.

Langkah 2: Tulis percakapannya

Arahkan kursor ke ReplicatedStorage, sisipkan ModuleScript bernama DialogueData dan tempel ini. Module ini tidak berisi logika, hanya kata-kata dan cara mereka terhubung, jadi inilah file yang paling sering kamu edit.

ModuleScript di ReplicatedStorage bernama DialogueData
-- ModuleScript di ReplicatedStorage bernama DialogueData.
-- Setiap percakapan, dengan key nama NPC di Workspace.NPCs. Setiap baris punya
-- teks NPC dan pilihan pemain. Sebuah pilihan bisa mengarah ke baris lain (next),
-- mengakhiri pembicaraan (tanpa next) dan meminta server melakukan sesuatu (action). Kalau server
-- tidak bisa melakukan aksinya, yang ditampilkan adalah baris failNext, bukan next.

export type Choice = {
	text: string,
	next: string?, -- baris yang ditampilkan setelah pilihan ini; nil mengakhiri percakapan
	action: string?, -- aksi server dari table ACTIONS milik DialogueService
	item: string?, -- untuk aksi GiveItem: nama Tool di ServerStorage.DialogueItems
	failNext: string?, -- baris yang ditampilkan sebagai ganti next saat aksinya tidak bisa dilakukan
}

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 bagian atas menjelaskan seperti apa bentuk sebuah baris dan sebuah pilihan. Baris itu tidak mengubah apa pun saat game berjalan; isinya menjelaskan datamu supaya type checker bisa mengeceknya.

Cara bagian-bagiannya terhubung:

  • Setiap NPC punya table yang dinamai sesuai modelnya di folder NPCs, di sini Guide. Setiap percakapan mulai di baris bernama start.
  • text adalah ucapan NPC. choices adalah tombol pemain, secara berurutan. Kotaknya muat empat.
  • next menyebut baris yang ditampilkan setelah pilihan itu. Pilihan tanpa next, seperti "Bye!", mengakhiri percakapan. next atau failNext yang menyebut baris yang tidak ada di table juga mengakhirinya, dengan peringatan di Output.
  • action menyebut sesuatu yang dilakukan server, dari table ACTIONS di DialogueService: di sini Heal atau GiveItem.
  • item dipakai GiveItem: nama sebuah Tool di ServerStorage, DialogueItems.
  • failNext adalah baris yang ditampilkan sebagai ganti next saat aksinya tidak bisa dilakukan, jadi NPC tidak pernah mengaku memberi heal atau hadiah yang tidak terjadi.
Percakapan Guide, baris demi baris
BarisGuide berkataPilihan, dan ke mana arahnya
start"Welcome to the village! What can I do for you?""Any tips?" mengarah ke tips. "I'm hurt. Can you help?" memberi heal, lalu healed (atau healTooSoon). "Got anything for the cave?" memberi Torch, lalu torch (atau hasTorch). "Bye!" mengakhiri.
tips"Stay off the red bricks, and come back if you get hurt.""Anything else?" kembali ke start. "Thanks!" mengakhiri.
healed"There you go, good as new.""Thank you!" mengakhiri.
torch"Take this torch. The cave is dark.""Thanks!" mengakhiri.
healTooSoon"I healed you a moment ago. Come back in a little while.""OK" mengakhiri.
hasTorch"You already have my torch. Keep it lit!""Will do!" mengakhiri.

Hanya server yang membaca module ini. LocalScript tidak pernah me-require-nya: server mengirim setiap baris saat pemain sampai ke baris itu. Namun module di ReplicatedStorage tetap disalin ke perangkat setiap pemain, jadi kalau sebuah percakapan berisi spoiler (jawaban teka-teki, misalnya), pindahkan DialogueData ke ServerStorage. Lalu, di baris require milik DialogueService, ganti ReplicatedStorage dengan ServerStorage, sehingga seluruh barisnya berbunyi local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.

Langkah 3: Tambahkan script server

Arahkan kursor ke ServerScriptService, sisipkan Script bernama DialogueService dan tempel kode di bawah. Inilah satu-satunya tempat percakapan bergerak maju dan satu-satunya tempat hadiah diberikan.

Script di ServerScriptService bernama DialogueService
-- Script di ServerScriptService bernama DialogueService.
-- Menambahkan prompt Talk ke setiap NPC di Workspace.NPCs dan menjalankan setiap percakapan.
-- Perangkat pemain hanya menampilkan teksnya dan mengirim balik nomor pilihan
-- yang mereka klik. Server tahu baris mana yang sedang dibaca tiap pemain, mengecek pilihannya
-- dan jaraknya, dan merupakan satu-satunya sisi yang memberi heal atau item.

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

-- Bentuk yang sama seperti di DialogueData, supaya type checker Studio juga mengenalnya di sini
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: jangkauan prompt, dan seberapa dekat pemain harus tetap berada
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30

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

-- Script ini membuat DialogueEvent sendiri, jadi jangan menambahkannya 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 -- tidak ada karakter, karakternya mati, atau NPC-nya sudah tidak ada
	end
	-- sedikit ruang tambahan, karena posisi pemain sampai ke server agak terlambat
	return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end

-- Yang dilakukan server saat sebuah pilihan punya aksi. Masing-masing mengembalikan true kalau berhasil.
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 -- baru saja di-heal
		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 mereka sudah punya satu
		end
		local item = template:Clone() :: Tool
		item.CanBeDropped = false -- supaya tidak ada yang bisa menjatuhkannya lalu minta 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 berbicara, tidak ada baris "start" untuk NPC ini, 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 nomor choiceIndex (0 berarti mereka menutup kotaknya)
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 cepat. Kirim baris yang sama lagi, karena kotaknya sudah mengunci
		-- tombolnya setelah klik dan kalau tidak akan menunggu jawaban selamanya.
		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 -- tidak ada pilihan seperti itu di baris yang sedang 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 -- misalnya "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 di 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 tidak didengarkan apa pun
	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 kotaknya untuk siapa pun yang berjalan pergi atau mati di tengah percakapan
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 yang membuat RemoteEvent DialogueEvent saat game dimulai, jadi tidak ada yang perlu disisipkan ke ReplicatedStorage secara manual. Kalau kamu sudah membuat RemoteEvent dengan nama itu, hapus: LocalScript bisa menemukan milikmu, yang tidak didengarkan apa pun di server.

Pengaturan di bagian atas DialogueService
PengaturanNilai di siniYang diubahnya
TALK_DISTANCE12Seberapa dekat, dalam stud, pemain harus berada supaya prompt Talk muncul. Server membiarkan mereka menjauh 4 stud lagi sebelum menutup kotaknya, karena posisi mereka sampai ke server agak terlambat.
MIN_SECONDS_BETWEEN_CHOICES0.3Waktu terpendek antara dua klik yang diterima server. Klik yang lebih cepat mendapat baris yang sama dikirim lagi, bukan jawaban.
HEAL_COOLDOWN_SECONDS30Lama setiap pemain menunggu di antara heal dari aksi Heal.

Server menyimpan satu entri per pemain di conversations: NPC mana yang sedang mereka ajak bicara, baris mana yang sedang mereka baca dan kapan klik terakhir mereka diterima. Saat prompt Talk terpicu, startConversation membuat entri itu hanya kalau pemain belum sedang berbicara, NPC-nya punya baris start dan pemain hidup serta dalam jangkauan. Setelah itu, setiap klik melewati pengecekan ini:

Yang dicek DialogueService pada setiap klik
PengecekanKodeKalau gagal
Pemain sedang dalam percakapanconversations[player]Kliknya diabaikan.
Pilihannya bilangan bulattypeof dan math.floorDiabaikan. String, table, pecahan dan NaN semuanya berhenti di sini.
0 berarti pemain menekan XchoiceIndex == 0Percakapan berakhir.
Hidup dan masih dalam 16 stud (12 ditambah 4)isClosePercakapan berakhir dan kotaknya tertutup.
Sedikitnya 0,3 detik sejak klik terakhir yang diterimaconversation.lastChoiceBaris yang sama dikirim lagi, jadi kotaknya mendapat tombol baru dan tidak menunggu selamanya.
Pilihannya ada di baris yang sedang dibaca pemain iniline.choices[choiceIndex]Diabaikan.
Aksinya berhasilsetiap aksi mengembalikan true atau falseBaris failNext ditampilkan sebagai ganti next.

Prompt ditaruh di HumanoidRootPart NPC, karena ProximityPrompt berfungsi saat berada di dalam part (atau attachment, atau model dengan PrimaryPart) di Workspace. RequiresLineOfSight-nya menyala secara default, yang menyembunyikan prompt setiap kali ada yang menghalangi pandangan dari kamera ke part itu. Roblox mengecualikan part milik prompt sendiri dari pengecekan itu, tapi tidak bagian tubuh lainnya, dan HumanoidRootPart berada di dalam torso, jadi script mematikan line of sight. Prompt-nya bernama TalkPrompt, dan script menghapus TalkPrompt yang sudah ada di part itu sebelum menambahkan miliknya: salinan NPC yang dibuat saat game berjalan datang dengan prompt aslinya, dan tidak ada yang mendengarkan prompt salinan. Kalau DialogueData tidak punya percakapan dengan baris start untuk nama NPC itu, Output menampilkan peringatan yang menyebut nama NPC-nya.

Sebuah loop mengecek setiap percakapan yang terbuka dua kali per detik dan menutupnya saat pemain berada lebih dari 16 stud jauhnya atau karakternya mati, jadi pemain yang mati di tengah percakapan tidak respawn dengan kotak yang masih terbuka. PlayerRemoving membersihkan kedua table saat seseorang keluar.

Langkah 4: Tambahkan kotak dialog

Buka StarterPlayer, arahkan kursor ke StarterPlayerScripts, sisipkan LocalScript bernama DialogueClient dan tempel ini. Script ini membuat kotak dialog dengan kode, jadi tidak ada GUI yang perlu digambar secara manual.

LocalScript di StarterPlayer > StarterPlayerScripts bernama DialogueClient
-- LocalScript di StarterPlayer > StarterPlayerScripts bernama DialogueClient.
-- Menggambar percakapan yang dikirim server: nama NPC, barisnya yang diketik huruf
-- demi huruf, speech bubble di atas kepalanya dan satu tombol per pilihan. Mengklik sebuah
-- pilihan hanya mengirim nomornya; server yang memutuskan apa yang terjadi berikutnya.

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)

-- Kotak dialognya, dibuat dengan kode
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 ke atas, supaya tool bar Roblox tidak pernah menutupi pilihannya
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 di layar ponsel 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 membesar melewati 20 piksel di layar 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 -- naik di setiap baris baru, supaya loop pengetikan 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 -- diubah hanya di perangkat ini
	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()

	-- Speech bubble di atas NPC (DisplayBubble hanya berfungsi di LocalScript)
	local head = npc:FindFirstChild("Head")
	if head then
		TextChatService:DisplayBubble(head, text)
	end

	-- Ketik barisnya, huruf demi huruf. Hitungannya berasal dari waktu yang berlalu,
	-- jadi kecepatannya sama di frame rate berapa pun.
	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 yang lebih baru atau penutupan menggantikan yang ini
		end
		shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
		lineLabel.MaxVisibleGraphemes = shown
	end
	lineLabel.MaxVisibleGraphemes = -1

	-- Satu tombol per pilihan; server hanya pernah menerima nomor tombolnya
	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 per baris
				dialogueEvent:FireServer(index)
			end
		end)
		if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
			GuiService.SelectedObject = button -- supaya controller bisa memilih sebuah pilihan
		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, ukuran dan LETTERS_PER_SECOND bebas kamu ubah. Biarkan dua handler terakhir apa adanya: itulah satu-satunya cara kotak berkomunikasi dengan server.

Fungsi setiap bagian DialogueClient:

  • Kotaknya. Sebuah ScreenGui dengan Frame yang ditambatkan di tengah bawah layar, 60% lebarnya dan 34% tingginya, dibatasi 720 kali 300 piksel oleh UISizeConstraint supaya tidak melebar di monitor lebar. Baris NPC memakai TextScaled, yang mengecilkan teks supaya muat di dalam label-nya di layar ponsel yang kecil, dan UITextSizeConstraint mencegahnya membesar melewati 20 piksel di layar besar. UIGridLayout menata pilihannya dua kali dua. ResetOnSpawn bernilai false karena LocalScript ini berjalan sekali per sesi: kotak yang terhapus saat respawn tidak akan pernah kembali.
  • Efek mesin tik. Seluruh baris masuk ke TextLabel sekaligus, dan MaxVisibleGraphemes menentukan berapa karakter yang tampil, properti yang sama yang dipakai contoh typewriter Roblox sendiri dengan utf8.graphemes. Roblox menata teksnya seolah setiap karakter terlihat, jadi kata-kata tidak melompat ke baris baru atau berubah ukuran saat muncul. Script menghitung berapa yang ditampilkan dari waktu yang sudah berlalu, 45 per detik, jadi kecepatannya sama di frame rate berapa pun, lalu mengatur propertinya ke -1, yang menampilkan semuanya.
  • Tombolnya. Tombol muncul begitu baris selesai diketik. Masing-masing hanya mengirim nomornya, sekali: pengecekan lineNumber mencegah klik ganda mengirim dua kali, dan kotaknya lalu menunggu baris berikutnya dari server.
  • Speech bubble. TextChatService:DisplayBubble(head, text) menaruh barisnya di chat bubble di atas Head NPC. Roblox hanya mengizinkannya di script client, dan bubble chat menyala secara default. Karena perangkat pemain ini yang menggambarnya, bubble itu hanya milik mereka.
  • Prompt-nya. Selagi pemain berbicara, salinan prompt Talk milik mereka (dicari lewat namanya, TalkPrompt) dimatikan, supaya tidak menumpuk di atas percakapan. Pemain lain masih melihat milik mereka.
  • Setiap perangkat. Activated terjadi untuk klik mouse, ketukan di ponsel dan tombol A di controller. Controller hanya bisa menekan tombol yang sedang terpilih, jadi saat PreferredInput menyatakan pemain memakai gamepad, script memilih pilihan pertama dengan GuiService.SelectedObject.
  • Tombol X. Tombol ini mengirim 0, yang dianggap server sebagai "akhiri percakapan", dan langsung menutup kotaknya.

Tambahkan aksimu sendiri

Aksi adalah function di table ACTIONS di dekat bagian atas DialogueService. Function itu menerima pemain dan pilihannya, dan mengembalikan true kalau tugasnya berhasil. Untuk menambah satu, misalnya quest yang diberikan NPC:

  1. Tambahkan entri ke ACTIONS bernama StartQuest. Cek dulu, baru ubah: kalau player:GetAttribute("Quest") sudah terisi, kembalikan false; kalau belum, panggil player:SetAttribute("Quest", "Cave") dan kembalikan true.
  2. Di DialogueData, beri sebuah pilihan action = "StartQuest", baris next untuk saat berhasil dan baris failNext untuk saat tidak, misalnya "You are already on a quest."
  3. Tekan Play dan ambil pilihan itu dua kali. Kalau nama di DialogueData tidak cocok dengan key di ACTIONS (huruf kapital dihitung), Output menampilkan DialogueService: no action named StartQuest dan percakapan pindah ke baris failNext.

Aturan menulis aksi:

  • Lakukan pengecekan dan perubahannya di dalam aksi, di server. Satu-satunya yang dikirim perangkat pemain adalah nomor pilihan.
  • Baca apa yang dibutuhkan aksi dari pilihannya (seperti item) atau dari state milik server sendiri, jangan pernah dari remote.
  • Batasi apa pun yang berharga di dalam aksi itu sendiri, seperti Heal yang menyimpan cooldown 30 detiknya sendiri di lastHeal. Batas klik 0,3 detik hanya memperlambat klik; itu tidak mencegah pemain melewati pilihan yang sama berulang-ulang.
  • Untuk membuka jendela lain, misalnya toko, sebuah aksi bisa memicu RemoteEvent ke pemain itu dan mengembalikan true. Apa pun yang terjadi di jendela itu tetap butuh pengecekan servernya sendiri, seperti di NPC penjaga toko.

Kesalahan di tutorial dialog NPC lain

Kalau kamu membandingkan panduan ini dengan video atau postingan forum, inilah perbedaan yang penting, beserta alasan tiap pola bermasalah.

Pola umum di tutorial dialog NPC, dan apa yang dilakukan panduan ini sebagai gantinya
TutorialnyaMasalahnyaPanduan ini
Memakai objek Dialog, dengan Script server yang mendengarkan DialogChoiceSelected untuk memberi hadiahReferensi Roblox menyebut event itu hanya di sisi client dan tidak akan terjadi di server, jadi hadiahnya tidak pernah datang.Pilihannya sampai ke server sebagai angka, dan server yang menjalankan hadiahnya.
Memberi hadiah dari LocalScriptPerubahan yang dibuat LocalScript tetap di satu perangkat itu (lihat apa yang direplikasi, dalam bahasa Inggris), dan cheater bisa menjalankan kode yang sama kapan pun mereka mau.Setiap aksi ada di DialogueService.
Membuat NPC berbicara dengan game:GetService("Chat"):Chat(head, text)Service Chat sudah deprecated dan digantikan TextChatService.TextChatService:DisplayBubble di LocalScript.
Mengirim nama hadiah atau id baris berikutnya dari clientCheater bisa mengirim nama item apa pun, atau langsung melompat ke baris yang memberi hadiah.Client hanya mengirim nomor pilihan. Server mencarinya di baris yang diketahuinya sedang dibaca pemain.
Tidak mengecek apa pun setelah prompt terpicuPanduan keamanan Roblox mencantumkan ProximityPrompt di samping remote sebagai sesuatu yang bisa disalahgunakan client, dan meminta pengecekan apakah pemain cukup dekat sebelum bertindak.Jaraknya dicek saat percakapan dimulai, pada setiap klik dan dua kali per detik selama terbuka.
Mengetik teksnya dengan wait() dalam loopwait global sudah deprecated dan digantikan task.wait.Menghitung huruf yang ditampilkan dari os.clock(), menunggu dengan task.wait().

Apa yang bisa dan tidak bisa dipalsukan pemain

Anggap cheater mengendalikan segala sesuatu di perangkatnya sendiri. Mereka bisa membaca LocalScript kamu dan apa pun di ReplicatedStorage, memicu DialogueEvent dengan argumen apa pun sesering yang mereka mau, dan memicu prompt Talk dari kode, yang diperingatkan panduan keamanan Roblox. DialogueService menjawabnya dengan pengecekan server sejenis yang dibahas di validasi argumen RemoteEvent. Inilah yang mereka dapatkan dari semua itu.

Apa yang bisa dicoba cheater, dan apa yang dilakukan DialogueService
Cheater mencobaHasilAlasannya
Memicu prompt Talk dari seberang mapTidak terjadi apa-apastartConversation mengecek bahwa mereka berada dalam 16 stud (12 ditambah 4).
Mengirim pilihan 99, string, pecahan atau NaNDiabaikanItu bukan bilangan bulat, atau tidak ada pilihan seperti itu di baris yang sedang mereka baca.
Mengirim nama hadiah atau id barisTidak pernah dibacaServer hanya membaca nomor pilihan. Hadiah berasal dari field item dan action di salinan baris milik server.
Mengklik secepat yang diizinkan jaringanSatu klik per 0,3 detik per percakapanKlik yang lebih cepat mendapat barisnya sendiri dikirim balik. Mengakhiri dan memulai lagi pembicaraan melewati jeda itu, dan itulah sebabnya Heal dan GiveItem menyimpan batasnya sendiri.
Meminta torch tanpa berbicaraMustahilItem hanya datang dari pilihan di baris yang diketahui server sedang mereka baca.
Mengumpulkan setumpuk torchSatu per satuServer lebih dulu mengecek Backpack dan karakter mereka untuk Torch, dan torch yang diberikannya tidak bisa dijatuhkan, jadi tidak bisa di-farm dengan menjatuhkannya lalu meminta lagi.
Men-spam baris healSatu heal setiap 30 detikCooldown-nya disimpan per pemain di server, dan NPC mengatakannya dengan baris healTooSoon.
Berjalan pergi dan membiarkan kotaknya terbukaTertutup dalam setengah detikServer mengecek setiap percakapan yang terbuka dua kali per detik.
Membaca seluruh percakapan, termasuk baris yang belum mereka capaiMungkinDialogueData ada di ReplicatedStorage, yang disalin ke setiap perangkat. Pindahkan ke ServerStorage kalau itu penting (lihat Langkah 2).

Satu batasan layak dijawab terus terang: cheater yang berjalan mendekati Guide dan mengambil pilihannya mendapat persis apa yang didapat pemain jujur. Server mengendalikan seberapa sering dan dari mana, bukan siapa. Apa pun yang langka, seperti hadiah yang hanya boleh diklaim sekali oleh tiap pemain, butuh pengecekan yang dimiliki server, seperti atribut yang diatur saat diklaim atau flag yang disimpan dengan data store.

Langkah 5: Tes

  1. Tekan Play (F5) dan berjalanlah ke Guide. Dalam jarak 12 stud, muncul prompt Talk dengan nama Guide. Tekan E.
  2. Kotaknya menampilkan "Guide", mengetik baris sambutan lalu menampilkan empat tombol. Baris yang sama muncul di speech bubble di atas kepala NPC.
  3. Pilih "Any tips?", lalu "Anything else?": kamu kembali ke baris pertama. Pilih "Bye!": kotaknya tertutup dan prompt Talk kembali.
  4. Lukai dirimu dulu: klik toggle Client/Server untuk pindah ke Server, pilih Humanoid karaktermu di Workspace, atur Health ke 50 di jendela Properties dan pindah kembali ke Client. Karakter pemain memulihkan 1% MaxHealth-nya setiap detik, jadi langsung bicara dengan Guide dan pilih "I'm hurt. Can you help?": health kamu langsung penuh. Bicara lagi dalam 30 detik dan pilih itu lagi: tidak ada heal, dan Guide bilang baru saja memberimu heal.
  5. Pilih "Got anything for the cave?": Torch muncul di hotbar kamu. Pegang dan tekan Backspace: Torch tetap di tanganmu. Minta lagi: tidak ada torch kedua, dan Guide bilang kamu sudah memilikinya.
  6. Mulai bicara, lalu berjalan pergi. Kotaknya tertutup kira-kira begitu kamu berada 16 stud dari Guide.
  7. Pilih Server & Clients di dropdown mode tes, atur 2 client dan tekan Play. Kedua pemain bisa berbicara dengan Guide pada saat yang sama, masing-masing di barisnya sendiri.
  8. Cek controller dengan Controller Emulator (Controller, di tab Emulation) saat playtest. Pakai pad yang diemulasikan untuk berjalan mendekat dan menekan tombol prompt (ButtonX secara default): saat pilihannya muncul, yang pertama sudah terpilih, dan A mengambilnya.
  9. Cek layar ponsel dengan Device Simulator milik Studio (masih beta saat panduan ini ditulis: nyalakan New Device Simulator di File, Beta Features, dan restart Studio). Pilih sebuah ponsel, klik Rotate sampai posisinya landscape, tekan Play, berjalanlah ke Guide dan ketuk prompt Talk. Pilih "Any tips?": seluruh barisnya tampil di atas tombol pilihan, dengan teks lebih kecil kalau perlu, tanpa menabrak tombolnya.

Biarkan jendela Output terbuka (menu Window, lalu Output) sepanjang waktu. Script-script ini tidak mencetak apa pun saat berfungsi, jadi error merah atau peringatan yang diawali DialogueService: adalah masalah sungguhan. Lihat Error umum.

Mengembangkannya

Lebih banyak NPC dan percakapan yang lebih panjang

Tambahkan rig lain ke folder NPCs dengan namanya sendiri, dan table dengan nama yang sama di DialogueData yang punya baris start. DialogueService menambahkan prompt Talk ke setiap model di folder yang punya HumanoidRootPart, termasuk yang ditambahkan saat game berjalan; salinan NPC mendapat prompt baru sebagai ganti prompt yang ikut tersalin. Dua NPC dengan nama yang sama memakai table yang sama. Baris bisa terhubung dalam urutan apa pun, dan sebuah pilihan bisa mengarah kembali ke baris sebelumnya, seperti "Anything else?". Jaga setiap baris paling banyak empat pilihan, karena kotaknya menata pilihan dua kali dua.

Baris yang bergantung pada progres

Untuk menyapa pemain yang kembali dengan cara berbeda, pilih baris pertama dari sesuatu yang dimiliki server. Di startConversation, pilih dengan local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", cek bahwa barisnya ada seperti cara script mengecek lines.start, dan pakai firstLine sebagai ganti "start" saat percakapan dibuat. Atur atributnya di sebuah aksi, dan tambahkan baris welcomeBack ke table milik Guide. Atribut bertahan satu sesi; untuk mengingat pemain lintas kunjungan, simpan flag-nya dengan data store seperti di tutorial DataStore.

NPC penjaga toko

Buat tokonya dari panduan shop GUI, lalu tambahkan aksi OpenShop yang memicu RemoteEvent ke pemain itu dan mengembalikan true, dan buat LocalScript toko membuka jendelanya saat event itu tiba. Pembelian tetap melewati pengecekan server milik toko sendiri. Kalau membeli hanya boleh berfungsi di dekat NPC, cek juga jaraknya di dalam handler pembelian, karena client bisa memanggil remote toko dari mana saja.

NPC yang berjalan

Untuk membuat Guide berkeliling atau mengikuti pemain, pakai panduan pathfinding NPC dan hilangkan centang Anchored di HumanoidRootPart supaya bisa bergerak. Prompt Talk berada di part itu, jadi ikut bergerak bersama NPC, dan pengecekan jarak memakai part yang sama. Jeda jalannya selagi percakapan terbuka, kalau tidak kotaknya tertutup begitu NPC berjalan lebih dari 16 stud dari pemain.

Kunci, quest dan hadiah lain

GiveItem memberikan Tool apa pun di DialogueItems, jadi NPC bisa memberi kunci yang dicek pintu terkunci, seperti di panduan pintu. Untuk item yang berbuat sesuatu saat dipakai, seperti makanan yang memberi heal, lihat panduan inventory.

Suara dan kamera

Untuk klip suara atau bunyi pendek di setiap baris, taruh Sound di Head NPC dan putar dari show di DialogueClient. Untuk mengarahkan kamera ke NPC selagi berbicara, panduan cutscene menunjukkan cara LocalScript mengambil alih kamera dan mengembalikannya.

Error umum dan cara memperbaikinya

Buka jendela Output (menu Window, lalu Output) sebelum kamu menekan Play. Sebagian besar masalah dialog mencetak peringatan di sana atau berasal dari nama yang tidak cocok.

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

DialogueClient sedang menunggu remote yang dibuat DialogueService, jadi DialogueService belum sampai ke sana. Cek bahwa itu Script, bukan LocalScript, langsung di dalam ServerScriptService, dan tidak dinonaktifkan. DialogueService lebih dulu menunggu DialogueData di ReplicatedStorage dan folder NPCs di Workspace, jadi kalau salah satunya tidak ada atau salah eja, script juga berhenti; Output lalu menampilkan peringatan infinite yield dari DialogueService yang menyebut namanya.

Tidak ada prompt Talk yang muncul di NPC

DialogueService hanya menambahkan prompt ke model yang berada langsung di dalam Workspace, NPCs dan punya part bernama HumanoidRootPart. Cek keduanya, dan berjalanlah sampai jarak 12 stud. Rig dari Toolbox mungkin tidak punya part itu, atau mungkin objek jenis lain yang dibungkus folder.

Prompt muncul, tapi menekan E tidak berbuat apa-apa

Server tidak menemukan percakapan untuk NPC itu, dan saat game dimulai Output menampilkan DialogueService: no conversation with a start line for Guide in DialogueData, dengan nama NPC kamu. Table di DialogueData harus punya nama model yang persis sama, termasuk huruf kapitalnya, dan baris bernama start.

Sebuah pilihan menutup kotaknya, bukan pindah ke baris berikutnya

Output menampilkan DialogueService: no line named tip for Guide in DialogueData, dengan nama-nama milikmu: next (atau failNext) pilihan itu menyebut baris yang tidak ada di table NPC itu. Nama baris membedakan huruf besar dan kecil, jadi cek ejaannya dengan table, di sini tips.

Kotaknya berfungsi, tapi tidak ada speech bubble

Bubble butuh part bernama Head langsung di dalam model NPC, dan bubble chat yang menyala: di Explorer, pilih BubbleChatConfiguration di bawah TextChatService dan cek bahwa Enabled dicentang. Secara default sudah menyala.

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

Server tidak bisa menemukan itemnya. Cek bahwa folder di ServerStorage bernama DialogueItems dan berisi Tool (bukan Model atau Part) dengan nama yang persis sama dengan item pilihan itu. Sampai kamu memperbaikinya, Guide menjawab dengan baris hasTorch, karena aksinya gagal.

Output menampilkan DialogueService: no action named ...

action sebuah pilihan tidak cocok dengan key mana pun di table ACTIONS. Namanya membedakan huruf besar dan kecil: heal bukan Heal.

Buat dengan RoCode

Kalau kamu lebih suka menjelaskan NPC-nya daripada merangkainya secara manual, RoCode bisa menulis script-script ini ke place yang sedang kamu buka. RoCode adalah agen AI independen untuk Roblox Studio, bukan buatan Roblox: kamu mengetik di web chat, dan plugin Studio-nya membuat dan mengedit script di Explorer kamu.

Kamu ketik

Buat model Guide di Workspace.NPCs berbicara: prompt Talk, kotak dialog dengan baris yang diketik dan tombol pilihan, speech bubble, pilihan heal dengan cooldown 30 detik dan pilihan yang memberi tool Torch dari ServerStorage satu kali. Simpan percakapannya di ModuleScript dan berikan setiap hadiah di server.

RoCode mengerjakan
  • Bisa memeriksa model itu lebih dulu, memakai Get Properties untuk membaca nilai penting seperti Anchored di part-nya dan WalkSpeed di Humanoid-nya. Ketik / di chat untuk melampirkan path persis model itu
  • Menulis ModuleScript DialogueData, Script DialogueService dan LocalScript DialogueClient dengan Create Script
  • Diperintahkan untuk mengecek compile setiap script yang ditulisnya dengan Check Script, yang meng-compile-nya di Studio tanpa menjalankannya
  • Mengirim perubahannya dalam batch, dan setiap batch adalah satu titik undo di history Studio

Dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.11 atau lebih baru RoCode bisa mengendalikan karakter tes untuk mengecek game-nya berfungsi, tapi tidak mengambil screenshot selagi game berjalan, jadi datangi sendiri NPC-nya dan ajak bicara. Kalau ada yang tidak beres, ceritakan ke RoCode apa yang kamu lihat: Check Output bisa membaca baris Server dan Client dari playtest terakhirmu. NPC yang berbicara adalah satu sistem di antara banyak sistem; membuat game Roblox dengan AI, satu sistem per prompt menunjukkan cara semuanya saling terhubung. Cara RoCode tersambung ke Studio.

Pertanyaan umum

Bagaimana cara membuat NPC berbicara di Roblox Studio?

Tambahkan ProximityPrompt ke NPC dan, saat pemain memicunya, tampilkan baris NPC di kotak dialog, speech bubble atau keduanya. Tiga script di panduan ini melakukan keduanya dan menambahkan pilihan. Untuk bubble saja, panggil TextChatService:DisplayBubble(npc.Head, "Hello!") dari LocalScript saat prompt terpicu, seperti contoh NPC di halaman bubble chat Roblox.

Sebaiknya pakai objek Dialog atau GUI dialog custom?

Objek Dialog tidak butuh kode dan menampilkan speech bubble yang bisa diklik, yang cukup untuk teks pemanis. Event pilihannya hanya terjadi di perangkat pemain, jadi tidak bisa memberi hadiah dengan aman, dan secara default hanya satu pemain yang bisa berbicara dengannya pada satu waktu. Kotak custom seperti di panduan ini membiarkan server menjalankan setiap hadiah dan memberi tiap pemain percakapannya sendiri.

Bagaimana cara memberi pemain item dari NPC?

Simpan Tool-nya di ServerStorage dan buat Script server meng-clone-nya ke Backpack pemain saat mereka mengambil pilihan itu, seperti yang dilakukan aksi GiveItem. Cek bahwa mereka belum punya, dan matikan CanBeDropped di salinannya supaya tidak bisa dijatuhkan lalu diminta lagi. Jangan pernah biarkan perangkat pemain menentukan item mana yang diberikan.

Bagaimana cara membuat kotak dialog dengan efek mesin tik?

Taruh seluruh baris di TextLabel, naikkan MaxVisibleGraphemes-nya dari 0 beberapa karakter setiap kali, dan atur ke -1 di akhir untuk menampilkan semuanya. Halaman UI animation Roblox memakai properti yang sama dengan utf8.graphemes. DialogueClient menghitung berapa karakter yang ditampilkan dari waktu yang sudah berlalu, 45 per detik, jadi kecepatannya tidak bergantung pada frame rate.

Bisakah dua pemain berbicara dengan NPC yang sama sekaligus?

Dengan script di panduan ini, bisa: server menyimpan satu percakapan per pemain, dan tiap pemain hanya melihat kotaknya sendiri. Objek Dialog bawaan berbeda: dengan BehaviorType default-nya, SinglePlayer, satu pemain berbicara pada satu waktu dan yang lain melihat pilihan pemain itu.

Apakah teks dialog NPC perlu difilter?

Tidak untuk baris yang kamu tulis sendiri. Roblox membuatmu bertanggung jawab memfilter teks tampil yang tidak kamu kendalikan secara eksplisit, seperti yang diketik pemain, kata yang dihasilkan dari karakter acak, atau teks yang diambil dari situs luar. Kalau NPC mengulang sesuatu yang diketik pemain, filter bagian itu.

Sumber dan bacaan lanjutan

Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.

Coba RoCode di game kamu sendiri.

Kredit gratis setiap hari, tanpa kartu. Pasang plugin-nya, jelaskan fiturnya, lalu cek hasilnya di Studio.