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
DialogChoiceSelecteddes 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 ServiceChatist 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
So funktioniert ein NPC-Dialog
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:
- Der Spieler geht zum NPC und drückt E an dessen Prompt Talk. Das Event
Triggereddes Prompts feuert auf dem Server mit diesem Spieler. - Das Server-Script prüft, dass der Spieler nah genug ist, merkt sich, dass er bei der Zeile
startist, und schickt den Text dieser Zeile und die Beschriftungen ihrer Antworten nur an diesen Spieler. - Das LocalScript tippt die Zeile in die Dialogbox, zeigt eine Sprechblase über dem NPC und fügt dann einen Button pro Antwort hinzu.
- Der Spieler klickt, tippt oder wählt eine Antwort aus. Nur ihre Nummer geht zurück an den Server.
- 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.
| Baustein | Wo er liegt | Was er macht |
|---|---|---|
Rig Guide | Workspace, in einem Ordner namens NPCs | Der NPC. Sein Name wählt sein Gespräch aus und steht am Prompt. |
ModuleScript DialogueData | ReplicatedStorage | Jede Zeile, die der NPC sagen kann, die Antworten unter jeder Zeile und wohin jede Antwort führt. |
Script DialogueService | ServerScriptService | Fügt den Talk-Prompt hinzu, merkt sich, bei welcher Zeile jeder Spieler ist, prüft jeden Klick und führt die Aktionen aus. |
RemoteEvent DialogueEvent | ReplicatedStorage (DialogueService erstellt es) | Trägt jede Zeile zum Spieler und die Nummer der angeklickten Antwort zurück zum Server. |
LocalScript DialogueClient | StarterPlayer, StarterPlayerScripts | Zeichnet die Box, tippt die Zeile, zeigt die Sprechblase und die Antwort-Buttons. |
Tool Torch (optional) | ServerStorage, in einem Ordner namens DialogueItems | Das Item, das eine Antwort vergibt. Nichts in ServerStorage wird an Spieler gesendet. |
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
- 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
Rigerscheint im Workspace. Ein R6-Rig funktioniert mit denselben Skripten. - Benenn es in
Guideum. Der Name ist wichtig: DialogueService sucht das Gespräch über den Namen des Models, und der Prompt zeigt ihn den Spielern. - 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.
- Fahr im Explorer mit der Maus über Workspace, klick auf den Button + und füge einen Folder namens
NPCsein. Zieh Guide hinein und stell das Rig irgendwohin, wo Spieler hinlaufen können. - Optional, für die Antwort mit dem Item: Fahr mit der Maus über ServerStorage und füge einen Folder namens
DialogueItemsein. Leg ein Tool namensTorchhinein, mit einem nicht verankerten Part namensHandle, 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.
-- 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 Zeilestart. textist, was der NPC sagt.choicessind die Buttons des Spielers, der Reihe nach. Die Box hat Platz für vier.nextnennt die Zeile, die nach dieser Antwort kommt. Eine Antwort ohnenext, etwa "Bye!", beendet das Gespräch. EinnextoderfailNext, das eine Zeile nennt, die in der Tabelle fehlt, beendet es auch, mit einer Warnung in Output.actionnennt etwas, das der Server tut, aus der TabelleACTIONSin DialogueService: hierHealoderGiveItem.itemist für GiveItem: der Name eines Tools in ServerStorage, DialogueItems.failNextist die Zeile, die stattnextkommt, wenn die Aktion nicht ausgeführt werden konnte, damit der NPC nie eine Heilung oder ein Geschenk behauptet, das es nicht gab.
| Zeile | Der Guide sagt | Antworten 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.
-- 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.
| Einstellung | Wert hier | Was sie ändert |
|---|---|---|
TALK_DISTANCE | 12 | Wie 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_CHOICES | 0.3 | Die kürzeste Zeit zwischen zwei Klicks, die der Server annimmt. Bei einem schnelleren Klick kommt dieselbe Zeile noch einmal statt einer Antwort. |
HEAL_COOLDOWN_SECONDS | 30 | Wie 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:
| Prüfung | Code | Wenn sie scheitert |
|---|---|---|
| Der Spieler ist in einem Gespräch | conversations[player] | Der Klick wird ignoriert. |
| Die Antwort ist eine ganze Zahl | typeof und math.floor | Wird ignoriert. Strings, Tabellen, Brüche und NaN bleiben alle hier hängen. |
| 0 heißt, der Spieler hat X gedrückt | choiceIndex == 0 | Das Gespräch endet. |
| Am Leben und noch höchstens 16 Studs entfernt (12 plus 4) | isClose | Das Gespräch endet, und die Box schließt sich. |
| Mindestens 0,3 Sekunden seit dem letzten angenommenen Klick | conversation.lastChoice | Dieselbe Zeile wird noch einmal geschickt, also bekommt die Box frische Buttons, statt ewig zu warten. |
| Die Antwort existiert auf der Zeile, die dieser Spieler liest | line.choices[choiceIndex] | Wird ignoriert. |
| Die Aktion hat geklappt | jede Aktion gibt true oder false zurück | Die 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.
-- 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
UISizeConstraintauf 720 mal 300 Pixel begrenzt, damit er sich auf einem breiten Monitor nicht in die Länge zieht. Die Zeile des NPCs nutztTextScaled, das den Text auf einem kleinen Handy-Bildschirm so verkleinert, dass er in sein Label passt, und einUITextSizeConstraintverhindert, dass er auf einem großen über 20 Pixel wächst. EinUIGridLayoutordnet die Antworten zwei mal zwei an.ResetOnSpawnist 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
MaxVisibleGraphemesbestimmt, wie viele Zeichen zu sehen sind, dieselbe Eigenschaft, die das Roblox-eigene Schreibmaschinen-Beispiel mitutf8.graphemesnutzt. 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
lineNumberverhindert, 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.
Activatedfeuert 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 mitGuiService.SelectedObjectdie erste Antwort aus, wennPreferredInputsagt, 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:
- Füge
ACTIONSeinen Eintrag namensStartQuesthinzu. Erst prüfen, dann ändern: Wennplayer:GetAttribute("Quest")schon gesetzt ist, gibfalsezurück; sonst rufplayer:SetAttribute("Quest", "Cave")auf und gibtruezurück. - Gib in DialogueData einer Antwort
action = "StartQuest", eine Zeilenextfür den Erfolg und eine ZeilefailNextfür den Fehlschlag, etwa "You are already on a quest." - Drück auf Play und wähl die Antwort zweimal. Wenn der Name in DialogueData nicht zum Key in
ACTIONSpasst (Großbuchstaben zählen), zeigt OutputDialogueService: no action named StartQuest, und das Gespräch geht zur ZeilefailNext.
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
lastHealhä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
truezurü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.
| Das Tutorial | Das Problem | Dieser Guide |
|---|---|---|
Nutzt das Dialog-Objekt, mit einem Server-Script, das auf DialogChoiceSelected hört, um eine Belohnung zu geben | Die 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 LocalScript | Eine Ä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) sprechen | Der Service Chat ist zugunsten von TextChatService veraltet. | TextChatService:DisplayBubble im LocalScript. |
| Schickt den Namen der Belohnung oder die ID der nächsten Zeile vom Client | Ein 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 ist | Der 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 Schleife | Das 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.
| Ein Cheater versucht | Ergebnis | Warum |
|---|---|---|
| Den Talk-Prompt vom anderen Ende der Map auszulösen | Nichts passiert | startConversation prüft, dass er höchstens 16 Studs entfernt ist (12 plus 4). |
| Antwort 99, einen String, einen Bruch oder NaN zu schicken | Wird ignoriert | Es ist keine ganze Zahl, oder es gibt diese Antwort auf der Zeile nicht, die er liest. |
| Einen Belohnungsnamen oder eine Zeilen-ID zu schicken | Wird nie gelesen | Der 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 erlaubt | Ein Klick pro 0,3 Sekunden pro Gespräch | Bei 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 reden | Unmöglich | Items kommen nur aus einer Antwort auf der Zeile, von der der Server weiß, dass er bei ihr ist. |
| Einen Stapel Torches zu sammeln | Immer nur eine | Der 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 spammen | Eine Heilung alle 30 Sekunden | Der Cooldown wird pro Spieler auf dem Server gehalten, und der NPC sagt das mit der Zeile healTooSoon. |
| Wegzugehen und die Box offen zu lassen | Innerhalb einer halben Sekunde geschlossen | Der Server prüft jedes offene Gespräch zweimal pro Sekunde. |
| Das ganze Gespräch zu lesen, auch Zeilen, die er noch nicht erreicht hat | Möglich | DialogueData 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
- Drück auf Play (F5) und geh zum Guide. Ab 12 Studs erscheint ein Prompt Talk mit dem Namen Guide. Drück E.
- Die Box zeigt "Guide", tippt die Begrüßungszeile und zeigt dann vier Buttons. Dieselbe Zeile erscheint in einer Sprechblase über dem Kopf des NPCs.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
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.
- 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
- Roblox Creator Docs: Proximity prompts (auf Englisch). Prompts erstellen, MaxActivationDistance und RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (auf Englisch). wo ein Prompt funktioniert, sein Standardtext und seine Tasten, Triggered und die Sichtlinien-Prüfung
- Roblox Creator Docs: Securing the client-server boundary (auf Englisch). ProximityPrompts als Angriffsfläche, und Prüfungen von Entfernung und Berechtigung
- Roblox Engine API: Dialog (auf Englisch). BehaviorType und das Event DialogChoiceSelected, das es nur auf dem Client gibt
- Roblox Engine API: TextChatService:DisplayBubble (auf Englisch). Sprechblasen für NPCs aus Client-Skripten
- Roblox Creator Docs: Customize bubble chat (auf Englisch). NPC-Blasen und BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (auf Englisch). welchen angezeigten Text du filtern musst
- Roblox Creator Docs: UI animation and tweens (auf Englisch). der Schreibmaschinen-Effekt mit MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (auf Englisch). was die Rücktaste mit einem Tool macht
- Roblox Engine API: UserInputService.PreferredInput (auf Englisch). einen Spieler mit Controller erkennen
- Roblox Creator Docs: Rig Generator (auf Englisch). ein R15- oder R6-Rig einfügen
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.