Lyhyesti
Laita NPC-malli Workspacen kansioon NPCs ja kirjoita sen keskustelu ModuleScriptiin ReplicatedStoragessa: jokaisella repliikillä on NPC:n teksti ja luettelo vaihtoehdoista, jotka johtavat toiseen repliikkiin. Script ServerScriptServicessä lisää jokaiselle NPC:lle ProximityPromptin ("Talk"), muistaa, missä repliikissä kukin pelaaja on, ja lähettää sen RemoteEventin kautta. LocalScript näyttää tekstin ja painikkeen jokaiselle vaihtoehdolle ja lähettää takaisin vain painetun painikkeen numeron.
- Anna palkinnot palvelimella. Sisäänrakennetun Dialog-olion
DialogChoiceSelected-tapahtuma laukeaa vain asiakkaalla, joten palvelimen Script ei koskaan kuule sitä, ja LocalScriptissä annettu parannus tai esine muuttaa vain kyseisen pelaajan kopiota pelistä. - Näytä repliikki puhekuplassa kutsulla
TextChatService:DisplayBubble(npc.Head, text)LocalScriptistä. VanhaChat-palvelu on vanhentunut, ja sen tilalla käytetään TextChatServiceä. - Itse kirjoittamiasi repliikkejä ei tarvitse suodattaa. Robloxin sääntö: suodata kaikki näytettävä teksti, jota et hallitse suoraan, esimerkiksi pelaajien kirjoittama.
Tällä sivulla
Miten NPC-dialogi toimii
Oikeassa pelissä toimiva puhuva NPC on jaettu palvelimen ja jokaisen pelaajan laitteen kesken. Laite piirtää ikkunan ja painikkeet. Palvelin, ainoa osapuoli, johon voi luottaa, tietää, mitä repliikkiä kukin pelaaja lukee, ja päättää, mitä kukin vastaus tekee. Yksi keskustelun vuoro näyttää tältä:
- Pelaaja kävelee NPC:n luo ja painaa E:tä sen Talk-kehotteessa. Kehotteen
Triggered-tapahtuma laukeaa palvelimella tämän pelaajan kanssa. - Palvelimen skripti tarkistaa, että pelaaja on tarpeeksi lähellä, muistaa, että hän on repliikissä nimeltä
start, ja lähettää tämän repliikin tekstin ja sen vaihtoehtojen otsikot vain tälle pelaajalle. - LocalScript kirjoittaa repliikin dialogi-ikkunaan, näyttää puhekuplan NPC:n yläpuolella ja lisää sitten painikkeen jokaiselle vaihtoehdolle.
- Pelaaja klikkaa, napauttaa tai valitsee vaihtoehdon. Palvelimelle palaa vain sen numero.
- Palvelin etsii tämän numeron repliikistä, jota pelaaja sen tietojen mukaan lukee, suorittaa vaihtoehdon toiminnon, jos sellainen on (parannus, esine), ja lähettää seuraavan repliikin tai sulkee ikkunan.
| Osa | Missä se on | Mitä se tekee |
|---|---|---|
Rig Guide | Workspace, kansiossa nimeltä NPCs | Itse NPC. Sen nimi valitsee keskustelun ja näkyy kehotteessa. |
ModuleScript DialogueData | ReplicatedStorage | Kaikki repliikit, jotka NPC voi sanoa, vaihtoehdot jokaisen repliikin alla ja se, mihin kukin vaihtoehto johtaa. |
Script DialogueService | ServerScriptService | Lisää Talk-kehotteen, muistaa, missä repliikissä kukin pelaaja on, tarkistaa jokaisen klikkauksen ja suorittaa toiminnot. |
RemoteEvent DialogueEvent | ReplicatedStorage (DialogueService luo sen) | Vie jokaisen repliikin pelaajalle ja valitun vaihtoehdon numeron takaisin palvelimelle. |
LocalScript DialogueClient | StarterPlayer, StarterPlayerScripts | Piirtää ikkunan, kirjoittaa repliikin, näyttää puhekuplan ja vaihtoehtopainikkeet. |
Tool Torch (valinnainen) | ServerStorage, kansiossa nimeltä DialogueItems | Esine, jonka yksi vaihtoehdoista antaa. ServerStoragesta ei lähetetä mitään pelaajille. |
Workspace
NPCs Folder new
Guide Model new
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (kehon osat)
ReplicatedStorage
DialogueData ModuleScript new
ServerScriptService
DialogueService Script new
ServerStorage
DialogueItems Folder new
Torch Tool new
Handle Part new
StarterPlayer
StarterPlayerScripts
DialogueClient LocalScript new
Vaihe 1: lisää NPC
- Paina Avatar- tai Home-välilehdellä Character avataksesi Rig Generatorin. Valitse R15, vartalon muoto ja tyyli. Workspaceen ilmestyy rig nimeltä
Rig. R6-rig toimii samoilla skripteillä. - Nimeä se uudelleen
Guide. Nimellä on väliä: DialogueService etsii keskustelun mallin nimen perusteella, ja kehote näyttää sen pelaajille. - Laajenna rig, valitse sen HumanoidRootPart ja rastita Anchored Properties-ikkunassa. Ankkuroitu partti ei koskaan liiku fysiikan vuoksi, joten NPC pysyy siellä, mihin sen asetit, eivätkä pelaajat voi tönäistä sitä.
- Vie osoitin Explorerissa Workspacen päälle, paina +-painiketta ja lisää Folder nimeltä
NPCs. Vedä Guide siihen ja aseta rig paikkaan, jonne pelaajat pääsevät kävelemään. - Valinnainen, esinevaihtoehtoa varten: vie osoitin ServerStoragen päälle ja lisää Folder nimeltä
DialogueItems. Laita siihen Tool nimeltäTorchja sen sisään yksi ankkuroimaton Part nimeltäHandle, eli partti, jota hahmo pitää kädessään. PointLight Handlen sisällä saa sen hehkumaan.
Nimet ovat kirjainkokoherkkiä, joten kirjoita NPCs, Guide, DialogueItems ja Torch täsmälleen kuten näytetään. NPC voi olla mikä tahansa malli, jossa on Humanoid ja HumanoidRootPart, myös Toolboxista, kunhan se on suoraan NPCs-kansiossa.
Vaihe 2: kirjoita keskustelu
Vie osoitin ReplicatedStoragen päälle, lisää ModuleScript nimeltä DialogueData ja liitä siihen tämä koodi. Siinä ei ole logiikkaa, vain sanat ja niiden väliset yhteydet, joten tätä tiedostoa muokkaat useimmin.
-- ModuleScript ReplicatedStoragessa, nimeltään DialogueData.
-- Kaikki keskustelut NPC:n nimen mukaan Workspace.NPCs-kansiossa. Jokaisella repliikillä on
-- NPC:n teksti ja pelaajan vastausvaihtoehdot. Vaihtoehto voi johtaa toiseen repliikkiin (next),
-- lopettaa keskustelun (ilman nextiä) ja pyytää palvelinta tekemään jotain (action). Jos palvelin
-- ei pysty suorittamaan toimintoa, se näyttää failNext-repliikin nextin sijaan.
export type Choice = {
text: string,
next: string?, -- repliikki, joka näytetään tämän vaihtoehdon jälkeen; nil lopettaa keskustelun
action: string?, -- palvelimen toiminto DialogueServicen ACTIONS-taulukosta
item: string?, -- GiveItem-toiminnolle: Toolin nimi kansiossa ServerStorage.DialogueItems
failNext: string?, -- repliikki, joka näytetään nextin sijaan, kun toimintoa ei saatu suoritettua
}
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
Alun export type -rivit kuvaavat, miltä repliikki ja vaihtoehto näyttävät. Pelin aikana ne eivät muuta mitään; ne kuvaavat tietojasi, jotta tyyppitarkistus voi tarkistaa ne.
Miten osat liittyvät toisiinsa:
- Jokaisella NPC:llä on taulukko, joka on nimetty sen NPCs-kansiossa olevan mallin mukaan, tässä
Guide. Jokainen keskustelu alkaa repliikistästart. texton se, mitä NPC sanoo.choicesovat pelaajan painikkeet järjestyksessä. Ikkunassa on tilaa neljälle.nextnimeää repliikin, joka näytetään tämän vaihtoehdon jälkeen. Vaihtoehto ilmannext-arvoa, kuten "Bye!", lopettaa keskustelun.nexttaifailNext, joka nimeää taulukosta puuttuvan repliikin, lopettaa sen myös, varoituksen kera Outputissa.actionnimeää sen, mitä palvelin tekee, DialogueServicenACTIONS-taulukosta: tässäHealtaiGiveItem.itemon GiveItemiä varten: se on Toolin nimi kohteessa ServerStorage, DialogueItems.failNexton repliikki, joka näytetäännext-repliikin sijaan, kun toimintoa ei saatu suoritettua, jotta NPC ei koskaan väitä parantaneensa tai antaneensa jotain, mitä ei tapahtunut.
| Repliikki | Guide sanoo | Vaihtoehdot ja mihin ne johtavat |
|---|---|---|
start | "Welcome to the village! What can I do for you?" | "Any tips?" johtaa repliikkiin tips. "I'm hurt. Can you help?" parantaa, sitten healed (tai healTooSoon). "Got anything for the cave?" antaa Torchin, sitten torch (tai hasTorch). "Bye!" lopettaa keskustelun. |
tips | "Stay off the red bricks, and come back if you get hurt." | "Anything else?" palaa repliikkiin start. "Thanks!" lopettaa keskustelun. |
healed | "There you go, good as new." | "Thank you!" lopettaa keskustelun. |
torch | "Take this torch. The cave is dark." | "Thanks!" lopettaa keskustelun. |
healTooSoon | "I healed you a moment ago. Come back in a little while." | "OK" lopettaa keskustelun. |
hasTorch | "You already have my torch. Keep it lit!" | "Will do!" lopettaa keskustelun. |
Tätä moduulia lukee vain palvelin. LocalScript ei koskaan tee sille requirea: palvelin lähettää jokaisen repliikin, kun pelaaja pääsee siihen. Mutta ReplicatedStoragessa oleva moduuli kopioidaan silti jokaisen pelaajan laitteelle, joten jos keskustelussa on juonipaljastuksia (vaikkapa arvoituksen vastaus), siirrä DialogueData ServerStorageen. Vaihda sitten DialogueServicen require-rivillä ReplicatedStorage tilalle ServerStorage, niin että koko rivi näyttää tältä: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.
Vaihe 3: lisää palvelimen skripti
Vie osoitin ServerScriptServicen päälle, lisää Script nimeltä DialogueService ja liitä siihen alla oleva koodi. Tämä on ainoa paikka, jossa keskustelu etenee, ja ainoa paikka, jossa palkinto annetaan.
-- Script ServerScriptServicessä, nimeltään DialogueService.
-- Lisää Talk-kehotteen jokaiselle NPC:lle Workspace.NPCs-kansiossa ja vie jokaista keskustelua.
-- Pelaajan laite vain näyttää tekstin ja lähettää takaisin sen vaihtoehdon numeron,
-- jota hän klikkasi. Palvelin tietää, missä repliikissä kukin pelaaja on, tarkistaa vaihtoehdon
-- ja etäisyyden, ja vain se parantaa tai antaa esineitä.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Samat muodot kuin DialogueDatassa, jotta Studion tyyppitarkistus tuntee ne myös täällä
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 -- studeina: kehotteen säde ja se, kuinka lähellä pelaajan pitää pysyä
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30
local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")
-- Tämä skripti luo DialogueEventin itse, joten älä lisää sitä käsin
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 -- ei hahmoa, hahmo on kuollut tai NPC on kadonnut
end
-- pieni varmuusvara, koska pelaajan sijainti saapuu palvelimelle pienellä viiveellä
return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end
-- Mitä palvelin tekee, kun vaihtoehdolla on toiminto. Jokainen palauttaa true, jos se onnistui.
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 -- parannettu liian äskettäin
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 -- reppua ei vielä ole tai esine on jo pelaajalla
end
local item = template:Clone() :: Tool
item.CanBeDropped = false -- jotta kukaan ei voi pudottaa sitä ja pyytää uutta
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 -- keskustelee jo, tällä NPC:llä ei ole "start"-repliikkiä, kuollut tai liian kaukana
end
local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
conversations[player] = conversation
showLine(player, conversation)
end
-- Pelaaja klikkasi vaihtoehtoa numero choiceIndex (0 tarkoittaa, että hän sulki ikkunan)
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
-- Liian nopeasti. Lähetetään sama repliikki uudelleen, koska ikkuna lukitsi jo
-- painikkeet klikkauksen jälkeen ja odottaisi muuten vastausta ikuisesti.
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 -- repliikissä, jota tämä pelaaja lukee, ei ole tällaista vaihtoehtoa
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 -- esimerkiksi "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)
-- Talk-kehote jokaiselle NPC:lle
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:n kopio tuo mukanaan vanhan kehotteen, jota kukaan ei kuuntele
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)
-- Suljetaan ikkuna kaikilta, jotka lähtivät pois tai kuolivat kesken keskustelun
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 luo RemoteEventin DialogueEvent itse pelin käynnistyessä, joten ReplicatedStorageen ei tarvitse lisätä mitään käsin. Jos loit jo samannimisen RemoteEventin, poista se: LocalScript saattaisi löytää sinun versiosi, eikä sitä kuuntele kukaan palvelimella.
| Asetus | Arvo tässä | Mitä se muuttaa |
|---|---|---|
TALK_DISTANCE | 12 | Kuinka lähellä, studeina, pelaajan pitää olla, jotta Talk-kehote ilmestyy. Palvelin antaa hänen siirtyä vielä 4 studia kauemmas ennen kuin sulkee ikkunan, koska pelaajan sijainti saapuu palvelimelle pienellä viiveellä. |
MIN_SECONDS_BETWEEN_CHOICES | 0.3 | Lyhin aika kahden klikkauksen välillä, jonka palvelin hyväksyy. Nopeampaan klikkaukseen lähetetään vastauksen sijaan sama repliikki uudelleen. |
HEAL_COOLDOWN_SECONDS | 30 | Kuinka kauan kukin pelaaja odottaa Heal-toiminnon parannusten välillä. |
Palvelin pitää conversations-taulukossa yhden merkinnän pelaajaa kohden: kenen NPC:n kanssa hän puhuu, mitä repliikkiä hän lukee ja milloin hänen viimeisin klikkauksensa hyväksyttiin. Kun Talk-kehote laukeaa, startConversation luo tämän merkinnän vain, jos pelaaja ei jo keskustele, NPC:llä on start-repliikki ja pelaaja on elossa ja säteen sisällä. Sen jälkeen jokainen klikkaus kulkee näiden tarkistusten läpi:
| Tarkistus | Koodi | Jos se ei mene läpi |
|---|---|---|
| Pelaaja on keskustelussa | conversations[player] | Klikkaus ohitetaan. |
| Vaihtoehto on kokonaisluku | typeof ja math.floor | Ohitetaan. Merkkijonot, taulukot, murtoluvut ja NaN pysähtyvät tähän. |
| 0 tarkoittaa, että pelaaja painoi X | choiceIndex == 0 | Keskustelu päättyy. |
| Elossa ja yhä enintään 16 studin päässä (12 plus 4) | isClose | Keskustelu päättyy, ja ikkuna sulkeutuu. |
| Vähintään 0.3 sekuntia viimeisestä hyväksytystä klikkauksesta | conversation.lastChoice | Sama repliikki lähetetään uudelleen, joten ikkuna saa tuoreet painikkeet eikä odota ikuisesti. |
| Vaihtoehto on olemassa repliikissä, jota tämä pelaaja lukee | line.choices[choiceIndex] | Ohitetaan. |
| Toiminto onnistui | jokainen toiminto palauttaa true tai false | next-repliikin sijaan näytetään failNext-repliikki. |
Kehote kiinnitetään NPC:n HumanoidRootPartiin, koska ProximityPrompt toimii, kun se on partin (tai Attachmentin tai PrimaryPartilla varustetun mallin) sisällä Workspacessa. Sen RequiresLineOfSight on oletuksena päällä ja piilottaa kehotteen aina, kun jokin peittää näkymän kamerasta tähän parttiin. Roblox jättää kehotteen oman partin tämän tarkistuksen ulkopuolelle, mutta muuta kehoa ei, ja HumanoidRootPart on vartalon sisällä, joten skripti kytkee näköyhteyden tarkistuksen pois. Kehotteen nimi on TalkPrompt, ja skripti poistaa partista jo löytyvän TalkPromptin ennen kuin lisää omansa: pelin aikana tehty NPC:n kopio tulee alkuperäisen kehotteen kanssa, eikä kopioitua kuuntele kukaan. Jos DialogueDatassa ei ole NPC:n nimelle keskustelua, jossa on start-repliikki, Outputiin ilmestyy varoitus kyseisen NPC:n nimellä.
Silmukka tarkistaa kahdesti sekunnissa jokaisen avoimen keskustelun ja sulkee sen, kun pelaaja on siirtynyt yli 16 studin päähän tai hänen hahmonsa on kuollut, jotta kesken keskustelun kuollut pelaaja ei synny uudelleen ikkuna auki. PlayerRemoving tyhjentää molemmat taulukot, kun joku poistuu.
Vaihe 4: lisää dialogi-ikkuna
Avaa StarterPlayer, vie osoitin StarterPlayerScriptsin päälle, lisää LocalScript nimeltä DialogueClient ja liitä siihen tämä koodi. Se rakentaa dialogi-ikkunan koodissa, joten GUI:ta ei tarvitse piirtää käsin.
-- LocalScript kohteessa StarterPlayer > StarterPlayerScripts, nimeltään DialogueClient.
-- Piirtää palvelimen lähettämän keskustelun: NPC:n nimen, sen repliikin kirjoitettuna kirjain
-- kerrallaan, puhekuplan pään yläpuolelle ja painikkeen jokaiselle vaihtoehdolle. Klikkaus
-- vaihtoehtoon lähettää vain sen numeron; mitä tapahtuu seuraavaksi, päättää palvelin.
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)
-- Dialogi-ikkuna, rakennettu koodissa
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 pikseliä ylempänä, jotta Robloxin työkalupalkki ei peitä vaihtoehtoja
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 -- pitkä repliikki pienenee mahtuakseen puhelimen pienelle näytölle
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- eikä koskaan kasva yli 20 pikselin suurella näytöllä
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 -- kasvaa jokaisella uudella repliikillä, jotta vanha kirjoitussilmukka pysähtyy
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 -- muuttuu vain tällä laitteella
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()
-- Puhekupla NPC:n yläpuolelle (DisplayBubble toimii vain LocalScriptissä)
local head = npc:FindFirstChild("Head")
if head then
TextChatService:DisplayBubble(head, text)
end
-- Kirjoitetaan repliikki kirjain kerrallaan. Määrä lasketaan kuluneesta ajasta,
-- joten nopeus on sama millä tahansa ruudunpäivitysnopeudella.
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 -- tämän repliikin korvasi uudempi tai sulkeminen
end
shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
lineLabel.MaxVisibleGraphemes = shown
end
lineLabel.MaxVisibleGraphemes = -1
-- Yksi painike vaihtoehtoa kohden; palvelin saa vain painikkeen numeron
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 -- yksi klikkaus repliikkiä kohden
dialogueEvent:FireServer(index)
end
end)
if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = button -- jotta vaihtoehdon voi valita peliohjaimella
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)
Värejä, kokoja ja LETTERS_PER_SECOND-arvoa voit muuttaa vapaasti. Jätä kaksi viimeistä käsittelijää ennalleen: ne ovat ainoa tapa, jolla ikkuna viestii palvelimen kanssa.
Mitä DialogueClientin kukin osa tekee:
- Ikkuna. ScreenGui, jossa on näytön alareunan keskelle kiinnitetty Frame, 60% sen leveydestä ja 34% korkeudesta, ja
UISizeConstraintrajoittaa sen 720 x 300 pikseliin, jotta se ei veny koko leveän näytön levyiseksi. NPC:n repliikki käyttääTextScaled-ominaisuutta, joka pienentää tekstiä, jotta se mahtuu labeliinsa puhelimen pienellä näytöllä, jaUITextSizeConstraintestää sitä kasvamasta yli 20 pikselin suurella näytöllä.UIGridLayoutasettelee vaihtoehdot kaksi kertaa kaksi.ResetOnSpawnon false, koska tämä LocalScript ajetaan kerran istuntoa kohden: uudelleensyntymisessä poistettu ikkuna ei palaisi enää. - Kirjoituskone-efekti. Koko repliikki menee TextLabeliin kerralla, ja
MaxVisibleGraphemespäättää, montako merkkiä näkyy; se on sama ominaisuus, jota Robloxin oma kirjoituskone-esimerkki käyttää yhdessäutf8.graphemes-funktion kanssa. Roblox asettelee tekstin ikään kuin kaikki merkit näkyisivät, joten sanat eivät hyppää uudelle riville eivätkä muuta kokoaan ilmestyessään. Skripti laskee näytettävien merkkien määrän kuluneesta ajasta, 45 sekunnissa, joten nopeus on sama millä tahansa ruudunpäivitysnopeudella, ja asettaa lopuksi ominaisuuden arvoon -1, joka näyttää kaiken. - Painikkeet. Ne ilmestyvät, kun repliikki on kirjoitettu. Kukin lähettää vain oman numeronsa ja vain kerran:
lineNumber-tarkistus estää tuplaklikkausta lähettämästä kahdesti, ja sen jälkeen ikkuna odottaa palvelimelta seuraavaa repliikkiä. - Puhekupla.
TextChatService:DisplayBubble(head, text)laittaa repliikin chat-kuplaan NPC:n Headin yläpuolelle. Roblox sallii tämän vain asiakasskripteissä, ja bubble chat on oletuksena päällä. Kuplan piirtää tämän pelaajan laite, joten vain hän näkee sen. - Kehote. Kun pelaaja keskustelee, hänen kopionsa Talk-kehotteesta (se löydetään nimellä TalkPrompt) on pois päältä, jotta se ei roiku keskustelun päällä. Muut pelaajat näkevät yhä omansa.
- Mikä tahansa laite.
Activatedlaukeaa hiiren klikkauksesta, puhelimen napautuksesta ja peliohjaimen A-painikkeesta. Peliohjaimella voi painaa vain valittua painiketta, joten kunPreferredInputkertoo pelaajan käyttävän peliohjainta, skripti valitsee ensimmäisen vaihtoehdonGuiService.SelectedObject-ominaisuudella. - X-painike. Se lähettää 0, jonka palvelin ymmärtää "lopeta keskustelu", ja sulkee ikkunan heti.
Lisää omia toimintoja
Toiminto on funktio DialogueServicen alussa olevassa ACTIONS-taulukossa. Se saa pelaajan ja vaihtoehdon ja palauttaa true, kun se on tehnyt tehtävänsä. Lisätäksesi oman, vaikkapa NPC:n antaman tehtävän:
- Lisää
ACTIONS-taulukkoon merkintä nimeltäStartQuest. Ensin tarkistus, sitten muutos: josplayer:GetAttribute("Quest")on jo asetettu, palautafalse; muuten kutsuplayer:SetAttribute("Quest", "Cave")ja palautatrue. - Anna DialogueDatassa vaihtoehdolle
action = "StartQuest",next-repliikki onnistumisen varalle jafailNext-repliikki epäonnistumisen varalle, esimerkiksi "You are already on a quest." - Paina Play ja valitse vaihtoehto kahdesti. Jos DialogueDatan nimi ei vastaa
ACTIONS-taulukon avainta (kirjainkoolla on väliä), Outputiin ilmestyyDialogueService: no action named StartQuest, ja keskustelu siirtyyfailNext-repliikkiin.
Säännöt toimintojen kirjoittamiseen:
- Tee tarkistus ja muutos toiminnon sisällä, palvelimella. Ainoa asia, jonka pelaajan laite lähettää, on vaihtoehdon numero.
- Lue toiminnon tarvitsema tieto vaihtoehdosta (kuten
item) tai palvelimen omasta tilasta, mutta ei koskaan remotesta. - Rajoita kaikkea arvokasta itse toiminnon sisällä, samoin kuin Heal pitää oman 30 sekunnin cooldowninsa
lastHeal-taulukossa. 0.3 sekunnin klikkausraja vain hidastaa klikkauksia; se ei estä pelaajaa käymästä samaa vaihtoehtoa läpi yhä uudelleen. - Avatakseen toisen ikkunan, esimerkiksi kaupan, toiminto voi lähettää RemoteEventin tälle pelaajalle ja palauttaa
true. Kaikki, mitä siinä ikkunassa tapahtuu, vaatii silti omat palvelintarkistuksensa, kuten osiossa Kauppias-NPC.
Missä muut NPC-dialogitutoriaalit menevät pieleen
Jos vertaat tätä opasta videoon tai foorumikirjoitukseen, tässä ovat tärkeät erot ja syy siihen, miksi kukin keino aiheuttaa ongelman.
| Tutoriaali | Ongelma | Tämä opas |
|---|---|---|
Käyttää Dialog-oliota, ja palvelimen Script kuuntelee DialogChoiceSelected-tapahtumaa antaakseen palkinnon | Robloxin dokumentaation mukaan tämä tapahtuma toimii vain asiakaspuolella eikä laukea palvelimella, joten palkinto ei koskaan tule. | Vaihtoehto saapuu palvelimelle numerona, ja palvelin antaa palkinnon itse. |
| Antaa palkinnon LocalScriptistä | LocalScriptin tekemä muutos jää tälle yhdelle laitteelle (katso mikä replikoituu), ja huijari voi ajaa saman koodin milloin tahansa. | Kaikki toiminnot ovat DialogueServicessä. |
Saa NPC:n puhumaan kutsulla game:GetService("Chat"):Chat(head, text) | Chat-palvelu on vanhentunut, ja sen tilalla käytetään TextChatServiceä. | TextChatService:DisplayBubble LocalScriptissä. |
| Lähettää asiakkaalta palkinnon nimen tai seuraavan repliikin id:n | Huijari voi lähettää minkä tahansa esineen nimen tai hypätä suoraan palkinnon antavaan repliikkiin. | Asiakas lähettää vain vaihtoehdon numeron. Palvelin etsii sen repliikistä, jota pelaaja sen tietojen mukaan lukee. |
| Ei tarkista mitään kehotteen laukeamisen jälkeen | Robloxin turvallisuusopas rinnastaa ProximityPromptin remoteihin asiana, jota asiakkaat voivat käyttää väärin, ja neuvoo tarkistamaan ennen toimintoa, onko pelaaja tarpeeksi lähellä. | Etäisyys tarkistetaan keskustelun alussa, jokaisella klikkauksella ja kahdesti sekunnissa niin kauan kuin keskustelu on auki. |
Kirjoittaa tekstin wait()-kutsulla silmukassa | Globaali wait on vanhentunut, ja sen tilalla käytetään task.wait-funktiota. | Laskee näkyvien kirjainten määrän os.clock()-arvosta ja odottaa kutsulla task.wait(). |
Mitä pelaaja voi ja mitä ei voi väärentää
Oleta, että huijari hallitsee kaikkea omalla laitteellaan. Hän voi lukea LocalScriptisi ja kaiken ReplicatedStoragessa, kutsua DialogueEventiä millä tahansa argumenteilla niin monta kertaa kuin haluaa ja laukaista Talk-kehotteen koodista, mistä Robloxin turvallisuusopas varoittaa. DialogueService vastaa palvelintarkistuksilla, jotka ovat samaa lajia kuin osiossa RemoteEventin argumenttien tarkistus. Tässä on se, mitä huijari tästä saa.
| Huijari yrittää | Tulos | Miksi |
|---|---|---|
| Laukaista Talk-kehotteen kartan toiselta laidalta | Mitään ei tapahdu | startConversation tarkistaa, että hän on enintään 16 studin päässä (12 plus 4). |
| Lähettää vaihtoehdon 99, merkkijonon, murtoluvun tai NaN:n | Ohitetaan | Se ei ole kokonaisluku, tai tällaista vaihtoehtoa ei ole repliikissä, jota hän lukee. |
| Lähettää palkinnon nimen tai repliikin id:n | Ei koskaan lueta | Palvelin lukee vain vaihtoehdon numeron. Palkinnot tulevat repliikin palvelinkopion item- ja action-kentistä. |
| Klikata niin nopeasti kuin verkko sallii | Yksi klikkaus 0.3 sekunnin välein keskustelua kohden | Nopeampiin klikkauksiin palautetaan niiden oma repliikki. Keskustelun lopettaminen ja uudelleen aloittaminen ohittaa tämän odotuksen, joten Heal ja GiveItem pitävät omat rajansa. |
| Pyytää soihtua keskustelematta | Mahdotonta | Esineet annetaan vain vaihtoehdosta repliikissä, jossa pelaaja palvelimen tietojen mukaan on. |
| Kerätä kasa soihtuja | Yksi kerrallaan | Palvelin etsii ensin Torchia hänen Backpackistaan ja hahmostaan, eikä annettua soihtua voi pudottaa, joten sitä ei voi farmata pudottamalla ja pyytämällä uudelleen. |
| Spämmätä parannusrepliikkiä | Yksi parannus 30 sekunnin välein | Cooldown säilytetään palvelimella jokaiselle pelaajalle, ja NPC kertoo siitä healTooSoon-repliikillä. |
| Kävellä pois ja jättää ikkuna auki | Sulkeutuu puolen sekunnin sisällä | Palvelin tarkistaa jokaisen avoimen keskustelun kahdesti sekunnissa. |
| Lukea koko keskustelu, myös repliikit, joihin hän ei ole päässyt | Mahdollista | DialogueData on ReplicatedStoragessa, joka kopioidaan jokaiselle laitteelle. Siirrä se ServerStorageen, jos tällä on väliä (katso vaihe 2). |
Yhdestä rajoituksesta kannattaa sanoa suoraan: huijari, joka kävelee Guiden luo ja valitsee vaihtoehtoja, saa täsmälleen saman kuin rehellinen pelaaja. Palvelin hallitsee sitä, kuinka usein ja mistä, mutta ei sitä, kuka. Kaikki harvinainen, esimerkiksi palkinto, jonka kukin pelaaja voi saada kerran, vaatii palvelimen omistaman tarkistuksen, kuten saamisen yhteydessä asetetun attribuutin tai tietovarastoon tallennetun lipun.
Vaihe 5: testaa
- Paina Play (F5) ja kävele Guiden luo. 12 studin säteellä ilmestyy Talk-kehote Guiden nimellä. Paina E.
- Ikkuna näyttää "Guide", kirjoittaa tervehdysrepliikin ja näyttää sitten neljä painiketta. Sama repliikki ilmestyy puhekuplaan NPC:n pään yläpuolelle.
- Valitse "Any tips?", sitten "Anything else?": olet taas ensimmäisessä repliikissä. Valitse "Bye!": ikkuna sulkeutuu, ja Talk-kehote palaa.
- Vahingoita ensin itseäsi: paina Client/Server-vaihtoa siirtyäksesi Serveriin, valitse hahmosi Humanoid Workspacessa, aseta Health arvoon 50 Properties-ikkunassa ja vaihda takaisin Clientiin. Pelaajien hahmot palauttavat 1% MaxHealthista joka sekunti, joten puhu heti Guidelle ja valitse "I'm hurt. Can you help?": terveys hyppää täyteen. Puhu uudelleen 30 sekunnin sisällä ja valitse se vielä kerran: parannusta ei tule, ja Guide sanoo parantaneensa sinut hetki sitten.
- Valitse "Got anything for the cave?": Torch ilmestyy hotbariin. Varusta se ja paina Backspace: se pysyy kädessä. Pyydä uudelleen: toista soihtua ei tule, ja Guide sanoo, että sinulla on se jo.
- Aloita keskustelu ja kävele pois. Ikkuna sulkeutuu suunnilleen silloin, kun olet 16 studin päässä Guidesta.
- Valitse testitilojen pudotusvalikosta Server & Clients, aseta 2 asiakasta ja paina Play. Molemmat pelaajat voivat puhua Guidelle samanaikaisesti, kumpikin omassa repliikissään.
- Testaa peliohjain Controller Emulatorilla (Controller Emulation-välilehdellä) pelitestin aikana. Kävele emuloidulla peliohjaimella NPC:n luo ja paina kehotteen painiketta (oletuksena ButtonX): kun vaihtoehdot ilmestyvät, ensimmäinen on jo valittuna, ja A painaa sitä.
- Testaa puhelimen näyttö Studion Device Simulatorilla (kirjoitushetkellä beta: ota New Device Simulator käyttöön kohdassa File, Beta Features ja käynnistä Studio uudelleen). Valitse puhelin, paina Rotate, kunnes se on vaakasuunnassa, paina Play, kävele Guiden luo ja napauta Talk-kehotetta. Valitse "Any tips?": koko repliikki näkyy vaihtoehtopainikkeiden yläpuolella, tarvittaessa pienemmällä tekstillä, eikä mene niiden päälle.
Pidä koko ajan Output-ikkuna auki (Window-valikko, sitten Output). Kun nämä skriptit toimivat, ne eivät tulosta mitään, joten mikä tahansa punainen virhe tai varoitus, joka alkaa sanalla DialogueService:, on todellinen ongelma. Katso Yleiset virheet.
Miten laajentaa
Lisää NPC:itä ja pidempiä keskusteluja
Lisää NPCs-kansioon uusi rig omalla nimellään ja DialogueDataan samanniminen taulukko, jossa on start-repliikki. DialogueService lisää Talk-kehotteen jokaiselle kansion mallille, jolla on HumanoidRootPart, myös pelin aikana lisätyille; NPC:n kopio saa tuoreen kehotteen sen sijaan, jonka kanssa se kopioitiin. Kaksi samannimistä NPC:tä käyttää samaa taulukkoa. Repliikit voivat linkittyä missä järjestyksessä tahansa, ja vaihtoehto voi johtaa takaisin aiempaan repliikkiin, kuten "Anything else?". Pidä repliikissä enintään neljä vaihtoehtoa, koska ikkuna asettelee ne kaksi kertaa kaksi.
Edistymisestä riippuvat repliikit
Tervehtiäksesi palaavia pelaajia eri tavalla valitse ensimmäinen repliikki sen perusteella, mitä palvelin omistaa. Valitse se startConversation-funktiossa lausekkeella local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", tarkista, että repliikki on olemassa, samoin kuin skripti tarkistaa lines.start-arvon, ja käytä firstLine-arvoa "start"-arvon sijaan keskustelua luodessa. Aseta attribuutti toiminnossa ja lisää welcomeBack-repliikki Guiden taulukkoon. Attribuutit elävät yhden istunnon; muistaaksesi pelaajan käyntien välillä tallenna lippu tietovarastoon, kuten DataStore-tutoriaalissa.
Kauppias-NPC
Rakenna kauppa kaupan GUI-oppaan mukaan, lisää sitten toiminto OpenShop, joka lähettää RemoteEventin tälle pelaajalle ja palauttaa true, ja anna kaupan LocalScriptin avata ikkunansa, kun tämä tapahtuma saapuu. Ostot kulkevat yhä kaupan omien palvelintarkistusten kautta. Jos ostaa saa vain NPC:n lähellä, tarkista etäisyys myös oston käsittelijässä, koska asiakas voi kutsua kaupan remotea mistä tahansa.
Kävelevät NPC:t
Jos haluat Guiden vaeltavan tai seuraavan pelaajia, ota käyttöön NPC:n reitinhakuopas ja poista Anchored HumanoidRootPartista, jotta se voi liikkua. Talk-kehote on tässä partissa, joten se liikkuu NPC:n mukana, ja etäisyystarkistukset käyttävät samaa parttia. Keskeytä käveleminen, kun keskustelu on auki, muuten ikkuna sulkeutuu heti, kun NPC siirtyy yli 16 studin päähän pelaajasta.
Avaimet, tehtävät ja muut palkinnot
GiveItem antaa minkä tahansa Toolin DialogueItems-kansiosta, joten NPC voi antaa avaimen, jonka lukittu ovi tarkistaa, kuten ovien oppaassa. Esineistä, jotka tekevät jotain käytettäessä, esimerkiksi parantavasta ruoasta, lue inventaario-oppaasta.
Äänet ja kamera
Ääniklippiä tai lyhyttä ääntä varten jokaiseen repliikkiin laita Sound NPC:n Headiin ja soita se DialogueClientin show-funktiosta. Kohdistaaksesi kameran NPC:hen sen puhuessa välikohtausopas näyttää, miten LocalScript ottaa kameran hallintaansa ja palauttaa sen.
Yleiset virheet ja ratkaisut
Avaa Output-ikkuna (Window-valikko, sitten Output) ennen kuin painat Play. Useimmat dialogiongelmat tulostavat sinne varoituksen tai johtuvat nimestä, joka ei täsmää.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'
DialogueClient odottaa remotea, jonka DialogueService luo, eli DialogueService ei päässyt tähän kohtaan asti. Tarkista, että se on Script eikä LocalScript, että se on suoraan ServerScriptServicessä eikä se ole pois käytöstä. DialogueService odottaa ensin DialogueData-moduulia ReplicatedStoragessa ja NPCs-kansiota Workspacessa, joten niiden puuttuminen tai kirjoitusvirhe nimessä pysäyttää sen myös; silloin Output näyttää DialogueServicen infinite yield -varoituksen kyseisellä nimellä.
NPC:ni yläpuolelle ei ilmesty Talk-kehotetta
DialogueService lisää kehotteita vain malleille, jotka ovat suoraan kohteessa Workspace, NPCs ja joilla on partti nimeltä HumanoidRootPart. Tarkista molemmat ehdot ja mene alle 12 studin päähän. Toolboxin rigiltä tämä partti voi puuttua, tai se voi olla kansioon kääritty erityyppinen olio.
Kehote ilmestyy, mutta E:n painaminen ei tee mitään
Palvelin ei löytänyt keskustelua tälle NPC:lle, ja pelin käynnistyessä Output näyttää DialogueService: no conversation with a start line for Guide in DialogueData NPC:si nimellä. DialogueDatan taulukon nimen pitää olla täsmälleen sama kuin mallin, isot kirjaimet mukaan lukien, ja siinä pitää olla start-repliikki.
Vaihtoehto sulkee ikkunan sen sijaan, että siirtyisi seuraavaan repliikkiin
Output näyttää DialogueService: no line named tip for Guide in DialogueData sinun nimilläsi: vaihtoehdon next (tai failNext) nimeää repliikin, jota ei ole tämän NPC:n taulukossa. Repliikkien nimet ovat kirjainkokoherkkiä, joten vertaa kirjoitusasua taulukkoon, tässä tips.
Ikkuna toimii, mutta puhekuplaa ei ole
Kupla tarvitsee partin nimeltä Head suoraan NPC-mallin sisällä ja bubble chatin päälle: valitse Explorerissa BubbleChatConfiguration TextChatServicen alta ja tarkista, että Enabled on rastitettu. Oletuksena se on päällä.
Outputissa lukee DialogueService: no Tool named Torch in ServerStorage.DialogueItems
Palvelin ei löytänyt esinettä. Tarkista, että ServerStoragen kansion nimi on DialogueItems ja että siinä on Tool (ei Model eikä Part), jonka nimi on täsmälleen sama kuin vaihtoehdon item. Ennen kuin korjaat tämän, Guide vastaa hasTorch-repliikillä, koska toiminto epäonnistui.
Outputissa lukee DialogueService: no action named ...
Vaihtoehdon action ei vastaa mitään ACTIONS-taulukon avainta. Nimet ovat kirjainkokoherkkiä: heal ei ole Heal.
Tee RoCodella
Jos sinun on helpompi kuvata NPC kuin rakentaa se käsin, RoCode voi kirjoittaa nämä skriptit suoraan paikkaan, joka on auki Studiossasi. Se on itsenäinen tekoälyagentti Roblox Studioon, ei Robloxin tekemä: kirjoitat verkkochatissa, ja sen Studio-lisäosa luo ja muokkaa skriptejä Explorerissasi.
Tee Workspace.NPCs-kansion Guide-mallista puhuva: Talk-kehote, dialogi-ikkuna kirjoittuvilla repliikeillä ja vaihtoehtopainikkeilla, puhekupla pään yläpuolella, parannusvaihtoehto 30 sekunnin cooldownilla ja vaihtoehto, joka antaa kerran Torch-työkalun ServerStoragesta. Säilytä keskustelu ModuleScriptissä ja anna kaikki palkinnot palvelimella.
- Voi ensin tutkia mallin Get Properties -työkalulla lukeakseen keskeiset arvot, kuten sen parttien Anchored ja sen Humanoidin WalkSpeed. Kirjoita chattiin / liittääksesi mallin tarkan polun
- Kirjoittaa ModuleScriptin DialogueData, Scriptin DialogueService ja LocalScriptin DialogueClient Create Script -työkalulla
- Sitä on ohjeistettu tarkistamaan jokaisen kirjoittamansa skriptin käännös Check Script -työkalulla, joka kääntää sen Studiossa ajamatta sitä
- Lähettää muutokset erissä, ja jokainen erä on kumouspiste Studion historiassa
Lisäosan versiolla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosan versiolla 3.9.11 tai uudemmalla se voi ohjata testihahmoa tarkistaakseen, että peli toimii, mutta pelin aikana se ei ota kuvakaappauksia, joten kävele NPC:n luo ja puhu sille itse. Jos jokin ei toimi oikein, kerro RoCodelle, mitä näit: Check Output voi lukea viimeisimmän pelitestisi Server- ja Client-rivit. Puhuva NPC on yksi järjestelmä monien joukossa; sivu miten tehdä Roblox-peli tekoälyllä, yksi järjestelmä kehotetta kohden näyttää, miten ne sopivat yhteen. Miten RoCode yhdistyy Studioon.
Usein kysytyt kysymykset
Miten tehdä puhuva NPC Roblox Studiossa?
Lisää NPC:lle ProximityPrompt, ja kun pelaaja laukaisee sen, näytä NPC:n repliikki dialogi-ikkunassa, puhekuplassa tai molemmissa. Tämän oppaan kolme skriptiä tekevät kumpaakin ja lisäävät vastausvaihtoehdot. Jos tarvitset vain kuplan, kutsu TextChatService:DisplayBubble(npc.Head, "Hello!") LocalScriptistä kehotteen lauetessa, kuten Robloxin bubble chat -sivun NPC-esimerkissä.
Kumpi valita: Dialog-olio vai oma dialogi-GUI?
Dialog-olio ei tarvitse koodia, ja se näyttää klikattavan kuplan, mikä riittää koristeelliseen tekstiin. Sen valintatapahtuma laukeaa vain pelaajan laitteella, joten se ei voi antaa palkintoja turvallisesti, ja oletuksena sen kanssa voi puhua vain yksi pelaaja kerrallaan. Oma ikkuna, kuten tässä oppaassa, antaa palvelimen jakaa jokaisen palkinnon ja antaa jokaiselle pelaajalle oman keskustelun.
Miten pelaajalle annetaan esine NPC:ltä?
Säilytä Tool ServerStoragessa ja anna palvelimen Scriptin kloonata se pelaajan Backpackiin, kun hän valitsee tämän vaihtoehdon, kuten GiveItem-toiminto tekee. Tarkista, ettei pelaajalla jo ole sellaista, ja kytke kopiolta CanBeDropped pois, jotta sitä ei voi pudottaa ja pyytää uudelleen. Älä koskaan anna pelaajan laitteen kertoa, mikä esine annetaan.
Miten tehdä dialogi-ikkuna kirjoituskone-efektillä?
Laita koko repliikki TextLabeliin, kasvata sen MaxVisibleGraphemes-arvoa 0:sta muutama merkki kerrallaan ja aseta lopuksi -1 näyttääksesi kaiken. Robloxin UI-animaatiosivu käyttää samaa ominaisuutta yhdessä utf8.graphemes-funktion kanssa. DialogueClient laskee näytettävien merkkien määrän kuluneesta ajasta, 45 sekunnissa, joten nopeus ei riipu ruudunpäivitysnopeudesta.
Voivatko kaksi pelaajaa puhua saman NPC:n kanssa samanaikaisesti?
Tämän oppaan skripteillä kyllä: palvelin ylläpitää yhtä keskustelua pelaajaa kohden, ja kukin pelaaja näkee vain oman ikkunansa. Sisäänrakennettu Dialog-olio toimii toisin: sen oletusarvoisella BehaviorType-arvolla, SinglePlayer, puhuu yksi pelaaja kerrallaan, ja muut näkevät hänen vaihtoehtonsa.
Pitääkö NPC-dialogin teksti suodattaa?
Itse kirjoittamiasi repliikkejä ei tarvitse. Roblox asettaa sinut vastuuseen sellaisen näytettävän tekstin suodattamisesta, jota et hallitse suoraan, esimerkiksi pelaajien kirjoittaman tekstin, satunnaisista merkeistä kootut sanat tai ulkoiselta sivustolta ladatun tekstin. Jos NPC toistaa jotain pelaajan kirjoittamaa, suodata se osa.
Lähteet ja lisälukemista
- Roblox Creator Docs: Proximity prompts (englanniksi). kehotteiden luonti, MaxActivationDistance ja RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (englanniksi). missä kehote toimii, sen teksti ja oletusnäppäimet, Triggered ja näköyhteyden tarkistus
- Roblox Creator Docs: Securing the client-server boundary (englanniksi). ProximityPrompt hyökkäyspintana, etäisyys- ja oikeustarkistukset
- Roblox Engine API: Dialog (englanniksi). BehaviorType ja vain asiakkaalla laukeava DialogChoiceSelected-tapahtuma
- Roblox Engine API: TextChatService:DisplayBubble (englanniksi). NPC:iden puhekuplat asiakasskripteistä
- Roblox Creator Docs: Customize bubble chat (englanniksi). NPC:iden puhekuplat ja BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (englanniksi). mikä näytettävä teksti pitää suodattaa
- Roblox Creator Docs: UI animation and tweens (englanniksi). kirjoituskone-efekti MaxVisibleGraphemesillä
- Roblox Engine API: Tool.CanBeDropped (englanniksi). mitä Backspace tekee työkalulle
- Roblox Engine API: UserInputService.PreferredInput (englanniksi). miten peliohjainta käyttävä pelaaja tunnistetaan
- Roblox Creator Docs: Rig Generator (englanniksi). R15- tai R6-rigin lisääminen
Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.