Tutorial · Gamesystemen

Hoe maak je een NPC-dialoog in Roblox Studio

Een NPC-dialoog in Roblox bestaat uit drie delen: een prompt om het gesprek te starten, een venster dat de woorden van de NPC en knoppen met de antwoorden van de speler toont, en een script dat beslist waar elk antwoord naartoe leidt. In deze handleiding bouwen we alle drie: je schrijft het gesprek als een simpele tabel, spelers drukken op E om te praten, en alles wat een antwoord oplevert (genezen, een item) geeft de server, niet het apparaat van de speler.

Bijgewerkt 20 november 202624 min lezenAuteur:

In het kort

Zet de model van de NPC in een map NPCs in Workspace en schrijf zijn gesprek in een ModuleScript in ReplicatedStorage: elke regel heeft de tekst van de NPC en een lijst opties die naar een andere regel leiden. Een Script in ServerScriptService geeft elke NPC een ProximityPrompt ("Talk"), onthoudt bij welke regel elke speler is en stuurt die via een RemoteEvent. Een LocalScript toont de tekst en een knop per optie, en stuurt alleen het nummer van de aangeklikte knop terug.

  • Geef beloningen op de server. Het event DialogChoiceSelected van het ingebouwde object Dialog gaat alleen af op de client, dus een server-Script hoort het nooit, en genezen of een item dat in een LocalScript wordt gegeven, verandert alleen de kopie van de game van die speler.
  • Toon een tekstballon met de regel via TextChatService:DisplayBubble(npc.Head, text) vanuit een LocalScript. De oude service Chat is verouderd, in plaats daarvan gebruik je TextChatService.
  • Regels die je zelf hebt geschreven, hoef je niet te filteren. De regel van Roblox: filter elke getoonde tekst die je niet direct zelf beheert, zoals wat spelers intypen.
Op deze pagina
  1. Hoe het werkt
  2. 1. De NPC toevoegen
  3. 2. Het gesprek
  4. 3. Serverscript
  5. 4. Dialoogvenster
  6. Eigen acties
  7. Andere tutorials
  8. Grenzen van de beveiliging
  9. 5. Testen
  10. Uitbreidingen
  11. Common errors
  12. Met RoCode
  13. Veelgestelde vragen
  14. Bronnen en verder lezen

Hoe een NPC-dialoog werkt

IllustratieElke regel wordt in het venster getypt terwijl hij in zijn geheel in de tekstballon staat, de opties verschijnen als de regel getypt is, en de server geeft de Torch als je "Got anything for the cave?" kiest.

Een pratende NPC die in een echte game werkt, is verdeeld tussen de server en het apparaat van elke speler. Het apparaat tekent het venster en de knoppen. De server, de enige kant die je kunt vertrouwen, weet welke regel elke speler leest en beslist wat elk antwoord doet. Eén beurt in het gesprek ziet er zo uit:

  1. De speler loopt naar de NPC en drukt op E bij zijn prompt Talk. Het event Triggered van de prompt gaat op de server af met die speler.
  2. Het serverscript controleert of de speler dichtbij genoeg is, onthoudt dat hij bij de regel met de naam start is, en stuurt de tekst van die regel en de labels van de opties alleen naar die speler.
  3. Het LocalScript typt de regel in het dialoogvenster, toont een tekstballon boven de NPC en voegt daarna een knop per optie toe.
  4. De speler klikt, tikt of kiest een optie. Alleen het nummer ervan gaat terug naar de server.
  5. De server zoekt dat nummer op in de regel waarvan hij weet dat de speler die leest, voert de actie van de optie uit als die er is (genezen, een item) en stuurt de volgende regel of sluit het venster.
Waaruit een pratende NPC bestaat
OnderdeelWaar het staatWat het doet
Rig GuideWorkspace, in een map met de naam NPCsDe NPC zelf. Zijn naam kiest het gesprek en staat op de prompt.
ModuleScript DialogueDataReplicatedStorageAlle regels die de NPC kan zeggen, de opties onder elke regel en waar elke optie naartoe leidt.
Script DialogueServiceServerScriptServiceVoegt de Talk-prompt toe, onthoudt bij welke regel elke speler is, controleert elke klik en voert de acties uit.
RemoteEvent DialogueEventReplicatedStorage (DialogueService maakt hem)Brengt elke regel naar de speler, en het nummer van de gekozen optie terug naar de server.
LocalScript DialogueClientStarterPlayer, StarterPlayerScriptsTekent het venster, typt de regel, toont de tekstballon en de knoppen met opties.
Tool Torch (optioneel)ServerStorage, in een map met de naam DialogueItemsHet item dat een van de opties geeft. Niets uit ServerStorage wordt naar spelers gestuurd.
Explorer als de NPC klaar is. Als de game draait, voegt DialogueService een RemoteEvent met de naam DialogueEvent toe aan ReplicatedStorage en een Talk-ProximityPrompt met de naam TalkPrompt aan de HumanoidRootPart van elke NPC.
Workspace
  NPCs Folder new
    Guide Model new
      Humanoid Humanoid
      HumanoidRootPart Part
      Head, UpperTorso, LowerTorso ... (lichaamsdelen)
ReplicatedStorage
  DialogueData ModuleScript new
ServerScriptService
  DialogueService Script new
ServerStorage
  DialogueItems Folder new
    Torch Tool new
      Handle Part new
StarterPlayer
  StarterPlayerScripts
    DialogueClient LocalScript new

Stap 1: voeg de NPC toe

  1. Klik op het tabblad Avatar of Home op Character om de Rig Generator te openen. Kies R15, een lichaamsvorm en een stijl. In Workspace verschijnt een rig met de naam Rig. Een R6-rig werkt met dezelfde scripts.
  2. Hernoem hem naar Guide. De naam is belangrijk: DialogueService zoekt het gesprek op aan de hand van de naam van de model, en de prompt toont die naam aan spelers.
  3. Klap de rig open, selecteer zijn HumanoidRootPart en vink Anchored aan in het venster Properties. Een geanchorde part beweegt nooit door physics, dus de NPC blijft staan waar je hem neerzette en spelers kunnen hem niet wegduwen.
  4. Beweeg je muis over Workspace in Explorer, klik op de knop + en voeg een Folder toe met de naam NPCs. Sleep Guide erin en zet de rig op een plek waar spelers naartoe kunnen lopen.
  5. Optioneel, voor de optie met een item: beweeg je muis over ServerStorage en voeg een Folder toe met de naam DialogueItems. Zet er een Tool in met de naam Torch en één niet-geanchorde Part met de naam Handle, de part die het personage in zijn hand houdt. Een PointLight in Handle laat hem gloeien.

Namen zijn hoofdlettergevoelig, dus typ NPCs, Guide, DialogueItems en Torch precies zoals hier staat. De NPC mag elke model met een Humanoid en een HumanoidRootPart zijn, ook een uit de Toolbox, zolang hij direct in de map NPCs staat.

Stap 2: schrijf het gesprek

Beweeg je muis over ReplicatedStorage, voeg een ModuleScript toe met de naam DialogueData en plak deze code erin. Er zit geen logica in, alleen woorden en de verbindingen ertussen, dus dit is het bestand dat je het vaakst zult aanpassen.

ModuleScript in ReplicatedStorage met de naam DialogueData
-- ModuleScript in ReplicatedStorage met de naam DialogueData.
-- Alle gesprekken, per naam van de NPC in Workspace.NPCs. Elke regel heeft
-- de tekst van de NPC en de antwoordopties van de speler. Een optie kan naar een andere regel leiden (next),
-- het gesprek beëindigen (zonder next) en de server vragen iets te doen (action). Als de server
-- de actie niet kan uitvoeren, toont hij de regel failNext in plaats van next.

export type Choice = {
	text: string,
	next: string?, -- de regel die na deze optie getoond wordt; nil beëindigt het gesprek
	action: string?, -- een serveractie uit de tabel ACTIONS in DialogueService
	item: string?, -- voor de actie GiveItem: de naam van een Tool in ServerStorage.DialogueItems
	failNext: string?, -- de regel die in plaats van next getoond wordt als de actie mislukte
}

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

De regels export type aan het begin beschrijven hoe een regel en een optie eruitzien. Tijdens het spelen veranderen ze niets; ze beschrijven je data, zodat de typecontrole die kan controleren.

Hoe de onderdelen met elkaar verbonden zijn:

  • Elke NPC heeft een tabel met de naam van zijn model in de map NPCs, hier is dat Guide. Elk gesprek begint bij de regel start.
  • text is wat de NPC zegt. choices zijn de knoppen van de speler, op volgorde. Het venster heeft plek voor vier.
  • next noemt de regel die na deze optie getoond wordt. Een optie zonder next, zoals "Bye!", beëindigt het gesprek. Een next of failNext die een regel noemt die niet in de tabel staat, beëindigt het ook, met een waarschuwing in Output.
  • action noemt wat de server doet, uit de tabel ACTIONS in DialogueService: hier is dat Heal of GiveItem.
  • item is voor GiveItem: de naam van een Tool in ServerStorage, DialogueItems.
  • failNext is de regel die in plaats van next getoond wordt als de actie mislukte, zodat de NPC nooit beweert dat hij je genas of iets gaf als dat niet gebeurde.
Het gesprek van Guide, regel voor regel
RegelGuide zegtOpties en waar ze naartoe leiden
start"Welcome to the village! What can I do for you?""Any tips?" leidt naar tips. "I'm hurt. Can you help?" geneest, dan healed (of healTooSoon). "Got anything for the cave?" geeft een Torch, dan torch (of hasTorch). "Bye!" beëindigt het gesprek.
tips"Stay off the red bricks, and come back if you get hurt.""Anything else?" gaat terug naar start. "Thanks!" beëindigt het gesprek.
healed"There you go, good as new.""Thank you!" beëindigt het gesprek.
torch"Take this torch. The cave is dark.""Thanks!" beëindigt het gesprek.
healTooSoon"I healed you a moment ago. Come back in a little while.""OK" beëindigt het gesprek.
hasTorch"You already have my torch. Keep it lit!""Will do!" beëindigt het gesprek.

Alleen de server leest deze module. Het LocalScript doet er nooit require op: de server stuurt elke regel zodra de speler die bereikt. Maar een module in ReplicatedStorage wordt toch naar het apparaat van elke speler gekopieerd, dus als het gesprek spoilers bevat (zeg, het antwoord op een raadsel), verplaats DialogueData dan naar ServerStorage. Vervang daarna in de regel met require in DialogueService ReplicatedStorage door ServerStorage, zodat de hele regel er zo uitziet: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.

Stap 3: voeg het serverscript toe

Beweeg je muis over ServerScriptService, voeg een Script toe met de naam DialogueService en plak de code hieronder erin. Dit is de enige plek waar het gesprek verder gaat, en de enige plek waar een beloning wordt gegeven.

Script in ServerScriptService met de naam DialogueService
-- Script in ServerScriptService met de naam DialogueService.
-- Voegt een Talk-prompt toe aan elke NPC in Workspace.NPCs en leidt elk gesprek.
-- Het apparaat van de speler toont alleen de tekst en stuurt het nummer van de optie terug
-- waarop hij klikte. De server weet bij welke regel elke speler is, controleert de optie
-- en de afstand, en alleen hij geneest of geeft items.

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

-- Dezelfde vormen als in DialogueData, zodat de typecontrole van Studio ze ook hier kent
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 -- studs: het bereik van de prompt en hoe dichtbij de speler moet blijven
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30

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

-- Dit script maakt DialogueEvent zelf, dus voeg hem niet met de hand toe
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 -- geen personage, hij is dood of de NPC is weg
	end
	-- een kleine marge, omdat de positie van de speler met een kleine vertraging bij de server aankomt
	return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end

-- Wat de server doet als een optie een actie heeft. Elke actie geeft true terug als hij gelukt is.
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 -- te kort geleden genezen
		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 -- nog geen backpack, of hij heeft het item al
		end
		local item = template:Clone() :: Tool
		item.CanBeDropped = false -- zodat niemand hem kan laten vallen en om nog een kan vragen
		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 -- praat al, deze NPC heeft geen regel "start", dood of te ver weg
	end
	local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
	conversations[player] = conversation
	showLine(player, conversation)
end

-- De speler klikte op optie nummer choiceIndex (0 betekent dat hij het venster sloot)
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
		-- Te snel. We sturen dezelfde regel opnieuw, omdat het venster de knoppen na de klik
		-- al heeft geblokkeerd en anders eeuwig op een antwoord zou wachten.
		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 -- deze optie bestaat niet op de regel die deze speler leest
	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 -- bijvoorbeeld "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)

-- Een Talk-prompt op elke 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() -- een kopie van een NPC neemt een oude prompt mee waar niemand naar luistert
	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)

-- Sluit het venster voor iedereen die midden in een gesprek wegliep of doodging
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 maakt de RemoteEvent DialogueEvent zelf als de game start, dus je hoeft niets met de hand aan ReplicatedStorage toe te voegen. Heb je al een RemoteEvent met die naam gemaakt, verwijder die dan: het LocalScript zou de jouwe kunnen vinden, en daar luistert op de server niemand naar.

Instellingen aan het begin van DialogueService
InstellingWaarde hierWat het verandert
TALK_DISTANCE12Hoe dichtbij, in studs, de speler moet zijn om de Talk-prompt te zien. De server laat hem nog 4 studs verder lopen voordat het venster sluit, omdat de positie van de speler met een kleine vertraging bij de server aankomt.
MIN_SECONDS_BETWEEN_CHOICES0.3De kortste tijd tussen twee klikken die de server accepteert. Op een snellere klik wordt in plaats van een antwoord dezelfde regel opnieuw gestuurd.
HEAL_COOLDOWN_SECONDS30Hoe lang elke speler wacht tussen twee keer genezen door de actie Heal.

De server bewaart in conversations één item per speler: met welke NPC hij praat, welke regel hij leest en wanneer zijn laatste klik geaccepteerd werd. Als de Talk-prompt afgaat, maakt startConversation dat item alleen als de speler nog niet aan het praten is, de NPC een regel start heeft en de speler leeft en binnen bereik is. Daarna gaat elke klik door deze controles:

Wat DialogueService bij elke klik controleert
ControleCodeAls hij niet slaagt
De speler zit in een gesprekconversations[player]De klik wordt genegeerd.
De optie is een geheel getaltypeof en math.floorGenegeerd. Strings, tabellen, breuken en NaN stoppen hier.
0 betekent dat de speler op X druktechoiceIndex == 0Het gesprek eindigt.
Leeft en is nog steeds niet verder dan 16 studs (12 plus 4)isCloseHet gesprek eindigt en het venster sluit.
Minstens 0.3 seconde sinds de laatste geaccepteerde klikconversation.lastChoiceDezelfde regel wordt opnieuw gestuurd, dus het venster krijgt verse knoppen in plaats van eeuwig te wachten.
De optie bestaat op de regel die deze speler leestline.choices[choiceIndex]Genegeerd.
De actie is geluktelke actie geeft true of false terugIn plaats van next wordt de regel failNext getoond.

De prompt komt op de HumanoidRootPart van de NPC, omdat een ProximityPrompt werkt als hij in een part (of een Attachment, of een model met een PrimaryPart) in Workspace zit. Zijn RequiresLineOfSight staat standaard aan en verbergt de prompt telkens als iets het zicht van de camera naar die part blokkeert. Roblox sluit de eigen part van de prompt uit van die controle, maar de rest van het lichaam niet, en de HumanoidRootPart zit in de torso, dus het script zet de controle op vrij zicht uit. De prompt heet TalkPrompt, en het script verwijdert elke TalkPrompt die al op de part zit voordat het zijn eigen toevoegt: een kopie van een NPC die tijdens het spelen wordt gemaakt, komt met de prompt van het origineel, en naar de gekopieerde luistert niemand. Heeft DialogueData geen gesprek met een regel start voor de naam van een NPC, dan verschijnt er een waarschuwing in Output met de naam van die NPC.

Een loop controleert twee keer per seconde elk open gesprek en sluit het als de speler verder dan 16 studs is weggelopen of zijn personage dood is, zodat een speler die midden in een gesprek doodging, niet respawnt met een open venster. PlayerRemoving maakt beide tabellen leeg als iemand weggaat.

Stap 4: voeg het dialoogvenster toe

Open StarterPlayer, beweeg je muis over StarterPlayerScripts, voeg een LocalScript toe met de naam DialogueClient en plak deze code erin. Het bouwt het dialoogvenster in code, dus je hoeft geen GUI met de hand te tekenen.

LocalScript in StarterPlayer > StarterPlayerScripts met de naam DialogueClient
-- LocalScript in StarterPlayer > StarterPlayerScripts met de naam DialogueClient.
-- Tekent het gesprek dat de server stuurt: de naam van de NPC, zijn regel die letter
-- voor letter verschijnt, een tekstballon boven het hoofd en een knop per optie. Een klik op
-- een optie stuurt alleen het nummer; wat er daarna gebeurt, beslist de server.

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)

-- Het dialoogvenster, gebouwd in code
local gui = Instance.new("ScreenGui")
gui.Name = "Dialogue"
gui.ResetOnSpawn = false
gui.Enabled = false

local box = Instance.new("Frame")
box.AnchorPoint = Vector2.new(0.5, 1)
box.Position = UDim2.new(0.5, 0, 1, -84) -- 84 pixels hoger, zodat de werkbalk van Roblox de opties niet bedekt
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 -- een lange regel wordt kleiner om op een klein telefoonscherm te passen
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- en wordt nooit groter dan 20 pixels op een groot scherm
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 -- groeit bij elke nieuwe regel, zodat de oude typloop stopt

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 -- verandert alleen op dit apparaat
	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()

	-- Tekstballon boven de NPC (DisplayBubble werkt alleen in een LocalScript)
	local head = npc:FindFirstChild("Head")
	if head then
		TextChatService:DisplayBubble(head, text)
	end

	-- Typ de regel letter voor letter. Het aantal wordt berekend uit de verstreken tijd,
	-- dus de snelheid is bij elke framerate gelijk.
	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 -- deze regel is vervangen door een nieuwere of door sluiten
		end
		shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
		lineLabel.MaxVisibleGraphemes = shown
	end
	lineLabel.MaxVisibleGraphemes = -1

	-- Een knop per optie; de server krijgt alleen het nummer van de knop
	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 -- één klik per regel
				dialogueEvent:FireServer(index)
			end
		end)
		if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
			GuiService.SelectedObject = button -- zodat je een optie met een gamepad kunt kiezen
		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)

Kleuren, maten en LETTERS_PER_SECOND mag je aanpassen zoals je wilt. Laat de laatste twee handlers zoals ze zijn: dat is de enige manier waarop het venster met de server praat.

Wat elk deel van DialogueClient doet:

  • Het venster. Een ScreenGui met een Frame die onderaan in het midden van het scherm vastzit, 60% van de breedte en 34% van de hoogte, begrensd op 720 bij 300 pixels via UISizeConstraint, zodat hij zich niet over een hele brede monitor uitrekt. De regel van de NPC gebruikt TextScaled, dat de tekst verkleint zodat hij op een klein telefoonscherm in zijn label past, en UITextSizeConstraint zorgt dat hij op een groot scherm niet groter wordt dan 20 pixels. UIGridLayout zet de opties twee bij twee neer. ResetOnSpawn is false, omdat dit LocalScript één keer per sessie start: een venster dat bij het respawnen verwijderd wordt, zou nooit terugkomen.
  • Het typemachine-effect. De hele regel gaat in één keer in de TextLabel, en MaxVisibleGraphemes bepaalt hoeveel tekens zichtbaar zijn; dat is dezelfde eigenschap die het eigen typemachinevoorbeeld van Roblox gebruikt, samen met utf8.graphemes. Roblox deelt de tekst in alsof alle tekens zichtbaar zijn, dus woorden springen niet naar een nieuwe regel en veranderen niet van grootte terwijl ze verschijnen. Het script berekent hoeveel tekens het toont uit de verstreken tijd, 45 per seconde, dus de snelheid is bij elke framerate gelijk, en zet de eigenschap daarna op -1, wat alles toont.
  • De knoppen. Ze verschijnen als de regel getypt is. Elke knop stuurt alleen zijn nummer, en maar één keer: de controle op lineNumber voorkomt dat een dubbelklik twee keer verstuurt, en daarna wacht het venster op de volgende regel van de server.
  • De tekstballon. TextChatService:DisplayBubble(head, text) zet de regel in een chatballon boven de Head van de NPC. Roblox staat dat alleen toe in clientscripts, en bubble chat staat standaard aan. Het apparaat van deze speler tekent de ballon, dus alleen hij ziet hem.
  • De prompt. Zolang de speler praat, staat zijn kopie van de Talk-prompt (gevonden aan de naam TalkPrompt) uit, zodat die niet over het gesprek heen hangt. Andere spelers zien die van hen nog gewoon.
  • Elk apparaat. Activated gaat af bij een muisklik, een tik op een telefoon en de knop A op een gamepad. Een gamepad kan alleen de geselecteerde knop indrukken, dus als PreferredInput zegt dat de speler een gamepad gebruikt, selecteert het script de eerste optie via GuiService.SelectedObject.
  • De knop X. Die stuurt 0, wat de server opvat als "gesprek beëindigen", en sluit het venster meteen.

Voeg je eigen acties toe

Een actie is een functie in de tabel ACTIONS aan het begin van DialogueService. Hij krijgt de speler en de optie en geeft true terug als hij zijn werk heeft gedaan. Om je eigen actie toe te voegen, zeg een quest die de NPC geeft:

  1. Voeg aan ACTIONS een item toe met de naam StartQuest. Eerst de controle, dan de wijziging: als player:GetAttribute("Quest") al gezet is, geef je false terug; anders roep je player:SetAttribute("Quest", "Cave") aan en geef je true terug.
  2. Geef in DialogueData een optie action = "StartQuest", een regel next voor als het lukt en een regel failNext voor als het mislukt, bijvoorbeeld "You are already on a quest."
  3. Druk op Play en kies de optie twee keer. Komt de naam in DialogueData niet overeen met de sleutel in ACTIONS (hoofdletters tellen), dan verschijnt DialogueService: no action named StartQuest in Output en gaat het gesprek naar de regel failNext.

Regels voor het schrijven van acties:

  • Doe de controle en de wijziging in de actie, op de server. Het enige wat het apparaat van de speler stuurt, is het nummer van de optie.
  • Lees wat de actie nodig heeft uit de optie (zoals item) of uit de eigen status van de server, maar nooit uit een remote.
  • Beperk alles wat waardevol is in de actie zelf, zoals Heal zijn eigen cooldown van 30 seconden bijhoudt in lastHeal. De limiet van 0.3 seconde per klik vertraagt alleen het klikken; hij houdt een speler niet tegen om steeds weer dezelfde optie te doorlopen.
  • Om een ander venster te openen, zoals een winkel, kan een actie een RemoteEvent naar die speler sturen en true teruggeven. Alles wat in dat venster gebeurt, heeft nog steeds zijn eigen servercontroles nodig, zoals in het onderdeel NPC als winkelier.

Wat andere tutorials over NPC-dialogen fout doen

Vergelijk je deze handleiding met een video of een forumpost, dan zijn dit de belangrijke verschillen en de reden waarom elke truc een probleem oplevert.

Veelgebruikte trucs in tutorials over NPC-dialogen en wat deze handleiding in plaats daarvan doet
TutorialProbleemDeze handleiding
Gebruikt het object Dialog, en een server-Script luistert naar DialogChoiceSelected om een beloning te gevenDe documentatie van Roblox zegt dat dit event alleen aan de clientkant werkt en op de server niet afgaat, dus de beloning komt nooit.De optie komt als getal bij de server aan, en de server geeft de beloning zelf.
Geeft de beloning vanuit een LocalScriptEen wijziging die een LocalScript maakt, blijft op dat ene apparaat (zie wat er gerepliceerd wordt), en een cheater kan dezelfde code starten wanneer hij wil.Alle acties zitten in DialogueService.
Laat de NPC praten via game:GetService("Chat"):Chat(head, text)De service Chat is verouderd, in plaats daarvan gebruik je TextChatService.TextChatService:DisplayBubble in een LocalScript.
Stuurt vanaf de client de naam van de beloning of de id van de volgende regelEen cheater kan elke itemnaam sturen of meteen naar de regel springen die de beloning geeft.De client stuurt alleen het nummer van de optie. De server zoekt dat op in de regel waarvan hij weet dat de speler die leest.
Controleert niets nadat de prompt afgingDe beveiligingshandleiding van Roblox noemt ProximityPrompts naast remotes als iets wat clients kunnen misbruiken, en raadt aan voor een actie te controleren of de speler dichtbij genoeg is.De afstand wordt gecontroleerd bij het begin van het gesprek, bij elke klik en twee keer per seconde zolang het open is.
Typt de tekst met wait() in een loopDe globale wait is verouderd, in plaats daarvan gebruik je task.wait.Berekent het aantal zichtbare letters uit os.clock() en wacht met task.wait().

Wat een speler wel en niet kan vervalsen

Ga ervan uit dat een cheater alles op zijn eigen apparaat beheerst. Hij kan je LocalScripts en alles in ReplicatedStorage lezen, DialogueEvent met willekeurige argumenten zo vaak aanroepen als hij wil en de Talk-prompt vanuit code starten, waar de beveiligingshandleiding van Roblox voor waarschuwt. DialogueService antwoordt met servercontroles van dezelfde soort als in het onderdeel argumenten van een RemoteEvent controleren. Dit is wat een cheater daarmee bereikt.

Wat een cheater kan proberen en wat DialogueService ermee doet
De cheater probeertResultaatWaarom
De Talk-prompt starten vanaf de andere kant van de mapEr gebeurt nietsstartConversation controleert of hij niet verder dan 16 studs is (12 plus 4).
Optie 99, een string, een breuk of NaN sturenGenegeerdHet is geen geheel getal, of die optie bestaat niet op de regel die hij leest.
De naam van een beloning of de id van een regel sturenWordt nooit gelezenDe server leest alleen het nummer van de optie. Beloningen komen uit de velden item en action van de serverkopie van de regel.
Zo snel klikken als het netwerk toelaatEén klik per 0.3 seconde per gesprekOp snellere klikken komt hun eigen regel terug. Het gesprek beëindigen en opnieuw starten omzeilt die wachttijd, daarom hebben Heal en GiveItem hun eigen limieten.
Om een fakkel vragen zonder gesprekOnmogelijkItems worden alleen gegeven via een optie op de regel waarvan de server weet dat de speler erbij is.
Een stapel fakkels verzamelenEén tegelijkDe server zoekt eerst naar een Torch in zijn Backpack en personage, en een gegeven fakkel kun je niet laten vallen, dus je kunt hem niet farmen door hem te laten vallen en opnieuw te vragen.
De regel met genezen spammenEén keer genezen per 30 secondenDe cooldown staat op de server per speler, en de NPC meldt het met de regel healTooSoon.
Weglopen en het venster open latenSluit binnen een halve secondeDe server controleert elk open gesprek twee keer per seconde.
Het hele gesprek lezen, ook regels die hij niet bereikt heeftMogelijkDialogueData staat in ReplicatedStorage, dat naar elk apparaat wordt gekopieerd. Verplaats het naar ServerStorage als dat belangrijk is (zie stap 2).

Eén beperking moet je eerlijk benoemen: een cheater die naar Guide loopt en opties kiest, krijgt precies hetzelfde als een eerlijke speler. De server bepaalt hoe vaak en vanaf waar, maar niet wie. Alles wat zeldzaam is, zoals een beloning die elke speler één keer mag krijgen, heeft een controle nodig waarvan de server eigenaar is, zoals een attribuut dat bij het ontvangen wordt gezet of een vlag die in een datastore wordt opgeslagen.

Stap 5: test het

  1. Druk op Play (F5) en loop naar Guide. Binnen 12 studs verschijnt de prompt Talk met de naam Guide. Druk op E.
  2. Het venster toont "Guide", typt de welkomstregel en toont daarna vier knoppen. Dezelfde regel verschijnt in een tekstballon boven het hoofd van de NPC.
  3. Kies "Any tips?" en daarna "Anything else?": je bent terug bij de eerste regel. Kies "Bye!": het venster sluit en de Talk-prompt komt terug.
  4. Doe jezelf eerst schade: klik op de schakelaar Client/Server om naar Server te gaan, selecteer de Humanoid van je personage in Workspace, zet Health op 50 in het venster Properties en schakel terug naar Client. Personages van spelers herstellen elke seconde 1% van MaxHealth, dus praat meteen met Guide en kies "I'm hurt. Can you help?": je health springt naar vol. Praat binnen 30 seconden opnieuw en kies het nog een keer: er wordt niet genezen, en Guide zegt dat hij je net nog genas.
  5. Kies "Got anything for the cave?": de Torch verschijnt in de hotbar. Pak hem vast en druk op Backspace: hij blijft in je hand. Vraag het opnieuw: er komt geen tweede fakkel, en Guide zegt dat je hem al hebt.
  6. Begin een gesprek en loop weg. Het venster sluit ongeveer op het moment dat je 16 studs van Guide af bent.
  7. Kies Server & Clients in de vervolgkeuzelijst met testmodi, stel 2 clients in en druk op Play. Beide spelers kunnen tegelijk met Guide praten, elk bij zijn eigen regel.
  8. Test een gamepad met de Controller Emulator (Controller op het tabblad Emulation) tijdens een playtest. Loop met de geëmuleerde gamepad naar de NPC en druk op de knop van de prompt (standaard ButtonX): als de opties verschijnen, is de eerste al geselecteerd, en A drukt hem in.
  9. Test een telefoonscherm met de Device Simulator in Studio (op het moment van schrijven is dat een bèta: zet New Device Simulator aan in File, Beta Features en start Studio opnieuw). Kies een telefoon, klik op Rotate tot hij liggend staat, druk op Play, loop naar Guide en tik op de Talk-prompt. Kies "Any tips?": de hele regel staat zichtbaar boven de knoppen met opties, zo nodig in kleinere tekst, en overlapt ze niet.

Houd de hele tijd het venster Output open (menu Window, dan Output). Als deze scripts werken, printen ze niets, dus elke rode fout of waarschuwing die begint met DialogueService: is een echt probleem. Zie Veelvoorkomende fouten.

Uitbreiden

Meer NPC's en langere gesprekken

Voeg aan de map NPCs nog een rig toe met een eigen naam, en aan DialogueData een tabel met dezelfde naam en een regel start. DialogueService geeft elke model in de map die een HumanoidRootPart heeft een Talk-prompt, ook modellen die tijdens het spelen worden toegevoegd; een kopie van een NPC krijgt een verse prompt in plaats van de prompt waarmee hij gekopieerd werd. Twee NPC's met dezelfde naam gebruiken één tabel. Regels kunnen in elke volgorde naar elkaar verwijzen, en een optie kan terugleiden naar een eerdere regel, zoals "Anything else?". Houd het op maximaal vier opties per regel, omdat het venster ze twee bij twee neerzet.

Regels die van de voortgang afhangen

Om terugkerende spelers anders te begroeten, kies je de eerste regel op basis van iets waarvan de server eigenaar is. Kies hem in startConversation met local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", controleer of de regel bestaat, net zoals het script lines.start controleert, en gebruik firstLine in plaats van "start" bij het maken van het gesprek. Zet het attribuut in een actie en voeg een regel welcomeBack toe aan de tabel van Guide. Attributen leven één sessie; om een speler tussen bezoeken te onthouden, sla je de vlag op in een datastore, zoals in de tutorial over DataStore.

NPC als winkelier

Bouw een winkel met de handleiding over een winkel-GUI, voeg daarna een actie OpenShop toe die een RemoteEvent naar die speler stuurt en true teruggeeft, en laat het LocalScript van de winkel zijn venster openen als dat event binnenkomt. Aankopen lopen nog steeds via de eigen servercontroles van de winkel. Mag je alleen bij de NPC kopen, controleer dan ook de afstand in de handler voor aankopen, omdat de client de remote van de winkel overal vandaan kan aanroepen.

NPC's die lopen

Wil je dat Guide rondloopt of spelers volgt, neem dan de handleiding over pathfinding voor NPC's en haal Anchored van de HumanoidRootPart, zodat hij kan bewegen. De Talk-prompt zit op die part, dus hij beweegt mee met de NPC, en de afstandscontroles gebruiken dezelfde part. Pauzeer het lopen zolang een gesprek open is, anders sluit het venster zodra de NPC verder dan 16 studs van de speler wegloopt.

Sleutels, quests en andere beloningen

GiveItem geeft elke Tool uit DialogueItems, dus een NPC kan een sleutel geven die een afgesloten deur controleert, zoals in de handleiding over deuren. Over items die iets doen als je ze gebruikt, zoals eten dat geneest, lees je in de handleiding over een inventaris.

Geluid en camera

Voor een stemclip of een kort geluid bij elke regel zet je een Sound in de Head van de NPC en speel je die af vanuit show in DialogueClient. Om de camera op de NPC te richten terwijl hij praat, laat de handleiding over cutscenes zien hoe een LocalScript de besturing van de camera overneemt en weer teruggeeft.

Veelvoorkomende fouten en oplossingen

Open het venster Output (menu Window, dan Output) voordat je op Play drukt. De meeste problemen met een dialoog printen daar een waarschuwing of komen door een naam die niet klopt.

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

DialogueClient wacht op de remote die DialogueService maakt, dus DialogueService is niet tot dat punt gekomen. Controleer dat het een Script is en geen LocalScript, dat het direct in ServerScriptService staat en niet uitgeschakeld is. DialogueService wacht eerst op DialogueData in ReplicatedStorage en de map NPCs in Workspace, dus als die ontbreken of een typfout in de naam hebben, stopt het ook; Output toont dan een waarschuwing infinite yield van DialogueService met die naam.

Boven mijn NPC verschijnt geen Talk-prompt

DialogueService voegt alleen prompts toe aan modellen die direct in Workspace, NPCs staan en een part hebben met de naam HumanoidRootPart. Controleer beide voorwaarden en kom dichterbij dan 12 studs. Een rig uit de Toolbox heeft die part misschien niet, of het is een object van een ander type dat in een map is verpakt.

De prompt verschijnt, maar op E drukken doet niets

De server vond geen gesprek voor deze NPC, en bij het starten van de game toont Output DialogueService: no conversation with a start line for Guide in DialogueData met de naam van je NPC. De tabel in DialogueData moet precies zo heten als de model, inclusief hoofdletters, en een regel start bevatten.

Een optie sluit het venster in plaats van naar de volgende regel te gaan

Output toont DialogueService: no line named tip for Guide in DialogueData met jouw namen: de next (of failNext) van de optie noemt een regel die niet in de tabel van deze NPC staat. Namen van regels zijn hoofdlettergevoelig, dus vergelijk de spelling met de tabel, hier is dat tips.

Het venster werkt, maar er is geen tekstballon

De tekstballon heeft een part met de naam Head direct in de model van de NPC nodig en bubble chat die aan staat: selecteer in Explorer BubbleChatConfiguration onder TextChatService en controleer dat Enabled aangevinkt is. Standaard staat het aan.

In Output staat DialogueService: no Tool named Torch in ServerStorage.DialogueItems

De server kon het item niet vinden. Controleer dat de map in ServerStorage DialogueItems heet en dat er een Tool in staat (geen Model en geen Part) met precies dezelfde naam als in item van de optie. Zolang je dat niet oplost, antwoordt Guide met de regel hasTorch, omdat de actie mislukte.

In Output staat DialogueService: no action named ...

De action van de optie komt niet overeen met een sleutel in de tabel ACTIONS. Namen zijn hoofdlettergevoelig: heal is niet Heal.

Maken met RoCode

Beschrijf je een NPC liever dan dat je hem met de hand bouwt, dan kan RoCode deze scripts direct in de place schrijven die je open hebt. Het is een onafhankelijke AI-agent voor Roblox Studio, niet van Roblox: je schrijft in de webchat en de plugin voor Studio maakt en bewerkt de scripts in je Explorer.

Jij typt

Laat de model Guide in Workspace.NPCs praten: een Talk-prompt, een dialoogvenster met regels die zich uittypen en knoppen met opties, een tekstballon boven het hoofd, een optie die geneest met een cooldown van 30 seconden en een optie die één keer de tool Torch uit ServerStorage geeft. Bewaar het gesprek in een ModuleScript en geef alle beloningen op de server.

RoCode doet
  • Kan de model eerst bekijken met Get Properties om belangrijke waarden te lezen, zoals Anchored van zijn parts en WalkSpeed van zijn Humanoid. Typ / in de chat om het exacte pad naar de model toe te voegen
  • Schrijft de ModuleScript DialogueData, het Script DialogueService en het LocalScript DialogueClient met Create Script
  • Heeft de opdracht de compilatie van elk geschreven script te controleren met Check Script, dat het in Studio compileert zonder het te starten
  • Stuurt wijzigingen in reeksen, en elke reeks is een ongedaan-maakpunt in de geschiedenis van Studio

Met plugin 3.9 of nieuwer kan RoCode een korte playtest draaien en de fouten lezen, en met plugin 3.9.11 of nieuwer kan het een testpersonage besturen om te controleren of de game werkt, maar tijdens het spelen maakt het geen screenshots, dus loop zelf naar de NPC en praat met hem. Werkt iets niet zoals het hoort, vertel RoCode dan wat je zag: Check Output kan de regels van Server en Client uit je laatste playtest lezen. Een pratende NPC is één systeem van vele; de pagina hoe je een Roblox-game maakt met AI, één systeem per prompt laat zien hoe ze samen een geheel vormen. Hoe RoCode verbinding maakt met Studio.

Veelgestelde vragen

Hoe maak je een pratende NPC in Roblox Studio?

Geef de NPC een ProximityPrompt en toon, als een speler die start, de regel van de NPC in een dialoogvenster, in een tekstballon of op beide plekken. De drie scripts uit deze handleiding doen allebei en voegen antwoordopties toe. Heb je alleen een tekstballon nodig, roep dan TextChatService:DisplayBubble(npc.Head, "Hello!") aan vanuit een LocalScript als de prompt afgaat, zoals in het voorbeeld met een NPC op de pagina van Roblox over bubble chat.

Wat kies je: het object Dialog of een eigen dialoog-GUI?

Het object Dialog heeft geen code nodig en toont een klikbare tekstballon, wat genoeg is voor decoratieve tekst. Zijn keuze-event gaat alleen af op het apparaat van de speler, dus het kan niet veilig beloningen geven, en standaard kan er maar één speler tegelijk mee praten. Een eigen venster, zoals in deze handleiding, laat de server elke beloning geven en geeft elke speler zijn eigen gesprek.

Hoe geef je een speler een item van een NPC?

Bewaar de Tool in ServerStorage en laat een server-Script hem naar de Backpack van de speler klonen als die de optie kiest, zoals de actie GiveItem doet. Controleer dat de speler er nog geen heeft en zet CanBeDropped uit op de kopie, zodat hij hem niet kan laten vallen en opnieuw kan vragen. Laat het apparaat van de speler nooit zeggen welk item er gegeven moet worden.

Hoe maak je een dialoogvenster met een typemachine-effect?

Zet de hele regel in een TextLabel, verhoog zijn MaxVisibleGraphemes vanaf 0 met een paar tekens tegelijk en zet hem aan het eind op -1 om alles te tonen. De pagina van Roblox over UI-animatie gebruikt dezelfde eigenschap samen met utf8.graphemes. DialogueClient berekent hoeveel tekens het toont uit de verstreken tijd, 45 per seconde, dus de snelheid hangt niet af van de framerate.

Kunnen twee spelers tegelijk met dezelfde NPC praten?

Met de scripts uit deze handleiding wel: de server houdt één gesprek per speler bij, en elke speler ziet alleen zijn eigen venster. Het ingebouwde object Dialog werkt anders: met zijn standaard BehaviorType, SinglePlayer, praat er één speler tegelijk, en de rest ziet zijn opties.

Moet je de tekst van een NPC-dialoog filteren?

Regels die je zelf hebt geschreven niet. Roblox maakt jou verantwoordelijk voor het filteren van getoonde tekst die je niet direct zelf beheert, zoals wat spelers intypen, woorden die uit willekeurige tekens zijn samengesteld of tekst die van een externe site is geladen. Herhaalt een NPC iets wat een speler heeft ingetypt, filter dan dat deel.

Bronnen en verder lezen

Hoe de code is gecontroleerd: elk script op deze pagina doorloopt een strikte Luau-typecontrole met de Roblox API-definities (luau-lsp, 20 november 2026). De typecontrole vangt fouten in API-namen en verkeerde types op, maar geen fouten in de gamelogica, dus test alles in Studio voordat je publiceert.

Probeer RoCode in je eigen game.

Elke dag gratis credits, geen creditcard nodig. Installeer de plugin, beschrijf een functie en kijk wat er in Studio verschijnt.