Tutorial · Spielsysteme

NPC-Dialoge in Roblox Studio erstellen

Ein NPC-Dialog in Roblox besteht aus drei Teilen: einem Prompt, um das Gespräch zu starten, einer Box, die zeigt, was der NPC sagt, mit Buttons für die Antworten des Spielers, und einem Skript, das entscheidet, wohin jede Antwort führt. Dieser Guide baut alle drei: Du schreibst das Gespräch als einfache Tabelle, Spieler drücken E zum Reden, und alles, was eine Antwort gibt (eine Heilung, ein Item), vergibt der Server, nie das Gerät des Spielers.

Aktualisiert am 12. November 202623 Min. LesezeitGeschrieben von

Kurz gesagt

Leg dein NPC-Model in einen Ordner namens NPCs in Workspace und schreib sein Gespräch in ein ModuleScript in ReplicatedStorage: Jede Zeile hat den Text des NPCs und eine Liste von Antworten, die zu einer anderen Zeile führen. Ein Script in ServerScriptService gibt jedem NPC ein ProximityPrompt ("Talk"), merkt sich, bei welcher Zeile jeder Spieler ist, und schickt sie über ein RemoteEvent. Ein LocalScript zeigt den Text und einen Button pro Antwort und schickt nur die Nummer des gedrückten Buttons zurück.

  • Vergib Belohnungen auf dem Server. Das Event DialogChoiceSelected des eingebauten Dialog-Objekts feuert nur auf dem Client, also hört ein Server-Script es nie, und eine Heilung oder ein Item aus einem LocalScript ändert nur die eigene Kopie des Spiels dieses Spielers.
  • Zeig eine Sprechblase mit TextChatService:DisplayBubble(npc.Head, text) aus einem LocalScript. Der alte Service Chat ist zugunsten von TextChatService veraltet.
  • Zeilen, die du selbst schreibst, müssen nicht gefiltert werden. Die Regel von Roblox lautet, jeden angezeigten Text zu filtern, über den du keine ausdrückliche Kontrolle hast, etwa das, was Spieler tippen.
Auf dieser Seite
  1. So funktioniert es
  2. 1. NPC hinzufügen
  3. 2. Gespräch
  4. 3. Server-Script
  5. 4. Dialogbox
  6. Eigene Aktionen
  7. Andere Tutorials
  8. Grenzen für Exploits
  9. 5. Testen
  10. Erweitern
  11. Häufige Fehler
  12. Mit RoCode
  13. Häufige Fragen
  14. Quellen und weiterführende Links

So funktioniert ein NPC-Dialog

IllustrationJede Zeile wird in der Box getippt, während die ganze Zeile in einer Sprechblase steht, die Antworten erscheinen, sobald die Zeile fertig getippt ist, und der Server übergibt die Torch, wenn du "Got anything for the cave?" wählst.

Ein sprechender NPC, der in einem Live-Spiel funktioniert, ist zwischen dem Server und dem Gerät jedes Spielers aufgeteilt. Das Gerät zeichnet die Box und die Buttons. Der Server, die einzige Seite, der du vertrauen kannst, weiß, welche Zeile jeder Spieler gerade liest, und entscheidet, was jede Antwort bewirkt. Ein Schritt eines Gesprächs läuft so ab:

  1. Der Spieler geht zum NPC und drückt E an dessen Prompt Talk. Das Event Triggered des Prompts feuert auf dem Server mit diesem Spieler.
  2. Das Server-Script prüft, dass der Spieler nah genug ist, merkt sich, dass er bei der Zeile start ist, und schickt den Text dieser Zeile und die Beschriftungen ihrer Antworten nur an diesen Spieler.
  3. Das LocalScript tippt die Zeile in die Dialogbox, zeigt eine Sprechblase über dem NPC und fügt dann einen Button pro Antwort hinzu.
  4. Der Spieler klickt, tippt oder wählt eine Antwort aus. Nur ihre Nummer geht zurück an den Server.
  5. Der Server schlägt diese Nummer auf der Zeile nach, von der er weiß, dass der Spieler sie liest, führt die Aktion der Antwort aus, falls sie eine hat (eine Heilung, ein Item), und schickt die nächste Zeile oder schließt die Box.
Die Bausteine eines sprechenden NPCs
BausteinWo er liegtWas er macht
Rig GuideWorkspace, in einem Ordner namens NPCsDer NPC. Sein Name wählt sein Gespräch aus und steht am Prompt.
ModuleScript DialogueDataReplicatedStorageJede Zeile, die der NPC sagen kann, die Antworten unter jeder Zeile und wohin jede Antwort führt.
Script DialogueServiceServerScriptServiceFügt den Talk-Prompt hinzu, merkt sich, bei welcher Zeile jeder Spieler ist, prüft jeden Klick und führt die Aktionen aus.
RemoteEvent DialogueEventReplicatedStorage (DialogueService erstellt es)Trägt jede Zeile zum Spieler und die Nummer der angeklickten Antwort zurück zum Server.
LocalScript DialogueClientStarterPlayer, StarterPlayerScriptsZeichnet die Box, tippt die Zeile, zeigt die Sprechblase und die Antwort-Buttons.
Tool Torch (optional)ServerStorage, in einem Ordner namens DialogueItemsDas Item, das eine Antwort vergibt. Nichts in ServerStorage wird an Spieler gesendet.
Der Explorer, wenn der NPC fertig ist. Wenn das Spiel läuft, fügt DialogueService ein RemoteEvent namens DialogueEvent zu ReplicatedStorage hinzu und einen Talk-ProximityPrompt namens TalkPrompt zum HumanoidRootPart jedes NPCs.
Workspace
  NPCs Folder new
    Guide Model new
      Humanoid Humanoid
      HumanoidRootPart Part
      Head, UpperTorso, LowerTorso ... (die Körperteile)
ReplicatedStorage
  DialogueData ModuleScript new
ServerScriptService
  DialogueService Script new
ServerStorage
  DialogueItems Folder new
    Torch Tool new
      Handle Part new
StarterPlayer
  StarterPlayerScripts
    DialogueClient LocalScript new

Schritt 1: Einen NPC hinzufügen

  1. Klick im Tab Avatar oder Home auf Character, um den Rig Generator zu öffnen. Wähl R15, eine Körperform und einen Stil. Ein Rig namens Rig erscheint im Workspace. Ein R6-Rig funktioniert mit denselben Skripten.
  2. Benenn es in Guide um. Der Name ist wichtig: DialogueService sucht das Gespräch über den Namen des Models, und der Prompt zeigt ihn den Spielern.
  3. Klapp das Rig auf, wähl seinen HumanoidRootPart aus und hak im Properties-Fenster Anchored an. Ein verankerter Part bewegt sich nie durch Physik, also steht der NPC dort, wo du ihn hinstellst, und Spieler können ihn nicht herumschieben.
  4. Fahr im Explorer mit der Maus über Workspace, klick auf den Button + und füge einen Folder namens NPCs ein. Zieh Guide hinein und stell das Rig irgendwohin, wo Spieler hinlaufen können.
  5. Optional, für die Antwort mit dem Item: Fahr mit der Maus über ServerStorage und füge einen Folder namens DialogueItems ein. Leg ein Tool namens Torch hinein, mit einem nicht verankerten Part namens Handle, dem Part, den ein Charakter hält. Ein PointLight im Handle lässt ihn leuchten.

Bei Namen zählt die Groß- und Kleinschreibung, also tipp NPCs, Guide, DialogueItems und Torch genau wie gezeigt. Jedes Model mit einem Humanoid und einem HumanoidRootPart kann ein NPC sein, auch eins aus der Toolbox, solange es direkt im Ordner NPCs liegt.

Schritt 2: Das Gespräch schreiben

Fahr mit der Maus über ReplicatedStorage, füge ein ModuleScript namens DialogueData ein und füge das hier ein. Es enthält keine Logik, nur die Worte und wie sie zusammenhängen, also ist das die Datei, die du am meisten bearbeitest.

ModuleScript in ReplicatedStorage namens DialogueData
-- ModuleScript in ReplicatedStorage namens DialogueData.
-- Jedes Gespräch, sortiert nach dem Namen des NPCs in Workspace.NPCs. Jede Zeile hat den
-- Text des NPCs und die Antworten des Spielers. Eine Antwort kann zu einer anderen Zeile führen (next),
-- das Gespräch beenden (kein next) und den Server um etwas bitten (action). Wenn der Server
-- die Aktion nicht ausführen kann, zeigt er die Zeile failNext statt next.

export type Choice = {
	text: string,
	next: string?, -- die Zeile, die nach dieser Antwort kommt; nil beendet das Gespräch
	action: string?, -- eine Server-Aktion aus der Tabelle ACTIONS in DialogueService
	item: string?, -- für die Aktion GiveItem: der Name eines Tools in ServerStorage.DialogueItems
	failNext: string?, -- die Zeile, die statt next kommt, wenn die Aktion nicht ging
}

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

Die Zeilen mit export type oben beschreiben, wie eine Zeile und eine Antwort aussehen. Sie ändern nichts, wenn das Spiel läuft; sie beschreiben deine Daten, damit ein Typ-Checker sie prüfen kann.

So hängen die Teile zusammen:

  • Jeder NPC hat eine Tabelle, die nach seinem Model im Ordner NPCs benannt ist, hier Guide. Jedes Gespräch beginnt bei der Zeile start.
  • text ist, was der NPC sagt. choices sind die Buttons des Spielers, der Reihe nach. Die Box hat Platz für vier.
  • next nennt die Zeile, die nach dieser Antwort kommt. Eine Antwort ohne next, etwa "Bye!", beendet das Gespräch. Ein next oder failNext, das eine Zeile nennt, die in der Tabelle fehlt, beendet es auch, mit einer Warnung in Output.
  • action nennt etwas, das der Server tut, aus der Tabelle ACTIONS in DialogueService: hier Heal oder GiveItem.
  • item ist für GiveItem: der Name eines Tools in ServerStorage, DialogueItems.
  • failNext ist die Zeile, die statt next kommt, wenn die Aktion nicht ausgeführt werden konnte, damit der NPC nie eine Heilung oder ein Geschenk behauptet, das es nicht gab.
Das Gespräch des Guide, Zeile für Zeile
ZeileDer Guide sagtAntworten und wohin sie führen
start"Welcome to the village! What can I do for you?""Any tips?" führt zu tips. "I'm hurt. Can you help?" heilt, dann healed (oder healTooSoon). "Got anything for the cave?" gibt die Torch, dann torch (oder hasTorch). "Bye!" beendet.
tips"Stay off the red bricks, and come back if you get hurt.""Anything else?" geht zurück zu start. "Thanks!" beendet.
healed"There you go, good as new.""Thank you!" beendet.
torch"Take this torch. The cave is dark.""Thanks!" beendet.
healTooSoon"I healed you a moment ago. Come back in a little while.""OK" beendet.
hasTorch"You already have my torch. Keep it lit!""Will do!" beendet.

Nur der Server liest dieses Modul. Das LocalScript lädt es nie mit require: Der Server schickt jede Zeile, wenn der Spieler sie erreicht. Ein Modul in ReplicatedStorage wird trotzdem auf das Gerät jedes Spielers kopiert, also verschieb DialogueData nach ServerStorage, wenn ein Gespräch Spoiler enthält (etwa die Lösung eines Rätsels). Ändere dann in der require-Zeile von DialogueService ReplicatedStorage in ServerStorage, sodass die ganze Zeile local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } } lautet.

Schritt 3: Das Server-Script hinzufügen

Fahr mit der Maus über ServerScriptService, füge ein Script namens DialogueService ein und füge den Code unten ein. Es ist der einzige Ort, an dem ein Gespräch weitergeht, und der einzige Ort, an dem eine Belohnung vergeben wird.

Script in ServerScriptService namens DialogueService
-- Script in ServerScriptService namens DialogueService.
-- Gibt jedem NPC in Workspace.NPCs einen Talk-Prompt und führt jedes Gespräch.
-- Das Gerät des Spielers zeigt nur den Text und schickt die Nummer der Antwort zurück,
-- die er angeklickt hat. Der Server weiß, bei welcher Zeile jeder Spieler ist, prüft die Antwort
-- und die Entfernung und ist die einzige Seite, die heilt oder Items vergibt.

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

-- Dieselben Formen wie in DialogueData, damit der Typ-Checker von Studio sie auch hier kennt
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: die Reichweite des Prompts, und wie nah ein Spieler bleiben muss
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30

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

-- Dieses Skript erstellt DialogueEvent selbst, also füge keins von Hand hinzu
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 -- kein Charakter, ein toter, oder der NPC ist weg
	end
	-- etwas Spielraum, weil die Position des Spielers leicht verspätet beim Server ankommt
	return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end

-- Was der Server tut, wenn eine Antwort eine Aktion hat. Jede gibt true zurück, wenn sie es getan hat.
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 -- zu kürzlich geheilt
		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 -- noch kein Backpack, oder er hat schon eins
		end
		local item = template:Clone() :: Tool
		item.CanBeDropped = false -- damit niemand es fallen lassen und ein neues verlangen kann
		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 -- redet schon, keine Zeile "start" für diesen NPC, tot oder zu weit weg
	end
	local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
	conversations[player] = conversation
	showLine(player, conversation)
end

-- Der Spieler hat Antwort Nummer choiceIndex angeklickt (0 heißt, er hat die Box geschlossen)
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
		-- Zu schnell. Dieselbe Zeile noch mal schicken, weil die Box ihre Buttons nach dem Klick
		-- schon gesperrt hat und sonst ewig auf eine Antwort warten würde.
		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 -- diese Antwort gibt es auf der Zeile nicht, die dieser Spieler gerade liest
	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 -- zum Beispiel "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)

-- Ein Talk-Prompt an jedem 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() -- eine Kopie eines NPCs bringt den alten Prompt mit, auf den nichts hört
	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)

-- Die Box für jeden schließen, der mitten im Gespräch weggeht oder stirbt
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 erstellt das RemoteEvent DialogueEvent beim Spielstart selbst, also musst du nichts von Hand in ReplicatedStorage einfügen. Wenn du schon ein RemoteEvent mit diesem Namen angelegt hast, lösch es: Das LocalScript könnte deins finden, auf das auf dem Server nichts hört.

Die Einstellungen oben in DialogueService
EinstellungWert hierWas sie ändert
TALK_DISTANCE12Wie nah, in Studs, ein Spieler sein muss, damit der Talk-Prompt erscheint. Der Server lässt ihn 4 Studs weiter abdriften, bevor er die Box schließt, weil seine Position leicht verspätet beim Server ankommt.
MIN_SECONDS_BETWEEN_CHOICES0.3Die kürzeste Zeit zwischen zwei Klicks, die der Server annimmt. Bei einem schnelleren Klick kommt dieselbe Zeile noch einmal statt einer Antwort.
HEAL_COOLDOWN_SECONDS30Wie lange jeder Spieler zwischen zwei Heilungen aus der Aktion Heal wartet.

Der Server hält in conversations einen Eintrag pro Spieler: mit welchem NPC er redet, welche Zeile er liest und wann sein letzter Klick angenommen wurde. Wenn der Talk-Prompt feuert, legt startConversation diesen Eintrag nur an, wenn der Spieler nicht schon redet, der NPC eine Zeile start hat und der Spieler lebt und in Reichweite ist. Danach läuft jeder Klick durch diese Prüfungen:

Was DialogueService bei jedem Klick prüft
PrüfungCodeWenn sie scheitert
Der Spieler ist in einem Gesprächconversations[player]Der Klick wird ignoriert.
Die Antwort ist eine ganze Zahltypeof und math.floorWird ignoriert. Strings, Tabellen, Brüche und NaN bleiben alle hier hängen.
0 heißt, der Spieler hat X gedrücktchoiceIndex == 0Das Gespräch endet.
Am Leben und noch höchstens 16 Studs entfernt (12 plus 4)isCloseDas Gespräch endet, und die Box schließt sich.
Mindestens 0,3 Sekunden seit dem letzten angenommenen Klickconversation.lastChoiceDieselbe Zeile wird noch einmal geschickt, also bekommt die Box frische Buttons, statt ewig zu warten.
Die Antwort existiert auf der Zeile, die dieser Spieler liestline.choices[choiceIndex]Wird ignoriert.
Die Aktion hat geklapptjede Aktion gibt true oder false zurückDie Zeile failNext kommt statt next.

Der Prompt kommt auf den HumanoidRootPart des NPCs, weil ein ProximityPrompt funktioniert, wenn er in einem Part (oder einem Attachment, oder einem Model mit PrimaryPart) im Workspace liegt. Sein RequiresLineOfSight ist standardmäßig an, was den Prompt versteckt, sobald etwas den Blick von der Kamera auf diesen Part versperrt. Roblox nimmt den eigenen Part des Prompts von dieser Prüfung aus, aber nicht den Rest des Körpers, und der HumanoidRootPart sitzt im Torso, also schaltet das Skript die Sichtlinie aus. Der Prompt heißt TalkPrompt, und das Skript löscht jeden TalkPrompt, der schon am Part hängt, bevor es seinen eigenen hinzufügt: Eine Kopie eines NPCs, die im laufenden Spiel entsteht, kommt mit dem Prompt des Originals an, und auf einen kopierten hört nichts. Wenn DialogueData für den Namen des NPCs kein Gespräch mit einer Zeile start hat, zeigt Output eine Warnung mit dem Namen des NPCs.

Eine Schleife prüft jedes offene Gespräch zweimal pro Sekunde und schließt es, wenn der Spieler mehr als 16 Studs entfernt oder sein Charakter gestorben ist, damit ein Spieler, der mitten im Gespräch stirbt, nicht mit offener Box respawnt. PlayerRemoving leert beide Tabellen, wenn jemand geht.

Schritt 4: Die Dialogbox hinzufügen

Öffne StarterPlayer, fahr mit der Maus über StarterPlayerScripts, füge ein LocalScript namens DialogueClient ein und füge das hier ein. Es baut die Dialogbox im Code, also musst du kein GUI von Hand zeichnen.

LocalScript in StarterPlayer > StarterPlayerScripts namens DialogueClient
-- LocalScript in StarterPlayer > StarterPlayerScripts namens DialogueClient.
-- Zeichnet das Gespräch, das der Server schickt: den Namen des NPCs, seine Zeile, Buchstabe für
-- Buchstabe getippt, eine Sprechblase über seinem Kopf und einen Button pro Antwort. Ein Klick auf
-- eine Antwort schickt nur ihre Nummer; der Server entscheidet, was als Nächstes passiert.

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)

-- Die Dialogbox, im Code gebaut
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 Pixel nach oben, damit die Tool-Leiste von Roblox nie die Antworten verdeckt
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 -- eine lange Zeile schrumpft, damit sie auf einen kleinen Handy-Bildschirm passt
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- und wird auf einem großen nie größer als 20 Pixel
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 -- steigt mit jeder neuen Zeile, damit eine alte Tipp-Schleife aufhört

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 -- nur auf diesem Gerät geändert
	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()

	-- Eine Sprechblase über dem NPC (DisplayBubble funktioniert nur in einem LocalScript)
	local head = npc:FindFirstChild("Head")
	if head then
		TextChatService:DisplayBubble(head, text)
	end

	-- Die Zeile Buchstabe für Buchstabe tippen. Die Anzahl ergibt sich aus der vergangenen Zeit,
	-- also ist das Tempo bei jeder Framerate gleich.
	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 -- eine neuere Zeile oder ein Schließen hat diese ersetzt
		end
		shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
		lineLabel.MaxVisibleGraphemes = shown
	end
	lineLabel.MaxVisibleGraphemes = -1

	-- Ein Button pro Antwort; der Server bekommt immer nur die Nummer des Buttons
	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 -- ein Klick pro Zeile
				dialogueEvent:FireServer(index)
			end
		end)
		if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
			GuiService.SelectedObject = button -- damit ein Controller eine Antwort wählen kann
		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)

Die Farben, Größen und LETTERS_PER_SECOND kannst du frei ändern. Lass die letzten beiden Handler, wie sie sind: Sie sind der einzige Weg, auf dem die Box mit dem Server redet.

Was jeder Teil von DialogueClient macht:

  • Die Box. Ein ScreenGui mit einem Frame, der unten in der Mitte des Bildschirms verankert ist, 60 % seiner Breite und 34 % seiner Höhe, durch einen UISizeConstraint auf 720 mal 300 Pixel begrenzt, damit er sich auf einem breiten Monitor nicht in die Länge zieht. Die Zeile des NPCs nutzt TextScaled, das den Text auf einem kleinen Handy-Bildschirm so verkleinert, dass er in sein Label passt, und ein UITextSizeConstraint verhindert, dass er auf einem großen über 20 Pixel wächst. Ein UIGridLayout ordnet die Antworten zwei mal zwei an. ResetOnSpawn ist false, weil dieses LocalScript einmal pro Sitzung läuft: Eine Box, die beim Respawn gelöscht wird, käme nie zurück.
  • Die Schreibmaschine. Die ganze Zeile kommt auf einmal in das TextLabel, und MaxVisibleGraphemes bestimmt, wie viele Zeichen zu sehen sind, dieselbe Eigenschaft, die das Roblox-eigene Schreibmaschinen-Beispiel mit utf8.graphemes nutzt. Roblox setzt den Text so, als wäre jedes Zeichen sichtbar, also springen Wörter beim Erscheinen nicht in eine neue Zeile und ändern nicht ihre Größe. Das Skript berechnet aus der vergangenen Zeit, wie viele es zeigt, 45 pro Sekunde, also ist das Tempo bei jeder Framerate gleich, und setzt die Eigenschaft dann auf -1, was alles zeigt.
  • Die Buttons. Sie erscheinen, sobald die Zeile fertig getippt ist. Jeder schickt nur seine Nummer, und zwar einmal: Die Prüfung von lineNumber verhindert, dass ein Doppelklick zweimal sendet, und die Box wartet dann auf die nächste Zeile des Servers.
  • Die Sprechblase. TextChatService:DisplayBubble(head, text) setzt die Zeile in eine Chat-Blase über dem Head des NPCs. Roblox erlaubt das nur in Client-Skripten, und Bubble Chat ist standardmäßig an. Weil das Gerät dieses Spielers sie zeichnet, gehört die Blase ihm allein.
  • Der Prompt. Während ein Spieler redet, wird seine Kopie des Talk-Prompts (gefunden über den Namen TalkPrompt) ausgeschaltet, damit sie nicht über dem Gespräch liegt. Andere Spieler sehen ihre weiterhin.
  • Jedes Gerät. Activated feuert bei einem Mausklick, einem Tippen auf dem Handy und der A-Taste eines Controllers. Ein Controller kann nur einen Button drücken, der ausgewählt ist, also wählt das Skript mit GuiService.SelectedObject die erste Antwort aus, wenn PreferredInput sagt, dass der Spieler ein Gamepad benutzt.
  • Der X-Button. Er schickt 0, was der Server als „Gespräch beenden“ versteht, und schließt die Box sofort.

Eigene Aktionen hinzufügen

Eine Aktion ist eine Funktion in der Tabelle ACTIONS weit oben in DialogueService. Sie bekommt den Spieler und die Antwort und gibt true zurück, wenn sie ihre Aufgabe erledigt hat. So fügst du eine hinzu, zum Beispiel eine Quest, die ein NPC vergibt:

  1. Füge ACTIONS einen Eintrag namens StartQuest hinzu. Erst prüfen, dann ändern: Wenn player:GetAttribute("Quest") schon gesetzt ist, gib false zurück; sonst ruf player:SetAttribute("Quest", "Cave") auf und gib true zurück.
  2. Gib in DialogueData einer Antwort action = "StartQuest", eine Zeile next für den Erfolg und eine Zeile failNext für den Fehlschlag, etwa "You are already on a quest."
  3. Drück auf Play und wähl die Antwort zweimal. Wenn der Name in DialogueData nicht zum Key in ACTIONS passt (Großbuchstaben zählen), zeigt Output DialogueService: no action named StartQuest, und das Gespräch geht zur Zeile failNext.

Regeln für eigene Aktionen:

  • Mach die Prüfung und die Änderung in der Aktion, auf dem Server. Das Einzige, was das Gerät des Spielers schickt, ist die Nummer einer Antwort.
  • Lies das, was die Aktion braucht, aus der Antwort (wie item) oder aus dem eigenen Zustand des Servers, nie aus dem Remote.
  • Begrenz alles Wertvolle in der Aktion selbst, so wie Heal seinen eigenen Cooldown von 30 Sekunden in lastHeal hält. Das Klick-Limit von 0,3 Sekunden bremst nur das Klicken; es hindert einen Spieler nicht daran, dieselbe Antwort wieder und wieder zu durchlaufen.
  • Um ein anderes Fenster zu öffnen, etwa einen Shop, kann eine Aktion ein RemoteEvent an diesen Spieler feuern und true zurückgeben. Was in diesem Fenster passiert, braucht trotzdem seine eigenen Server-Prüfungen, wie in Ein Händler-NPC.

Was andere Tutorials zu NPC-Dialogen falsch machen

Wenn du diesen Guide mit einem Video oder einem Forenbeitrag vergleichst: Das sind die Unterschiede, die zählen, mit dem Grund, warum jedes Muster ein Problem ist.

Häufige Muster in Tutorials zu NPC-Dialogen und was dieser Guide stattdessen macht
Das TutorialDas ProblemDieser Guide
Nutzt das Dialog-Objekt, mit einem Server-Script, das auf DialogChoiceSelected hört, um eine Belohnung zu gebenDie Referenz von Roblox sagt, dass dieses Event nur auf dem Client existiert und auf dem Server nicht feuert, also kommt die Belohnung nie an.Die Antwort erreicht den Server als Nummer, und der Server führt die Belohnung aus.
Gibt die Belohnung aus einem LocalScriptEine Änderung, die ein LocalScript macht, bleibt auf diesem einen Gerät (siehe was repliziert wird (auf Englisch)), und ein Cheater kann denselben Code ausführen, wann immer er will.Jede Aktion liegt in DialogueService.
Lässt den NPC mit game:GetService("Chat"):Chat(head, text) sprechenDer Service Chat ist zugunsten von TextChatService veraltet.TextChatService:DisplayBubble im LocalScript.
Schickt den Namen der Belohnung oder die ID der nächsten Zeile vom ClientEin Cheater kann jeden Item-Namen schicken oder direkt zu der Zeile springen, die die Belohnung gibt.Der Client schickt nur die Nummer der Antwort. Der Server schlägt sie auf der Zeile nach, von der er weiß, dass der Spieler sie liest.
Prüft nichts mehr, sobald der Prompt ausgelöst istDer Security-Guide von Roblox führt ProximityPrompts neben Remotes als etwas auf, das Clients missbrauchen können, und fragt vor dem Handeln, ob der Spieler nah genug ist.Die Entfernung wird beim Start des Gesprächs geprüft, bei jedem Klick und zweimal pro Sekunde, solange es offen ist.
Tippt den Text mit wait() in einer SchleifeDas globale wait ist zugunsten von task.wait veraltet.Berechnet die sichtbaren Buchstaben aus os.clock() und wartet mit task.wait().

Was ein Spieler fälschen kann und was nicht

Geh davon aus, dass ein Cheater alles auf seinem eigenen Gerät kontrolliert. Er kann deine LocalScripts und alles in ReplicatedStorage lesen, DialogueEvent mit beliebigen Argumenten so oft feuern, wie er will, und den Talk-Prompt per Code auslösen, wovor der Security-Guide von Roblox warnt. DialogueService antwortet mit Server-Prüfungen der Art, die Argumente von RemoteEvents prüfen behandelt. Das bringt es ihm.

Was ein Cheater versuchen kann und was DialogueService dagegen tut
Ein Cheater versuchtErgebnisWarum
Den Talk-Prompt vom anderen Ende der Map auszulösenNichts passiertstartConversation prüft, dass er höchstens 16 Studs entfernt ist (12 plus 4).
Antwort 99, einen String, einen Bruch oder NaN zu schickenWird ignoriertEs ist keine ganze Zahl, oder es gibt diese Antwort auf der Zeile nicht, die er liest.
Einen Belohnungsnamen oder eine Zeilen-ID zu schickenWird nie gelesenDer Server liest nur die Nummer der Antwort. Belohnungen kommen aus den Feldern item und action in der Kopie der Zeile auf dem Server.
So schnell zu klicken, wie das Netzwerk erlaubtEin Klick pro 0,3 Sekunden pro GesprächBei schnelleren Klicks kommt die eigene Zeile zurück. Das Gespräch zu beenden und neu zu starten überspringt diese Wartezeit, und deshalb haben Heal und GiveItem ihre eigenen Limits.
Die Torch zu verlangen, ohne zu redenUnmöglichItems kommen nur aus einer Antwort auf der Zeile, von der der Server weiß, dass er bei ihr ist.
Einen Stapel Torches zu sammelnImmer nur eineDer Server prüft zuerst seinen Backpack und Charakter auf eine Torch, und die Torch, die er vergibt, lässt sich nicht fallen lassen, also kann man sie nicht farmen, indem man sie fallen lässt und neu fragt.
Die Heil-Zeile zu spammenEine Heilung alle 30 SekundenDer Cooldown wird pro Spieler auf dem Server gehalten, und der NPC sagt das mit der Zeile healTooSoon.
Wegzugehen und die Box offen zu lassenInnerhalb einer halben Sekunde geschlossenDer Server prüft jedes offene Gespräch zweimal pro Sekunde.
Das ganze Gespräch zu lesen, auch Zeilen, die er noch nicht erreicht hatMöglichDialogueData liegt in ReplicatedStorage, das auf jedes Gerät kopiert wird. Verschieb es nach ServerStorage, wenn das wichtig ist (siehe Schritt 2).

Eine Grenze verdient eine klare Antwort: Ein Cheater, der zum Guide geht und die Antworten wählt, bekommt genau das, was ein ehrlicher Spieler bekommt. Der Server kontrolliert, wie oft und von wo, nicht wer. Alles Knappe, etwa eine Belohnung, die jeder Spieler nur einmal abholen darf, braucht eine Prüfung, die dem Server gehört, wie ein Attribut, das beim Abholen gesetzt wird, oder ein Flag, das mit einem Data Store gespeichert wird.

Schritt 5: Testen

  1. Drück auf Play (F5) und geh zum Guide. Ab 12 Studs erscheint ein Prompt Talk mit dem Namen Guide. Drück E.
  2. Die Box zeigt "Guide", tippt die Begrüßungszeile und zeigt dann vier Buttons. Dieselbe Zeile erscheint in einer Sprechblase über dem Kopf des NPCs.
  3. Wähl "Any tips?", dann "Anything else?": Du bist wieder bei der ersten Zeile. Wähl "Bye!": Die Box schließt sich, und der Talk-Prompt kommt zurück.
  4. Verletz dich zuerst: Klick auf den Umschalter Client/Server, um zum Server zu wechseln, wähl im Workspace den Humanoid deines Charakters aus, setz im Properties-Fenster Health auf 50 und wechsel zurück zum Client. Spieler-Charaktere regenerieren jede Sekunde 1 % ihrer MaxHealth, also sprich sofort mit dem Guide und wähl "I'm hurt. Can you help?": Dein Leben springt auf voll. Sprich innerhalb von 30 Sekunden noch mal mit ihm und wähl es wieder: keine Heilung, und der Guide sagt, dass er dich gerade erst geheilt hat.
  5. Wähl "Got anything for the cave?": Die Torch erscheint in deiner Hotbar. Rüste sie aus und drück die Rücktaste: Sie bleibt in deiner Hand. Frag noch mal: keine zweite Torch, und der Guide sagt, dass du sie schon hast.
  6. Fang ein Gespräch an und geh dann weg. Die Box schließt sich ungefähr dann, wenn du 16 Studs vom Guide entfernt bist.
  7. Wähl im Dropdown für den Testmodus Server & Clients, stell 2 Clients ein und drück auf Play. Beide Spieler können gleichzeitig mit dem Guide reden, jeder bei seiner eigenen Zeile.
  8. Prüf einen Controller mit dem Controller Emulator (Controller, im Tab Emulation) während eines Playtests. Lauf mit dem emulierten Pad hin und drück die Taste des Prompts (standardmäßig ButtonX): Wenn die Antworten erscheinen, ist die erste ausgewählt, und A wählt sie.
  9. Prüf einen Handy-Bildschirm mit dem Device Simulator von Studio (zum Zeitpunkt des Schreibens eine Beta: Schalte New Device Simulator unter File, Beta Features ein und starte Studio neu). Wähl ein Handy, klick auf Rotate, bis es im Querformat ist, drück auf Play, geh zum Guide und tipp auf den Talk-Prompt. Wähl "Any tips?": Die ganze Zeile steht über den Antwort-Buttons, wenn nötig in kleinerer Schrift, ohne in sie hineinzulaufen.

Lass das Output-Fenster die ganze Zeit offen (Menü Window, dann Output). Diese Skripte geben nichts aus, wenn sie funktionieren, also ist jeder rote Fehler oder jede Warnung, die mit DialogueService: beginnt, ein echtes Problem. Siehe Häufige Fehler.

Den Dialog erweitern

Mehr NPCs und längere Gespräche

Füge dem Ordner NPCs ein weiteres Rig mit eigenem Namen hinzu und in DialogueData eine Tabelle mit demselben Namen, die eine Zeile start hat. DialogueService gibt jedem Model im Ordner, das einen HumanoidRootPart hat, den Talk-Prompt, auch denen, die im laufenden Spiel dazukommen; eine Kopie eines NPCs bekommt einen frischen Prompt anstelle des mitkopierten. Zwei NPCs mit demselben Namen nutzen dieselbe Tabelle. Zeilen können in beliebiger Reihenfolge verknüpft sein, und eine Antwort kann zu einer früheren Zeile zurückführen, wie es "Anything else?" tut. Bleib bei höchstens vier Antworten pro Zeile, weil die Box sie zwei mal zwei anordnet.

Zeilen, die vom Fortschritt abhängen

Um wiederkehrende Spieler anders zu begrüßen, wähl die erste Zeile anhand von etwas, das dem Server gehört. Wähl sie in startConversation mit local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", prüf, dass die Zeile existiert, so wie das Skript lines.start prüft, und nimm firstLine statt "start", wenn das Gespräch angelegt wird. Setz das Attribut in einer Aktion und füge der Tabelle des Guide eine Zeile welcomeBack hinzu. Attribute halten eine Sitzung; um dir den Spieler über mehrere Besuche zu merken, speichere das Flag mit einem Data Store wie im DataStore-Tutorial.

Ein Händler-NPC

Bau den Shop aus dem Guide zum Shop-GUI, füge dann eine Aktion OpenShop hinzu, die ein RemoteEvent an diesen Spieler feuert und true zurückgibt, und lass das LocalScript des Shops sein Fenster öffnen, wenn dieses Event ankommt. Käufe laufen weiter durch die eigenen Server-Prüfungen des Shops. Wenn Kaufen nur in der Nähe des NPCs gehen soll, prüf die Entfernung auch im Kauf-Handler, weil ein Client das Remote des Shops von überall aufrufen kann.

NPCs, die laufen

Damit der Guide umherwandert oder Spielern folgt, nimm den Guide zu NPC-Pathfinding und entferne den Haken bei Anchored am HumanoidRootPart, damit er sich bewegen kann. Der Talk-Prompt sitzt auf diesem Part, also wandert er mit dem NPC mit, und die Entfernungsprüfungen nutzen denselben Part. Pausier das Laufen, solange ein Gespräch offen ist, sonst schließt sich die Box, sobald der NPC mehr als 16 Studs vom Spieler wegläuft.

Schlüssel, Quests und andere Belohnungen

GiveItem vergibt jedes Tool in DialogueItems, also kann ein NPC den Schlüssel geben, den eine verschlossene Tür prüft, wie im Tür-Guide. Für Items, die beim Benutzen etwas tun, etwa Essen, das heilt, siehe den Inventar-Guide.

Sounds und die Kamera

Für einen Sprachclip oder einen Piepton bei jeder Zeile leg einen Sound in den Head des NPCs und spiel ihn aus show in DialogueClient ab. Wie du die Kamera auf den NPC richtest, während er redet, zeigt der Guide zu Cutscenes: Dort übernimmt ein LocalScript die Kamera und gibt sie wieder zurück.

Häufige Fehler und Lösungen

Öffne das Output-Fenster (Menü Window, dann Output), bevor du auf Play drückst. Die meisten Dialog-Probleme geben dort eine Warnung aus oder kommen von einem Namen, der nicht passt.

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

DialogueClient wartet auf das Remote, das DialogueService erstellt, also ist DialogueService noch nicht so weit gekommen. Prüf, dass es ein Script ist, kein LocalScript, direkt in ServerScriptService, und dass es nicht deaktiviert ist. DialogueService wartet zuerst auf DialogueData in ReplicatedStorage und den Ordner NPCs im Workspace, also hält ein fehlender oder falsch geschriebener Name es ebenfalls auf; Output zeigt dann eine Infinite-yield-Warnung von DialogueService, die ihn nennt.

Über meinem NPC erscheint kein Talk-Prompt

DialogueService fügt Prompts nur zu Models direkt in Workspace, NPCs hinzu, die einen Part namens HumanoidRootPart haben. Prüf beides und geh auf 12 Studs heran. Einem Rig aus der Toolbox kann dieser Part fehlen, oder es ist eine andere Art von Objekt, das in einen Ordner verpackt ist.

Der Prompt erscheint, aber E drücken bewirkt nichts

Der Server hat kein Gespräch für diesen NPC gefunden, und beim Spielstart zeigt Output DialogueService: no conversation with a start line for Guide in DialogueData, mit dem Namen deines NPCs. Die Tabelle in DialogueData muss exakt den Namen des Models haben, auch in der Groß- und Kleinschreibung, und eine Zeile namens start.

Eine Antwort schließt die Box, statt zur nächsten Zeile zu gehen

Output zeigt DialogueService: no line named tip for Guide in DialogueData, mit deinen Namen: Das next (oder failNext) der Antwort nennt eine Zeile, die nicht in der Tabelle dieses NPCs steht. Bei Zeilennamen zählt die Groß- und Kleinschreibung, also vergleich die Schreibweise mit der Tabelle, hier tips.

Die Box funktioniert, aber es gibt keine Sprechblase

Die Blase braucht einen Part namens Head direkt im NPC-Model und eingeschalteten Bubble Chat: Wähl im Explorer BubbleChatConfiguration unter TextChatService aus und prüf, dass Enabled angehakt ist. Standardmäßig ist es an.

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

Der Server konnte das Item nicht finden. Prüf, dass der Ordner in ServerStorage DialogueItems heißt und ein Tool enthält (kein Model und keinen Part), das exakt so heißt wie das item der Antwort. Bis du das behoben hast, antwortet der Guide mit der Zeile hasTorch, weil die Aktion fehlgeschlagen ist.

Output meldet DialogueService: no action named ...

Die action einer Antwort passt zu keinem Key in der Tabelle ACTIONS. Bei den Namen zählt die Groß- und Kleinschreibung: heal ist nicht Heal.

Mit RoCode bauen

Wenn du den NPC lieber beschreibst, als ihn von Hand zu verdrahten, kann RoCode diese Skripte in das Spiel schreiben, das du offen hast. Es ist ein unabhängiger KI-Agent für Roblox Studio und stammt nicht von Roblox: Du tippst in einem Webchat, und sein Studio-Plugin erstellt und bearbeitet die Skripte in deinem Explorer. Prompts kannst du auf Deutsch schreiben.

Du schreibst

Lass das Model Guide in Workspace.NPCs sprechen: ein Talk-Prompt, eine Dialogbox mit getippten Zeilen und Antwort-Buttons, eine Sprechblase, eine Heil-Antwort mit 30 Sekunden Cooldown und eine Antwort, die einmal das Tool Torch aus ServerStorage gibt. Leg das Gespräch in ein ModuleScript und vergib jede Belohnung auf dem Server.

RoCode macht
  • Kann sich zuerst das Model ansehen und mit Get Properties wichtige Werte lesen, etwa Anchored an seinen Parts und WalkSpeed an seinem Humanoid. Tipp / im Chat, um den genauen Pfad des Models anzuhängen
  • Schreibt das ModuleScript DialogueData, das Script DialogueService und das LocalScript DialogueClient mit Create Script
  • Ist angewiesen, jedes Skript, das es schreibt, mit Check Script auf Kompilierfehler zu prüfen; das kompiliert es in Studio, ohne es auszuführen
  • Schickt seine Änderungen in Runden, und jede Runde ist ein Undo-Punkt im Verlauf von Studio

Mit Plugin 3.9 oder neuer kann RoCode einen kurzen Playtest machen und die Fehler lesen, und mit Plugin 3.9.11 oder neuer kann es einen Test-Charakter steuern, um zu prüfen, ob das Spiel funktioniert, aber es macht keine Screenshots, während das Spiel läuft, also geh selbst zum NPC und sprich mit ihm. Wenn sich etwas falsch verhält, sag RoCode, was du gesehen hast: Check Output kann die Server- und Client-Zeilen deines letzten Playtests lesen. Ein sprechender NPC ist ein System unter vielen; ein Roblox-Spiel mit KI erstellen, ein System pro Prompt zeigt, wie sie zusammenpassen. Wie sich RoCode mit Studio verbindet.

Häufige Fragen

Wie lasse ich einen NPC in Roblox Studio sprechen?

Gib dem NPC ein ProximityPrompt und zeig seine Zeile in einer Dialogbox, einer Sprechblase oder beidem, wenn ein Spieler es auslöst. Die drei Skripte in diesem Guide machen beides und fügen Antworten hinzu. Nur für eine Blase rufst du TextChatService:DisplayBubble(npc.Head, "Hello!") aus einem LocalScript auf, wenn der Prompt ausgelöst wird, wie im NPC-Beispiel auf der Roblox-Seite zu Bubble Chat.

Soll ich das Dialog-Objekt oder ein eigenes Dialog-GUI nehmen?

Das Dialog-Objekt braucht keinen Code und zeigt eine anklickbare Sprechblase, was für Stimmungstext reicht. Sein Antwort-Event feuert nur auf dem Gerät des Spielers, also kann es nicht sicher Belohnungen vergeben, und standardmäßig kann immer nur ein Spieler damit reden. Mit einer eigenen Box wie in diesem Guide führt der Server jede Belohnung aus, und jeder Spieler bekommt sein eigenes Gespräch.

Wie gebe ich dem Spieler ein Item von einem NPC?

Lass das Tool in ServerStorage und lass ein Server-Script es in den Backpack des Spielers klonen, wenn er diese Antwort wählt, wie es die Aktion GiveItem macht. Prüf, dass er noch keins hat, und schalte CanBeDropped an der Kopie aus, damit man sie nicht fallen lassen und neu verlangen kann. Lass nie das Gerät des Spielers sagen, welches Item vergeben wird.

Wie baue ich eine Dialogbox mit Schreibmaschinen-Effekt?

Setz die ganze Zeile in ein TextLabel, erhöh sein MaxVisibleGraphemes von 0 aus immer um ein paar Zeichen und setz es am Ende auf -1, um alles zu zeigen. Die Roblox-Seite zu UI-Animation nutzt dieselbe Eigenschaft mit utf8.graphemes. DialogueClient berechnet aus der vergangenen Zeit, wie viele Zeichen es zeigt, 45 pro Sekunde, also hängt das Tempo nicht von der Framerate ab.

Können zwei Spieler gleichzeitig mit demselben NPC reden?

Mit den Skripten in diesem Guide ja: Der Server hält ein Gespräch pro Spieler, und jeder Spieler sieht nur seine eigene Box. Beim eingebauten Dialog-Objekt ist das anders: Mit seinem Standard-BehaviorType, SinglePlayer, redet immer nur ein Spieler, und die anderen sehen die Antworten dieses Spielers.

Muss ich den Dialogtext von NPCs filtern?

Zeilen, die du selbst geschrieben hast, nicht. Roblox macht dich dafür verantwortlich, angezeigten Text zu filtern, über den du keine ausdrückliche Kontrolle hast, etwa das, was Spieler tippen, Wörter aus zufälligen Zeichen oder Text von einer externen Website. Wenn ein NPC etwas wiederholt, das ein Spieler getippt hat, filtere diesen Teil.

Quellen und weiterführende Links

So wurde der Code geprüft: Jedes Skript auf dieser Seite besteht die strikte Typprüfung von Luau mit den Roblox API-Definitionen (luau-lsp, 12. November 2026). Eine Typprüfung findet falsch geschriebene APIs und falsche Typen, aber keine Fehler in der Spiellogik. Teste also in Studio, bevor du veröffentlichst.

Probier RoCode in deinem eigenen Spiel aus.

Jeden Tag kostenlose Credits, ohne Karte. Installiere das Plugin, beschreibe das Feature und prüfe, was in Studio ankommt.