Tutorial · Game systems

Paano gumawa ng NPC dialogue sa Roblox Studio

Tatlong bahagi ang NPC dialogue sa Roblox: prompt para simulan ang usapan, window na nagpapakita ng sinasabi ng NPC at mga button para sa sagot ng player, at script na nagpapasya kung saan papunta ang bawat sagot. Sa guide na ito, bubuuin natin ang tatlo: isusulat mo ang usapan bilang simpleng table, pipindutin ng mga player ang E para makipag-usap, at lahat ng ibinibigay ng isang sagot (heal, item) ay galing sa server, hindi sa device ng player.

In-update Nobyembre 20, 202625 minutong basaIsinulat ni

Sa madaling salita

Ilagay ang NPC model sa folder na NPCs sa Workspace at isulat ang usapan nito sa isang ModuleScript sa ReplicatedStorage: bawat line ay may text ng NPC at listahan ng mga pagpipilian na papunta sa ibang line. Ang Script sa ServerScriptService ay nagdadagdag ng ProximityPrompt ("Talk") sa bawat NPC, naaalala kung nasaang line ang bawat player, at ipinapadala ito sa pamamagitan ng RemoteEvent. Ipinapakita ng LocalScript ang text at isang button kada pagpipilian, at ang numero lang ng pinindot na button ang ibinabalik nito.

  • Ibigay ang mga reward sa server. Ang event na DialogChoiceSelected ng built-in na Dialog object ay nagpa-fire lang sa client, kaya hindi ito kailanman maririnig ng server Script, at ang heal o item na ibinigay sa LocalScript ay nagbabago lang sa kopya ng game ng player na iyon.
  • Ipakita ang bubble ng line gamit ang TextChatService:DisplayBubble(npc.Head, text) mula sa LocalScript. Deprecated na ang lumang Chat service, at TextChatService na ang ginagamit kapalit nito.
  • Hindi kailangang i-filter ang mga line na ikaw mismo ang sumulat. Patakaran ng Roblox: i-filter ang kahit anong ipinapakitang text na hindi mo direktang kontrolado, gaya ng tina-type ng mga player.
Sa page na ito
  1. Paano ito gumagana
  2. 1. Pagdagdag ng NPC
  3. 2. Usapan
  4. 3. Server script
  5. 4. Dialogue window
  6. Sariling action
  7. Ibang tutorial
  8. Hangganan ng proteksyon
  9. 5. Test
  10. Pagpapalawak
  11. Common errors
  12. Gamit ang RoCode
  13. Mga madalas itanong
  14. Mga source at dagdag na babasahin

Paano gumagana ang NPC dialogue

IlustrasyonTinitipa ang bawat line sa window habang buo itong kita sa bubble, lumalabas ang mga pagpipilian pagkatipa ng line, at ibinibigay ng server ang Torch kapag pinili mo ang "Got anything for the cave?".

Ang nagsasalitang NPC na gumagana sa totoong game ay hati sa pagitan ng server at ng device ng bawat player. Ang device ang gumuguhit ng window at mga button. Ang server, ang tanging panig na mapagkakatiwalaan, ang nakakaalam kung anong line ang binabasa ng bawat player at nagpapasya kung ano ang ginagawa ng bawat sagot. Ganito ang isang ikot ng usapan:

  1. Lumapit ang player sa NPC at pinindot ang E sa Talk prompt nito. Nagpa-fire ang Triggered event ng prompt sa server kasama ang player na ito.
  2. Chine-check ng server script na sapat ang lapit ng player, inaalala na nasa line siya na pinangalanang start, at ipinapadala ang text ng line na iyon at ang mga label ng mga pagpipilian nito sa player na ito lang.
  3. Tinitipa ng LocalScript ang line sa dialogue window, nagpapakita ng bubble sa itaas ng NPC, saka nagdadagdag ng isang button kada pagpipilian.
  4. Nag-click, nag-tap o pumili ng opsyon ang player. Ang numero lang nito ang bumabalik sa server.
  5. Hinahanap ng server ang numerong iyon sa line na alam nitong binabasa ng player, pinapatakbo ang action ng pagpipilian kung meron (heal, item), at ipinapadala ang susunod na line o isinasara ang window.
Mga bumubuo sa nagsasalitang NPC
BahagiNasaanAno ang ginagawa
Rig na GuideWorkspace, sa folder na pinangalanang NPCsAng NPC mismo. Ang pangalan nito ang pumipili ng usapan at ipinapakita sa prompt.
ModuleScript na DialogueDataReplicatedStorageLahat ng line na kayang sabihin ng NPC, ang mga pagpipilian sa ilalim ng bawat line, at kung saan papunta ang bawat pagpipilian.
Script na DialogueServiceServerScriptServiceNagdadagdag ng Talk prompt, naaalala kung nasaang line ang bawat player, chine-check ang bawat click at pinapatakbo ang mga action.
RemoteEvent na DialogueEventReplicatedStorage (ginagawa ito ng DialogueService)Dinadala ang bawat line sa player, at ang numero ng napiling opsyon pabalik sa server.
LocalScript na DialogueClientStarterPlayer, StarterPlayerScriptsGumuguhit ng window, tinitipa ang line, nagpapakita ng bubble at ng mga button ng pagpipilian.
Tool na Torch (optional)ServerStorage, sa folder na pinangalanang DialogueItemsAng item na ibinibigay ng isa sa mga pagpipilian. Walang anumang mula sa ServerStorage na ipinapadala sa mga player.
Ang Explorer kapag handa na ang NPC. Kapag tumatakbo ang game, nagdadagdag ang DialogueService ng RemoteEvent na pinangalanang DialogueEvent sa ReplicatedStorage, at ng Talk ProximityPrompt na pinangalanang TalkPrompt sa HumanoidRootPart ng bawat NPC.
Workspace
  NPCs Folder new
    Guide Model new
      Humanoid Humanoid
      HumanoidRootPart Part
      Head, UpperTorso, LowerTorso ... (mga bahagi ng katawan)
ReplicatedStorage
  DialogueData ModuleScript new
ServerScriptService
  DialogueService Script new
ServerStorage
  DialogueItems Folder new
    Torch Tool new
      Handle Part new
StarterPlayer
  StarterPlayerScripts
    DialogueClient LocalScript new

Hakbang 1: idagdag ang NPC

  1. Sa Avatar o Home tab, pindutin ang Character para buksan ang Rig Generator. Piliin ang R15, isang body shape at isang style. May lalabas na rig sa Workspace na pinangalanang Rig. Gumagana rin ang R6 rig sa parehong mga script.
  2. I-rename ito sa Guide. Mahalaga ang pangalan: hinahanap ng DialogueService ang usapan ayon sa pangalan ng model, at ipinapakita ito ng prompt sa mga player.
  3. I-expand ang rig, i-select ang HumanoidRootPart nito at i-check ang Anchored sa Properties window. Hindi kailanman gumagalaw dahil sa physics ang anchored na part, kaya nakatayo ang NPC kung saan mo ito inilagay, at hindi ito maitutulak ng mga player.
  4. I-hover ang Workspace sa Explorer, pindutin ang + button at mag-insert ng Folder na pinangalanang NPCs. I-drag dito si Guide at ilagay ang rig kung saan malalapitan ng mga player.
  5. Optional, para sa opsyong may item: i-hover ang ServerStorage at mag-insert ng Folder na pinangalanang DialogueItems. Ilagay dito ang isang Tool na pinangalanang Torch na may isang hindi anchored na Part na pinangalanang Handle, ang part na hawak ng character. Kapag may PointLight sa loob ng Handle, magliliwanag ito.

Case-sensitive ang mga pangalan, kaya i-type ang NPCs, Guide, DialogueItems at Torch nang eksakto gaya ng nakikita. Puwedeng maging NPC ang kahit anong model na may Humanoid at HumanoidRootPart, pati mula sa Toolbox, basta direkta itong nasa folder na NPCs.

Hakbang 2: isulat ang usapan

I-hover ang ReplicatedStorage, mag-insert ng ModuleScript na pinangalanang DialogueData at i-paste dito ang code na ito. Walang logic dito, mga salita lang at ang mga koneksyon nila, kaya ito ang file na pinakamadalas mong ie-edit.

ModuleScript sa ReplicatedStorage na pinangalanang DialogueData
-- ModuleScript sa ReplicatedStorage na pinangalanang DialogueData.
-- Lahat ng usapan, ayon sa pangalan ng NPC sa Workspace.NPCs. Bawat line ay may
-- text ng NPC at mga sagot ng player. Ang opsyon ay puwedeng pumunta sa ibang line (next),
-- tapusin ang usapan (walang next) at humiling sa server na may gawin (action). Kung hindi
-- kayang gawin ng server ang action, ipinapakita nito ang line na failNext sa halip na next.

export type Choice = {
	text: string,
	next: string?, -- line na ipapakita pagkatapos ng opsyong ito; tinatapos ng nil ang usapan
	action: string?, -- server action mula sa ACTIONS table sa DialogueService
	item: string?, -- para sa action na GiveItem: pangalan ng Tool sa ServerStorage.DialogueItems
	failNext: string?, -- line na ipapakita sa halip na next kapag hindi nagawa ang action
}

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

Inilalarawan ng mga linyang export type sa simula kung ano ang itsura ng line at ng opsyon. Wala silang binabago habang tumatakbo ang game; inilalarawan nila ang data mo para masuri ito ng type check.

Paano magkakaugnay ang mga bahagi:

  • May table ang bawat NPC na ipinangalan ayon sa model nito sa folder na NPCs, dito ay Guide. Bawat usapan ay nagsisimula sa line na start.
  • Ang text ay ang sinasabi ng NPC. Ang choices ay ang mga button ng player, ayon sa pagkakasunod. May puwang ang window para sa apat.
  • Ang next ay nagsasabi ng line na ipapakita pagkatapos ng opsyong ito. Ang opsyong walang next, gaya ng "Bye!", ay tinatapos ang usapan. Ang next o failNext na tumutukoy sa line na wala sa table ay tinatapos din ito, na may warning sa Output.
  • Ang action ay nagsasabi kung ano ang gagawin ng server, mula sa ACTIONS table sa DialogueService: dito ay Heal o GiveItem.
  • Ang item ay para sa GiveItem: ito ang pangalan ng Tool sa ServerStorage, DialogueItems.
  • Ang failNext ay ang line na ipinapakita sa halip na next kapag hindi nagawa ang action, para hindi kailanman magsabi ang NPC ng heal o regalo na hindi naman nangyari.
Ang usapan ni Guide, line kada line
LineSinasabi ni GuideMga opsyon at kung saan papunta
start"Welcome to the village! What can I do for you?"Ang "Any tips?" ay papunta sa tips. Ang "I'm hurt. Can you help?" ay nagh-heal, tapos healed (o healTooSoon). Ang "Got anything for the cave?" ay nagbibigay ng Torch, tapos torch (o hasTorch). Tinatapos ng "Bye!" ang usapan.
tips"Stay off the red bricks, and come back if you get hurt."Ibinabalik ng "Anything else?" sa start. Tinatapos ng "Thanks!" ang usapan.
healed"There you go, good as new."Tinatapos ng "Thank you!" ang usapan.
torch"Take this torch. The cave is dark."Tinatapos ng "Thanks!" ang usapan.
healTooSoon"I healed you a moment ago. Come back in a little while."Tinatapos ng "OK" ang usapan.
hasTorch"You already have my torch. Keep it lit!"Tinatapos ng "Will do!" ang usapan.

Server lang ang nagbabasa ng module na ito. Hindi ito kailanman nire-require ng LocalScript: ipinapadala ng server ang bawat line kapag naabot ito ng player. Pero kinokopya pa rin sa device ng bawat player ang module sa ReplicatedStorage, kaya kung may spoiler sa usapan (halimbawa, ang sagot sa isang bugtong), ilipat ang DialogueData sa ServerStorage. Saka sa linyang may require sa DialogueService, palitan ang ReplicatedStorage ng ServerStorage para ganito ang buong linya: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.

Hakbang 3: idagdag ang server script

I-hover ang ServerScriptService, mag-insert ng Script na pinangalanang DialogueService at i-paste dito ang code sa ibaba. Ito lang ang lugar kung saan sumusulong ang usapan, at ito lang ang lugar kung saan ibinibigay ang reward.

Script sa ServerScriptService na pinangalanang DialogueService
-- Script sa ServerScriptService na pinangalanang DialogueService.
-- Nagdadagdag ng Talk prompt sa bawat NPC sa Workspace.NPCs at pinapatakbo ang bawat usapan.
-- Ang device ng player ay nagpapakita lang ng text at nagbabalik ng numero ng opsyon
-- na kinlik niya. Alam ng server kung nasaang line ang bawat player, chine-check ang opsyon
-- at ang layo, at ito lang ang nagh-heal o nagbibigay ng item.

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

-- Parehong mga hugis gaya sa DialogueData, para kilala rin sila rito ng type check ng Studio
type Choice = { text: string, next: string?, action: string?, item: string?, failNext: string? }
type Line = { text: string, choices: { Choice } }
local DialogueData = require(ReplicatedStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }

local TALK_DISTANCE = 12 -- studs: radius ng prompt at kung gaano kalapit dapat manatili ang player
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30

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

-- Ang script na ito mismo ang gumagawa ng DialogueEvent, kaya huwag itong idagdag nang mano-mano
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 -- walang character, patay ito, o nawala ang NPC
	end
	-- maliit na palugit, dahil medyo nahuhuli ang pagdating ng posisyon ng player sa server
	return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end

-- Ang ginagawa ng server kapag may action ang opsyon. Bawat isa ay nagbabalik ng true kapag nagawa.
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 -- masyadong kamakailan ang huling heal
		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 -- wala pang backpack, o meron na siyang item
		end
		local item = template:Clone() :: Tool
		item.CanBeDropped = false -- para walang makapagtapon nito at humingi ng isa pa
		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 -- kausap na, walang "start" line ang NPC na ito, patay, o masyadong malayo
	end
	local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
	conversations[player] = conversation
	showLine(player, conversation)
end

-- Kinlik ng player ang opsyon na may numerong choiceIndex (ang 0 ay ibig sabihing isinara niya ang window)
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
		-- Masyadong mabilis. Ipinapadala ulit ang parehong line, dahil na-lock na ng window
		-- ang mga button pagka-click at kung hindi ay maghihintay ito ng sagot habambuhay.
		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 -- walang ganitong opsyon sa line na binabasa ng player na ito
	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 -- halimbawa "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 prompt sa bawat 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() -- may dalang lumang prompt ang kopya ng NPC na walang nakikinig
	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)

-- Isinasara ang window para sa lahat ng umalis o namatay sa gitna ng usapan
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)

Ang DialogueService mismo ang gumagawa ng RemoteEvent na DialogueEvent pagsimula ng game, kaya walang kailangang i-insert nang mano-mano sa ReplicatedStorage. Kung nakagawa ka na ng RemoteEvent na may ganitong pangalan, burahin ito: baka iyon ang mahanap ng LocalScript, at walang nakikinig doon sa server.

Mga setting sa simula ng DialogueService
SettingValue ditoAno ang binabago
TALK_DISTANCE12Gaano kalapit, sa studs, dapat ang player para lumabas ang Talk prompt. Pinapayagan siya ng server na lumayo pa nang 4 studs bago isara ang window, dahil medyo nahuhuli ang pagdating ng posisyon ng player sa server.
MIN_SECONDS_BETWEEN_CHOICES0.3Ang pinakamaikling oras sa pagitan ng dalawang click na tinatanggap ng server. Sa mas mabilis na click, ipinapadala ulit ang parehong line sa halip na sumagot.
HEAL_COOLDOWN_SECONDS30Gaano katagal maghihintay ang bawat player sa pagitan ng mga heal mula sa action na Heal.

Nag-iimbak ang server sa conversations ng isang entry kada player: kung sinong NPC ang kausap niya, anong line ang binabasa niya, at kailan tinanggap ang huling click niya. Kapag nag-fire ang Talk prompt, ginagawa ng startConversation ang entry na ito kung hindi pa kausap ang player, may start line ang NPC, at buhay ang player at nasa range. Pagkatapos noon, dumadaan ang bawat click sa mga check na ito:

Ano ang chine-check ng DialogueService sa bawat click
CheckCodeKapag hindi pumasa
Nasa usapan ang playerconversations[player]Hindi pinapansin ang click.
Integer ang opsyontypeof at math.floorHindi pinapansin. Dito hinihinto ang mga string, table, fraction at NaN.
Ang 0 ay ibig sabihing pinindot ng player ang XchoiceIndex == 0Natatapos ang usapan.
Buhay at hindi pa lumalayo nang higit sa 16 studs (12 dagdag ang 4)isCloseNatatapos ang usapan, at nagsasara ang window.
Hindi bababa sa 0.3 segundo mula sa huling tinanggap na clickconversation.lastChoiceIpinapadala ulit ang parehong line, kaya nakakakuha ang window ng bagong mga button sa halip na maghintay habambuhay.
Umiiral ang opsyon sa line na binabasa ng player na itoline.choices[choiceIndex]Hindi pinapansin.
Gumana ang actionbawat action ay nagbabalik ng true o falseIpinapakita ang line na failNext sa halip na next.

Isinasabit ang prompt sa HumanoidRootPart ng NPC, dahil gumagana ang ProximityPrompt kapag nasa loob ito ng part (o Attachment, o model na may PrimaryPart) sa Workspace. Naka-on by default ang RequiresLineOfSight nito at itinatago ang prompt tuwing may humaharang sa tanaw mula sa camera papunta sa part na iyon. Hindi isinasama ng Roblox sa check na ito ang sariling part ng prompt, pero kasama ang natitirang katawan, at nasa loob ng torso ang HumanoidRootPart, kaya ino-off ng script ang line-of-sight check. TalkPrompt ang pangalan ng prompt, at binubura ng script ang kahit anong TalkPrompt na nasa part na bago idagdag ang sarili nito: ang kopya ng NPC na ginawa habang tumatakbo ang game ay may dalang prompt ng orihinal, at walang nakikinig sa nakopya. Kung walang usapan na may start line ang DialogueData para sa pangalan ng NPC, lalabas sa Output ang warning na may pangalan ng NPC na iyon.

Dalawang beses kada segundo chine-check ng isang loop ang bawat bukas na usapan at isinasara ito kapag lumayo ang player nang higit sa 16 studs o namatay ang character niya, para hindi mag-respawn nang bukas ang window ang player na namatay sa gitna ng usapan. Nililinis ng PlayerRemoving ang dalawang table kapag may umalis.

Hakbang 4: idagdag ang dialogue window

Buksan ang StarterPlayer, i-hover ang StarterPlayerScripts, mag-insert ng LocalScript na pinangalanang DialogueClient at i-paste dito ang code na ito. Binubuo nito ang dialogue window sa code, kaya hindi mo na kailangang gumuhit ng GUI nang mano-mano.

LocalScript sa StarterPlayer > StarterPlayerScripts na pinangalanang DialogueClient
-- LocalScript sa StarterPlayer > StarterPlayerScripts na pinangalanang DialogueClient.
-- Iginuguhit ang usapang ipinapadala ng server: pangalan ng NPC, ang line nito na tinitipa letra
-- kada letra, bubble sa itaas ng ulo at isang button kada opsyon. Ang pag-click sa
-- opsyon ay nagpapadala lang ng numero nito; ang server ang nagpapasya kung ano ang susunod.

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)

-- Ang dialogue window, binuo sa code
local gui = Instance.new("ScreenGui")
gui.Name = "Dialogue"
gui.ResetOnSpawn = false
gui.Enabled = false

local box = Instance.new("Frame")
box.AnchorPoint = Vector2.new(0.5, 1)
box.Position = UDim2.new(0.5, 0, 1, -84) -- 84 pixel na mas mataas, para hindi takpan ng toolbar ng Roblox ang mga opsyon
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 -- lumiliit ang mahabang line para magkasya sa maliit na screen ng phone
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- at hindi kailanman lalaki sa 20 pixel sa malaking screen
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 -- tumataas sa bawat bagong line, para huminto ang lumang typing loop

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 -- sa device lang na ito nagbabago
	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()

	-- Bubble sa itaas ng NPC (gumagana lang ang DisplayBubble sa LocalScript)
	local head = npc:FindFirstChild("Head")
	if head then
		TextChatService:DisplayBubble(head, text)
	end

	-- Tinitipa ang line letra kada letra. Binibilang ang dami mula sa lumipas na oras,
	-- kaya pareho ang bilis sa kahit anong frame rate.
	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 -- pinalitan ang line na ito ng mas bago o ng pagsara
		end
		shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
		lineLabel.MaxVisibleGraphemes = shown
	end
	lineLabel.MaxVisibleGraphemes = -1

	-- Isang button kada opsyon; numero lang ng button ang natatanggap ng server
	for index, choiceText in choices do
		local button = Instance.new("TextButton")
		button.LayoutOrder = index
		button.BackgroundColor3 = Color3.fromRGB(124, 77, 255)
		button.TextColor3 = Color3.new(1, 1, 1)
		button.TextScaled = true
		button.FontFace = BOLD
		button.Text = choiceText
		local buttonCorner = Instance.new("UICorner")
		buttonCorner.CornerRadius = UDim.new(0, 8)
		buttonCorner.Parent = button
		button.Parent = choiceList
		button.Activated:Connect(function()
			if lineNumber == thisLine then
				lineNumber += 1 -- isang click kada line
				dialogueEvent:FireServer(index)
			end
		end)
		if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
			GuiService.SelectedObject = button -- para mapili ang opsyon gamit ang gamepad
		end
	end
end

closeButton.Activated:Connect(function()
	dialogueEvent:FireServer(0)
	close()
end)

dialogueEvent.OnClientEvent:Connect(function(kind: string, npc: Model?, text: string?, choices: { string }?)
	if kind == "show" and npc and text and choices then
		show(npc, text, choices)
	elseif kind == "close" then
		close()
	end
end)

Puwede mong baguhin ang mga kulay, size at LETTERS_PER_SECOND ayon sa gusto mo. Huwag galawin ang huling dalawang handler: iyon lang ang paraan ng window para makipag-usap sa server.

Ano ang ginagawa ng bawat bahagi ng DialogueClient:

  • Ang window. ScreenGui na may Frame na naka-anchor sa ibabang gitna ng screen, 60% ng lapad nito at 34% ng taas, na may limit na 720 by 300 pixel gamit ang UISizeConstraint, para hindi ito umabot sa buong lapad ng malapad na monitor. Gumagamit ang line ng NPC ng TextScaled, na nagpapaliit sa text para magkasya sa label nito sa maliit na screen ng phone, at pinipigilan ng UITextSizeConstraint na lumaki ito nang higit sa 20 pixel sa malaking screen. Inaayos ng UIGridLayout ang mga opsyon nang dalawa-dalawa. False ang ResetOnSpawn, dahil isang beses lang tumatakbo ang LocalScript na ito kada session: hindi na babalik ang window na nabura sa respawn.
  • Typewriter effect. Napupunta agad sa TextLabel ang buong line, at ang MaxVisibleGraphemes ang nagpapasya kung ilang character ang kita; ito rin ang property na ginagamit ng sariling typewriter example ng Roblox kasama ang utf8.graphemes. Inaayos ng Roblox ang text na parang kita ang lahat ng character, kaya hindi tumatalon sa bagong linya o nagbabago ng size ang mga salita habang lumalabas. Kinakalkula ng script kung ilang character ang ipapakita mula sa lumipas na oras, 45 kada segundo, kaya pareho ang bilis sa kahit anong frame rate, saka ginagawang -1 ang property, na nagpapakita ng lahat.
  • Ang mga button. Lumalabas sila pagkatipa ng line. Bawat isa ay nagpapadala lang ng sarili nitong numero at isang beses lang: pinipigilan ng check sa lineNumber na magpadala nang dalawang beses ang double click, at pagkatapos ay hinihintay ng window ang susunod na line mula sa server.
  • Bubble ng line. Inilalagay ng TextChatService:DisplayBubble(head, text) ang line sa chat bubble sa itaas ng Head ng NPC. Sa client script lang ito pinapayagan ng Roblox, at naka-on by default ang bubble chat. Device ng player na ito ang gumuguhit ng bubble, kaya siya lang ang nakakakita nito.
  • Ang prompt. Habang nakikipag-usap ang player, naka-off ang kopya niya ng Talk prompt (hinahanap ito sa pangalang TalkPrompt), para hindi ito nakalutang sa ibabaw ng usapan. Nakikita pa rin ng ibang player ang kanila.
  • Kahit anong device. Nagpa-fire ang Activated sa click ng mouse, tap sa phone at A button sa gamepad. Napiling button lang ang kayang pindutin ng gamepad, kaya kapag sinasabi ng PreferredInput na gamepad ang gamit ng player, pinipili ng script ang unang opsyon gamit ang GuiService.SelectedObject.
  • Ang X button. Nagpapadala ito ng 0, na naiintindihan ng server bilang "tapusin ang usapan", at agad nitong isinasara ang window.

Magdagdag ng sarili mong mga action

Ang action ay isang function sa ACTIONS table sa simula ng DialogueService. Natatanggap nito ang player at ang opsyon, at nagbabalik ng true kapag nagawa na nito ang trabaho. Para magdagdag ng sarili mo, halimbawa quest na ibinibigay ng NPC:

  1. Magdagdag sa ACTIONS ng entry na pinangalanang StartQuest. Check muna, saka pagbabago: kung naka-set na ang player:GetAttribute("Quest"), ibalik ang false; kung hindi, tawagin ang player:SetAttribute("Quest", "Cave") at ibalik ang true.
  2. Sa DialogueData, bigyan ang opsyon ng action = "StartQuest", ng next line para kapag nagtagumpay, at ng failNext line para kapag pumalya, halimbawa "You are already on a quest."
  3. Pindutin ang Play at piliin ang opsyon nang dalawang beses. Kung hindi tugma ang pangalan sa DialogueData sa key sa ACTIONS (mahalaga ang laki ng titik), lalabas sa Output ang DialogueService: no action named StartQuest, at lilipat ang usapan sa failNext line.

Mga patakaran sa pagsulat ng action:

  • Gawin ang check at ang pagbabago sa loob ng action, sa server. Ang numero ng opsyon lang ang ipinapadala ng device ng player.
  • Basahin ang kailangan ng action mula sa opsyon (gaya ng item) o mula sa sariling state ng server, pero hindi kailanman mula sa remote.
  • Limitahan ang lahat ng may halaga sa loob mismo ng action, gaya ng pagpapanatili ng Heal ng sarili nitong 30-segundong cooldown sa lastHeal. Pinapabagal lang ng 0.3-segundong limit kada click ang mga click; hindi nito pinipigilan ang player na daanan ang parehong opsyon nang paulit-ulit.
  • Para magbukas ng ibang window, halimbawa shop, puwedeng magpadala ang action ng RemoteEvent sa player na ito at magbalik ng true. Lahat ng nangyayari sa window na iyon ay kailangan pa rin ng sarili nitong server check, gaya sa section na NPC na tindero.

Saan nagkakamali ang ibang tutorial sa NPC dialogue

Kung ikinukumpara mo ang guide na ito sa isang video o forum post, ito ang mahahalagang pagkakaiba at ang dahilan kung bakit nagdudulot ng problema ang bawat technique.

Mga karaniwang technique sa mga tutorial sa NPC dialogue at ang ginagawa ng guide na ito kapalit nila
TutorialProblemaAng guide na ito
Gumagamit ng Dialog object, at nakikinig ang server Script sa DialogChoiceSelected para magbigay ng rewardSabi ng Roblox reference, sa client side lang gumagana ang event na ito at hindi magpa-fire sa server, kaya hindi kailanman dumarating ang reward.Dumarating sa server ang opsyon bilang numero, at ang server mismo ang nagbibigay ng reward.
Nagbibigay ng reward mula sa LocalScriptNananatili sa iisang device na iyon ang pagbabagong ginawa ng LocalScript (tingnan ang kung ano ang nare-replicate), at kayang patakbuhin ng cheater ang parehong code kahit kailan.Nakatira ang lahat ng action sa DialogueService.
Pinapasalita ang NPC gamit ang game:GetService("Chat"):Chat(head, text)Deprecated na ang Chat service, at TextChatService na ang ginagamit kapalit nito.TextChatService:DisplayBubble sa LocalScript.
Nagpapadala mula sa client ng pangalan ng reward o ng id ng susunod na lineKayang magpadala ng cheater ng kahit anong pangalan ng item o tumalon diretso sa line na nagbibigay ng reward.Numero lang ng opsyon ang ipinapadala ng client. Hinahanap ito ng server sa line na alam nitong binabasa ng player.
Walang chine-check pagkatapos mag-fire ng promptInilalagay ng security guide ng Roblox ang ProximityPrompt kasama ng mga remote bilang bagay na kayang abusuhin ng mga client, at pinapayong i-check kung sapat ang lapit ng player bago ang action.Chine-check ang layo pagsimula ng usapan, sa bawat click at dalawang beses kada segundo habang bukas ito.
Tinitipa ang text gamit ang wait() sa loopDeprecated na ang global na wait, at task.wait na ang ginagamit kapalit nito.Kinakalkula ang bilang ng kitang letra mula sa os.clock() at naghihintay gamit ang task.wait().

Ano ang kaya at hindi kayang dayain ng player

Ipagpalagay na kontrolado ng cheater ang lahat sa device niya. Kaya niyang basahin ang mga LocalScript mo at lahat ng nasa ReplicatedStorage, tawagin ang DialogueEvent gamit ang kahit anong argument nang kahit ilang beses, at i-trigger ang Talk prompt mula sa code, gaya ng babala ng security guide ng Roblox. Sumasagot ang DialogueService gamit ang mga server check na kapareho ng uri sa section na pag-validate ng argument ng RemoteEvent. Ito ang nakukuha ng cheater dito.

Ano ang puwedeng subukan ng cheater at ano ang ginagawa rito ng DialogueService
Sinusubukan ng cheaterResultaBakit
I-trigger ang Talk prompt mula sa kabilang dulo ng mapWalang nangyayariChine-check ng startConversation na hindi siya lalampas sa 16 studs (12 dagdag ang 4).
Magpadala ng opsyon 99, string, fraction o NaNHindi pinapansinHindi ito integer, o walang ganitong opsyon sa line na binabasa niya.
Magpadala ng pangalan ng reward o id ng lineHindi kailanman binabasaNumero lang ng opsyon ang binabasa ng server. Galing ang mga reward sa mga field na item at action ng kopya ng line sa server.
Mag-click nang kasing-bilis ng kaya ng networkIsang click kada 0.3 segundo kada usapanIbinabalik sa mas mabibilis na click ang mismong line nila. Nalulusutan ng pagtatapos at muling pagsimula ng usapan ang paghihintay na ito, kaya may sariling limit ang Heal at GiveItem.
Humingi ng torch nang hindi nakikipag-usapImposibleIbinibigay lang ang mga item sa pamamagitan ng opsyon sa line na alam ng server na kinaroroonan ng player.
Mag-ipon ng maraming torchIsa lang sa isang pagkakataonHinahanap muna ng server ang Torch sa Backpack at character niya, at hindi maitatapon ang ibinigay na torch, kaya hindi ito mafa-farm sa pagtatapon at paghingi ulit.
I-spam ang line na may healIsang heal kada 30 segundoNasa server ang cooldown para sa bawat player, at sinasabi ito ng NPC gamit ang line na healTooSoon.
Lumayo at iwanang bukas ang windowNagsasara sa loob ng kalahating segundoDalawang beses kada segundo chine-check ng server ang bawat bukas na usapan.
Basahin ang buong usapan, pati ang mga line na hindi pa niya naaabotPosibleNasa ReplicatedStorage ang DialogueData, na kinokopya sa bawat device. Ilipat ito sa ServerStorage kung mahalaga ito (tingnan ang hakbang 2).

Isang limitasyon ang dapat sabihin nang diretso: ang cheater na lumalapit kay Guide at pumipili ng mga opsyon ay nakakakuha ng eksaktong nakukuha ng tapat na player. Kontrolado ng server kung gaano kadalas at mula saan, pero hindi kung sino. Ang lahat ng bihira, halimbawa reward na isang beses lang makukuha ng bawat player, ay kailangan ng check na pagmamay-ari ng server, gaya ng attribute na sine-set pagkakuha o ng flag na naka-save sa data store.

Hakbang 5: i-test

  1. Pindutin ang Play (F5) at lumapit kay Guide. Sa loob ng 12 studs, lalabas ang Talk prompt na may pangalang Guide. Pindutin ang E.
  2. Ipinapakita ng window ang "Guide", tinitipa ang welcome line at saka ipinapakita ang apat na button. Lumalabas din ang parehong line sa bubble sa itaas ng ulo ng NPC.
  3. Piliin ang "Any tips?", tapos "Anything else?": nasa unang line ka ulit. Piliin ang "Bye!": magsasara ang window, at babalik ang Talk prompt.
  4. Saktan muna ang sarili mo: pindutin ang Client/Server toggle para lumipat sa Server, i-select ang Humanoid ng character mo sa Workspace, gawing 50 ang Health sa Properties window, at lumipat pabalik sa Client. Nagre-regenerate ang mga character ng player ng 1% ng MaxHealth kada segundo, kaya kausapin agad si Guide at piliin ang "I'm hurt. Can you help?": tatalon sa puno ang health. Kausapin ulit sa loob ng 30 segundo at piliin ulit ito: walang heal, at sasabihin ni Guide na kaka-heal lang niya sa iyo.
  5. Piliin ang "Got anything for the cave?": lalabas ang Torch sa hotbar. I-equip ito at pindutin ang Backspace: mananatili ito sa kamay. Humingi ulit: walang pangalawang torch, at sasabihin ni Guide na meron ka na nito.
  6. Magsimula ng usapan at lumayo. Magsasara ang window halos kapag 16 studs ka na mula kay Guide.
  7. Piliin ang Server & Clients sa dropdown ng test mode, i-set sa 2 client at pindutin ang Play. Kayang kausapin ng dalawang player si Guide nang sabay, bawat isa sa sariling line.
  8. I-test ang gamepad gamit ang Controller Emulator (Controller sa Emulation tab) habang nagpe-playtest. Gamit ang emulated na gamepad, lumapit at pindutin ang button ng prompt (by default ButtonX): kapag lumabas ang mga opsyon, napili na ang una, at pinipindot ito ng A.
  9. I-test ang screen ng phone gamit ang Device Simulator sa Studio (sa oras ng pagsulat, beta ito: i-on ang New Device Simulator sa File, Beta Features at i-restart ang Studio). Pumili ng phone, pindutin ang Rotate hanggang naka-landscape ito, pindutin ang Play, lumapit kay Guide at i-tap ang Talk prompt. Piliin ang "Any tips?": kita ang buong line sa itaas ng mga button ng opsyon, mas maliit na text kung kailangan, at hindi ito sumasapaw sa kanila.

Panatilihing bukas ang Output window sa buong panahong ito (Window menu, tapos Output). Kapag gumagana ang mga script na ito, wala silang pini-print, kaya ang kahit anong pulang error o warning na nagsisimula sa DialogueService: ay totoong problema. Tingnan ang Mga karaniwang error.

Paano palawakin

Mas maraming NPC at mas mahahabang usapan

Magdagdag sa folder na NPCs ng isa pang rig na may sariling pangalan, at sa DialogueData ng table na may parehong pangalan at start line. Nagdadagdag ang DialogueService ng Talk prompt sa bawat model sa folder na may HumanoidRootPart, pati sa mga idinagdag habang tumatakbo ang game; nakakakuha ang kopya ng NPC ng bagong prompt sa halip ng prompt na kasama nang kinopya ito. Iisang table ang gamit ng dalawang NPC na may parehong pangalan. Puwedeng magkaugnay ang mga line sa kahit anong ayos, at puwedeng ibalik ng opsyon sa mas naunang line, gaya ng "Anything else?". Huwag lalampas sa apat na opsyon kada line, dahil dalawa-dalawa ang ayos ng window sa kanila.

Mga line na nakadepende sa progress

Para batiin nang iba ang mga bumabalik na player, piliin ang unang line batay sa pagmamay-ari ng server. Sa startConversation, piliin ito gamit ang local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", i-check na umiiral ang line, gaya ng pag-check ng script sa lines.start, at gamitin ang firstLine sa halip na "start" sa paggawa ng usapan. I-set ang attribute sa isang action at magdagdag ng line na welcomeBack sa table ni Guide. Isang session lang tumatagal ang mga attribute; para maalala ang player sa pagitan ng mga pagbisita, i-save ang flag sa data store, gaya sa tutorial sa DataStore.

NPC na tindero

Buuin ang shop gamit ang guide sa shop GUI, saka magdagdag ng action na OpenShop na nagpapadala ng RemoteEvent sa player na ito at nagbabalik ng true, at hayaang buksan ng LocalScript ng shop ang window nito kapag dumating ang event na iyon. Dumadaan pa rin ang mga pagbili sa sariling server check ng shop. Kung malapit lang sa NPC puwedeng bumili, i-check din ang layo sa loob ng purchase handler, dahil kayang tawagin ng client ang remote ng shop mula kahit saan.

Mga NPC na naglalakad

Para gumala o sumunod si Guide sa mga player, gamitin ang guide sa NPC pathfinding at i-off ang Anchored sa HumanoidRootPart para makagalaw ito. Nakasabit sa part na iyon ang Talk prompt, kaya gumagalaw ito kasama ng NPC, at parehong part ang gamit ng mga distance check. I-pause ang paglalakad habang bukas ang usapan, kung hindi ay magsasara ang window sa sandaling lumayo ang NPC nang higit sa 16 studs mula sa player.

Mga susi, quest at ibang reward

Nagbibigay ang GiveItem ng kahit anong Tool mula sa DialogueItems, kaya kayang magbigay ng NPC ng susi na chine-check ng nakakandadong pinto, gaya sa guide sa pinto. Para sa mga item na may ginagawa kapag ginamit, halimbawa pagkaing nagh-heal, basahin ang guide sa inventory.

Mga tunog at camera

Para sa voice clip o maikling tunog sa bawat line, maglagay ng Sound sa Head ng NPC at patugtugin ito mula sa show sa DialogueClient. Para ituon ang camera sa NPC habang nagsasalita ito, ipinapakita ng guide sa cutscene kung paano kinukuha ng LocalScript ang kontrol sa camera at ibinabalik ito.

Mga karaniwang error at solusyon

Buksan ang Output window (Window menu, tapos Output) bago pindutin ang Play. Karamihan sa mga problema sa dialogue ay nagpi-print ng warning doon, o nangyayari dahil sa pangalang hindi tugma.

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

Naghihintay ang DialogueClient ng remote na ginagawa ng DialogueService, ibig sabihin hindi umabot sa puntong iyon ang DialogueService. Siguraduhing Script ito, hindi LocalScript, na direkta itong nasa ServerScriptService at hindi naka-disable. Hinihintay muna ng DialogueService ang DialogueData sa ReplicatedStorage at ang folder na NPCs sa Workspace, kaya pinapahinto rin ito kapag wala ang mga iyon o mali ang pagkaka-type ng pangalan; sa ganoong kaso, ipinapakita ng Output ang infinite yield warning mula sa DialogueService na may pangalang iyon.

Walang lumalabas na Talk prompt sa itaas ng NPC ko

Nagdadagdag lang ng prompt ang DialogueService sa mga model na direktang nasa Workspace, NPCs at may part na pinangalanang HumanoidRootPart. I-check ang dalawang kondisyon at lumapit nang mas malapit sa 12 studs. Ang rig mula sa Toolbox ay puwedeng walang ganitong part, o puwedeng ibang uri ng object ito na nakabalot sa folder.

Lumalabas ang prompt, pero walang nangyayari kapag pinindot ang E

Hindi nahanap ng server ang usapan para sa NPC na ito, at pagsimula ng game ay ipinapakita ng Output ang DialogueService: no conversation with a start line for Guide in DialogueData na may pangalan ng NPC mo. Dapat eksaktong kapangalan ng model ang table sa DialogueData, pati ang malalaking titik, at may start line.

Isinasara ng opsyon ang window sa halip na lumipat sa susunod na line

Ipinapakita ng Output ang DialogueService: no line named tip for Guide in DialogueData na may mga pangalan mo: tumutukoy ang next (o failNext) ng opsyon sa line na wala sa table ng NPC na ito. Case-sensitive ang mga pangalan ng line, kaya ikumpara ang spelling sa table, dito ay tips.

Gumagana ang window, pero walang bubble ng line

Kailangan ng bubble ng part na pinangalanang Head na direktang nasa loob ng NPC model, at naka-on na bubble chat: sa Explorer, i-select ang BubbleChatConfiguration sa ilalim ng TextChatService at siguraduhing naka-check ang Enabled. Naka-on ito by default.

Sinasabi ng Output ang DialogueService: no Tool named Torch in ServerStorage.DialogueItems

Hindi nahanap ng server ang item. Siguraduhing DialogueItems ang pangalan ng folder sa ServerStorage at may Tool dito (hindi Model at hindi Part) na eksaktong kapangalan ng nasa item ng opsyon. Hangga't hindi mo ito naaayos, sumasagot si Guide ng hasTorch line, dahil pumalya ang action.

Sinasabi ng Output ang DialogueService: no action named ...

Hindi tugma ang action ng opsyon sa kahit anong key sa ACTIONS table. Case-sensitive ang mga pangalan: ang heal ay hindi Heal.

Gawin gamit ang RoCode

Kung mas madali sa iyong ilarawan ang NPC kaysa buuin ito nang mano-mano, kayang isulat ng RoCode ang mga script na ito mismo sa place na bukas mo. Isa itong independent na AI agent para sa Roblox Studio, hindi galing sa Roblox: nagsusulat ka sa web chat, at ang plugin nito para sa Studio ang gumagawa at nag-e-edit ng mga script sa Explorer mo.

Ang tina-type mo

Gawin mong nakikipag-usap ang Guide model sa Workspace.NPCs: Talk prompt, dialogue window na may tumitipang line at mga button ng opsyon, bubble sa itaas ng ulo, opsyong may heal na may 30 segundong cooldown, at opsyong isang beses na nagbibigay ng Torch tool mula sa ServerStorage. I-store ang usapan sa ModuleScript at ibigay ang lahat ng reward sa server.

Ang ginagawa ng RoCode
  • Puwedeng pag-aralan muna ang model gamit ang Get Properties para basahin ang mahahalagang value, gaya ng Anchored sa mga part nito at ng WalkSpeed ng Humanoid nito. I-type ang / sa chat para i-attach ang eksaktong path ng model
  • Sumusulat ng ModuleScript na DialogueData, Script na DialogueService at LocalScript na DialogueClient gamit ang Create Script
  • Inuutusan itong i-check ang compile ng bawat script na isinulat nito gamit ang Check Script, na kino-compile ito sa Studio nang hindi pinapatakbo
  • Ipinapadala ang mga pagbabago nang batch-batch, at bawat batch ay isang undo point sa history ng Studio

Sa plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang mga error, at sa plugin 3.9.11 o mas bago, kaya nitong kontrolin ang isang test character para suriin na gumagana ang game, pero hindi ito kumukuha ng screenshot habang naglalaro, kaya lumapit ka mismo sa NPC at kausapin ito. Kung may hindi gumagana nang tama, sabihin sa RoCode ang nakita mo: kayang basahin ng Check Output ang mga Server at Client line mula sa huli mong playtest. Isang system lang ang nagsasalitang NPC sa marami; ipinapakita ng page na paano gumawa ng Roblox game gamit ang AI, isang system kada prompt kung paano sila nagsasama-sama. Paano kumokonekta ang RoCode sa Studio.

Mga madalas itanong

Paano gumawa ng nagsasalitang NPC sa Roblox Studio?

Bigyan ang NPC ng ProximityPrompt at, kapag na-trigger ito ng player, ipakita ang line ng NPC sa dialogue window, sa bubble, o sa dalawa. Ginagawa ng tatlong script sa guide na ito ang pareho at nagdadagdag ng mga opsyon sa pagsagot. Kung bubble lang ang kailangan, tawagin ang TextChatService:DisplayBubble(npc.Head, "Hello!") mula sa LocalScript kapag nag-fire ang prompt, gaya ng NPC example sa page ng Roblox tungkol sa bubble chat.

Alin ang pipiliin: Dialog object o sariling dialogue GUI?

Walang code na kailangan ang Dialog object, at nagpapakita ito ng clickable na bubble, na sapat para sa pandekorasyong text. Sa device lang ng player nagpa-fire ang choice event nito, kaya hindi ito ligtas na makakapagbigay ng reward, at by default isang player lang ang puwedeng kumausap dito sa isang pagkakataon. Ang sariling window, gaya sa guide na ito, ay hinahayaan ang server na magbigay ng bawat reward at binibigyan ang bawat player ng sariling usapan.

Paano magbigay ng item sa player mula sa NPC?

Mag-imbak ng Tool sa ServerStorage, at hayaang i-clone ito ng server Script sa Backpack ng player kapag pinili niya ang opsyong iyon, gaya ng ginagawa ng action na GiveItem. I-check na wala pa sa player ang ganoon, at i-off ang CanBeDropped ng kopya para hindi ito maitapon at mahingi ulit. Huwag kailanman hayaang ang device ng player ang magsabi kung anong item ang ibibigay.

Paano gumawa ng dialogue window na may typewriter effect?

Ilagay ang buong line sa TextLabel, taasan ang MaxVisibleGraphemes nito mula 0 nang ilang character sa bawat pagkakataon, at sa dulo ay gawing -1 para ipakita ang lahat. Ginagamit ng page ng Roblox tungkol sa UI animation ang parehong property kasama ang utf8.graphemes. Kinakalkula ng DialogueClient kung ilang character ang ipapakita mula sa lumipas na oras, 45 kada segundo, kaya hindi nakadepende sa frame rate ang bilis.

Puwede bang kausapin ng dalawang player ang iisang NPC nang sabay?

Sa mga script sa guide na ito, oo: nagpapatakbo ang server ng isang usapan kada player, at sariling window lang ang nakikita ng bawat player. Iba ang built-in na Dialog object: sa default nitong BehaviorType, SinglePlayer, isang player lang ang nagsasalita sa isang pagkakataon, at nakikita ng iba ang mga opsyon niya.

Kailangan bang i-filter ang text ng NPC dialogue?

Hindi kailangan para sa mga line na ikaw mismo ang sumulat. Ikaw ang pinapanagot ng Roblox sa pag-filter ng ipinapakitang text na hindi mo direktang kontrolado, gaya ng tina-type ng mga player, mga salitang binuo mula sa random na character, o text na kinuha mula sa external na site. Kung inuulit ng NPC ang kahit anong tinype ng player, i-filter ang bahaging iyon.

Mga source at dagdag na babasahin

Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.

Subukan ang RoCode sa sarili mong game.

Libreng credits araw-araw, walang card. I-install ang plugin, ilarawan ang feature, at tingnan kung ano ang lumabas sa Studio.