Με λίγα λόγια
Βάλτε το μοντέλο του NPC σε έναν φάκελο NPCs στο Workspace και γράψτε τη συζήτησή του σε ένα ModuleScript στο ReplicatedStorage: κάθε ατάκα έχει το κείμενο του NPC και μια λίστα επιλογών που οδηγούν σε άλλη ατάκα. Ένα Script στο ServerScriptService προσθέτει σε κάθε NPC ένα ProximityPrompt ("Talk"), θυμάται σε ποια ατάκα βρίσκεται κάθε παίκτης και τη στέλνει μέσω ενός RemoteEvent. Ένα LocalScript δείχνει το κείμενο και ένα κουμπί για κάθε επιλογή, και στέλνει πίσω μόνο τον αριθμό του κουμπιού που πατήθηκε.
- Δίνετε τις ανταμοιβές στον server. Το συμβάν
DialogChoiceSelectedτου ενσωματωμένου αντικειμένου Dialog πυροδοτείται μόνο στον client, οπότε ένα Script του server δεν θα το ακούσει ποτέ, και μια θεραπεία ή ένα αντικείμενο που δίνεται σε LocalScript αλλάζει μόνο το αντίγραφο του παιχνιδιού αυτού του παίκτη. - Δείξτε συννεφάκι με την ατάκα μέσω
TextChatService:DisplayBubble(npc.Head, text)από ένα LocalScript. Η παλιά υπηρεσίαChatείναι παρωχημένη και τη θέση της έχει πάρει το TextChatService. - Τις ατάκες που γράψατε εσείς δεν χρειάζεται να τις φιλτράρετε. Ο κανόνας του Roblox: φιλτράρετε κάθε κείμενο που εμφανίζεται και δεν ελέγχετε άμεσα, για παράδειγμα ό,τι πληκτρολογούν οι παίκτες.
Σε αυτή τη σελίδα
Πώς λειτουργεί ένας διάλογος με NPC
Ένα NPC που μιλά και δουλεύει σε πραγματικό παιχνίδι μοιράζεται ανάμεσα στον server και στη συσκευή κάθε παίκτη. Η συσκευή σχεδιάζει το παράθυρο και τα κουμπιά. Ο server, η μόνη πλευρά που μπορείτε να εμπιστευτείτε, ξέρει ποια ατάκα διαβάζει κάθε παίκτης και αποφασίζει τι κάνει κάθε απάντηση. Ένας γύρος της συζήτησης μοιάζει έτσι:
- Ο παίκτης πλησιάζει το NPC και πατά E στο prompt Talk του. Το συμβάν
Triggeredτου prompt πυροδοτείται στον server με αυτόν τον παίκτη. - Το script του server ελέγχει ότι ο παίκτης είναι αρκετά κοντά, θυμάται ότι είναι στην ατάκα με όνομα
startκαι στέλνει το κείμενο αυτής της ατάκας και τις λεζάντες των επιλογών της μόνο σε αυτόν τον παίκτη. - Το LocalScript γράφει την ατάκα στο παράθυρο διαλόγου, δείχνει ένα συννεφάκι πάνω από το NPC και μετά προσθέτει ένα κουμπί για κάθε επιλογή.
- Ο παίκτης κάνει κλικ, πατά στην οθόνη ή επιλέγει μια επιλογή. Στον server επιστρέφει μόνο ο αριθμός της.
- Ο server βρίσκει αυτόν τον αριθμό στην ατάκα που ξέρει ότι διαβάζει ο παίκτης, εκτελεί την ενέργεια της επιλογής, αν έχει (θεραπεία, αντικείμενο), και στέλνει την επόμενη ατάκα ή κλείνει το παράθυρο.
| Στοιχείο | Πού βρίσκεται | Τι κάνει |
|---|---|---|
Rig Guide | Workspace, σε φάκελο με όνομα NPCs | Το ίδιο το NPC. Το όνομά του επιλέγει τη συζήτηση και εμφανίζεται στο prompt. |
ModuleScript DialogueData | ReplicatedStorage | Όλες οι ατάκες που μπορεί να πει το NPC, οι επιλογές κάτω από κάθε ατάκα και πού οδηγεί κάθε επιλογή. |
Script DialogueService | ServerScriptService | Προσθέτει το prompt Talk, θυμάται σε ποια ατάκα είναι κάθε παίκτης, ελέγχει κάθε κλικ και εκτελεί τις ενέργειες. |
RemoteEvent DialogueEvent | ReplicatedStorage (το δημιουργεί το DialogueService) | Μεταφέρει κάθε ατάκα στον παίκτη και τον αριθμό της επιλογής πίσω στον server. |
LocalScript DialogueClient | StarterPlayer, StarterPlayerScripts | Σχεδιάζει το παράθυρο, γράφει την ατάκα, δείχνει το συννεφάκι και τα κουμπιά των επιλογών. |
Tool Torch (προαιρετικό) | ServerStorage, σε φάκελο με όνομα DialogueItems | Το αντικείμενο που δίνει μία από τις επιλογές. Τίποτα από το ServerStorage δεν στέλνεται στους παίκτες. |
Workspace
NPCs Folder new
Guide Model new
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (μέρη του σώματος)
ReplicatedStorage
DialogueData ModuleScript new
ServerScriptService
DialogueService Script new
ServerStorage
DialogueItems Folder new
Torch Tool new
Handle Part new
StarterPlayer
StarterPlayerScripts
DialogueClient LocalScript new
Βήμα 1: προσθέστε το NPC
- Στην καρτέλα Avatar ή Home πατήστε Character για να ανοίξει το Rig Generator. Διαλέξτε R15, σωματότυπο και στυλ. Στο Workspace θα εμφανιστεί ένα rig με όνομα
Rig. Ένα rig R6 δουλεύει με τα ίδια scripts. - Μετονομάστε το σε
Guide. Το όνομα μετράει: το DialogueService ψάχνει τη συζήτηση με βάση το όνομα του μοντέλου, και το prompt το δείχνει στους παίκτες. - Ανοίξτε το rig, επιλέξτε το HumanoidRootPart του και τσεκάρετε το Anchored στο παράθυρο Properties. Ένα anchored part δεν κινείται ποτέ λόγω φυσικής, οπότε το NPC στέκεται εκεί όπου το βάλατε και οι παίκτες δεν μπορούν να το σπρώξουν.
- Περάστε τον κέρσορα πάνω από το Workspace στο Explorer, πατήστε το κουμπί + και προσθέστε ένα Folder με όνομα
NPCs. Σύρετε μέσα του τον Guide και βάλτε το rig εκεί όπου μπορούν να πάνε οι παίκτες. - Προαιρετικά, για την επιλογή με το αντικείμενο: περάστε τον κέρσορα πάνω από το ServerStorage και προσθέστε ένα Folder με όνομα
DialogueItems. Βάλτε μέσα ένα Tool με όνομαTorchκαι ένα μη anchored Part με όνομαHandle, το part που κρατά ο χαρακτήρας στο χέρι. Ένα PointLight μέσα στο Handle το κάνει να φωτίζει.
Τα ονόματα κάνουν διάκριση πεζών και κεφαλαίων, οπότε γράψτε NPCs, Guide, DialogueItems και Torch ακριβώς όπως φαίνονται. NPC μπορεί να είναι οποιοδήποτε μοντέλο με Humanoid και HumanoidRootPart, και από το Toolbox, αρκεί να βρίσκεται απευθείας στον φάκελο NPCs.
Βήμα 2: γράψτε τη συζήτηση
Περάστε τον κέρσορα πάνω από το ReplicatedStorage, προσθέστε ένα ModuleScript με όνομα DialogueData και επικολλήστε μέσα αυτόν τον κώδικα. Δεν έχει λογική, μόνο λέξεις και τις συνδέσεις ανάμεσά τους, οπότε αυτό είναι το αρχείο που θα αλλάζετε πιο συχνά.
-- ModuleScript στο ReplicatedStorage με όνομα DialogueData.
-- Όλες οι συζητήσεις, ανά όνομα NPC στο Workspace.NPCs. Κάθε ατάκα έχει
-- το κείμενο του NPC και τις επιλογές απάντησης του παίκτη. Μια επιλογή μπορεί να οδηγεί σε άλλη ατάκα (next),
-- να τελειώνει τη συζήτηση (χωρίς next) και να ζητά από τον server να κάνει κάτι (action). Αν ο server
-- δεν μπορεί να εκτελέσει την ενέργεια, δείχνει την ατάκα failNext αντί για την next.
export type Choice = {
text: string,
next: string?, -- η ατάκα που εμφανίζεται μετά από αυτή την επιλογή· το nil τελειώνει τη συζήτηση
action: string?, -- ενέργεια του server από τον πίνακα ACTIONS στο DialogueService
item: string?, -- για την ενέργεια GiveItem: το όνομα του Tool στο ServerStorage.DialogueItems
failNext: string?, -- η ατάκα που εμφανίζεται αντί για την next όταν η ενέργεια δεν εκτελέστηκε
}
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
Οι γραμμές export type στην αρχή περιγράφουν πώς μοιάζει μια ατάκα και μια επιλογή. Κατά το παιχνίδι δεν αλλάζουν τίποτα· περιγράφουν τα δεδομένα σας ώστε να μπορεί να τα ελέγξει ο έλεγχος τύπων.
Πώς συνδέονται τα κομμάτια μεταξύ τους:
- Κάθε NPC έχει έναν πίνακα που λέγεται όπως το μοντέλο του στον φάκελο NPCs, εδώ
Guide. Κάθε συζήτηση ξεκινά από την ατάκαstart. - Το
textείναι αυτό που λέει το NPC. Τοchoicesείναι τα κουμπιά του παίκτη, με τη σειρά. Στο παράθυρο υπάρχει χώρος για τέσσερα. - Το
nextονομάζει την ατάκα που εμφανίζεται μετά από αυτή την επιλογή. Μια επιλογή χωρίςnext, όπως το "Bye!", τελειώνει τη συζήτηση. ΈναnextήfailNextπου ονομάζει ατάκα που δεν υπάρχει στον πίνακα επίσης την τελειώνει, με μια προειδοποίηση στο Output. - Το
actionονομάζει κάτι που κάνει ο server, από τον πίνακαACTIONSστο DialogueService: εδώHealήGiveItem. - Το
itemχρειάζεται για το GiveItem: είναι το όνομα ενός Tool στο ServerStorage, DialogueItems. - Το
failNextείναι η ατάκα που εμφανίζεται αντί για τηνnextόταν η ενέργεια δεν μπόρεσε να εκτελεστεί, ώστε το NPC να μη λέει ποτέ ότι σας θεράπευσε ή σας έδωσε κάτι που δεν έγινε.
| Ατάκα | Ο Guide λέει | Επιλογές και πού οδηγούν |
|---|---|---|
start | "Welcome to the village! What can I do for you?" | Το "Any tips?" οδηγεί στο tips. Το "I'm hurt. Can you help?" θεραπεύει, μετά healed (ή healTooSoon). Το "Got anything for the cave?" δίνει το Torch, μετά torch (ή hasTorch). Το "Bye!" τελειώνει τη συζήτηση. |
tips | "Stay off the red bricks, and come back if you get hurt." | Το "Anything else?" γυρίζει στο start. Το "Thanks!" τελειώνει τη συζήτηση. |
healed | "There you go, good as new." | Το "Thank you!" τελειώνει τη συζήτηση. |
torch | "Take this torch. The cave is dark." | Το "Thanks!" τελειώνει τη συζήτηση. |
healTooSoon | "I healed you a moment ago. Come back in a little while." | Το "OK" τελειώνει τη συζήτηση. |
hasTorch | "You already have my torch. Keep it lit!" | Το "Will do!" τελειώνει τη συζήτηση. |
Αυτό το module το διαβάζει μόνο ο server. Το LocalScript δεν του κάνει ποτέ require: ο server στέλνει κάθε ατάκα όταν ο παίκτης φτάσει σε αυτήν. Όμως ένα module στο ReplicatedStorage αντιγράφεται ούτως ή άλλως στη συσκευή κάθε παίκτη, οπότε αν η συζήτηση έχει spoilers (ας πούμε, τη λύση ενός γρίφου), μεταφέρετε το DialogueData στο ServerStorage. Μετά, στη γραμμή με το require στο DialogueService, αλλάξτε το ReplicatedStorage σε ServerStorage, ώστε όλη η γραμμή να είναι: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.
Βήμα 3: προσθέστε το script του server
Περάστε τον κέρσορα πάνω από το ServerScriptService, προσθέστε ένα Script με όνομα DialogueService και επικολλήστε μέσα τον κώδικα παρακάτω. Είναι το μόνο σημείο όπου η συζήτηση προχωρά και το μόνο σημείο όπου δίνεται ανταμοιβή.
-- Script στο ServerScriptService με όνομα DialogueService.
-- Προσθέτει prompt Talk σε κάθε NPC στο Workspace.NPCs και διαχειρίζεται κάθε συζήτηση.
-- Η συσκευή του παίκτη μόνο δείχνει το κείμενο και στέλνει πίσω τον αριθμό της επιλογής
-- που πάτησε. Ο server ξέρει σε ποια ατάκα είναι κάθε παίκτης, ελέγχει την επιλογή
-- και την απόσταση, και μόνο αυτός θεραπεύει ή δίνει αντικείμενα.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Οι ίδιες μορφές με το DialogueData, ώστε ο έλεγχος τύπων του Studio να τις ξέρει και εδώ
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: η ακτίνα του prompt και πόσο κοντά πρέπει να μένει ο παίκτης
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30
local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")
-- Αυτό το script δημιουργεί μόνο του το DialogueEvent, οπότε μην το προσθέσετε με το χέρι
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 -- δεν υπάρχει χαρακτήρας, είναι νεκρός ή το NPC χάθηκε
end
-- μικρό περιθώριο, γιατί η θέση του παίκτη φτάνει στον server με μικρή καθυστέρηση
return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end
-- Τι κάνει ο server όταν μια επιλογή έχει ενέργεια. Η καθεμία επιστρέφει true αν εκτελέστηκε.
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 -- θεραπεύτηκε πολύ πρόσφατα
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 -- δεν υπάρχει ακόμα σακίδιο ή έχει ήδη το αντικείμενο
end
local item = template:Clone() :: Tool
item.CanBeDropped = false -- ώστε να μην μπορεί κανείς να το πετάξει και να ζητήσει άλλο
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 -- συζητά ήδη, αυτό το NPC δεν έχει ατάκα "start", είναι νεκρός ή πολύ μακριά
end
local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
conversations[player] = conversation
showLine(player, conversation)
end
-- Ο παίκτης πάτησε την επιλογή με αριθμό choiceIndex (0 σημαίνει ότι έκλεισε το παράθυρο)
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
-- Πολύ γρήγορα. Στέλνουμε ξανά την ίδια ατάκα, γιατί το παράθυρο έχει ήδη κλειδώσει
-- τα κουμπιά μετά το κλικ και αλλιώς θα περίμενε απάντηση για πάντα.
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 -- στην ατάκα που διαβάζει αυτός ο παίκτης δεν υπάρχει τέτοια επιλογή
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 -- για παράδειγμα "I healed you a moment ago"
end
end
if nextLine and not DialogueData[conversation.npcName][nextLine] then
warn(`DialogueService: no line named {nextLine} for {conversation.npcName} in DialogueData`)
nextLine = nil
end
if nextLine then
conversation.lineId = nextLine
showLine(player, conversation)
else
endConversation(player)
end
end)
-- Prompt Talk σε κάθε 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() -- ένα αντίγραφο NPC φέρνει το παλιό prompt, που δεν το ακούει κανείς
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)
-- Κλείνουμε το παράθυρο σε όποιον έφυγε ή πέθανε στη μέση της συζήτησης
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 δημιουργεί μόνο του το RemoteEvent DialogueEvent όταν ξεκινά το παιχνίδι, οπότε δεν χρειάζεται να προσθέσετε τίποτα με το χέρι στο ReplicatedStorage. Αν έχετε ήδη φτιάξει RemoteEvent με αυτό το όνομα, διαγράψτε το: το LocalScript θα μπορούσε να βρει το δικό σας, που δεν το ακούει κανείς στον server.
| Ρύθμιση | Τιμή εδώ | Τι αλλάζει |
|---|---|---|
TALK_DISTANCE | 12 | Πόσο κοντά, σε studs, πρέπει να είναι ο παίκτης για να εμφανιστεί το prompt Talk. Ο server τον αφήνει να απομακρυνθεί άλλα 4 studs πριν κλείσει το παράθυρο, γιατί η θέση του παίκτη φτάνει στον server με μικρή καθυστέρηση. |
MIN_SECONDS_BETWEEN_CHOICES | 0.3 | Ο μικρότερος χρόνος ανάμεσα σε δύο κλικ που δέχεται ο server. Σε πιο γρήγορο κλικ στέλνεται ξανά η ίδια ατάκα αντί για απάντηση. |
HEAL_COOLDOWN_SECONDS | 30 | Πόσο περιμένει κάθε παίκτης ανάμεσα σε δύο θεραπείες από την ενέργεια Heal. |
Ο server κρατά στο conversations μία εγγραφή ανά παίκτη: με ποιο NPC μιλά, ποια ατάκα διαβάζει και πότε έγινε δεκτό το τελευταίο του κλικ. Όταν πυροδοτείται το prompt Talk, το startConversation δημιουργεί αυτή την εγγραφή μόνο αν ο παίκτης δεν μιλά ήδη, το NPC έχει ατάκα start και ο παίκτης είναι ζωντανός και εντός ακτίνας. Μετά από αυτό, κάθε κλικ περνά από τους εξής ελέγχους:
| Έλεγχος | Κώδικας | Αν αποτύχει |
|---|---|---|
| Ο παίκτης είναι σε συζήτηση | conversations[player] | Το κλικ αγνοείται. |
| Η επιλογή είναι ακέραιος αριθμός | typeof και math.floor | Αγνοείται. Strings, πίνακες, δεκαδικοί και NaN σταματούν εδώ. |
| Το 0 σημαίνει ότι ο παίκτης πάτησε το X | choiceIndex == 0 | Η συζήτηση τελειώνει. |
| Ζωντανός και ακόμα όχι πιο μακριά από 16 studs (12 συν 4) | isClose | Η συζήτηση τελειώνει και το παράθυρο κλείνει. |
| Τουλάχιστον 0.3 δευτερόλεπτα από το τελευταίο αποδεκτό κλικ | conversation.lastChoice | Η ίδια ατάκα στέλνεται ξανά, οπότε το παράθυρο παίρνει φρέσκα κουμπιά αντί να περιμένει για πάντα. |
| Η επιλογή υπάρχει στην ατάκα που διαβάζει αυτός ο παίκτης | line.choices[choiceIndex] | Αγνοείται. |
| Η ενέργεια πέτυχε | κάθε ενέργεια επιστρέφει true ή false | Αντί για την next εμφανίζεται η ατάκα failNext. |
Το prompt μπαίνει στο HumanoidRootPart του NPC, γιατί ένα ProximityPrompt λειτουργεί όταν βρίσκεται μέσα σε part (ή Attachment, ή μοντέλο με PrimaryPart) στο Workspace. Το RequiresLineOfSight του είναι ενεργό από προεπιλογή και κρύβει το prompt κάθε φορά που κάτι εμποδίζει τη θέα από την κάμερα προς αυτό το part. Το Roblox εξαιρεί από αυτόν τον έλεγχο το ίδιο το part του prompt, αλλά όχι το υπόλοιπο σώμα, και το HumanoidRootPart βρίσκεται μέσα στον κορμό, γι' αυτό το script απενεργοποιεί τον έλεγχο οπτικής επαφής. Το prompt λέγεται TalkPrompt, και το script διαγράφει κάθε TalkPrompt που υπάρχει ήδη στο part πριν προσθέσει το δικό του: ένα αντίγραφο NPC που φτιάχτηκε κατά το παιχνίδι έρχεται με το prompt του πρωτοτύπου, και το αντιγραμμένο δεν το ακούει κανείς. Αν στο DialogueData δεν υπάρχει συζήτηση με ατάκα start για το όνομα του NPC, στο Output εμφανίζεται προειδοποίηση με το όνομα αυτού του NPC.
Ένας βρόχος ελέγχει δύο φορές το δευτερόλεπτο κάθε ανοιχτή συζήτηση και την κλείνει όταν ο παίκτης απομακρύνθηκε πάνω από 16 studs ή ο χαρακτήρας του πέθανε, ώστε ένας παίκτης που πέθανε στη μέση της συζήτησης να μην κάνει respawn με ανοιχτό παράθυρο. Το PlayerRemoving καθαρίζει και τους δύο πίνακες όταν κάποιος φεύγει.
Βήμα 4: προσθέστε το παράθυρο διαλόγου
Ανοίξτε το StarterPlayer, περάστε τον κέρσορα πάνω από το StarterPlayerScripts, προσθέστε ένα LocalScript με όνομα DialogueClient και επικολλήστε μέσα αυτόν τον κώδικα. Φτιάχνει το παράθυρο διαλόγου σε κώδικα, οπότε δεν χρειάζεται να σχεδιάσετε GUI με το χέρι.
-- LocalScript στο StarterPlayer > StarterPlayerScripts με όνομα DialogueClient.
-- Σχεδιάζει τη συζήτηση που στέλνει ο server: το όνομα του NPC, την ατάκα του που γράφεται γράμμα
-- γράμμα, ένα συννεφάκι πάνω από το κεφάλι και ένα κουμπί για κάθε επιλογή. Το κλικ σε
-- μια επιλογή στέλνει μόνο τον αριθμό της· τι γίνεται μετά το αποφασίζει ο server.
local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TextChatService = game:GetService("TextChatService")
local UserInputService = game:GetService("UserInputService")
local dialogueEvent = ReplicatedStorage:WaitForChild("DialogueEvent") :: RemoteEvent
local player = Players.LocalPlayer
local LETTERS_PER_SECOND = 45
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)
-- Το παράθυρο διαλόγου, φτιαγμένο σε κώδικα
local gui = Instance.new("ScreenGui")
gui.Name = "Dialogue"
gui.ResetOnSpawn = false
gui.Enabled = false
local box = Instance.new("Frame")
box.AnchorPoint = Vector2.new(0.5, 1)
box.Position = UDim2.new(0.5, 0, 1, -84) -- 84 pixels πιο ψηλά, ώστε η γραμμή εργαλείων του Roblox να μην κρύβει τις επιλογές
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 -- μια μεγάλη ατάκα μικραίνει για να χωρέσει σε μικρή οθόνη κινητού
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- και δεν γίνεται ποτέ μεγαλύτερη από 20 pixels σε μεγάλη
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 -- αυξάνεται με κάθε νέα ατάκα, ώστε να σταματήσει ο παλιός βρόχος πληκτρολόγησης
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 -- αλλάζει μόνο σε αυτή τη συσκευή
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()
-- Συννεφάκι πάνω από το NPC (το DisplayBubble δουλεύει μόνο σε LocalScript)
local head = npc:FindFirstChild("Head")
if head then
TextChatService:DisplayBubble(head, text)
end
-- Γράφουμε την ατάκα γράμμα γράμμα. Ο αριθμός υπολογίζεται από τον χρόνο που πέρασε,
-- οπότε η ταχύτητα είναι ίδια σε κάθε ρυθμό καρέ.
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 -- αυτή την ατάκα την αντικατέστησε νεότερη ή το κλείσιμο
end
shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
lineLabel.MaxVisibleGraphemes = shown
end
lineLabel.MaxVisibleGraphemes = -1
-- Ένα κουμπί ανά επιλογή· ο server λαμβάνει μόνο τον αριθμό του κουμπιού
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 -- ένα κλικ ανά ατάκα
dialogueEvent:FireServer(index)
end
end)
if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = button -- ώστε η επιλογή να μπορεί να γίνει με gamepad
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)
Τα χρώματα, τα μεγέθη και το LETTERS_PER_SECOND αλλάξτε τα όπως θέλετε. Τους δύο τελευταίους handlers αφήστε τους όπως είναι: είναι ο μόνος τρόπος με τον οποίο το παράθυρο επικοινωνεί με τον server.
Τι κάνει κάθε μέρος του DialogueClient:
- Το παράθυρο. Ένα ScreenGui με ένα Frame στερεωμένο κάτω στο κέντρο της οθόνης, στο 60% του πλάτους της και στο 34% του ύψους, με όριο 720 επί 300 pixels μέσω
UISizeConstraint, ώστε να μην απλώνεται σε όλη μια φαρδιά οθόνη. Η ατάκα του NPC χρησιμοποιείTextScaled, που μικραίνει το κείμενο ώστε να χωρά στο label του σε μικρή οθόνη κινητού, και τοUITextSizeConstraintδεν το αφήνει να ξεπεράσει τα 20 pixels σε μεγάλη. ΤοUIGridLayoutτοποθετεί τις επιλογές δύο επί δύο. ΤοResetOnSpawnείναι false, γιατί αυτό το LocalScript τρέχει μία φορά ανά συνεδρία: ένα παράθυρο που διαγράφεται στο respawn δεν θα επέστρεφε ποτέ. - Εφέ γραφομηχανής. Όλη η ατάκα μπαίνει αμέσως στο TextLabel, και το
MaxVisibleGraphemesαποφασίζει πόσοι χαρακτήρες φαίνονται· είναι η ίδια ιδιότητα που χρησιμοποιεί το παράδειγμα γραφομηχανής του ίδιου του Roblox μαζί με τοutf8.graphemes. Το Roblox στοιχειοθετεί το κείμενο σαν να φαίνονταν όλοι οι χαρακτήρες, οπότε οι λέξεις δεν πηδούν σε νέα γραμμή ούτε αλλάζουν μέγεθος όσο εμφανίζονται. Το script υπολογίζει πόσους χαρακτήρες να δείξει από τον χρόνο που πέρασε, 45 το δευτερόλεπτο, οπότε η ταχύτητα είναι ίδια σε κάθε ρυθμό καρέ, και μετά δίνει στην ιδιότητα την τιμή -1, που δείχνει τα πάντα. - Τα κουμπιά. Εμφανίζονται όταν γραφτεί η ατάκα. Το καθένα στέλνει μόνο τον αριθμό του και μόνο μία φορά: ο έλεγχος
lineNumberεμποδίζει ένα διπλό κλικ να στείλει δύο φορές, και μετά το παράθυρο περιμένει την επόμενη ατάκα από τον server. - Συννεφάκι με την ατάκα. Το
TextChatService:DisplayBubble(head, text)βάζει την ατάκα σε συννεφάκι chat πάνω από το Head του NPC. Το Roblox το επιτρέπει μόνο σε scripts του client, και το bubble chat είναι ενεργό από προεπιλογή. Το συννεφάκι το σχεδιάζει η συσκευή αυτού του παίκτη, οπότε το βλέπει μόνο αυτός. - Το prompt. Όσο ο παίκτης μιλά, το δικό του αντίγραφο του prompt Talk (το βρίσκει με το όνομα TalkPrompt) είναι απενεργοποιημένο, ώστε να μην κρέμεται πάνω από τη συζήτηση. Οι άλλοι παίκτες εξακολουθούν να βλέπουν τα δικά τους.
- Κάθε συσκευή. Το
Activatedπυροδοτείται με κλικ ποντικιού, πάτημα σε κινητό και το κουμπί A σε gamepad. Ένα gamepad μπορεί να πατήσει μόνο το επιλεγμένο κουμπί, οπότε όταν τοPreferredInputλέει ότι ο παίκτης χρησιμοποιεί gamepad, το script επιλέγει την πρώτη επιλογή μέσωGuiService.SelectedObject. - Το κουμπί X. Στέλνει 0, που ο server το καταλαβαίνει ως «τέλος συζήτησης», και κλείνει αμέσως το παράθυρο.
Προσθέστε δικές σας ενέργειες
Μια ενέργεια είναι μια συνάρτηση στον πίνακα ACTIONS στην αρχή του DialogueService. Παίρνει τον παίκτη και την επιλογή και επιστρέφει true όταν έκανε τη δουλειά της. Για να προσθέσετε δική σας, ας πούμε μια αποστολή (quest) που δίνει το NPC:
- Προσθέστε στο
ACTIONSμια εγγραφή με όνομαStartQuest. Πρώτα έλεγχος, μετά αλλαγή: αν τοplayer:GetAttribute("Quest")έχει ήδη τιμή, επιστρέψτεfalse· αλλιώς καλέστεplayer:SetAttribute("Quest", "Cave")και επιστρέψτεtrue. - Στο DialogueData δώστε σε μια επιλογή
action = "StartQuest", μια ατάκαnextγια την επιτυχία και μια ατάκαfailNextγια την αποτυχία, για παράδειγμα "You are already on a quest." - Πατήστε Play και διαλέξτε την επιλογή δύο φορές. Αν το όνομα στο DialogueData δεν ταιριάζει με το κλειδί στο
ACTIONS(τα κεφαλαία μετράνε), στο Output θα εμφανιστείDialogueService: no action named StartQuestκαι η συζήτηση θα πάει στην ατάκαfailNext.
Κανόνες για να γράφετε ενέργειες:
- Κάντε τον έλεγχο και την αλλαγή μέσα στην ενέργεια, στον server. Το μόνο που στέλνει η συσκευή του παίκτη είναι ο αριθμός της επιλογής.
- Ό,τι χρειάζεται η ενέργεια διαβάστε το από την επιλογή (όπως το
item) ή από τη δική του κατάσταση του server, αλλά ποτέ από το remote. - Περιορίστε οτιδήποτε πολύτιμο μέσα στην ίδια την ενέργεια, όπως το Heal κρατά δικό του cooldown 30 δευτερολέπτων στο
lastHeal. Το όριο των 0.3 δευτερολέπτων ανά κλικ απλώς επιβραδύνει τα κλικ· δεν εμποδίζει τον παίκτη να περνά από την ίδια επιλογή ξανά και ξανά. - Για να ανοίξει άλλο παράθυρο, για παράδειγμα ένα κατάστημα, η ενέργεια μπορεί να στείλει ένα RemoteEvent σε αυτόν τον παίκτη και να επιστρέψει
true. Ό,τι γίνεται σε εκείνο το παράθυρο χρειάζεται και πάλι τους δικούς του ελέγχους στον server, όπως στην ενότητα NPC πωλητής.
Πού κάνουν λάθος άλλοι οδηγοί για διάλογο με NPC
Αν συγκρίνετε αυτόν τον οδηγό με ένα βίντεο ή μια ανάρτηση σε φόρουμ, να οι σημαντικές διαφορές και ο λόγος για τον οποίο κάθε τεχνική δημιουργεί πρόβλημα.
| Οδηγός | Πρόβλημα | Αυτός ο οδηγός |
|---|---|---|
Χρησιμοποιεί το αντικείμενο Dialog, και ένα Script του server ακούει το DialogChoiceSelected για να δώσει την ανταμοιβή | Η τεκμηρίωση του Roblox λέει ότι αυτό το συμβάν λειτουργεί μόνο στην πλευρά του client και δεν πυροδοτείται στον server, οπότε η ανταμοιβή δεν έρχεται ποτέ. | Η επιλογή φτάνει στον server ως αριθμός και ο server δίνει μόνος του την ανταμοιβή. |
| Δίνει την ανταμοιβή από LocalScript | Μια αλλαγή από LocalScript μένει σε αυτή τη μία συσκευή (δείτε τι αναπαράγεται), και ένας cheater μπορεί να τρέξει τον ίδιο κώδικα όποτε θέλει. | Όλες οι ενέργειες ζουν στο DialogueService. |
Κάνει το NPC να μιλά με game:GetService("Chat"):Chat(head, text) | Η υπηρεσία Chat είναι παρωχημένη και τη θέση της έχει πάρει το TextChatService. | TextChatService:DisplayBubble σε LocalScript. |
| Στέλνει από τον client το όνομα της ανταμοιβής ή το id της επόμενης ατάκας | Ένας cheater μπορεί να στείλει οποιοδήποτε όνομα αντικειμένου ή να πηδήξει κατευθείαν στην ατάκα που δίνει την ανταμοιβή. | Ο client στέλνει μόνο τον αριθμό της επιλογής. Ο server τον βρίσκει στην ατάκα που ξέρει ότι διαβάζει ο παίκτης. |
| Δεν ελέγχει τίποτα αφού πυροδοτηθεί το prompt | Ο οδηγός ασφάλειας του Roblox βάζει το ProximityPrompt δίπλα στα remotes ως κάτι που οι clients μπορούν να καταχραστούν, και συμβουλεύει να ελέγχετε πριν από την ενέργεια αν ο παίκτης είναι αρκετά κοντά. | Η απόσταση ελέγχεται στην αρχή της συζήτησης, σε κάθε κλικ και δύο φορές το δευτερόλεπτο όσο είναι ανοιχτή. |
Γράφει το κείμενο με wait() σε βρόχο | Το καθολικό wait είναι παρωχημένο και τη θέση του έχει πάρει το task.wait. | Υπολογίζει τον αριθμό των ορατών γραμμάτων από το os.clock() και περιμένει με task.wait(). |
Τι μπορεί και τι δεν μπορεί να πλαστογραφήσει ένας παίκτης
Θεωρήστε ότι ένας cheater ελέγχει τα πάντα στη συσκευή του. Μπορεί να διαβάσει τα LocalScripts σας και ό,τι υπάρχει στο ReplicatedStorage, να καλεί το DialogueEvent με οποιαδήποτε ορίσματα όσες φορές θέλει και να πυροδοτεί το prompt Talk από κώδικα, για το οποίο προειδοποιεί ο οδηγός ασφάλειας του Roblox. Το DialogueService απαντά με ελέγχους στον server του ίδιου είδους με αυτούς που εξηγούνται στην ενότητα έλεγχος ορισμάτων RemoteEvent. Να τι κερδίζει από αυτό ο cheater.
| Ο cheater προσπαθεί | Αποτέλεσμα | Γιατί |
|---|---|---|
| Να πυροδοτήσει το prompt Talk από την άλλη άκρη του χάρτη | Δεν συμβαίνει τίποτα | Το startConversation ελέγχει ότι δεν είναι πιο μακριά από 16 studs (12 συν 4). |
| Να στείλει την επιλογή 99, ένα string, έναν δεκαδικό ή NaN | Αγνοείται | Δεν είναι ακέραιος, ή δεν υπάρχει τέτοια επιλογή στην ατάκα που διαβάζει. |
| Να στείλει όνομα ανταμοιβής ή id ατάκας | Δεν διαβάζεται ποτέ | Ο server διαβάζει μόνο τον αριθμό της επιλογής. Οι ανταμοιβές βγαίνουν από τα πεδία item και action του αντιγράφου της ατάκας στον server. |
| Να κάνει κλικ όσο γρήγορα επιτρέπει το δίκτυο | Ένα κλικ ανά 0.3 δευτερόλεπτα ανά συζήτηση | Στα πιο γρήγορα κλικ επιστρέφει η ίδια τους η ατάκα. Το τέλος και η επανέναρξη της συζήτησης παρακάμπτουν αυτή την αναμονή, γι' αυτό το Heal και το GiveItem έχουν τα δικά τους όρια. |
| Να ζητήσει τον πυρσό χωρίς συζήτηση | Αδύνατο | Τα αντικείμενα δίνονται μόνο μέσω επιλογής στην ατάκα όπου ο server ξέρει ότι βρίσκεται ο παίκτης. |
| Να μαζέψει πολλούς πυρσούς | Έναν κάθε φορά | Ο server πρώτα ψάχνει Torch στο Backpack και στον χαρακτήρα του, και ο πυρσός που δόθηκε δεν μπορεί να πεταχτεί, οπότε δεν μαζεύεται πετώντας τον και ζητώντας ξανά. |
| Να επαναλαμβάνει την ατάκα της θεραπείας | Μία θεραπεία ανά 30 δευτερόλεπτα | Το cooldown κρατιέται στον server για κάθε παίκτη, και το NPC το λέει με την ατάκα healTooSoon. |
| Να φύγει αφήνοντας το παράθυρο ανοιχτό | Κλείνει μέσα σε μισό δευτερόλεπτο | Ο server ελέγχει κάθε ανοιχτή συζήτηση δύο φορές το δευτερόλεπτο. |
| Να διαβάσει όλη τη συζήτηση, και ατάκες στις οποίες δεν έφτασε | Γίνεται | Το DialogueData βρίσκεται στο ReplicatedStorage, που αντιγράφεται σε κάθε συσκευή. Μεταφέρετέ το στο ServerStorage αν έχει σημασία (δείτε το βήμα 2). |
Ένας περιορισμός αξίζει να ειπωθεί ευθέως: ένας cheater που πλησιάζει τον Guide και διαλέγει επιλογές παίρνει ακριβώς ό,τι και ένας τίμιος παίκτης. Ο server ελέγχει πόσο συχνά και από πού, όχι όμως ποιος. Οτιδήποτε σπάνιο, για παράδειγμα μια ανταμοιβή που κάθε παίκτης μπορεί να πάρει μία φορά, χρειάζεται έναν έλεγχο που ανήκει στον server, όπως ένα attribute που ορίζεται κατά την παραλαβή ή μια σημαία αποθηκευμένη σε αποθήκευση δεδομένων.
Βήμα 5: δοκιμάστε το
- Πατήστε Play (F5) και πλησιάστε τον Guide. Σε απόσταση 12 studs εμφανίζεται το prompt Talk με το όνομα Guide. Πατήστε E.
- Το παράθυρο δείχνει "Guide", γράφει την ατάκα καλωσορίσματος και μετά δείχνει τέσσερα κουμπιά. Η ίδια ατάκα εμφανίζεται σε συννεφάκι πάνω από το κεφάλι του NPC.
- Διαλέξτε "Any tips?" και μετά "Anything else?": είστε πάλι στην πρώτη ατάκα. Διαλέξτε "Bye!": το παράθυρο κλείνει και το prompt Talk επιστρέφει.
- Πρώτα προκαλέστε ζημιά στον εαυτό σας: πατήστε τον διακόπτη Client/Server για να πάτε στο Server, επιλέξτε το Humanoid του χαρακτήρα σας στο Workspace, ορίστε το Health σε 50 στο παράθυρο Properties και γυρίστε πίσω στο Client. Οι χαρακτήρες των παικτών αναπληρώνουν 1% του MaxHealth κάθε δευτερόλεπτο, οπότε μιλήστε αμέσως στον Guide και διαλέξτε "I'm hurt. Can you help?": η υγεία ανεβαίνει στο μέγιστο. Μιλήστε ξανά μέσα σε 30 δευτερόλεπτα και διαλέξτε το πάλι: δεν υπάρχει θεραπεία και ο Guide λέει ότι σας θεράπευσε πριν από λίγο.
- Διαλέξτε "Got anything for the cave?": το Torch εμφανίζεται στο hotbar. Εξοπλιστείτε με αυτό και πατήστε Backspace: μένει στο χέρι. Ζητήστε ξανά: δεύτερος πυρσός δεν υπάρχει και ο Guide λέει ότι τον έχετε ήδη.
- Ξεκινήστε μια συζήτηση και απομακρυνθείτε. Το παράθυρο κλείνει περίπου όταν βρεθείτε 16 studs από τον Guide.
- Διαλέξτε Server & Clients στη λίστα με τις λειτουργίες τεστ, ορίστε 2 clients και πατήστε Play. Και οι δύο παίκτες μπορούν να μιλούν με τον Guide ταυτόχρονα, ο καθένας στη δική του ατάκα.
- Δοκιμάστε gamepad με το Controller Emulator (Controller στην καρτέλα Emulation) κατά το playtest. Με το εξομοιωμένο gamepad πλησιάστε και πατήστε το κουμπί του prompt (από προεπιλογή ButtonX): όταν εμφανιστούν οι επιλογές, η πρώτη είναι ήδη επιλεγμένη και το A την πατά.
- Δοκιμάστε οθόνη κινητού με το Device Simulator στο Studio (τη στιγμή που γράφεται αυτό είναι beta: ενεργοποιήστε το New Device Simulator στο File, Beta Features και επανεκκινήστε το Studio). Διαλέξτε ένα κινητό, πατήστε Rotate μέχρι να γυρίσει σε οριζόντιο προσανατολισμό, πατήστε Play, πλησιάστε τον Guide και πατήστε στο prompt Talk. Διαλέξτε "Any tips?": όλη η ατάκα φαίνεται πάνω από τα κουμπιά των επιλογών, αν χρειαστεί με μικρότερο κείμενο, και δεν πέφτει πάνω τους.
Σε όλη τη διάρκεια κρατήστε ανοιχτό το παράθυρο Output (μενού Window, μετά Output). Όταν αυτά τα scripts δουλεύουν, δεν τυπώνουν τίποτα, οπότε κάθε κόκκινο σφάλμα ή προειδοποίηση που ξεκινά με DialogueService: είναι πραγματικό πρόβλημα. Δείτε Συνηθισμένα λάθη.
Επεκτάσεις
Περισσότερα NPC και μεγαλύτερες συζητήσεις
Προσθέστε στον φάκελο NPCs ένα ακόμα rig με δικό του όνομα, και στο DialogueData έναν πίνακα με το ίδιο όνομα και ατάκα start. Το DialogueService προσθέτει prompt Talk σε κάθε μοντέλο του φακέλου που έχει HumanoidRootPart, και σε όσα προστίθενται κατά το παιχνίδι· ένα αντίγραφο NPC παίρνει φρέσκο prompt αντί για εκείνο με το οποίο αντιγράφηκε. Δύο NPC με το ίδιο όνομα χρησιμοποιούν τον ίδιο πίνακα. Οι ατάκες μπορούν να συνδέονται με οποιαδήποτε σειρά, και μια επιλογή μπορεί να οδηγεί πίσω σε προηγούμενη ατάκα, όπως το "Anything else?". Κρατήστε το πολύ τέσσερις επιλογές ανά ατάκα, γιατί το παράθυρο τις τοποθετεί δύο επί δύο.
Ατάκες που εξαρτώνται από την πρόοδο
Για να χαιρετά διαφορετικά τους παίκτες που επιστρέφουν, διαλέξτε την πρώτη ατάκα με βάση κάτι που ανήκει στον server. Στο startConversation διαλέξτε την με local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", ελέγξτε ότι η ατάκα υπάρχει, όπως το script ελέγχει το lines.start, και χρησιμοποιήστε το firstLine αντί για το "start" όταν δημιουργείται η συζήτηση. Ορίστε το attribute σε μια ενέργεια και προσθέστε την ατάκα welcomeBack στον πίνακα του Guide. Τα attributes ζουν μία συνεδρία· για να θυμάται τον παίκτη ανάμεσα στις επισκέψεις, αποθηκεύστε τη σημαία σε αποθήκευση δεδομένων, όπως στον οδηγό για DataStore.
NPC πωλητής
Φτιάξτε ένα κατάστημα με τον οδηγό για GUI καταστήματος, μετά προσθέστε μια ενέργεια OpenShop που στέλνει ένα RemoteEvent σε αυτόν τον παίκτη και επιστρέφει true, και αφήστε το LocalScript του καταστήματος να ανοίγει το παράθυρό του όταν φτάνει αυτό το συμβάν. Οι αγορές εξακολουθούν να περνούν από τους δικούς ελέγχους του καταστήματος στον server. Αν οι αγορές επιτρέπονται μόνο κοντά στο NPC, ελέγξτε την απόσταση και μέσα στον handler της αγοράς, γιατί ο client μπορεί να καλέσει το remote του καταστήματος από οπουδήποτε.
NPC που περπατούν
Για να περιφέρεται ο Guide ή να ακολουθεί τους παίκτες, πάρτε τον οδηγό εύρεσης διαδρομής για NPC και βγάλτε το Anchored από το HumanoidRootPart, ώστε να μπορεί να κινείται. Το prompt Talk βρίσκεται σε αυτό το part, οπότε κινείται μαζί με το NPC, και οι έλεγχοι απόστασης χρησιμοποιούν το ίδιο part. Σταματήστε το περπάτημα όσο είναι ανοιχτή η συζήτηση, αλλιώς το παράθυρο θα κλείσει μόλις το NPC απομακρυνθεί από τον παίκτη πάνω από 16 studs.
Κλειδιά, αποστολές και άλλες ανταμοιβές
Το GiveItem δίνει οποιοδήποτε Tool από το DialogueItems, οπότε ένα NPC μπορεί να δώσει ένα κλειδί που ελέγχει μια κλειδωμένη πόρτα, όπως στον οδηγό για πόρτες. Για αντικείμενα που κάνουν κάτι όταν χρησιμοποιούνται, για παράδειγμα φαγητό που θεραπεύει, διαβάστε τον οδηγό για inventory.
Ήχοι και κάμερα
Για ένα φωνητικό κλιπ ή έναν σύντομο ήχο σε κάθε ατάκα, βάλτε ένα Sound στο Head του NPC και παίξτε το από το show στο DialogueClient. Για να στρέψετε την κάμερα στο NPC όσο μιλά, ο οδηγός για cutscenes δείχνει πώς ένα LocalScript παίρνει τον έλεγχο της κάμερας και τον επιστρέφει.
Συνηθισμένα λάθη και λύσεις
Ανοίξτε το παράθυρο Output (μενού Window, μετά Output) πριν πατήσετε Play. Τα περισσότερα προβλήματα με τον διάλογο τυπώνουν εκεί μια προειδοποίηση ή οφείλονται σε ένα όνομα που δεν ταιριάζει.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'
Το DialogueClient περιμένει το remote που δημιουργεί το DialogueService, άρα το DialogueService δεν έφτασε ως εκείνο το σημείο. Ελέγξτε ότι είναι Script και όχι LocalScript, ότι βρίσκεται απευθείας στο ServerScriptService και ότι δεν είναι απενεργοποιημένο. Το DialogueService πρώτα περιμένει το DialogueData στο ReplicatedStorage και τον φάκελο NPCs στο Workspace, οπότε αν λείπουν ή έχουν τυπογραφικό λάθος στο όνομα, επίσης σταματά· τότε το Output δείχνει μια προειδοποίηση infinite yield από το DialogueService με αυτό το όνομα.
Πάνω από το NPC μου δεν εμφανίζεται το prompt Talk
Το DialogueService προσθέτει prompts μόνο σε μοντέλα που βρίσκονται απευθείας στο Workspace, NPCs και έχουν part με όνομα HumanoidRootPart. Ελέγξτε και τις δύο συνθήκες και πλησιάστε σε λιγότερο από 12 studs. Ένα rig από το Toolbox μπορεί να μην έχει αυτό το part ή να είναι αντικείμενο άλλου τύπου τυλιγμένο σε φάκελο.
Το prompt εμφανίζεται, αλλά το E δεν κάνει τίποτα
Ο server δεν βρήκε συζήτηση για αυτό το NPC, και όταν ξεκινά το παιχνίδι το Output δείχνει DialogueService: no conversation with a start line for Guide in DialogueData με το όνομα του NPC σας. Ο πίνακας στο DialogueData πρέπει να λέγεται ακριβώς όπως το μοντέλο, μαζί με τα κεφαλαία, και να περιέχει ατάκα start.
Μια επιλογή κλείνει το παράθυρο αντί να πάει στην επόμενη ατάκα
Το Output δείχνει DialogueService: no line named tip for Guide in DialogueData με τα δικά σας ονόματα: το next (ή failNext) της επιλογής ονομάζει ατάκα που δεν υπάρχει στον πίνακα αυτού του NPC. Τα ονόματα των ατακών κάνουν διάκριση πεζών και κεφαλαίων, οπότε συγκρίνετε τη γραφή με τον πίνακα, εδώ tips.
Το παράθυρο δουλεύει, αλλά δεν υπάρχει συννεφάκι με την ατάκα
Το συννεφάκι χρειάζεται ένα part με όνομα Head απευθείας μέσα στο μοντέλο του NPC και ενεργό bubble chat: στο Explorer επιλέξτε το BubbleChatConfiguration κάτω από το TextChatService και ελέγξτε ότι είναι τσεκαρισμένο το Enabled. Από προεπιλογή είναι ενεργό.
Το Output γράφει DialogueService: no Tool named Torch in ServerStorage.DialogueItems
Ο server δεν βρήκε το αντικείμενο. Ελέγξτε ότι ο φάκελος στο ServerStorage λέγεται DialogueItems και ότι μέσα του υπάρχει ένα Tool (όχι Model ούτε Part) με όνομα ακριβώς όπως στο item της επιλογής. Μέχρι να το διορθώσετε, ο Guide απαντά με την ατάκα hasTorch, γιατί η ενέργεια απέτυχε.
Το Output γράφει DialogueService: no action named ...
Το action της επιλογής δεν ταιριάζει με κανένα κλειδί στον πίνακα ACTIONS. Τα ονόματα κάνουν διάκριση πεζών και κεφαλαίων: το heal δεν είναι Heal.
Φτιάξτε το με το RoCode
Αν σας είναι πιο εύκολο να περιγράψετε το NPC παρά να το φτιάξετε με το χέρι, το RoCode μπορεί να γράψει αυτά τα scripts απευθείας στο place που έχετε ανοιχτό. Είναι ανεξάρτητος πράκτορας AI για το Roblox Studio, όχι της Roblox: γράφετε στη συνομιλία στο web και το plugin του για το Studio δημιουργεί και διορθώνει scripts στο Explorer σας.
Κάνε το μοντέλο Guide στο Workspace.NPCs να μιλά: prompt Talk, παράθυρο διαλόγου με ατάκες που γράφονται και κουμπιά επιλογών, συννεφάκι πάνω από το κεφάλι, μια επιλογή θεραπείας με cooldown 30 δευτερολέπτων και μια επιλογή που δίνει μία φορά το εργαλείο Torch από το ServerStorage. Κράτα τη συζήτηση σε ModuleScript και δίνε όλες τις ανταμοιβές στον server.
- Μπορεί πρώτα να εξετάσει το μοντέλο με Get Properties για να διαβάσει βασικές τιμές, όπως το Anchored των parts του και το WalkSpeed του Humanoid του. Πληκτρολογήστε / στη συνομιλία για να επισυνάψετε την ακριβή διαδρομή του μοντέλου
- Γράφει το ModuleScript DialogueData, το Script DialogueService και το LocalScript DialogueClient με Create Script
- Έχει εντολή να ελέγχει ότι κάθε script που γράφει κάνει compile με Check Script, που το μεταγλωττίζει στο Studio χωρίς να το τρέξει
- Στέλνει τις αλλαγές σε δέσμες, και κάθε δέσμη είναι ένα σημείο αναίρεσης στο ιστορικό του Studio
Με το plugin 3.9 ή νεότερο το RoCode μπορεί να τρέξει ένα σύντομο playtest και να διαβάσει τα σφάλματα, και με το plugin 3.9.11 ή νεότερο μπορεί να ελέγχει έναν χαρακτήρα δοκιμής για να επιβεβαιώσει ότι το παιχνίδι δουλεύει, αλλά κατά το παιχνίδι δεν τραβά στιγμιότυπα, οπότε πλησιάστε το NPC και μιλήστε του μόνοι σας. Αν κάτι δεν δουλεύει σωστά, πείτε στο RoCode τι είδατε: το Check Output μπορεί να διαβάσει τις γραμμές Server και Client από το τελευταίο σας playtest. Ένα NPC που μιλά είναι ένα σύστημα από πολλά· η σελίδα πώς να φτιάξετε παιχνίδι Roblox με AI, ένα σύστημα ανά prompt δείχνει πώς δένουν μεταξύ τους. Πώς συνδέεται το RoCode με το Studio.
Συχνές ερωτήσεις
Πώς φτιάχνω NPC που μιλά στο Roblox Studio;
Δώστε στο NPC ένα ProximityPrompt και, όταν ο παίκτης το πυροδοτεί, δείξτε την ατάκα του NPC σε παράθυρο διαλόγου, σε συννεφάκι ή και στα δύο. Τα τρία scripts αυτού του οδηγού κάνουν και τα δύο και προσθέτουν επιλογές απάντησης. Αν χρειάζεστε μόνο το συννεφάκι, καλέστε TextChatService:DisplayBubble(npc.Head, "Hello!") από ένα LocalScript όταν πυροδοτείται το prompt, όπως στο παράδειγμα με NPC στη σελίδα του Roblox για το bubble chat.
Τι να διαλέξω: αντικείμενο Dialog ή δικό μου GUI διαλόγου;
Το αντικείμενο Dialog δεν χρειάζεται κώδικα και δείχνει ένα συννεφάκι που πατιέται, κάτι που αρκεί για διακοσμητικό κείμενο. Το συμβάν επιλογής του πυροδοτείται μόνο στη συσκευή του παίκτη, οπότε δεν μπορεί να δίνει ανταμοιβές με ασφάλεια, και από προεπιλογή μπορεί να του μιλά μόνο ένας παίκτης τη φορά. Ένα δικό σας παράθυρο, όπως σε αυτόν τον οδηγό, αφήνει τον server να δίνει κάθε ανταμοιβή και δίνει σε κάθε παίκτη τη δική του συζήτηση.
Πώς δίνω στον παίκτη ένα αντικείμενο από NPC;
Κρατήστε το Tool στο ServerStorage και αφήστε ένα Script του server να το κλωνοποιεί στο Backpack του παίκτη όταν διαλέγει αυτή την επιλογή, όπως κάνει η ενέργεια GiveItem. Ελέγξτε ότι ο παίκτης δεν το έχει ήδη και απενεργοποιήστε το CanBeDropped στο αντίγραφο, ώστε να μην μπορεί να το πετάξει και να ζητήσει ξανά. Μην αφήνετε ποτέ τη συσκευή του παίκτη να λέει ποιο αντικείμενο θα δοθεί.
Πώς φτιάχνω παράθυρο διαλόγου με εφέ γραφομηχανής;
Βάλτε όλη την ατάκα σε ένα TextLabel, αυξάνετε το MaxVisibleGraphemes του από το 0 λίγους χαρακτήρες κάθε φορά και στο τέλος ορίστε -1 για να φαίνονται όλα. Η σελίδα του Roblox για animation στο UI χρησιμοποιεί την ίδια ιδιότητα μαζί με το utf8.graphemes. Το DialogueClient υπολογίζει πόσους χαρακτήρες να δείξει από τον χρόνο που πέρασε, 45 το δευτερόλεπτο, οπότε η ταχύτητα δεν εξαρτάται από τον ρυθμό καρέ.
Μπορούν δύο παίκτες να μιλούν στο ίδιο NPC ταυτόχρονα;
Με τα scripts αυτού του οδηγού ναι: ο server κρατά μία συζήτηση ανά παίκτη και κάθε παίκτης βλέπει μόνο το δικό του παράθυρο. Το ενσωματωμένο αντικείμενο Dialog λειτουργεί αλλιώς: με το προεπιλεγμένο BehaviorType του, SinglePlayer, μιλά ένας παίκτης τη φορά και οι υπόλοιποι βλέπουν τις επιλογές του.
Χρειάζεται να φιλτράρω το κείμενο του διαλόγου του NPC;
Τις ατάκες που γράψατε εσείς όχι. Το Roblox σας αναθέτει την ευθύνη να φιλτράρετε κείμενο που εμφανίζεται και δεν ελέγχετε άμεσα, για παράδειγμα ό,τι πληκτρολογούν οι παίκτες, λέξεις φτιαγμένες από τυχαίους χαρακτήρες ή κείμενο που φορτώνεται από εξωτερικό site. Αν το NPC επαναλαμβάνει κάτι που έγραψε ένας παίκτης, φιλτράρετε αυτό το κομμάτι.
Πηγές και περαιτέρω ανάγνωση
- Roblox Creator Docs: Proximity prompts (στα αγγλικά). δημιουργία prompts, MaxActivationDistance και RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (στα αγγλικά). πού λειτουργεί το prompt, το κείμενο και τα προεπιλεγμένα πλήκτρα του, Triggered και ο έλεγχος οπτικής επαφής
- Roblox Creator Docs: Securing the client-server boundary (στα αγγλικά). το ProximityPrompt ως επιφάνεια επίθεσης, έλεγχοι απόστασης και δικαιωμάτων
- Roblox Engine API: Dialog (στα αγγλικά). BehaviorType και το συμβάν DialogChoiceSelected μόνο στον client
- Roblox Engine API: TextChatService:DisplayBubble (στα αγγλικά). συννεφάκια με ατάκες για NPC από scripts του client
- Roblox Creator Docs: Customize bubble chat (στα αγγλικά). συννεφάκια NPC και BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (στα αγγλικά). ποιο κείμενο που εμφανίζεται πρέπει να φιλτράρεται
- Roblox Creator Docs: UI animation and tweens (στα αγγλικά). εφέ γραφομηχανής με MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (στα αγγλικά). τι κάνει το Backspace σε ένα εργαλείο
- Roblox Engine API: UserInputService.PreferredInput (στα αγγλικά). πώς αναγνωρίζεται ένας παίκτης με gamepad
- Roblox Creator Docs: Rig Generator (στα αγγλικά). προσθήκη rig R15 ή R6
Πώς ελέγχθηκε ο κώδικας: κάθε script σε αυτή τη σελίδα περνά αυστηρό έλεγχο τύπων Luau με τους ορισμούς του Roblox API (luau-lsp, 20 Νοεμβρίου 2026). Ο έλεγχος τύπων πιάνει λάθη σε ονόματα API και λάθος τύπους, όχι όμως λάθη στη λογική του παιχνιδιού, γι' αυτό δοκιμάστε τα πάντα στο Studio πριν τη δημοσίευση.