Návod · Herné systémy

Ako urobiť dialóg s NPC v Roblox Studiu

Dialóg s NPC v Robloxe má tri časti: výzvu na začatie rozhovoru, okno, ktoré ukazuje slová NPC a tlačidlá s odpoveďami hráča, a skript, ktorý rozhoduje, kam každá odpoveď vedie. V tomto návode postavíme všetky tri: rozhovor napíšete ako jednoduchú tabuľku, hráči stláčajú E, aby prehovorili, a všetko, čo odpoveď dáva (liečenie, predmet), vydáva server, nie zariadenie hráča.

Aktualizované 20. novembra 202619 min čítaniaAutor:

V skratke

Dajte model NPC do priečinka NPCs vo Workspace a jeho rozhovor zapíšte do ModuleScriptu v ReplicatedStorage: každá replika má text NPC a zoznam možností, ktoré vedú k inej replike. Script v ServerScriptService pridá každému NPC ProximityPrompt ("Talk"), pamätá si, na ktorej replike je každý hráč, a posiela ju cez RemoteEvent. LocalScript ukáže text a jedno tlačidlo na každú možnosť a späť posiela iba číslo stlačeného tlačidla.

  • Odmeny vydávajte na serveri. Udalosť DialogChoiceSelected vstavaného objektu Dialog sa spúšťa iba na klientovi, takže ju serverový Script nikdy nepočuje, a liečenie alebo predmet vydané v LocalScripte zmení iba kópiu hry u tohto hráča.
  • Bublinu s replikou ukazujte cez TextChatService:DisplayBubble(npc.Head, text) z LocalScriptu. Stará služba Chat je zastaraná, namiesto nej sa používa TextChatService.
  • Repliky, ktoré ste napísali sami, filtrovať nemusíte. Pravidlo Robloxu: filtrovať každý zobrazovaný text, ktorý priamo neovládate, napríklad to, čo píšu hráči.
Na tejto stránke
  1. Ako to funguje
  2. 1. Pridávame NPC
  3. 2. Rozhovor
  4. 3. Serverový skript
  5. 4. Dialógové okno
  6. Vlastné akcie
  7. Iné návody
  8. Hranice ochrany
  9. 5. Test
  10. Rozšírenie
  11. Common errors
  12. S RoCode
  13. Časté otázky
  14. Zdroje a ďalšie čítanie

Ako dialóg s NPC funguje

IlustráciaKaždá replika sa píše v okne, kým je celá vidieť v bubline, možnosti sa objavia, keď je replika napísaná, a server vydá Torch, keď vyberiete "Got anything for the cave?".

Hovoriace NPC, ktoré funguje v skutočnej hre, je rozdelené medzi server a zariadenie každého hráča. Zariadenie kreslí okno a tlačidlá. Server, jediná strana, ktorej možno veriť, vie, ktorú repliku každý hráč číta, a rozhoduje, čo každá odpoveď urobí. Jeden ťah rozhovoru vyzerá takto:

  1. Hráč príde k NPC a stlačí E na jeho výzve Talk. Udalosť Triggered výzvy sa spustí na serveri s týmto hráčom.
  2. Serverový skript overí, že je hráč dosť blízko, zapamätá si, že je na replike s názvom start, a pošle text tejto repliky a popisky jej možností iba tomuto hráčovi.
  3. LocalScript napíše repliku v dialógovom okne, ukáže bublinu nad NPC a potom pridá jedno tlačidlo na každú možnosť.
  4. Hráč klikne, ťukne alebo možnosť vyberie. Na server sa vráti iba jej číslo.
  5. Server toto číslo nájde na replike, o ktorej vie, že ju hráč číta, vykoná akciu možnosti, ak nejakú má (liečenie, predmet), a pošle ďalšiu repliku alebo okno zavrie.
Z čoho sa hovoriace NPC skladá
PrvokKde jeČo robí
Rig GuideWorkspace, v priečinku s názvom NPCsSamotné NPC. Jeho názov vyberá rozhovor a zobrazuje sa na výzve.
ModuleScript DialogueDataReplicatedStorageVšetky repliky, ktoré NPC môže povedať, možnosti pod každou replikou a to, kam každá možnosť vedie.
Script DialogueServiceServerScriptServicePridá výzvu Talk, pamätá si, na ktorej replike je každý hráč, overuje každé kliknutie a vykonáva akcie.
RemoteEvent DialogueEventReplicatedStorage (vytvára ho DialogueService)Nesie každú repliku k hráčovi a číslo vybranej možnosti späť na server.
LocalScript DialogueClientStarterPlayer, StarterPlayerScriptsKreslí okno, píše repliku, ukazuje bublinu a tlačidlá možností.
Tool Torch (voliteľné)ServerStorage, v priečinku s názvom DialogueItemsPredmet, ktorý dáva jedna z možností. Nič zo ServerStorage sa hráčom neposiela.
Explorer, keď je NPC hotové. Keď hra beží, DialogueService pridá RemoteEvent s názvom DialogueEvent do ReplicatedStorage a ProximityPrompt Talk s názvom TalkPrompt do HumanoidRootPart každého NPC.
Workspace
  NPCs Folder new
    Guide Model new
      Humanoid Humanoid
      HumanoidRootPart Part
      Head, UpperTorso, LowerTorso ... (časti tela)
ReplicatedStorage
  DialogueData ModuleScript new
ServerScriptService
  DialogueService Script new
ServerStorage
  DialogueItems Folder new
    Torch Tool new
      Handle Part new
StarterPlayer
  StarterPlayerScripts
    DialogueClient LocalScript new

Krok 1: pridajte NPC

  1. Na karte Avatar alebo Home kliknite na Character a otvorí sa Rig Generator. Vyberte R15, tvar tela a štýl. Vo Workspace sa objaví rig s názvom Rig. Rig R6 funguje s tými istými skriptmi.
  2. Premenujte ho na Guide. Na názve záleží: DialogueService hľadá rozhovor podľa názvu modelu a výzva ho ukazuje hráčom.
  3. Rozbaľte rig, vyberte jeho HumanoidRootPart a v okne Properties zaškrtnite Anchored. Ukotvený part sa fyzikou nikdy nepohne, takže NPC stojí tam, kam ste ho postavili, a hráči doňho nemôžu strkať.
  4. Prejdite myšou na Workspace v Exploreri, kliknite na tlačidlo + a vložte Folder s názvom NPCs. Presuňte doňho Guide a rig postavte tam, kam hráči môžu dôjsť.
  5. Voliteľne, pre možnosť s predmetom: prejdite myšou na ServerStorage a vložte Folder s názvom DialogueItems. Dajte doňho Tool s názvom Torch a jedným neukotveným Part s názvom Handle, to je part, ktorý postava drží v ruke. PointLight vnútri Handle ho rozsvieti.

Názvy rozlišujú veľkosť písmen, preto zadajte NPCs, Guide, DialogueItems a Torch presne tak, ako sú uvedené. NPC môže byť akýkoľvek model s Humanoid a HumanoidRootPart, vrátane modelu z Toolboxu, ak leží priamo v priečinku NPCs.

Krok 2: napíšte rozhovor

Prejdite myšou na ReplicatedStorage, vložte ModuleScript s názvom DialogueData a vložte doňho tento kód. Nie je v ňom žiadna logika, iba slová a väzby medzi nimi, takže tento súbor budete upravovať najčastejšie.

ModuleScript v ReplicatedStorage s názvom DialogueData
-- ModuleScript v ReplicatedStorage s názvom DialogueData.
-- Všetky rozhovory, podľa názvu NPC vo Workspace.NPCs. Každá replika má
-- text NPC a možnosti odpovede hráča. Možnosť môže viesť k inej replike (next),
-- ukončiť rozhovor (bez next) a požiadať server, aby niečo urobil (action). Ak server
-- akciu nemôže vykonať, ukáže repliku failNext namiesto next.

export type Choice = {
	text: string,
	next: string?, -- replika, ktorá sa ukáže po tejto možnosti; nil rozhovor ukončí
	action: string?, -- serverová akcia z tabuľky ACTIONS v DialogueService
	item: string?, -- pre akciu GiveItem: názov Toolu v ServerStorage.DialogueItems
	failNext: string?, -- replika, ktorá sa ukáže namiesto next, keď sa akciu nepodarilo vykonať
}

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

Riadky export type na začiatku opisujú, ako vyzerá replika a možnosť. Počas hry nič nemenia; opisujú vaše dáta, aby ich mohla overiť kontrola typov.

Ako sú časti prepojené:

  • Každé NPC má tabuľku pomenovanú podľa jeho modelu v priečinku NPCs, tu Guide. Každý rozhovor začína replikou start.
  • text je to, čo NPC hovorí. choices sú tlačidlá hráča, po poradí. V okne je miesto pre štyri.
  • next pomenuje repliku, ktorá sa ukáže po tejto možnosti. Možnosť bez next, napríklad "Bye!", rozhovor ukončí. next alebo failNext, ktorý pomenuje repliku, ktorá v tabuľke nie je, ho tiež ukončí, s varovaním v Output.
  • action pomenuje to, čo urobí server, z tabuľky ACTIONS v DialogueService: tu je to Heal alebo GiveItem.
  • item je pre GiveItem: je to názov Toolu v ServerStorage, DialogueItems.
  • failNext je replika, ktorá sa ukáže namiesto next, keď sa akciu nepodarilo vykonať, aby NPC nikdy netvrdilo, že liečilo alebo dalo darček, keď sa to nestalo.
Rozhovor Guide, replika po replike
ReplikaGuide hovoríMožnosti a kam vedú
start"Welcome to the village! What can I do for you?""Any tips?" vedie k tips. "I'm hurt. Can you help?" vylieči, potom healed (alebo healTooSoon). "Got anything for the cave?" vydá Torch, potom torch (alebo hasTorch). "Bye!" rozhovor ukončí.
tips"Stay off the red bricks, and come back if you get hurt.""Anything else?" vráti na start. "Thanks!" rozhovor ukončí.
healed"There you go, good as new.""Thank you!" rozhovor ukončí.
torch"Take this torch. The cave is dark.""Thanks!" rozhovor ukončí.
healTooSoon"I healed you a moment ago. Come back in a little while.""OK" rozhovor ukončí.
hasTorch"You already have my torch. Keep it lit!""Will do!" rozhovor ukončí.

Tento modul číta iba server. LocalScript naňho nikdy nevolá require: server posiela každú repliku, keď sa k nej hráč dostane. Modul v ReplicatedStorage sa však aj tak kopíruje na zariadenie každého hráča, takže ak sú v rozhovore spoilery (napríklad odpoveď na hádanku), presuňte DialogueData do ServerStorage. Potom v riadku s require v DialogueService nahraďte ReplicatedStorage za ServerStorage, aby celý riadok vyzeral takto: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.

Krok 3: pridajte serverový skript

Prejdite myšou na ServerScriptService, vložte Script s názvom DialogueService a vložte doňho kód nižšie. Je to jediné miesto, kde rozhovor postupuje ďalej, a jediné miesto, kde sa vydáva odmena.

Script v ServerScriptService s názvom DialogueService
-- Script v ServerScriptService s názvom DialogueService.
-- Pridá výzvu Talk každému NPC vo Workspace.NPCs a vedie každý rozhovor.
-- Zariadenie hráča iba ukazuje text a posiela späť číslo možnosti,
-- na ktorú kliklo. Server vie, na ktorej replike je každý hráč, overí možnosť
-- aj vzdialenosť a iba on lieči alebo dáva predmety.

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

-- Rovnaké tvary ako v DialogueData, aby ich kontrola typov v Studiu poznala aj tu
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 -- study: dosah výzvy a ako blízko musí hráč zostať
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30

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

-- Tento skript si DialogueEvent vytvorí sám, preto ho nepridávajte ručne
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 -- nemá postavu, je mŕtvy alebo NPC zmizlo
	end
	-- malá rezerva, pretože pozícia hráča sa na server dostane s malým oneskorením
	return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end

-- Čo server urobí, keď má možnosť akciu. Každá vráti true, ak sa vykonala.
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 -- liečili sme príliš nedávno
		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 -- batoh ešte nie je, alebo predmet už má
		end
		local item = template:Clone() :: Tool
		item.CanBeDropped = false -- aby ho nikto nemohol zahodiť a požiadať o ďalší
		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 -- už hovorí, toto NPC nemá repliku "start", je mŕtvy alebo príliš ďaleko
	end
	local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
	conversations[player] = conversation
	showLine(player, conversation)
end

-- Hráč klikol na možnosť s číslom choiceIndex (0 znamená, že zavrel okno)
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
		-- Príliš rýchlo. Pošleme tú istú repliku znova, pretože okno už po kliknutí
		-- tlačidlá zablokovalo a inak by na odpoveď čakalo večne.
		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 -- na replike, ktorú tento hráč číta, taká možnosť nie je
	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 -- napríklad "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)

-- Výzva Talk na každom NPC
local function setUpNpc(npc: Instance)
	local root = if npc:IsA("Model") then rootOf(npc) else nil
	if not (npc:IsA("Model") and root) then
		return
	end
	if not (DialogueData[npc.Name] and DialogueData[npc.Name].start) then
		warn(`DialogueService: no conversation with a start line for {npc.Name} in DialogueData`)
	end
	local leftover = root:FindFirstChild("TalkPrompt")
	if leftover then
		leftover:Destroy() -- kópia NPC prinesie starú výzvu, ktorú nikto nepočúva
	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)

-- Zavrieme okno všetkým, ktorí uprostred rozhovoru odišli alebo zomreli
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 si RemoteEvent DialogueEvent vytvorí sám pri spustení hry, takže do ReplicatedStorage nič vkladať ručne nemusíte. Ak ste už RemoteEvent s týmto názvom vytvorili, zmažte ho: LocalScript by mohol nájsť ten váš, a ten na serveri nikto nepočúva.

Nastavenia na začiatku DialogueService
NastavenieHodnota tuČo mení
TALK_DISTANCE12Ako blízko, v studoch, musí hráč byť, aby sa objavila výzva Talk. Server mu dovolí odísť ešte o 4 study, kým okno zavrie, pretože pozícia hráča sa na server dostane s malým oneskorením.
MIN_SECONDS_BETWEEN_CHOICES0.3Najkratší čas medzi dvoma kliknutiami, ktorý server prijme. Na rýchlejšie kliknutie sa namiesto odpovede znova pošle tá istá replika.
HEAL_COOLDOWN_SECONDS30Ako dlho každý hráč čaká medzi liečeniami od akcie Heal.

Server uchováva v conversations jeden záznam na hráča: s ktorým NPC hovorí, ktorú repliku číta a kedy bolo prijaté jeho posledné kliknutie. Keď sa spustí výzva Talk, startConversation tento záznam vytvorí, iba ak hráč ešte nehovorí, NPC má repliku start a hráč je živý a v dosahu. Potom každé kliknutie prejde týmito kontrolami:

Čo DialogueService kontroluje pri každom kliknutí
KontrolaKódAk neprejde
Hráč je v rozhovoreconversations[player]Kliknutie sa ignoruje.
Možnosť je celé číslotypeof a math.floorIgnoruje sa. Reťazce, tabuľky, desatinné čísla a NaN sa zastavia tu.
0 znamená, že hráč klikol na XchoiceIndex == 0Rozhovor skončí.
Živý a stále najviac 16 studov ďaleko (12 plus 4)isCloseRozhovor skončí a okno sa zavrie.
Aspoň 0.3 sekundy od posledného prijatého kliknutiaconversation.lastChoiceTá istá replika sa pošle znova, takže okno dostane čerstvé tlačidlá a nečaká večne.
Možnosť existuje na replike, ktorú tento hráč čítaline.choices[choiceIndex]Ignoruje sa.
Akcia zafungovalakaždá akcia vracia true alebo falseNamiesto next sa ukáže replika failNext.

Výzva visí na HumanoidRootPart NPC, pretože ProximityPrompt funguje, keď leží vnútri partu (alebo Attachmentu, alebo modelu s PrimaryPart) vo Workspace. Jeho RequiresLineOfSight je v predvolenom stave zapnuté a skryje výzvu zakaždým, keď niečo zakryje pohľad od kamery k tomuto partu. Vlastný part výzvy Roblox z tejto kontroly vynechá, ale zvyšok tela nie, a HumanoidRootPart je vnútri trupu, preto skript kontrolu priamej viditeľnosti vypína. Výzva sa volá TalkPrompt a skript zmaže každý TalkPrompt, ktorý už na parte je, kým pridá svoj: kópia NPC vytvorená počas hry príde s výzvou originálu a tú skopírovanú nikto nepočúva. Ak v DialogueData nie je rozhovor s replikou start pre názov NPC, objaví sa v Output varovanie s názvom tohto NPC.

Slučka dvakrát za sekundu skontroluje každý otvorený rozhovor a zavrie ho, keď hráč odišiel ďalej ako 16 studov alebo jeho postava zomrela, aby sa hráč, ktorý zomrel uprostred rozhovoru, neoživil s otvoreným oknom. PlayerRemoving vyčistí obe tabuľky, keď niekto odíde.

Krok 4: pridajte dialógové okno

Otvorte StarterPlayer, prejdite myšou na StarterPlayerScripts, vložte LocalScript s názvom DialogueClient a vložte doňho tento kód. Dialógové okno postaví v kóde, takže GUI nemusíte kresliť ručne.

LocalScript v StarterPlayer > StarterPlayerScripts s názvom DialogueClient
-- LocalScript v StarterPlayer > StarterPlayerScripts s názvom DialogueClient.
-- Kreslí rozhovor, ktorý pošle server: meno NPC, jeho repliku písanú písmeno
-- po písmene, bublinu nad hlavou a jedno tlačidlo na každú možnosť. Kliknutie na
-- možnosť pošle iba jej číslo; čo bude ďalej, rozhoduje server.

local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TextChatService = game:GetService("TextChatService")
local UserInputService = game:GetService("UserInputService")

local dialogueEvent = ReplicatedStorage:WaitForChild("DialogueEvent") :: RemoteEvent
local player = Players.LocalPlayer

local LETTERS_PER_SECOND = 45
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)

-- Dialógové okno postavené v kóde
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) -- o 84 pixelov vyššie, aby panel nástrojov Robloxu nezakrýval možnosti
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 -- dlhá replika sa zmenší, aby sa zmestila na malú obrazovku telefónu
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- a nikdy nebude väčšia ako 20 pixelov na veľkej
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 -- rastie s každou novou replikou, aby sa stará slučka písania zastavila

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 -- mení sa iba na tomto zariadení
	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()

	-- Bublina nad NPC (DisplayBubble funguje iba v LocalScripte)
	local head = npc:FindFirstChild("Head")
	if head then
		TextChatService:DisplayBubble(head, text)
	end

	-- Píšeme repliku písmeno po písmene. Počet sa počíta z uplynulého času,
	-- takže rýchlosť je rovnaká pri akejkoľvek snímkovej frekvencii.
	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úto repliku nahradila novšia alebo zatvorenie
		end
		shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
		lineLabel.MaxVisibleGraphemes = shown
	end
	lineLabel.MaxVisibleGraphemes = -1

	-- Jedno tlačidlo na možnosť; server dostane iba číslo tlačidla
	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 -- jedno kliknutie na repliku
				dialogueEvent:FireServer(index)
			end
		end)
		if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
			GuiService.SelectedObject = button -- aby sa možnosť dala vybrať gamepadom
		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)

Farby, veľkosti a LETTERS_PER_SECOND môžete meniť, ako chcete. Posledné dva handlery nechajte, ako sú: je to jediný spôsob, ako okno komunikuje so serverom.

Čo robí každá časť DialogueClient:

  • Okno. ScreenGui s Frame ukotveným dole v strede obrazovky, 60 % jej šírky a 34 % výšky, s obmedzením 720 na 300 pixelov cez UISizeConstraint, aby sa neroztiahlo cez celý široký monitor. Replika NPC používa TextScaled, ktorý text zmenší, aby sa zmestil do svojho labelu na malej obrazovke telefónu, a UITextSizeConstraint mu nedovolí narásť nad 20 pixelov na veľkej. UIGridLayout rozloží možnosti dve na dve. ResetOnSpawn je false, pretože tento LocalScript sa spustí raz za reláciu: okno zmazané pri respawne by sa už nevrátilo.
  • Efekt písacieho stroja. Celá replika sa do TextLabelu dostane naraz a MaxVisibleGraphemes rozhoduje, koľko znakov je vidieť; je to tá istá vlastnosť, ktorú používa vlastný príklad písacieho stroja od Robloxu spolu s utf8.graphemes. Roblox rozvrhne text, ako keby boli vidieť všetky znaky, takže slová nepreskakujú na nový riadok ani nemenia veľkosť, ako sa objavujú. Skript spočíta, koľko znakov ukázať, z uplynulého času, 45 za sekundu, takže rýchlosť je rovnaká pri akejkoľvek snímkovej frekvencii, a potom vlastnosť nastaví na -1, čo ukáže všetko.
  • Tlačidlá. Objavia sa, keď je replika napísaná. Každé pošle iba svoje číslo a iba raz: kontrola lineNumber zabráni, aby dvojklik poslal dvakrát, a okno potom čaká na ďalšiu repliku od servera.
  • Bublina s replikou. TextChatService:DisplayBubble(head, text) dá repliku do bubliny chatu nad Head NPC. Roblox to dovoľuje iba v klientskych skriptoch a bubble chat je v predvolenom stave zapnutý. Bublinu kreslí zariadenie tohto hráča, takže ju vidí iba on.
  • Výzva. Kým hráč hovorí, jeho kópia výzvy Talk (nájde sa podľa názvu TalkPrompt) je vypnutá, aby nevisela nad rozhovorom. Ostatní hráči tú svoju ďalej vidia.
  • Akékoľvek zariadenie. Activated sa spustí kliknutím myši, ťuknutím na telefóne a tlačidlom A na gamepade. Gamepad vie stlačiť iba vybrané tlačidlo, takže keď PreferredInput povie, že hráč používa gamepad, skript vyberie prvú možnosť cez GuiService.SelectedObject.
  • Tlačidlo X. Pošle 0, čo server chápe ako „ukončiť rozhovor“, a okno hneď zavrie.

Pridajte vlastné akcie

Akcia je funkcia v tabuľke ACTIONS na začiatku DialogueService. Dostane hráča a možnosť a vráti true, keď svoju prácu urobila. Ak chcete pridať vlastnú, povedzme quest, ktorý NPC zadá:

  1. Pridajte do ACTIONS záznam s názvom StartQuest. Najprv kontrola, potom zmena: ak je player:GetAttribute("Quest") už nastavený, vráťte false; inak zavolajte player:SetAttribute("Quest", "Cave") a vráťte true.
  2. V DialogueData nastavte možnosti action = "StartQuest", repliku next pre úspech a repliku failNext pre neúspech, napríklad "You are already on a quest."
  3. Kliknite na Play a vyberte možnosť dvakrát. Ak sa názov v DialogueData nezhoduje s kľúčom v ACTIONS (veľkosť písmen je dôležitá), objaví sa v Output DialogueService: no action named StartQuest a rozhovor prejde na repliku failNext.

Pravidlá na písanie akcií:

  • Kontrolu aj zmenu robte vnútri akcie, na serveri. Jediné, čo zariadenie hráča posiela, je číslo možnosti.
  • Čo akcia potrebuje, čítajte z možnosti (ako item) alebo z vlastného stavu servera, ale nikdy z remotu.
  • Všetko cenné obmedzujte priamo v akcii, rovnako ako Heal drží vlastný cooldown 30 sekúnd v lastHeal. Limit 0.3 sekundy na kliknutie iba spomaľuje kliknutia; nebráni hráčovi prechádzať tou istou možnosťou znova a znova.
  • Ak chcete otvoriť iné okno, napríklad obchod, môže akcia poslať tomuto hráčovi RemoteEvent a vrátiť true. Všetko, čo sa v tom okne deje, aj tak potrebuje vlastné kontroly na serveri, ako v časti NPC predavač.

V čom sa iné návody na dialógy s NPC mýlia

Ak tento návod porovnávate s videom alebo príspevkom na fóre, tu sú dôležité rozdiely a dôvod, prečo každý postup spôsobuje problém.

Časté postupy v návodoch na dialógy s NPC a čo tento návod robí namiesto nich
NávodProblémTento návod
Používa objekt Dialog a serverový Script počúva DialogChoiceSelected, aby vydal odmenuReferenčná príručka Robloxu uvádza, že táto udalosť funguje iba na strane klienta a na serveri sa nespustí, takže odmena nikdy nepríde.Možnosť sa na server dostane ako číslo a server odmenu vydá sám.
Vydáva odmenu z LocalScriptuZmena urobená LocalScriptom zostane na tomto jednom zariadení (pozrite čo sa replikuje) a podvodník môže ten istý kód spustiť kedykoľvek.Všetky akcie žijú v DialogueService.
Necháva NPC hovoriť cez game:GetService("Chat"):Chat(head, text)Služba Chat je zastaraná, namiesto nej sa používa TextChatService.TextChatService:DisplayBubble v LocalScripte.
Posiela z klienta názov odmeny alebo id ďalšej replikyPodvodník môže poslať akýkoľvek názov predmetu alebo skočiť rovno na repliku, ktorá dáva odmenu.Klient posiela iba číslo možnosti. Server ho nájde na replike, o ktorej vie, že ju hráč číta.
Po spustení výzvy nič nekontrolujeNávod Robloxu o bezpečnosti radí ProximityPrompt vedľa remotov ako niečo, čo klienti môžu zneužiť, a radí pred akciou overiť, či je hráč dosť blízko.Vzdialenosť sa kontroluje na začiatku rozhovoru, pri každom kliknutí a dvakrát za sekundu, kým je otvorený.
Píše text cez wait() v slučkeGlobálny wait je zastaraný, namiesto neho sa používa task.wait.Počet viditeľných písmen počíta z os.clock() a čaká cez task.wait().

Čo hráč môže a nemôže podvrhnúť

Počítajte s tým, že podvodník ovláda všetko na svojom zariadení. Môže čítať vaše LocalScripty a všetko v ReplicatedStorage, volať DialogueEvent s akýmikoľvek argumentmi koľkokrát chce a spúšťať výzvu Talk z kódu, pred čím varuje návod Robloxu o bezpečnosti. DialogueService odpovedá kontrolami na serveri rovnakého druhu, aké rozoberá časť kontrola argumentov RemoteEvent. Tu je, čo z toho podvodník má.

Čo môže podvodník skúsiť a čo s tým DialogueService urobí
Podvodník skúšaVýsledokPrečo
Spustiť výzvu Talk z druhého konca mapyNič sa nestanestartConversation overí, že nie je ďalej ako 16 studov (12 plus 4).
Poslať možnosť 99, reťazec, desatinné číslo alebo NaNIgnoruje saNie je to celé číslo, alebo taká možnosť na replike, ktorú číta, nie je.
Poslať názov odmeny alebo id replikyNikdy sa nečítaServer číta iba číslo možnosti. Odmeny sa berú z polí item a action serverovej kópie repliky.
Klikať tak rýchlo, ako sieť dovolíJedno kliknutie za 0.3 sekundy na rozhovorNa rýchlejšie kliknutia sa vráti ich vlastná replika. Ukončenie a nové začatie rozhovoru toto čakanie obíde, preto Heal a GiveItem držia vlastné limity.
Požiadať o pochodeň bez rozhovoruNemožnéPredmety sa vydávajú iba podľa možnosti na replike, o ktorej server vie, že na nej hráč je.
Nahromadiť kopu pochodníPo jednejServer najprv hľadá Torch v jeho Backpacku a postave a vydanú pochodeň nemožno zahodiť, takže sa nedá farmiť zahadzovaním a novým žiadaním.
Spamovať repliku s liečenímJedno liečenie za 30 sekúndCooldown sa ukladá na serveri pre každého hráča a NPC to oznámi replikou healTooSoon.
Odísť a nechať okno otvorenéZavrie sa do pol sekundyServer kontroluje každý otvorený rozhovor dvakrát za sekundu.
Prečítať celý rozhovor, vrátane replík, ku ktorým sa nedostalMožnéDialogueData leží v ReplicatedStorage, ktorý sa kopíruje na každé zariadenie. Ak na tom záleží, presuňte ho do ServerStorage (pozrite krok 2).

Jedno obmedzenie stojí za to povedať otvorene: podvodník, ktorý príde ku Guide a vyberá možnosti, dostane presne to isté čo poctivý hráč. Server riadi, ako často a odkiaľ, ale nie kto. Čokoľvek vzácne, napríklad odmena, ktorú každý hráč môže dostať iba raz, potrebuje kontrolu, ktorú vlastní server, napríklad atribút nastavený pri získaní alebo príznak uložený v úložisku dát.

Krok 5: otestujte

  1. Kliknite na Play (F5) a príďte ku Guide. Do 12 studov sa objaví výzva Talk s menom Guide. Stlačte E.
  2. Okno ukáže "Guide", napíše uvítaciu repliku a potom ukáže štyri tlačidlá. Tá istá replika sa objaví v bubline nad hlavou NPC.
  3. Vyberte "Any tips?", potom "Anything else?": ste späť na prvej replike. Vyberte "Bye!": okno sa zavrie a výzva Talk sa vráti.
  4. Najprv si spôsobte poškodenie: kliknite na prepínač Client/Server a prejdite na Server, vyberte Humanoid svojej postavy vo Workspace, nastavte Health v okne Properties na 50 a prepnite späť na Client. Postavy hráčov obnovujú každú sekundu 1 % z MaxHealth, preto hneď prehovorte s Guide a vyberte "I'm hurt. Can you help?": zdravie vyskočí na plné. Prehovorte znova do 30 sekúnd a vyberte to ešte raz: liečenie nebude a Guide povie, že vás pred chvíľou liečil.
  5. Vyberte "Got anything for the cave?": Torch sa objaví v hotbare. Vybavte ho a stlačte Backspace: zostane v ruke. Požiadajte znova: druhá pochodeň nebude a Guide povie, že ju už máte.
  6. Začnite rozhovor a odíďte. Okno sa zavrie zhruba vo chvíli, keď ste 16 studov od Guide.
  7. V rozbaľovacom zozname režimov testu vyberte Server & Clients, nastavte 2 klientov a kliknite na Play. Obaja hráči môžu hovoriť s Guide súčasne, každý na svojej replike.
  8. Otestujte gamepad cez Controller Emulator (Controller na karte Emulation) počas playtestu. Emulovaným gamepadom príďte a stlačte tlačidlo výzvy (v predvolenom stave ButtonX): keď sa objavia možnosti, prvá už je vybraná a A ju stlačí.
  9. Otestujte obrazovku telefónu cez Device Simulator v Studiu (v čase písania je to beta: zapnite New Device Simulator vo File, Beta Features a reštartujte Studio). Vyberte telefón, stláčajte Rotate, kým nebude na šírku, kliknite na Play, príďte ku Guide a ťuknite na výzvu Talk. Vyberte "Any tips?": celá replika je vidieť nad tlačidlami možností, prípadne menším písmom, a neprekrýva ich.

Celý čas majte otvorené okno Output (menu Window, potom Output). Keď tieto skripty fungujú, nič nevypisujú, takže akákoľvek červená chyba alebo varovanie začínajúce na DialogueService: je skutočný problém. Pozrite Časté chyby.

Ako systém rozšíriť

Viac NPC a dlhšie rozhovory

Pridajte do priečinka NPCs ďalší rig s vlastným menom a do DialogueData tabuľku s rovnakým menom a replikou start. DialogueService pridá výzvu Talk každému modelu v priečinku, ktorý má HumanoidRootPart, vrátane tých pridaných počas hry; kópia NPC dostane čerstvú výzvu namiesto tej, s ktorou bola skopírovaná. Dve NPC s rovnakým menom používajú jednu tabuľku. Repliky sa môžu prepájať v akomkoľvek poradí a možnosť môže viesť späť k skoršej replike, ako "Anything else?". Na replike majte najviac štyri možnosti, pretože okno ich rozkladá dve na dve.

Repliky, ktoré závisia od postupu

Ak chcete vracajúcich sa hráčov pozdraviť inak, vyberajte prvú repliku podľa toho, čo vlastní server. V startConversation ju vyberte cez local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", overte, že replika existuje, rovnako ako skript overuje lines.start, a pri vytváraní rozhovoru použite firstLine namiesto "start". Atribút nastavujte v akcii a do tabuľky Guide pridajte repliku welcomeBack. Atribúty žijú jednu reláciu; ak si chcete hráčov pamätať medzi návštevami, ukladajte príznak do úložiska dát ako v návode na DataStore.

NPC predavač

Postavte obchod podľa návodu na GUI obchodu, potom pridajte akciu OpenShop, ktorá tomuto hráčovi pošle RemoteEvent a vráti true, a nech LocalScript obchodu otvorí svoje okno, keď táto udalosť príde. Nákupy ďalej prechádzajú vlastnými kontrolami obchodu na serveri. Ak sa má nakupovať iba pri NPC, kontrolujte vzdialenosť aj vnútri handlera nákupu, pretože klient môže remote obchodu zavolať odkiaľkoľvek.

NPC, ktoré chodia

Ak chcete, aby sa Guide prechádzal alebo sledoval hráčov, vezmite návod na hľadanie cesty pre NPC a odškrtnite Anchored pri HumanoidRootPart, aby sa mohol hýbať. Výzva Talk visí na tomto parte, takže sa pohybuje s NPC, a kontroly vzdialenosti používajú ten istý part. Chôdzu pozastavte, kým je rozhovor otvorený, inak sa okno zavrie, hneď ako NPC odíde od hráča ďalej ako 16 studov.

Kľúče, questy a ďalšie odmeny

GiveItem vydá akýkoľvek Tool z DialogueItems, takže NPC môže dať kľúč, ktorý kontrolujú zamknuté dvere, ako v návode na dvere. O predmetoch, ktoré pri použití niečo robia, napríklad jedlo, ktoré lieči, si prečítajte v návode na inventár.

Zvuky a kamera

Pre hlasový klip alebo krátky zvuk pri každej replike dajte Sound do Head NPC a prehrávajte ho zo show v DialogueClient. Ak chcete zamerať kameru na NPC, kým hovorí, návod na cutscény ukazuje, ako LocalScript prevezme riadenie kamery a vráti ho.

Časté chyby a riešenia

Otvorte okno Output (menu Window, potom Output) pred kliknutím na Play. Väčšina problémov s dialógom tam vypíše varovanie alebo vzniká kvôli názvu, ktorý nesedí.

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

DialogueClient čaká na remote, ktorý vytvára DialogueService, takže sa DialogueService k tomuto miestu nedostal. Overte, že je to Script, nie LocalScript, že leží priamo v ServerScriptService a nie je vypnutý. DialogueService najprv čaká na DialogueData v ReplicatedStorage a priečinok NPCs vo Workspace, takže ich absencia alebo preklep v názve ho tiež zastaví; potom Output ukáže varovanie infinite yield od DialogueService s týmto názvom.

Nad mojím NPC sa neobjaví výzva Talk

DialogueService pridáva výzvy iba modelom, ktoré ležia priamo vo Workspace, NPCs a majú part s názvom HumanoidRootPart. Skontrolujte obe podmienky a príďte bližšie ako na 12 studov. Rig z Toolboxu tento part nemusí mať, alebo to môže byť objekt iného typu zabalený v priečinku.

Výzva sa objaví, ale stlačenie E nič nerobí

Server pre toto NPC nenašiel rozhovor a pri spustení hry Output ukáže DialogueService: no conversation with a start line for Guide in DialogueData s menom vášho NPC. Tabuľka v DialogueData sa musí volať presne ako model, vrátane veľkých písmen, a obsahovať repliku start.

Možnosť zavrie okno, namiesto toho, aby prešla na ďalšiu repliku

Output ukáže DialogueService: no line named tip for Guide in DialogueData s vašimi názvami: next (alebo failNext) možnosti pomenúva repliku, ktorá v tabuľke tohto NPC nie je. Názvy replík rozlišujú veľkosť písmen, takže pravopis porovnajte s tabuľkou, tu je to tips.

Okno funguje, ale bublina s replikou nie je

Bublina potrebuje part s názvom Head priamo vnútri modelu NPC a zapnutý bubble chat: v Exploreri vyberte BubbleChatConfiguration pod TextChatService a overte, že je zaškrtnuté Enabled. V predvolenom stave je zapnutý.

V Output stojí DialogueService: no Tool named Torch in ServerStorage.DialogueItems

Server nemohol nájsť predmet. Overte, že sa priečinok v ServerStorage volá DialogueItems a že v ňom leží Tool (nie Model ani Part) s názvom presne ako v item možnosti. Kým to neopravíte, Guide odpovedá replikou hasTorch, pretože akcia zlyhala.

V Output stojí DialogueService: no action named ...

action možnosti nezodpovedá žiadnemu kľúču v tabuľke ACTIONS. Názvy rozlišujú veľkosť písmen: heal nie je Heal.

Urobiť s RoCode

Ak je pre vás jednoduchšie NPC opísať, ako ho stavať ručne, RoCode môže tieto skripty napísať priamo do vášho otvoreného place. Je to nezávislý AI agent pre Roblox Studio, nie od Robloxu: píšete vo webovom chate a jeho plugin pre Studio vytvára a upravuje skripty vo vašom Exploreri.

Napíšete

Urob, aby model Guide vo Workspace.NPCs hovoril: výzva Talk, dialógové okno s postupne písanými replikami a tlačidlami možností, bublina nad hlavou, možnosť s liečením s cooldownom 30 sekúnd a možnosť, ktorá raz vydá nástroj Torch zo ServerStorage. Rozhovor drž v ModuleScripte a všetky odmeny vydávaj na serveri.

RoCode urobí
  • Môže si najprv pozrieť model cez Get Properties a prečítať kľúčové hodnoty, ako Anchored pri jeho partoch a WalkSpeed pri jeho Humanoide. Napíšte v chate / a pripojíte presnú cestu k modelu
  • Napíše ModuleScript DialogueData, Script DialogueService a LocalScript DialogueClient cez Create Script
  • Má za úlohu overiť kompiláciu každého napísaného skriptu cez Check Script, ktorý ho v Studiu skompiluje bez spustenia
  • Posiela zmeny po dávkach a každá dávka je bod na vrátenie v histórii Studia

S pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby a s pluginom 3.9.11 alebo novším ovládať testovaciu postavu, aby overil, že hra funguje, ale počas hry nerobí snímky obrazovky, takže k NPC príďte a prehovorte s ním sami. Ak niečo nefunguje, ako má, povedzte RoCode, čo ste videli: Check Output vie prečítať riadky Server a Client z vášho posledného playtestu. Hovoriace NPC je jeden systém z mnohých; stránka ako vytvoriť hru v Robloxe s AI, po jednom systéme na prompt ukazuje, ako do seba zapadajú. Ako sa RoCode pripája k Studiu.

Časté otázky

Ako urobiť hovoriace NPC v Roblox Studiu?

Pridajte NPC ProximityPrompt, a keď ho hráč spustí, ukážte repliku NPC v dialógovom okne, v bubline alebo na oboch miestach. Tri skripty z tohto návodu robia oboje a pridávajú možnosti odpovede. Ak chcete iba bublinu, zavolajte TextChatService:DisplayBubble(npc.Head, "Hello!") z LocalScriptu pri spustení výzvy, ako v príklade s NPC na stránke Robloxu o bubble chate.

Čo vybrať: objekt Dialog, alebo vlastné GUI dialógu?

Objekt Dialog nepotrebuje kód a ukazuje klikaciu bublinu, čo stačí na dekoratívny text. Jeho udalosť výberu sa spúšťa iba na zariadení hráča, takže bezpečne vydávať odmeny nemôže, a v predvolenom stave s ním môže hovoriť iba jeden hráč naraz. Vlastné okno, ako v tomto návode, dovolí serveru vydávať každú odmenu a dá každému hráčovi vlastný rozhovor.

Ako dať hráčovi predmet od NPC?

Tool uchovávajte v ServerStorage a nech ho serverový Script naklonuje do Backpacku hráča, keď vyberie túto možnosť, ako to robí akcia GiveItem. Overte, že ho hráč ešte nemá, a pri kópii vypnite CanBeDropped, aby ju nebolo možné zahodiť a požiadať znova. Nikdy nedovoľte zariadeniu hráča hovoriť, aký predmet vydať.

Ako urobiť dialógové okno s efektom písacieho stroja?

Dajte celú repliku do TextLabelu, zvyšujte jeho MaxVisibleGraphemes od 0 po niekoľkých znakoch a nakoniec nastavte -1, aby sa ukázalo všetko. Stránka Robloxu o animácii UI používa tú istú vlastnosť spolu s utf8.graphemes. DialogueClient počíta, koľko znakov ukázať, z uplynulého času, 45 za sekundu, takže rýchlosť nezávisí od snímkovej frekvencie.

Môžu dvaja hráči hovoriť s tým istým NPC súčasne?

So skriptmi z tohto návodu áno: server vedie jeden rozhovor na hráča a každý hráč vidí iba svoje okno. Vstavaný objekt Dialog funguje inak: s jeho predvoleným BehaviorType, SinglePlayer, hovorí jeden hráč naraz a ostatní vidia jeho možnosti.

Musím filtrovať text dialógu NPC?

Repliky, ktoré ste napísali sami, nie. Roblox vám ukladá zodpovednosť za filtrovanie zobrazovaného textu, ktorý priamo neovládate, napríklad toho, čo píšu hráči, slov zložených z náhodných znakov alebo textu stiahnutého z externého webu. Ak NPC opakuje niečo, čo hráč napísal, túto časť filtrujte.

Zdroje a ďalšie čítanie

Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.

Vyskúšajte RoCode vo svojej hre.

Kredity zadarmo každý deň, bez karty. Nainštalujte plugin, opíšte funkciu a pozrite sa, čo sa objaví v Studiu.