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
DialogChoiceSelectedng 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 lumangChatservice, 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
Paano gumagana ang NPC dialogue
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:
- Lumapit ang player sa NPC at pinindot ang E sa Talk prompt nito. Nagpa-fire ang
Triggeredevent ng prompt sa server kasama ang player na ito. - 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. - Tinitipa ng LocalScript ang line sa dialogue window, nagpapakita ng bubble sa itaas ng NPC, saka nagdadagdag ng isang button kada pagpipilian.
- Nag-click, nag-tap o pumili ng opsyon ang player. Ang numero lang nito ang bumabalik sa server.
- 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.
| Bahagi | Nasaan | Ano ang ginagawa |
|---|---|---|
Rig na Guide | Workspace, sa folder na pinangalanang NPCs | Ang NPC mismo. Ang pangalan nito ang pumipili ng usapan at ipinapakita sa prompt. |
ModuleScript na DialogueData | ReplicatedStorage | Lahat ng line na kayang sabihin ng NPC, ang mga pagpipilian sa ilalim ng bawat line, at kung saan papunta ang bawat pagpipilian. |
Script na DialogueService | ServerScriptService | Nagdadagdag ng Talk prompt, naaalala kung nasaang line ang bawat player, chine-check ang bawat click at pinapatakbo ang mga action. |
RemoteEvent na DialogueEvent | ReplicatedStorage (ginagawa ito ng DialogueService) | Dinadala ang bawat line sa player, at ang numero ng napiling opsyon pabalik sa server. |
LocalScript na DialogueClient | StarterPlayer, StarterPlayerScripts | Gumuguhit ng window, tinitipa ang line, nagpapakita ng bubble at ng mga button ng pagpipilian. |
Tool na Torch (optional) | ServerStorage, sa folder na pinangalanang DialogueItems | Ang item na ibinibigay ng isa sa mga pagpipilian. Walang anumang mula sa ServerStorage na ipinapadala sa mga player. |
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
- 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. - 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. - 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.
- 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. - Optional, para sa opsyong may item: i-hover ang ServerStorage at mag-insert ng Folder na pinangalanang
DialogueItems. Ilagay dito ang isang Tool na pinangalanangTorchna may isang hindi anchored na Part na pinangalanangHandle, 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.
-- 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 nastart. - Ang
textay ang sinasabi ng NPC. Angchoicesay ang mga button ng player, ayon sa pagkakasunod. May puwang ang window para sa apat. - Ang
nextay nagsasabi ng line na ipapakita pagkatapos ng opsyong ito. Ang opsyong walangnext, gaya ng "Bye!", ay tinatapos ang usapan. AngnextofailNextna tumutukoy sa line na wala sa table ay tinatapos din ito, na may warning sa Output. - Ang
actionay nagsasabi kung ano ang gagawin ng server, mula saACTIONStable sa DialogueService: dito ayHealoGiveItem. - Ang
itemay para sa GiveItem: ito ang pangalan ng Tool sa ServerStorage, DialogueItems. - Ang
failNextay ang line na ipinapakita sa halip nanextkapag hindi nagawa ang action, para hindi kailanman magsabi ang NPC ng heal o regalo na hindi naman nangyari.
| Line | Sinasabi ni Guide | Mga 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.
-- 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.
| Setting | Value dito | Ano ang binabago |
|---|---|---|
TALK_DISTANCE | 12 | Gaano 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_CHOICES | 0.3 | Ang 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_SECONDS | 30 | Gaano 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:
| Check | Code | Kapag hindi pumasa |
|---|---|---|
| Nasa usapan ang player | conversations[player] | Hindi pinapansin ang click. |
| Integer ang opsyon | typeof at math.floor | Hindi pinapansin. Dito hinihinto ang mga string, table, fraction at NaN. |
| Ang 0 ay ibig sabihing pinindot ng player ang X | choiceIndex == 0 | Natatapos ang usapan. |
| Buhay at hindi pa lumalayo nang higit sa 16 studs (12 dagdag ang 4) | isClose | Natatapos ang usapan, at nagsasara ang window. |
| Hindi bababa sa 0.3 segundo mula sa huling tinanggap na click | conversation.lastChoice | Ipinapadala 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 ito | line.choices[choiceIndex] | Hindi pinapansin. |
| Gumana ang action | bawat action ay nagbabalik ng true o false | Ipinapakita 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.
-- 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 ngTextScaled, na nagpapaliit sa text para magkasya sa label nito sa maliit na screen ng phone, at pinipigilan ngUITextSizeConstraintna lumaki ito nang higit sa 20 pixel sa malaking screen. Inaayos ngUIGridLayoutang mga opsyon nang dalawa-dalawa. False angResetOnSpawn, 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
MaxVisibleGraphemesang nagpapasya kung ilang character ang kita; ito rin ang property na ginagamit ng sariling typewriter example ng Roblox kasama angutf8.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
lineNumberna 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
Activatedsa click ng mouse, tap sa phone at A button sa gamepad. Napiling button lang ang kayang pindutin ng gamepad, kaya kapag sinasabi ngPreferredInputna gamepad ang gamit ng player, pinipili ng script ang unang opsyon gamit angGuiService.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:
- Magdagdag sa
ACTIONSng entry na pinangalanangStartQuest. Check muna, saka pagbabago: kung naka-set na angplayer:GetAttribute("Quest"), ibalik angfalse; kung hindi, tawagin angplayer:SetAttribute("Quest", "Cave")at ibalik angtrue. - Sa DialogueData, bigyan ang opsyon ng
action = "StartQuest", ngnextline para kapag nagtagumpay, at ngfailNextline para kapag pumalya, halimbawa "You are already on a quest." - 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 angDialogueService: no action named StartQuest, at lilipat ang usapan safailNextline.
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.
| Tutorial | Problema | Ang guide na ito |
|---|---|---|
Gumagamit ng Dialog object, at nakikinig ang server Script sa DialogChoiceSelected para magbigay ng reward | Sabi 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 LocalScript | Nananatili 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 line | Kayang 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 prompt | Inilalagay 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 loop | Deprecated 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.
| Sinusubukan ng cheater | Resulta | Bakit |
|---|---|---|
| I-trigger ang Talk prompt mula sa kabilang dulo ng map | Walang nangyayari | Chine-check ng startConversation na hindi siya lalampas sa 16 studs (12 dagdag ang 4). |
| Magpadala ng opsyon 99, string, fraction o NaN | Hindi pinapansin | Hindi ito integer, o walang ganitong opsyon sa line na binabasa niya. |
| Magpadala ng pangalan ng reward o id ng line | Hindi kailanman binabasa | Numero 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 network | Isang click kada 0.3 segundo kada usapan | Ibinabalik 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-usap | Imposible | Ibinibigay lang ang mga item sa pamamagitan ng opsyon sa line na alam ng server na kinaroroonan ng player. |
| Mag-ipon ng maraming torch | Isa lang sa isang pagkakataon | Hinahanap 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 heal | Isang heal kada 30 segundo | Nasa server ang cooldown para sa bawat player, at sinasabi ito ng NPC gamit ang line na healTooSoon. |
| Lumayo at iwanang bukas ang window | Nagsasara sa loob ng kalahating segundo | Dalawang beses kada segundo chine-check ng server ang bawat bukas na usapan. |
| Basahin ang buong usapan, pati ang mga line na hindi pa niya naaabot | Posible | Nasa 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
- Pindutin ang Play (F5) at lumapit kay Guide. Sa loob ng 12 studs, lalabas ang Talk prompt na may pangalang Guide. Pindutin ang E.
- 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.
- Piliin ang "Any tips?", tapos "Anything else?": nasa unang line ka ulit. Piliin ang "Bye!": magsasara ang window, at babalik ang Talk prompt.
- 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.
- 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.
- Magsimula ng usapan at lumayo. Magsasara ang window halos kapag 16 studs ka na mula kay Guide.
- 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.
- 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.
- 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.
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.
- 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
- Roblox Creator Docs: Proximity prompts (sa English). paggawa ng prompt, MaxActivationDistance at RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (sa English). saan gumagana ang prompt, ang text nito at mga default na key, Triggered at ang line-of-sight check
- Roblox Creator Docs: Securing the client-server boundary (sa English). ProximityPrompt bilang attack surface, mga check ng layo at pahintulot
- Roblox Engine API: Dialog (sa English). BehaviorType at ang DialogChoiceSelected event na sa client lang
- Roblox Engine API: TextChatService:DisplayBubble (sa English). mga bubble ng line para sa NPC mula sa client script
- Roblox Creator Docs: Customize bubble chat (sa English). mga bubble ng NPC at BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (sa English). anong ipinapakitang text ang kailangang i-filter
- Roblox Creator Docs: UI animation and tweens (sa English). typewriter effect gamit ang MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (sa English). ano ang ginagawa ng Backspace sa tool
- Roblox Engine API: UserInputService.PreferredInput (sa English). paano malalaman kung gamepad ang gamit ng player
- Roblox Creator Docs: Rig Generator (sa English). pag-insert ng R15 o R6 rig
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.