Коротко
Положите модель 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, 12 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.