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
DialogChoiceSelectedvan 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 serviceChatis 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
Hoe een NPC-dialoog werkt
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:
- De speler loopt naar de NPC en drukt op E bij zijn prompt Talk. Het event
Triggeredvan de prompt gaat op de server af met die speler. - Het serverscript controleert of de speler dichtbij genoeg is, onthoudt dat hij bij de regel met de naam
startis, en stuurt de tekst van die regel en de labels van de opties alleen naar die speler. - Het LocalScript typt de regel in het dialoogvenster, toont een tekstballon boven de NPC en voegt daarna een knop per optie toe.
- De speler klikt, tikt of kiest een optie. Alleen het nummer ervan gaat terug naar de server.
- 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.
| Onderdeel | Waar het staat | Wat het doet |
|---|---|---|
Rig Guide | Workspace, in een map met de naam NPCs | De NPC zelf. Zijn naam kiest het gesprek en staat op de prompt. |
ModuleScript DialogueData | ReplicatedStorage | Alle regels die de NPC kan zeggen, de opties onder elke regel en waar elke optie naartoe leidt. |
Script DialogueService | ServerScriptService | Voegt de Talk-prompt toe, onthoudt bij welke regel elke speler is, controleert elke klik en voert de acties uit. |
RemoteEvent DialogueEvent | ReplicatedStorage (DialogueService maakt hem) | Brengt elke regel naar de speler, en het nummer van de gekozen optie terug naar de server. |
LocalScript DialogueClient | StarterPlayer, StarterPlayerScripts | Tekent het venster, typt de regel, toont de tekstballon en de knoppen met opties. |
Tool Torch (optioneel) | ServerStorage, in een map met de naam DialogueItems | Het item dat een van de opties geeft. Niets uit ServerStorage wordt naar spelers gestuurd. |
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
- 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. - 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. - 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.
- 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. - 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 naamTorchen één niet-geanchorde Part met de naamHandle, 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.
-- 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 regelstart. textis wat de NPC zegt.choiceszijn de knoppen van de speler, op volgorde. Het venster heeft plek voor vier.nextnoemt de regel die na deze optie getoond wordt. Een optie zondernext, zoals "Bye!", beëindigt het gesprek. EennextoffailNextdie een regel noemt die niet in de tabel staat, beëindigt het ook, met een waarschuwing in Output.actionnoemt wat de server doet, uit de tabelACTIONSin DialogueService: hier is datHealofGiveItem.itemis voor GiveItem: de naam van een Tool in ServerStorage, DialogueItems.failNextis de regel die in plaats vannextgetoond wordt als de actie mislukte, zodat de NPC nooit beweert dat hij je genas of iets gaf als dat niet gebeurde.
| Regel | Guide zegt | Opties 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.
-- 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.
| Instelling | Waarde hier | Wat het verandert |
|---|---|---|
TALK_DISTANCE | 12 | Hoe 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_CHOICES | 0.3 | De 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_SECONDS | 30 | Hoe 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:
| Controle | Code | Als hij niet slaagt |
|---|---|---|
| De speler zit in een gesprek | conversations[player] | De klik wordt genegeerd. |
| De optie is een geheel getal | typeof en math.floor | Genegeerd. Strings, tabellen, breuken en NaN stoppen hier. |
| 0 betekent dat de speler op X drukte | choiceIndex == 0 | Het gesprek eindigt. |
| Leeft en is nog steeds niet verder dan 16 studs (12 plus 4) | isClose | Het gesprek eindigt en het venster sluit. |
| Minstens 0.3 seconde sinds de laatste geaccepteerde klik | conversation.lastChoice | Dezelfde 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 leest | line.choices[choiceIndex] | Genegeerd. |
| De actie is gelukt | elke actie geeft true of false terug | In 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.
-- 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 gebruiktTextScaled, dat de tekst verkleint zodat hij op een klein telefoonscherm in zijn label past, enUITextSizeConstraintzorgt dat hij op een groot scherm niet groter wordt dan 20 pixels.UIGridLayoutzet de opties twee bij twee neer.ResetOnSpawnis 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
MaxVisibleGraphemesbepaalt hoeveel tekens zichtbaar zijn; dat is dezelfde eigenschap die het eigen typemachinevoorbeeld van Roblox gebruikt, samen metutf8.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
lineNumbervoorkomt 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.
Activatedgaat 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 alsPreferredInputzegt dat de speler een gamepad gebruikt, selecteert het script de eerste optie viaGuiService.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:
- Voeg aan
ACTIONSeen item toe met de naamStartQuest. Eerst de controle, dan de wijziging: alsplayer:GetAttribute("Quest")al gezet is, geef jefalseterug; anders roep jeplayer:SetAttribute("Quest", "Cave")aan en geef jetrueterug. - Geef in DialogueData een optie
action = "StartQuest", een regelnextvoor als het lukt en een regelfailNextvoor als het mislukt, bijvoorbeeld "You are already on a quest." - Druk op Play en kies de optie twee keer. Komt de naam in DialogueData niet overeen met de sleutel in
ACTIONS(hoofdletters tellen), dan verschijntDialogueService: no action named StartQuestin Output en gaat het gesprek naar de regelfailNext.
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
trueteruggeven. 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.
| Tutorial | Probleem | Deze handleiding |
|---|---|---|
Gebruikt het object Dialog, en een server-Script luistert naar DialogChoiceSelected om een beloning te geven | De 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 LocalScript | Een 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 regel | Een 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 afging | De 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 loop | De 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.
| De cheater probeert | Resultaat | Waarom |
|---|---|---|
| De Talk-prompt starten vanaf de andere kant van de map | Er gebeurt niets | startConversation controleert of hij niet verder dan 16 studs is (12 plus 4). |
| Optie 99, een string, een breuk of NaN sturen | Genegeerd | Het 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 sturen | Wordt nooit gelezen | De 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 toelaat | Eén klik per 0.3 seconde per gesprek | Op 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 gesprek | Onmogelijk | Items worden alleen gegeven via een optie op de regel waarvan de server weet dat de speler erbij is. |
| Een stapel fakkels verzamelen | Eén tegelijk | De 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 spammen | Eén keer genezen per 30 seconden | De cooldown staat op de server per speler, en de NPC meldt het met de regel healTooSoon. |
| Weglopen en het venster open laten | Sluit binnen een halve seconde | De server controleert elk open gesprek twee keer per seconde. |
| Het hele gesprek lezen, ook regels die hij niet bereikt heeft | Mogelijk | DialogueData 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
- Druk op Play (F5) en loop naar Guide. Binnen 12 studs verschijnt de prompt Talk met de naam Guide. Druk op E.
- Het venster toont "Guide", typt de welkomstregel en toont daarna vier knoppen. Dezelfde regel verschijnt in een tekstballon boven het hoofd van de NPC.
- 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.
- 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.
- 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.
- Begin een gesprek en loop weg. Het venster sluit ongeveer op het moment dat je 16 studs van Guide af bent.
- 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.
- 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.
- 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.
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.
- 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
- Roblox Creator Docs: Proximity prompts (in het Engels). prompts maken, MaxActivationDistance en RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (in het Engels). waar een prompt werkt, zijn tekst en standaardtoetsen, Triggered en de controle op vrij zicht
- Roblox Creator Docs: Securing the client-server boundary (in het Engels). ProximityPrompt als aanvalsoppervlak, controles op afstand en rechten
- Roblox Engine API: Dialog (in het Engels). BehaviorType en het event DialogChoiceSelected alleen op de client
- Roblox Engine API: TextChatService:DisplayBubble (in het Engels). tekstballonnen voor NPC's vanuit clientscripts
- Roblox Creator Docs: Customize bubble chat (in het Engels). tekstballonnen van NPC's en BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (in het Engels). welke getoonde tekst je moet filteren
- Roblox Creator Docs: UI animation and tweens (in het Engels). typemachine-effect met MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (in het Engels). wat Backspace met een tool doet
- Roblox Engine API: UserInputService.PreferredInput (in het Engels). hoe je een speler met een gamepad herkent
- Roblox Creator Docs: Rig Generator (in het Engels). een R15- of R6-rig invoegen
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.