Накратко
Сложи модела на NPC в папка NPCs в Workspace и запиши разговора му в ModuleScript в ReplicatedStorage: всяка реплика има текст на NPC и списък с варианти, които водят към друга реплика. Script в ServerScriptService добавя на всеки NPC ProximityPrompt ("Talk"), помни на коя реплика е всеки играч и я праща през RemoteEvent. LocalScript показва текста и по един бутон за всеки вариант, а обратно праща само номера на натиснатия бутон.
- Давай наградите на сървъра. Събитието
DialogChoiceSelectedна вградения обект Dialog се задейства само на клиента, затова сървърният Script никога няма да го чуе, а лечение или предмет, дадени в LocalScript, променят само копието на играта при този играч. - Показвай балончето с репликата чрез
TextChatService:DisplayBubble(npc.Head, text)от LocalScript. Старата услугаChatе остаряла, вместо нея се използва TextChatService. - Репликите, които си написал сам, не е нужно да се филтрират. Правилото на Roblox: филтрирай всеки показван текст, който не контролираш пряко, например това, което пишат играчите.
На тази страница
Как работи диалогът с NPC
Говорещ NPC, който работи в истинска игра, е разделен между сървъра и устройството на всеки играч. Устройството рисува прозореца и бутоните. Сървърът, единствената страна, на която може да се вярва, знае коя реплика чете всеки играч и решава какво прави всеки отговор. Един ход от разговора изглежда така:
- Играчът се приближава до NPC и натиска E на неговата подкана Talk. Събитието
Triggeredна подканата се задейства на сървъра с този играч. - Сървърният скрипт проверява дали играчът е достатъчно близо, запомня, че е на репликата с име
start, и праща текста на тази реплика и надписите на вариантите ѝ само на този играч. - LocalScript изписва репликата в диалоговия прозорец, показва балонче над NPC и после добавя по един бутон за всеки вариант.
- Играчът кликва, докосва или избира вариант. Към сървъра се връща само неговият номер.
- Сървърът намира този номер в репликата, която знае, че играчът чете, изпълнява действието на варианта, ако има такова (лечение, предмет), и праща следващата реплика или затваря прозореца.
| Елемент | Къде се намира | Какво прави |
|---|---|---|
Риг Guide | Workspace, в папка с име NPCs | Самият NPC. Името му избира разговора и се показва на подканата. |
ModuleScript DialogueData | ReplicatedStorage | Всички реплики, които NPC може да каже, вариантите под всяка реплика и накъде води всеки вариант. |
Script DialogueService | ServerScriptService | Добавя подканата Talk, помни на коя реплика е всеки играч, проверява всеки клик и изпълнява действията. |
RemoteEvent DialogueEvent | ReplicatedStorage (създава го DialogueService) | Носи всяка реплика до играча, а номера на избрания вариант обратно до сървъра. |
LocalScript DialogueClient | StarterPlayer, StarterPlayerScripts | Рисува прозореца, изписва репликата, показва балончето и бутоните с варианти. |
Tool Torch (по желание) | ServerStorage, в папка с име DialogueItems | Предметът, който дава един от вариантите. Нищо от ServerStorage не се праща на играчите. |
Workspace
NPCs Folder new
Guide Model new
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (части на тялото)
ReplicatedStorage
DialogueData ModuleScript new
ServerScriptService
DialogueService Script new
ServerStorage
DialogueItems Folder new
Torch Tool new
Handle Part new
StarterPlayer
StarterPlayerScripts
DialogueClient LocalScript new
Стъпка 1: добави NPC
- В раздела Avatar или Home натисни Character, за да отвориш Rig Generator. Избери R15, форма на тялото и стил. В Workspace ще се появи риг с име
Rig. Риг R6 работи със същите скриптове. - Преименувай го на
Guide. Името е важно: DialogueService търси разговора по името на модела, а подканата го показва на играчите. - Разгъни рига, избери неговия HumanoidRootPart и отметни Anchored в прозореца Properties. Закотвеният парт никога не се движи от физиката, затова NPC стои там, където си го сложил, и играчите не могат да го бутат.
- Задръж курсора върху Workspace в Explorer, натисни бутона + и вмъкни Folder с име
NPCs. Довлечи Guide в нея и постави рига там, където играчите могат да стигнат. - По желание, за варианта с предмет: задръж курсора върху ServerStorage и вмъкни Folder с име
DialogueItems. Сложи в нея Tool с имеTorchи един незакотвен Part с имеHandle, това е партът, който персонажът държи в ръка. PointLight в Handle ще го накара да свети.
Имената различават главни и малки букви, затова въвеждай NPCs, Guide, DialogueItems и Torch точно както е показано. NPC може да бъде всеки модел с Humanoid и HumanoidRootPart, включително от Toolbox, ако стои направо в папката NPCs.
Стъпка 2: напиши разговора
Задръж курсора върху ReplicatedStorage, вмъкни ModuleScript с име DialogueData и постави в него този код. В него няма логика, само думи и връзките между тях, затова този файл ще редактираш най-често.
-- ModuleScript в ReplicatedStorage с име DialogueData.
-- Всички разговори, по име на NPC в Workspace.NPCs. Всяка реплика има
-- текст на NPC и варианти за отговор на играча. Вариантът може да води към друга реплика (next),
-- да приключва разговора (без next) и да иска от сървъра да направи нещо (action). Ако сървърът
-- не може да изпълни действието, той показва репликата failNext вместо next.
export type Choice = {
text: string,
next: string?, -- реплика, която да се покаже след този вариант; nil приключва разговора
action: string?, -- сървърно действие от таблицата ACTIONS в DialogueService
item: string?, -- за действието GiveItem: името на Tool в ServerStorage.DialogueItems
failNext: string?, -- реплика, която да се покаже вместо next, когато действието не е успяло
}
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
Редовете export type в началото описват как изглеждат репликата и вариантът. По време на игра те не променят нищо; описват данните ти, за да може проверката на типове да ги провери.
Как частите са свързани помежду си:
- Всеки NPC има таблица, наречена по модела му в папката NPCs, тук това е
Guide. Всеки разговор започва с репликатаstart. textе това, което казва NPC.choicesса бутоните на играча, по ред. В прозореца има място за четири.nextпосочва репликата, която да се покаже след този вариант. Вариант безnext, например "Bye!", приключва разговора.nextилиfailNext, който посочва реплика, липсваща в таблицата, също го приключва, с предупреждение в Output.actionпосочва какво прави сървърът, от таблицатаACTIONSв DialogueService: тук това еHealилиGiveItem.itemе нужен за GiveItem: това е името на Tool в ServerStorage, DialogueItems.failNextе репликата, която се показва вместоnext, когато действието не е успяло, за да не твърди NPC никога, че е лекувал или подарил нещо, което не се е случило.
| Реплика | Guide казва | Варианти и накъде водят |
|---|---|---|
start | "Welcome to the village! What can I do for you?" | "Any tips?" води към tips. "I'm hurt. Can you help?" лекува, после healed (или healTooSoon). "Got anything for the cave?" дава Torch, после torch (или hasTorch). "Bye!" приключва разговора. |
tips | "Stay off the red bricks, and come back if you get hurt." | "Anything else?" връща към start. "Thanks!" приключва разговора. |
healed | "There you go, good as new." | "Thank you!" приключва разговора. |
torch | "Take this torch. The cave is dark." | "Thanks!" приключва разговора. |
healTooSoon | "I healed you a moment ago. Come back in a little while." | "OK" приключва разговора. |
hasTorch | "You already have my torch. Keep it lit!" | "Will do!" приключва разговора. |
Този модул се чете само от сървъра. LocalScript никога не го зарежда с require: сървърът праща всяка реплика, когато играчът стигне до нея. Но модулът в ReplicatedStorage все пак се копира на устройството на всеки играч, затова, ако в разговора има спойлери (например отговор на гатанка), премести DialogueData в ServerStorage. После в реда с require в DialogueService замени ReplicatedStorage с ServerStorage, така че целият ред да изглежда така: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.
Стъпка 3: добави сървърния скрипт
Задръж курсора върху ServerScriptService, вмъкни Script с име DialogueService и постави в него кода по-долу. Това е единственото място, където разговорът напредва, и единственото място, където се дава награда.
-- Script в ServerScriptService с име DialogueService.
-- Добавя подкана Talk на всеки NPC в Workspace.NPCs и води всеки разговор.
-- Устройството на играча само показва текста и връща номера на варианта,
-- върху който е кликнал. Сървърът знае на коя реплика е всеки играч, проверява варианта
-- и разстоянието и само той лекува или дава предмети.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Същите форми като в DialogueData, за да ги знае и тук проверката на типове в 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 -- стъда: радиусът на подканата и колко близо трябва да остане играчът
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30
local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")
-- Този скрипт сам създава DialogueEvent, затова не го добавяй ръчно
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 -- няма персонаж, той е мъртъв или NPC е изчезнал
end
-- малък запас, защото позицията на играча стига до сървъра с леко закъснение
return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end
-- Какво прави сървърът, когато вариантът има действие. Всяко връща true, ако е изпълнено.
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 -- лекуван е твърде скоро
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 -- още няма раница или вече има предмета
end
local item = template:Clone() :: Tool
item.CanBeDropped = false -- за да не може никой да го изхвърли и да поиска още един
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 -- вече разговаря, този NPC няма реплика "start", мъртъв е или е твърде далеч
end
local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
conversations[player] = conversation
showLine(player, conversation)
end
-- Играчът е кликнал вариант с номер choiceIndex (0 значи, че е затворил прозореца)
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
-- Твърде бързо. Пращаме същата реплика отново, защото прозорецът вече е блокирал
-- бутоните след клика и иначе щеше да чака отговор вечно.
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 -- на репликата, която чете този играч, няма такъв вариант
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 -- например "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 на всеки 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() -- копие на NPC носи стара подкана, която никой не слуша
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)
-- Затваряме прозореца на всеки, който се е отдалечил или е умрял по средата на разговора
task.spawn(function()
while true do
task.wait(0.5)
for player, conversation in conversations do
if not isClose(player, conversation.npc) then
endConversation(player)
end
end
end
end)
Players.PlayerRemoving:Connect(function(player: Player)
conversations[player] = nil
lastHeal[player] = nil
end)
DialogueService сам създава RemoteEvent DialogueEvent при стартиране на играта, затова не е нужно да вмъкваш ръчно нищо в ReplicatedStorage. Ако вече си създал RemoteEvent с това име, изтрий го: LocalScript може да намери твоя, а него на сървъра никой не го слуша.
| Настройка | Стойност тук | Какво променя |
|---|---|---|
TALK_DISTANCE | 12 | Колко близо, в стъда, трябва да е играчът, за да се появи подканата Talk. Сървърът му позволява да се отдалечи с още 4 стъда, преди да затвори прозореца, защото позицията на играча стига до сървъра с леко закъснение. |
MIN_SECONDS_BETWEEN_CHOICES | 0.3 | Най-краткото време между два клика, което сървърът приема. На по-бърз клик вместо отговор отново се праща същата реплика. |
HEAL_COOLDOWN_SECONDS | 30 | Колко чака всеки играч между две лечения от действието Heal. |
Сървърът пази в conversations по един запис на играч: с кой NPC говори, коя реплика чете и кога е приет последният му клик. Когато подканата Talk се задейства, startConversation създава този запис само ако играчът още не разговаря, NPC има реплика start, а играчът е жив и в радиуса. След това всеки клик минава през тези проверки:
| Проверка | Код | Ако не мине |
|---|---|---|
| Играчът е в разговор | conversations[player] | Кликът се пренебрегва. |
| Вариантът е цяло число | typeof и math.floor | Пренебрегва се. Низове, таблици, дробни числа и NaN спират тук. |
| 0 означава, че играчът е натиснал X | choiceIndex == 0 | Разговорът приключва. |
| Жив е и все още не е по-далеч от 16 стъда (12 плюс 4) | isClose | Разговорът приключва и прозорецът се затваря. |
| Поне 0.3 секунди от последния приет клик | conversation.lastChoice | Същата реплика се праща отново, затова прозорецът получава нови бутони, вместо да чака вечно. |
| Вариантът съществува в репликата, която чете този играч | line.choices[choiceIndex] | Пренебрегва се. |
| Действието е сработило | всяко действие връща true или false | Вместо next се показва репликата failNext. |
Подканата се закача на HumanoidRootPart на NPC, защото ProximityPrompt работи, когато е вътре в парт (или Attachment, или модел с PrimaryPart) в Workspace. Неговото RequiresLineOfSight по подразбиране е включено и скрива подканата винаги, когато нещо закрива гледката от камерата до този парт. Собствения парт на подканата Roblox изключва от тази проверка, но останалото тяло не, а HumanoidRootPart е вътре в торса, затова скриптът изключва проверката за пряка видимост. Подканата се казва TalkPrompt и скриптът изтрива всеки TalkPrompt, който вече е на парта, преди да добави своя: копие на NPC, направено по време на игра, идва с подканата на оригинала, а копираната никой не я слуша. Ако в DialogueData няма разговор с реплика start за името на NPC, в Output се появява предупреждение с името на този NPC.
Цикъл два пъти в секунда проверява всеки отворен разговор и го затваря, когато играчът се е отдалечил на повече от 16 стъда или персонажът му е умрял, за да не се появи отново с отворен прозорец играч, умрял по средата на разговора. PlayerRemoving изчиства и двете таблици, когато някой излезе.
Стъпка 4: добави диалоговия прозорец
Отвори StarterPlayer, задръж курсора върху StarterPlayerScripts, вмъкни LocalScript с име DialogueClient и постави в него този код. Той сглобява диалоговия прозорец в кода, затова не е нужно да рисуваш GUI ръчно.
-- LocalScript в StarterPlayer > StarterPlayerScripts с име DialogueClient.
-- Рисува разговора, който праща сървърът: името на NPC, репликата му, изписвана буква
-- по буква, балонче над главата и по един бутон за всеки вариант. Кликът върху
-- вариант праща само номера му; какво следва, решава сървърът.
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)
-- Диалоговият прозорец, сглобен в кода
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 пиксела по-нагоре, за да не закрива лентата с инструменти на Roblox вариантите
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 -- дългата реплика се смалява, за да се побере на малкия екран на телефона
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- и никога не става по-голяма от 20 пиксела на голям екран
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 -- расте с всяка нова реплика, за да спре старият цикъл на изписване
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 -- променя се само на това устройство
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()
-- Балонче над NPC (DisplayBubble работи само в LocalScript)
local head = npc:FindFirstChild("Head")
if head then
TextChatService:DisplayBubble(head, text)
end
-- Изписваме репликата буква по буква. Броят се изчислява от изминалото време,
-- затова скоростта е еднаква при всяка честота на кадрите.
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 -- тази реплика е заменена от по-нова или от затваряне
end
shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
lineLabel.MaxVisibleGraphemes = shown
end
lineLabel.MaxVisibleGraphemes = -1
-- По един бутон за вариант; сървърът получава само номера на бутона
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 -- един клик на реплика
dialogueEvent:FireServer(index)
end
end)
if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = button -- за да може вариантът да се избере с геймпад
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)
Цветовете, размерите и LETTERS_PER_SECOND можеш да променяш както искаш. Последните два обработчика остави както са: това е единственият начин, по който прозорецът общува със сървъра.
Какво прави всяка част на DialogueClient:
- Прозорецът. ScreenGui с Frame, закрепен долу в центъра на екрана, 60% от ширината му и 34% от височината, с ограничение 720 на 300 пиксела чрез
UISizeConstraint, за да не се разтяга по целия широк монитор. Репликата на NPC използваTextScaled, което смалява текста, за да се побере в своя етикет на малкия екран на телефона, аUITextSizeConstraintне му дава да стане по-голям от 20 пиксела на голям екран.UIGridLayoutподрежда вариантите две на две.ResetOnSpawnе false, защото този LocalScript се пуска веднъж на сесия: прозорец, изтрит при повторно появяване, нямаше да се върне. - Ефектът на пишеща машина. Цялата реплика влиза в TextLabel наведнъж, а
MaxVisibleGraphemesрешава колко символа се виждат; това е същото свойство, което използва собственият пример на Roblox за пишеща машина заедно сutf8.graphemes. Roblox подрежда текста така, сякаш се виждат всички символи, затова думите не прескачат на нов ред и не менят размера си, докато се появяват. Скриптът изчислява колко символа да покаже от изминалото време, 45 в секунда, затова скоростта е еднаква при всяка честота на кадрите, а после задава на свойството -1, което показва всичко. - Бутоните. Появяват се, когато репликата е изписана. Всеки праща само своя номер и само веднъж: проверката
lineNumberне позволява двоен клик да прати два пъти, а след това прозорецът чака следващата реплика от сървъра. - Балончето с репликата.
TextChatService:DisplayBubble(head, text)слага репликата в балонче на чата над Head на NPC. Roblox позволява това само в клиентски скриптове, а bubble chat е включен по подразбиране. Балончето се рисува от устройството на този играч, затова го вижда само той. - Подканата. Докато играчът разговаря, неговото копие на подканата Talk (намира се по името TalkPrompt) е изключено, за да не виси върху разговора. Другите играчи продължават да виждат своите.
- Всяко устройство.
Activatedсе задейства при клик с мишка, докосване на телефон и бутона A на геймпад. Геймпадът може да натисне само избрания бутон, затова, когатоPreferredInputказва, че играчът използва геймпад, скриптът избира първия вариант чрезGuiService.SelectedObject. - Бутонът X. Той праща 0, което сървърът разбира като „приключи разговора“, и веднага затваря прозореца.
Добави свои действия
Действието е функция в таблицата ACTIONS в началото на DialogueService. Тя получава играча и варианта и връща true, когато е свършила работата си. За да добавиш свое, например куест, който дава NPC:
- Добави в
ACTIONSзапис с имеStartQuest. Първо проверката, после промяната: акоplayer:GetAttribute("Quest")вече е зададен, върниfalse; иначе извикайplayer:SetAttribute("Quest", "Cave")и върниtrue. - В DialogueData задай на варианта
action = "StartQuest", репликаnextза успех и репликаfailNextза неуспех, например "You are already on a quest." - Натисни Play и избери варианта два пъти. Ако името в DialogueData не съвпада с ключа в
ACTIONS(главните букви имат значение), в Output ще се появиDialogueService: no action named StartQuest, а разговорът ще премине към репликатаfailNext.
Правила за писане на действия:
- Прави проверката и промяната вътре в действието, на сървъра. Единственото, което праща устройството на играча, е номерът на варианта.
- Това, което трябва на действието, чети от варианта (като
item) или от собственото състояние на сървъра, но никога от ремоута. - Ограничавай всичко ценно вътре в самото действие, точно както Heal пази собствен кулдаун от 30 секунди в
lastHeal. Лимитът от 0.3 секунди на клик само забавя кликовете; той не пречи на играча да минава през един и същ вариант отново и отново. - За да отвори друг прозорец, например магазин, действието може да прати RemoteEvent на този играч и да върне
true. Всичко, което се случва в този прозорец, пак изисква свои сървърни проверки, както в раздела NPC продавач.
Къде грешат другите уроци за диалог с NPC
Ако сравняваш това ръководство с видео или пост във форум, ето важните разлики и причината, поради която всеки похват създава проблем.
| Урокът | Проблемът | Това ръководство |
|---|---|---|
Използва обекта Dialog, а сървърен Script слуша DialogChoiceSelected, за да даде награда | В справката на Roblox пише, че това събитие работи само от страната на клиента и няма да се задейства на сървъра, затова наградата никога не идва. | Вариантът стига до сървъра като число и сървърът сам дава наградата. |
| Дава наградата от LocalScript | Промяна, направена от LocalScript, остава на това едно устройство (виж какво се репликира), а читър може да пусне същия код когато поиска. | Всички действия живеят в DialogueService. |
Кара NPC да говори чрез game:GetService("Chat"):Chat(head, text) | Услугата Chat е остаряла, вместо нея се използва TextChatService. | TextChatService:DisplayBubble в LocalScript. |
| Праща от клиента името на наградата или id на следващата реплика | Читър може да прати всяко име на предмет или да прескочи направо до репликата, която дава награда. | Клиентът праща само номера на варианта. Сървърът го намира в репликата, която знае, че играчът чете. |
| Не проверява нищо след задействането на подканата | Ръководството на Roblox за сигурност слага ProximityPrompt до ремоутите като нещо, с което клиентите могат да злоупотребят, и съветва преди действие да се проверява дали играчът е достатъчно близо. | Разстоянието се проверява при започване на разговора, при всеки клик и два пъти в секунда, докато той е отворен. |
Изписва текста чрез wait() в цикъл | Глобалното wait е остаряло, вместо него се използва task.wait. | Изчислява броя видими букви от os.clock() и чака чрез task.wait(). |
Какво играчът може и какво не може да подправи
Приеми, че читърът управлява всичко на своето устройство. Той може да чете твоите LocalScript и всичко в ReplicatedStorage, да извиква DialogueEvent с всякакви аргументи колкото пъти иска и да задейства подканата Talk от код, за което предупреждава ръководството на Roblox за сигурност. DialogueService отговаря със сървърни проверки от същия вид като разгледаните в раздела проверка на аргументите на RemoteEvent. Ето какво печели читърът от това.
| Читърът опитва | Резултат | Защо |
|---|---|---|
| Да задейства подканата Talk от другия край на картата | Нищо не става | startConversation проверява, че не е по-далеч от 16 стъда (12 плюс 4). |
| Да прати вариант 99, низ, дробно число или NaN | Пренебрегва се | Не е цяло число или такъв вариант няма в репликата, която чете. |
| Да прати име на награда или id на реплика | Никога не се чете | Сървърът чете само номера на варианта. Наградите се вземат от полетата item и action на сървърното копие на репликата. |
| Да кликва толкова бързо, колкото позволява мрежата | Един клик на 0.3 секунди на разговор | При по-бързи кликове се връща същата им реплика. Приключването и рестартирането на разговора заобикалят това чакане, затова Heal и GiveItem пазят собствени лимити. |
| Да поиска факел без разговор | Невъзможно | Предметите се дават само за вариант от репликата, на която сървърът знае, че е играчът. |
| Да събере куп факли | По един наведнъж | Сървърът първо търси Torch в неговия Backpack и персонаж, а дадената факла не може да се изхвърли, затова не може да се фармят, като се изхвърлят и се искат отново. |
| Да спами репликата с лечение | Едно лечение на 30 секунди | Кулдаунът се пази на сървъра за всеки играч, а NPC съобщава за него с репликата healTooSoon. |
| Да се отдалечи и да остави прозореца отворен | Затваря се до половин секунда | Сървърът проверява всеки отворен разговор два пъти в секунда. |
| Да прочете целия разговор, включително реплики, до които не е стигнал | Възможно | DialogueData е в ReplicatedStorage, който се копира на всяко устройство. Премести го в ServerStorage, ако това е важно (виж стъпка 2). |
За едно ограничение си струва да се каже направо: читър, който се приближи до Guide и избира варианти, получава точно същото като честния играч. Сървърът управлява колко често и откъде, но не и кой. Всичко рядко, например награда, която всеки играч може да получи веднъж, изисква проверка, която е на сървъра, като атрибут, зададен при получаването, или флаг, запазен в хранилище за данни.
Стъпка 5: тествай
- Натисни Play (F5) и се приближи до Guide. В рамките на 12 стъда се появява подканата Talk с името Guide. Натисни E.
- Прозорецът показва "Guide", изписва приветствената реплика и после показва четири бутона. Същата реплика се появява в балонче над главата на NPC.
- Избери "Any tips?", после "Anything else?": отново си на първата реплика. Избери "Bye!": прозорецът се затваря и подканата Talk се връща.
- Първо си нанеси щета: натисни превключвателя Client/Server, за да минеш на Server, избери Humanoid на своя персонаж в Workspace, задай Health на 50 в прозореца Properties и превключи обратно на Client. Персонажите на играчите възстановяват 1% от MaxHealth всяка секунда, затова веднага заговори Guide и избери "I'm hurt. Can you help?": здравето скача до пълно. Заговори го отново до 30 секунди и избери това пак: лечение няма, а Guide казва, че те е лекувал преди малко.
- Избери "Got anything for the cave?": Torch се появява в хотбара. Екипирай го и натисни Backspace: остава в ръката. Поискай отново: втори факел няма, а Guide казва, че вече го имаш.
- Започни разговор и се отдалечи. Прозорецът се затваря горе-долу когато си на 16 стъда от Guide.
- Избери Server & Clients в падащия списък с режими за тест, задай 2 клиента и натисни Play. И двамата играчи могат да говорят с Guide едновременно, всеки на своя реплика.
- Тествай геймпад чрез Controller Emulator (Controller в раздела Emulation) по време на плейтест. С емулирания геймпад се приближи и натисни бутона на подканата (по подразбиране ButtonX): когато се появят вариантите, първият вече е избран и A го натиска.
- Тествай екрана на телефон чрез Device Simulator в Studio (към момента на писане е бета: включи New Device Simulator във File, Beta Features и рестартирай Studio). Избери телефон, натискай Rotate, докато не е в хоризонтална ориентация, натисни Play, приближи се до Guide и докосни подканата Talk. Избери "Any tips?": цялата реплика се вижда над бутоните с варианти, при нужда с по-дребен текст, и не застъпва бутоните.
През цялото време дръж прозореца Output отворен (менюто Window, после Output). Когато тези скриптове работят, те не печатат нищо, затова всяка червена грешка или предупреждение, започващо с DialogueService:, е истински проблем. Виж Чести грешки.
Как да го разшириш
Повече NPC и по-дълги разговори
Добави в папката NPCs още един риг със свое име, а в DialogueData таблица със същото име и реплика start. DialogueService добавя подкана Talk на всеки модел в папката, който има HumanoidRootPart, включително добавените по време на игра; копие на NPC получава нова подкана вместо тази, с която е копирано. Два NPC с еднакво име използват една таблица. Репликите могат да се свързват в произволен ред, а вариант може да води обратно към по-ранна реплика, като "Anything else?". Дръж на реплика не повече от четири варианта, защото прозорецът ги подрежда две на две.
Реплики, които зависят от напредъка
За да поздравяваш по различен начин върналите се играчи, избирай първата реплика по нещо, което е на сървъра. В startConversation я избери чрез local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", провери дали репликата съществува, точно както скриптът проверява lines.start, и използвай firstLine вместо "start" при създаването на разговора. Задавай атрибута в действие и добави реплика welcomeBack в таблицата на Guide. Атрибутите живеят една сесия; за да помниш играча между посещенията, запазвай флаг в хранилище за данни, както в урока за DataStore.
NPC продавач
Направи магазин по ръководството за GUI на магазин, после добави действие OpenShop, което праща RemoteEvent на този играч и връща true, и нека LocalScript на магазина отваря своя прозорец, когато дойде това събитие. Покупките пак минават през собствените сървърни проверки на магазина. Ако може да се купува само близо до NPC, проверявай разстоянието и в обработчика на покупката, защото клиентът може да извика ремоута на магазина отвсякъде.
NPC, които ходят
За да се разхожда Guide или да следва играчите, вземи ръководството за намиране на път за NPC и махни Anchored от HumanoidRootPart, за да може да се движи. Подканата Talk е на този парт, затова се движи заедно с NPC, а проверките на разстоянието използват същия парт. Спирай ходенето на пауза, докато разговорът е отворен, иначе прозорецът ще се затвори, щом NPC се отдалечи от играча на повече от 16 стъда.
Ключове, куестове и други награди
GiveItem дава всеки Tool от DialogueItems, затова NPC може да даде ключ, който заключена врата проверява, както в ръководството за врати. За предмети, които правят нещо при използване, например храна, която лекува, прочети ръководството за инвентар.
Звуци и камера
За гласов клип или кратък звук на всяка реплика сложи Sound в Head на NPC и го пускай от show в DialogueClient. За да насочиш камерата към NPC, докато говори, ръководството за катсцени показва как LocalScript поема управлението на камерата и го връща.
Чести грешки и решения
Отвори прозореца Output (менюто Window, после Output), преди да натиснеш Play. Повечето проблеми с диалога печатат там предупреждение или идват от име, което не съвпада.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'
DialogueClient чака ремоута, който създава DialogueService, значи DialogueService не е стигнал до това място. Провери, че е Script, а не LocalScript, че е направо в ServerScriptService и не е изключен. DialogueService първо чака DialogueData в ReplicatedStorage и папката NPCs в Workspace, затова липсата им или грешка в името също го спира; тогава Output показва предупреждение infinite yield от DialogueService с това име.
Над моя NPC не се появява подканата Talk
DialogueService добавя подкани само на модели, които са направо в Workspace, NPCs и имат парт с име HumanoidRootPart. Провери и двете условия и се приближи на по-малко от 12 стъда. Риг от Toolbox може да няма този парт или да е обект от друг тип, увит в папка.
Подканата се появява, но натискането на E не прави нищо
Сървърът не е намерил разговор за този NPC и при стартиране на играта Output показва DialogueService: no conversation with a start line for Guide in DialogueData с името на твоя NPC. Таблицата в DialogueData трябва да се казва точно като модела, включително главните букви, и да съдържа реплика start.
Вариантът затваря прозореца, вместо да премине към следващата реплика
Output показва DialogueService: no line named tip for Guide in DialogueData с твоите имена: next (или failNext) на варианта посочва реплика, която я няма в таблицата на този NPC. Имената на репликите различават главни и малки букви, затова сравни изписването с таблицата, тук това е tips.
Прозорецът работи, но балонче с репликата няма
Балончето изисква парт с име Head направо в модела на NPC и включен bubble chat: в Explorer избери BubbleChatConfiguration под TextChatService и провери дали Enabled е отметнато. По подразбиране е включено.
В Output пише DialogueService: no Tool named Torch in ServerStorage.DialogueItems
Сървърът не е намерил предмета. Провери дали папката в ServerStorage се казва DialogueItems и дали в нея има Tool (не Model и не Part) с име точно като в item на варианта. Докато не го оправиш, Guide отговаря с репликата hasTorch, защото действието не е успяло.
В Output пише DialogueService: no action named ...
action на варианта не съвпада с нито един ключ в таблицата ACTIONS. Имената различават главни и малки букви: heal не е Heal.
Направи го с RoCode
Ако ти е по-лесно да опишеш NPC, отколкото да го сглобиш ръчно, RoCode може да напише тези скриптове направо в плейса, който имаш отворен. Това е независим ИИ агент за Roblox Studio, който не е от Roblox: пишеш в уеб чата, а плъгинът му за Studio създава и редактира скриптове в твоя Explorer.
Накарай модела Guide в Workspace.NPCs да говори: подкана Talk, диалогов прозорец с изписващи се реплики и бутони с варианти, балонче над главата, вариант с лечение с кулдаун 30 секунди и вариант, който веднъж дава инструмента Torch от ServerStorage. Пази разговора в ModuleScript и давай всички награди на сървъра.
- Може първо да разгледа модела чрез Get Properties, за да прочете ключови стойности като Anchored на партовете му и WalkSpeed на неговия Humanoid. Напиши / в чата, за да прикачиш точния път до модела
- Пише ModuleScript DialogueData, Script DialogueService и LocalScript DialogueClient чрез Create Script
- Казано му е да проверява компилацията на всеки написан скрипт чрез Check Script, който го компилира в Studio, без да го пуска
- Праща промените на пакети и всеки пакет е точка за отмяна в историята на Studio
С плъгин 3.9 или по-нов RoCode може да пусне кратък плейтест и да прочете грешките, а с плъгин 3.9.11 или по-нов може да управлява тестов персонаж, за да провери дали играта работи, но по време на игра не прави екранни снимки, затова се приближи до NPC и поговори с него сам. Ако нещо не работи както трябва, кажи на RoCode какво си видял: Check Output може да прочете редовете Server и Client от последния ти плейтест. Говорещият NPC е една система от много; страницата как да създадеш игра в Roblox с ИИ, по една система на промпт показва как те се съчетават. Как RoCode се свързва със Studio.
Често задавани въпроси
Как да направя говорещ NPC в Roblox Studio?
Добави на NPC ProximityPrompt и когато играчът го задейства, показвай репликата на NPC в диалогов прозорец, в балонче или и на двете места. Трите скрипта от това ръководство правят и двете и добавят варианти за отговор. Ако ти трябва само балонче, извикай TextChatService:DisplayBubble(npc.Head, "Hello!") от LocalScript при задействане на подканата, както в примера с NPC на страницата на Roblox за bubble chat.
Какво да избера: обекта Dialog или собствен GUI за диалог?
Обектът Dialog не изисква код и показва кликаемо балонче, което стига за декоративен текст. Събитието му за избор се задейства само на устройството на играча, затова не може да дава награди безопасно, а по подразбиране с него може да говори само един играч наведнъж. Собственият прозорец, като в това ръководство, позволява на сървъра да дава всяка награда и дава на всеки играч свой разговор.
Как да дам на играча предмет от NPC?
Пази Tool в ServerStorage и нека сървърен Script го клонира в Backpack на играча, когато той избере този вариант, както прави действието GiveItem. Проверявай дали играчът вече няма такъв и изключвай CanBeDropped на копието, за да не може да се изхвърли и да се поиска отново. Никога не позволявай на устройството на играча да казва кой предмет да се даде.
Как да направя диалогов прозорец с ефект на пишеща машина?
Сложи цялата реплика в TextLabel, увеличавай неговото MaxVisibleGraphemes от 0 с по няколко символа наведнъж, а накрая задай -1, за да се покаже всичко. Страницата на Roblox за UI анимация използва същото свойство заедно с utf8.graphemes. DialogueClient изчислява колко символа да покаже от изминалото време, 45 в секунда, затова скоростта не зависи от честотата на кадрите.
Могат ли двама играчи да говорят с един NPC едновременно?
Със скриптовете от това ръководство да: сървърът води по един разговор на играч и всеки играч вижда само своя прозорец. Вграденият обект Dialog работи иначе: с неговия BehaviorType по подразбиране, SinglePlayer, говори един играч наведнъж, а останалите виждат неговите варианти.
Трябва ли да филтрирам текста на диалога на NPC?
Репликите, които си написал сам, не. Roblox ти възлага отговорността да филтрираш показван текст, който не контролираш пряко, например това, което пишат играчите, думи, съставени от случайни символи, или текст, зареден от външен сайт. Ако NPC повтаря нещо, въведено от играч, филтрирай тази част.
Източници и какво да прочетеш
- Roblox Creator Docs: Proximity prompts (на английски). създаване на подкани, MaxActivationDistance и RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (на английски). къде работи подканата, текстът и клавишите ѝ по подразбиране, Triggered и проверката за пряка видимост
- Roblox Creator Docs: Securing the client-server boundary (на английски). ProximityPrompt като повърхност за атака, проверки на разстоянието и правата
- Roblox Engine API: Dialog (на английски). BehaviorType и събитието DialogChoiceSelected само на клиента
- Roblox Engine API: TextChatService:DisplayBubble (на английски). балончета с реплики за NPC от клиентски скриптове
- Roblox Creator Docs: Customize bubble chat (на английски). балончета на NPC и BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (на английски). кой показван текст трябва да се филтрира
- Roblox Creator Docs: UI animation and tweens (на английски). ефект на пишеща машина чрез MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (на английски). какво прави Backspace с инструмента
- Roblox Engine API: UserInputService.PreferredInput (на английски). как да разпознаеш играч с геймпад
- Roblox Creator Docs: Rig Generator (на английски). вмъкване на риг R15 или R6
Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.