Tutoriaali · Pelijärjestelmät

Miten tehdä NPC-dialogi Roblox Studiossa

NPC-dialogi Robloxissa koostuu kolmesta osasta: kehotteesta keskustelun aloittamiseen, ikkunasta, joka näyttää NPC:n sanat ja pelaajan vastauspainikkeet, ja skriptistä, joka päättää, mihin kukin vastaus johtaa. Tässä oppaassa kokoamme kaikki kolme: kirjoitat keskustelun yksinkertaisena taulukkona, pelaajat painavat E:tä puhuakseen, ja kaiken, mitä vastaus antaa (parannuksen, esineen), antaa palvelin eikä pelaajan laite.

Päivitetty 20. marraskuuta 202617 min lukuaikaKirjoittaja:

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ä. Vanha Chat-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
  1. Miten se toimii
  2. 1. NPC:n lisääminen
  3. 2. Keskustelu
  4. 3. Palvelimen skripti
  5. 4. Dialogi-ikkuna
  6. Omat toiminnot
  7. Muut tutoriaalit
  8. Suojauksen rajat
  9. 5. Testaus
  10. Laajennukset
  11. Common errors
  12. RoCodella
  13. Usein kysytyt kysymykset
  14. Lähteet ja lisälukemista

Miten NPC-dialogi toimii

HavainnollistusJokainen repliikki kirjoittuu ikkunaan, kun se näkyy kokonaisena puhekuplassa, vaihtoehdot ilmestyvät, kun repliikki on kirjoitettu, ja palvelin antaa Torchin, kun valitset "Got anything for the cave?".

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ä:

  1. Pelaaja kävelee NPC:n luo ja painaa E:tä sen Talk-kehotteessa. Kehotteen Triggered-tapahtuma laukeaa palvelimella tämän pelaajan kanssa.
  2. 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.
  3. LocalScript kirjoittaa repliikin dialogi-ikkunaan, näyttää puhekuplan NPC:n yläpuolella ja lisää sitten painikkeen jokaiselle vaihtoehdolle.
  4. Pelaaja klikkaa, napauttaa tai valitsee vaihtoehdon. Palvelimelle palaa vain sen numero.
  5. 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.
Mistä puhuva NPC koostuu
OsaMissä se onMitä se tekee
Rig GuideWorkspace, kansiossa nimeltä NPCsItse NPC. Sen nimi valitsee keskustelun ja näkyy kehotteessa.
ModuleScript DialogueDataReplicatedStorageKaikki repliikit, jotka NPC voi sanoa, vaihtoehdot jokaisen repliikin alla ja se, mihin kukin vaihtoehto johtaa.
Script DialogueServiceServerScriptServiceLisää Talk-kehotteen, muistaa, missä repliikissä kukin pelaaja on, tarkistaa jokaisen klikkauksen ja suorittaa toiminnot.
RemoteEvent DialogueEventReplicatedStorage (DialogueService luo sen)Vie jokaisen repliikin pelaajalle ja valitun vaihtoehdon numeron takaisin palvelimelle.
LocalScript DialogueClientStarterPlayer, StarterPlayerScriptsPiirtää ikkunan, kirjoittaa repliikin, näyttää puhekuplan ja vaihtoehtopainikkeet.
Tool Torch (valinnainen)ServerStorage, kansiossa nimeltä DialogueItemsEsine, jonka yksi vaihtoehdoista antaa. ServerStoragesta ei lähetetä mitään pelaajille.
Explorer, kun NPC on valmis. Kun peli on käynnissä, DialogueService lisää ReplicatedStorageen RemoteEventin nimeltä DialogueEvent ja jokaisen NPC:n HumanoidRootPartiin Talk-ProximityPromptin nimeltä TalkPrompt.
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

  1. 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ä.
  2. Nimeä se uudelleen Guide. Nimellä on väliä: DialogueService etsii keskustelun mallin nimen perusteella, ja kehote näyttää sen pelaajille.
  3. 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ä.
  4. 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.
  5. Valinnainen, esinevaihtoehtoa varten: vie osoitin ServerStoragen päälle ja lisää Folder nimeltä DialogueItems. Laita siihen Tool nimeltä Torch ja 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 kohteessa ReplicatedStorage nimeltä DialogueData
-- 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.
  • text on se, mitä NPC sanoo. choices ovat pelaajan painikkeet järjestyksessä. Ikkunassa on tilaa neljälle.
  • next nimeää repliikin, joka näytetään tämän vaihtoehdon jälkeen. Vaihtoehto ilman next-arvoa, kuten "Bye!", lopettaa keskustelun. next tai failNext, joka nimeää taulukosta puuttuvan repliikin, lopettaa sen myös, varoituksen kera Outputissa.
  • action nimeää sen, mitä palvelin tekee, DialogueServicen ACTIONS-taulukosta: tässä Heal tai GiveItem.
  • item on GiveItemiä varten: se on Toolin nimi kohteessa ServerStorage, DialogueItems.
  • failNext on repliikki, joka näytetään next-repliikin sijaan, kun toimintoa ei saatu suoritettua, jotta NPC ei koskaan väitä parantaneensa tai antaneensa jotain, mitä ei tapahtunut.
Guiden keskustelu repliikki repliikiltä
RepliikkiGuide sanooVaihtoehdot 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 kohteessa ServerScriptService nimeltä DialogueService
-- 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.

Asetukset DialogueServicen alussa
AsetusArvo tässäMitä se muuttaa
TALK_DISTANCE12Kuinka 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_CHOICES0.3Lyhin aika kahden klikkauksen välillä, jonka palvelin hyväksyy. Nopeampaan klikkaukseen lähetetään vastauksen sijaan sama repliikki uudelleen.
HEAL_COOLDOWN_SECONDS30Kuinka 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:

Mitä DialogueService tarkistaa jokaisella klikkauksella
TarkistusKoodiJos se ei mene läpi
Pelaaja on keskustelussaconversations[player]Klikkaus ohitetaan.
Vaihtoehto on kokonaislukutypeof ja math.floorOhitetaan. Merkkijonot, taulukot, murtoluvut ja NaN pysähtyvät tähän.
0 tarkoittaa, että pelaaja painoi XchoiceIndex == 0Keskustelu päättyy.
Elossa ja yhä enintään 16 studin päässä (12 plus 4)isCloseKeskustelu päättyy, ja ikkuna sulkeutuu.
Vähintään 0.3 sekuntia viimeisestä hyväksytystä klikkauksestaconversation.lastChoiceSama repliikki lähetetään uudelleen, joten ikkuna saa tuoreet painikkeet eikä odota ikuisesti.
Vaihtoehto on olemassa repliikissä, jota tämä pelaaja lukeeline.choices[choiceIndex]Ohitetaan.
Toiminto onnistuijokainen toiminto palauttaa true tai falsenext-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ä DialogueClient
-- 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 UISizeConstraint rajoittaa 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ä, ja UITextSizeConstraint estää sitä kasvamasta yli 20 pikselin suurella näytöllä. UIGridLayout asettelee vaihtoehdot kaksi kertaa kaksi. ResetOnSpawn on false, koska tämä LocalScript ajetaan kerran istuntoa kohden: uudelleensyntymisessä poistettu ikkuna ei palaisi enää.
  • Kirjoituskone-efekti. Koko repliikki menee TextLabeliin kerralla, ja MaxVisibleGraphemes pää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. Activated laukeaa hiiren klikkauksesta, puhelimen napautuksesta ja peliohjaimen A-painikkeesta. Peliohjaimella voi painaa vain valittua painiketta, joten kun PreferredInput kertoo pelaajan käyttävän peliohjainta, skripti valitsee ensimmäisen vaihtoehdon GuiService.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:

  1. Lisää ACTIONS-taulukkoon merkintä nimeltä StartQuest. Ensin tarkistus, sitten muutos: jos player:GetAttribute("Quest") on jo asetettu, palauta false; muuten kutsu player:SetAttribute("Quest", "Cave") ja palauta true.
  2. Anna DialogueDatassa vaihtoehdolle action = "StartQuest", next-repliikki onnistumisen varalle ja failNext-repliikki epäonnistumisen varalle, esimerkiksi "You are already on a quest."
  3. Paina Play ja valitse vaihtoehto kahdesti. Jos DialogueDatan nimi ei vastaa ACTIONS-taulukon avainta (kirjainkoolla on väliä), Outputiin ilmestyy DialogueService: no action named StartQuest, ja keskustelu siirtyy failNext-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.

Yleisiä keinoja NPC-dialogitutoriaaleissa ja mitä tämä opas tekee niiden sijaan
TutoriaaliOngelmaTämä opas
Käyttää Dialog-oliota, ja palvelimen Script kuuntelee DialogChoiceSelected-tapahtumaa antaakseen palkinnonRobloxin 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:nHuijari 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älkeenRobloxin 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 silmukassaGlobaali 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.

Mitä huijari voi yrittää ja mitä DialogueService sille tekee
Huijari yrittääTulosMiksi
Laukaista Talk-kehotteen kartan toiselta laidaltaMitään ei tapahdustartConversation tarkistaa, että hän on enintään 16 studin päässä (12 plus 4).
Lähettää vaihtoehdon 99, merkkijonon, murtoluvun tai NaN:nOhitetaanSe ei ole kokonaisluku, tai tällaista vaihtoehtoa ei ole repliikissä, jota hän lukee.
Lähettää palkinnon nimen tai repliikin id:nEi koskaan luetaPalvelin lukee vain vaihtoehdon numeron. Palkinnot tulevat repliikin palvelinkopion item- ja action-kentistä.
Klikata niin nopeasti kuin verkko salliiYksi klikkaus 0.3 sekunnin välein keskustelua kohdenNopeampiin 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 keskustelemattaMahdotontaEsineet annetaan vain vaihtoehdosta repliikissä, jossa pelaaja palvelimen tietojen mukaan on.
Kerätä kasa soihtujaYksi kerrallaanPalvelin 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äleinCooldown säilytetään palvelimella jokaiselle pelaajalle, ja NPC kertoo siitä healTooSoon-repliikillä.
Kävellä pois ja jättää ikkuna aukiSulkeutuu puolen sekunnin sisälläPalvelin tarkistaa jokaisen avoimen keskustelun kahdesti sekunnissa.
Lukea koko keskustelu, myös repliikit, joihin hän ei ole päässytMahdollistaDialogueData 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

  1. Paina Play (F5) ja kävele Guiden luo. 12 studin säteellä ilmestyy Talk-kehote Guiden nimellä. Paina E.
  2. Ikkuna näyttää "Guide", kirjoittaa tervehdysrepliikin ja näyttää sitten neljä painiketta. Sama repliikki ilmestyy puhekuplaan NPC:n pään yläpuolelle.
  3. Valitse "Any tips?", sitten "Anything else?": olet taas ensimmäisessä repliikissä. Valitse "Bye!": ikkuna sulkeutuu, ja Talk-kehote palaa.
  4. 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.
  5. 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.
  6. Aloita keskustelu ja kävele pois. Ikkuna sulkeutuu suunnilleen silloin, kun olet 16 studin päässä Guidesta.
  7. Valitse testitilojen pudotusvalikosta Server & Clients, aseta 2 asiakasta ja paina Play. Molemmat pelaajat voivat puhua Guidelle samanaikaisesti, kumpikin omassa repliikissään.
  8. 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ä.
  9. 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.

Sinä kirjoitat

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.

RoCode tekee
  • 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

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.

Kokeile RoCodea omassa pelissäsi.

Ilmaisia krediittejä joka päivä, ei korttia. Asenna lisäosa, kuvaile ominaisuus ja katso, mitä Studioon ilmestyi.