Kısaca
NPC modelini Workspace'te NPCs adlı bir klasöre koy ve konuşmasını ReplicatedStorage içindeki bir ModuleScript'e yaz: her replikte NPC'nin metni ve başka bir repliğe götüren seçeneklerin listesi var. ServerScriptService içindeki bir Script her NPC'ye bir ProximityPrompt ("Talk") ekler, her oyuncunun hangi replikte olduğunu hatırlar ve onu bir RemoteEvent ile gönderir. Bir LocalScript metni ve her seçenek için bir buton gösterir, geriye sadece basılan butonun numarasını gönderir.
- Ödülleri sunucuda ver. Yerleşik Dialog nesnesinin
DialogChoiceSelectedevent'i sadece istemcide tetiklenir, yani bir sunucu Script'i onu hiç almaz; bir LocalScript'te verilen can ya da eşya da sadece o oyuncunun oyun kopyasını değiştirir. - Bir LocalScript'ten
TextChatService:DisplayBubble(npc.Head, text)ile bir konuşma balonu göster. EskiChatservisi kullanımdan kalktı ve yerine TextChatService geldi. - Kendi yazdığın repliklerin filtrelenmesi gerekmez. Roblox'un kuralı, üzerinde açık bir kontrolün olmayan, oyuncuların yazdıkları gibi gösterilen her metni filtrelemek.
Bu sayfada
NPC diyaloğu nasıl çalışır
Canlı bir oyunda çalışan konuşan bir NPC, sunucu ile her oyuncunun cihazı arasında paylaşılmıştır. Cihaz kutuyu ve butonları çizer. Güvenebileceğin tek taraf olan sunucu ise her oyuncunun hangi repliği okuduğunu bilir ve her cevabın ne yapacağına karar verir. Konuşmanın bir turu şöyle ilerler:
- Oyuncu NPC'ye yaklaşır ve onun Talk prompt'unda E'ye basar. Prompt'un
Triggeredevent'i sunucuda o oyuncuyla tetiklenir. - Sunucu scripti oyuncunun yeterince yakın olduğunu kontrol eder,
startadlı replikte olduğunu not eder ve o repliğin metnini ve seçeneklerinin etiketlerini sadece o oyuncuya gönderir. - LocalScript repliği konuşma kutusuna yazar, NPC'nin üstünde bir konuşma balonu gösterir, sonra her seçenek için bir buton ekler.
- Oyuncu bir seçeneğe tıklar, dokunur ya da onu seçer. Sunucuya sadece numarası geri döner.
- Sunucu o numarayı oyuncunun okuduğunu bildiği replikte arar, seçeneğin bir eylemi varsa (can, eşya) onu çalıştırır ve bir sonraki repliği gönderir ya da kutuyu kapatır.
| Parça | Nereye gider | Ne yapar |
|---|---|---|
Guide rig'i | Workspace, NPCs adlı bir klasörde | NPC'nin kendisi. Adı konuşmasını seçer ve prompt'ta görünür. |
DialogueData ModuleScript'i | ReplicatedStorage | NPC'nin söyleyebileceği tüm replikler, her repliğin seçenekleri ve her seçeneğin nereye götürdüğü. |
DialogueService Script'i | ServerScriptService | Talk prompt'unu ekler, her oyuncunun hangi replikte olduğunu hatırlar, her tıklamayı kontrol eder ve eylemleri çalıştırır. |
DialogueEvent RemoteEvent'i | ReplicatedStorage (DialogueService oluşturur) | Her repliği oyuncuya, seçilen seçeneğin numarasını da sunucuya geri taşır. |
DialogueClient LocalScript'i | StarterPlayer, StarterPlayerScripts | Kutuyu çizer, repliği yazar, konuşma balonunu ve seçenek butonlarını gösterir. |
Torch Tool'u (isteğe bağlı) | ServerStorage, DialogueItems adlı bir klasörde | Seçeneklerden birinin verdiği eşya. ServerStorage'daki hiçbir şey oyunculara gönderilmez. |
Workspace
NPCs Folder new
Guide Model new
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (vücut parçaları)
ReplicatedStorage
DialogueData ModuleScript new
ServerScriptService
DialogueService Script new
ServerStorage
DialogueItems Folder new
Torch Tool new
Handle Part new
StarterPlayer
StarterPlayerScripts
DialogueClient LocalScript new
1. adım: bir NPC ekle
- Avatar ya da Home sekmesinde Rig Generator'ı açmak için Character'a tıkla. R15'i, bir vücut şeklini ve bir stili seç. Workspace'te
Rigadlı bir rig belirir. Bir R6 rig'i de aynı scriptlerle çalışır. - Adını
Guideyap. Ad önemli: DialogueService konuşmayı modelin adına göre arar ve prompt bunu oyunculara gösterir. - Rig'i aç, HumanoidRootPart'ını seç ve Properties penceresinde Anchored'ı işaretle. Anchored bir parça fizikle asla hareket etmez, yani NPC koyduğun yerde kalır ve oyuncular onu itemez.
- Explorer'da fareyle Workspace üzerine gel, + butonuna tıkla ve
NPCsadlı bir Folder ekle. Guide'ı içine sürükle ve rig'i oyuncuların yaklaşabileceği bir yere koy. - İsteğe bağlı, eşya seçeneği için: fareyle ServerStorage üzerine gel ve
DialogueItemsadlı bir Folder ekle. İçineTorchadlı bir Tool koy; içinde de bir karakterin tuttuğu parça olan, anchored olmayanHandleadlı bir Part olsun. Handle içindeki bir PointLight onu parlatır.
Adlar büyük küçük harfe duyarlı, bu yüzden NPCs, Guide, DialogueItems ve Torch'u tam gösterildiği gibi yaz. Humanoid'i ve HumanoidRootPart'ı olan her model bir NPC olabilir, Toolbox'tan gelen biri de dahil, yeter ki doğrudan NPCs klasörünün içinde olsun.
2. adım: konuşmayı yaz
Fareyle ReplicatedStorage üzerine gel, DialogueData adlı bir ModuleScript ekle ve bunu yapıştır. İçinde mantık yok, sadece sözler ve nasıl bağlandıkları var, yani en çok düzenleyeceğin dosya bu.
-- ReplicatedStorage içinde DialogueData adlı ModuleScript.
-- Tüm konuşmalar, Workspace.NPCs içindeki NPC adına göre. Her replikte NPC'nin
-- metni ve oyuncunun seçenekleri var. Bir seçenek başka bir repliğe götürebilir (next),
-- konuşmayı bitirebilir (next yok) ve sunucudan bir şey yapmasını isteyebilir (action). Sunucu
-- eylemi yapamazsa next yerine failNext repliğini gösterir.
export type Choice = {
text: string,
next: string?, -- bu seçenekten sonra gösterilen replik; nil konuşmayı bitirir
action: string?, -- DialogueService'in ACTIONS tablosundaki bir sunucu eylemi
item: string?, -- GiveItem eylemi için: ServerStorage.DialogueItems içindeki bir Tool'un adı
failNext: string?, -- eylem yapılamadığında next yerine gösterilen replik
}
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
Baştaki export type satırları bir repliğin ve bir seçeneğin neye benzediğini tarif eder. Oyun çalışırken hiçbir şeyi değiştirmezler; verini bir tip denetleyicisinin kontrol edebilmesi için tarif ederler.
Parçalar nasıl bağlanıyor:
- Her NPC'nin NPCs klasöründeki model adını taşıyan bir tablosu var, burada
Guide. Her konuşmastartadlı replikte başlar. textNPC'nin söylediği şey.choicessırayla oyuncunun butonları. Kutuya dört tane sığar.nexto seçenekten sonra gösterilecek repliğin adı. "Bye!" gibinext'i olmayan bir seçenek konuşmayı bitirir. Tabloda olmayan bir repliği adlandıran birnextya dafailNextda konuşmayı bitirir, Output'ta bir uyarıyla.action, DialogueService'inACTIONStablosundan sunucunun yaptığı bir şeyin adı: buradaHealya daGiveItem.itemGiveItem için: ServerStorage, DialogueItems içindeki bir Tool'un adı.failNext, eylem yapılamadığındanextyerine gösterilen replik; böylece NPC olmayan bir iyileştirmeyi ya da hediyeyi asla iddia etmez.
| Replik | Guide ne diyor | Seçenekler ve nereye götürdükleri |
|---|---|---|
start | "Welcome to the village! What can I do for you?" | "Any tips?" tips'e götürür. "I'm hurt. Can you help?" iyileştirir, sonra healed (ya da healTooSoon). "Got anything for the cave?" Torch'u verir, sonra torch (ya da hasTorch). "Bye!" bitirir. |
tips | "Stay off the red bricks, and come back if you get hurt." | "Anything else?" start'a döner. "Thanks!" konuşmayı bitirir. |
healed | "There you go, good as new." | "Thank you!" bitirir. |
torch | "Take this torch. The cave is dark." | "Thanks!" bitirir. |
healTooSoon | "I healed you a moment ago. Come back in a little while." | "OK" bitirir. |
hasTorch | "You already have my torch. Keep it lit!" | "Will do!" bitirir. |
Bu modülü sadece sunucu okur. LocalScript ona asla require yapmaz: oyuncu bir repliğe ulaştığında sunucu onu gönderir. Yine de ReplicatedStorage'daki bir modül her oyuncunun cihazına kopyalanır, bu yüzden bir konuşmada spoiler varsa (örneğin bir bilmecenin cevabı) DialogueData'yı ServerStorage'a taşı. Sonra DialogueService'teki require satırında ReplicatedStorage'ı ServerStorage ile değiştir, böylece satırın tamamı local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } } olur.
3. adım: sunucu scriptini ekle
Fareyle ServerScriptService üzerine gel, DialogueService adlı bir Script ekle ve aşağıdaki kodu yapıştır. Bir konuşmanın ilerlediği tek yer ve bir ödülün verildiği tek yer burası.
-- ServerScriptService içinde DialogueService adlı Script.
-- Workspace.NPCs içindeki her NPC'ye bir Talk prompt'u ekler ve her konuşmayı yönetir.
-- Oyuncunun cihazı sadece metni gösterir ve tıkladığı seçeneğin numarasını
-- geri gönderir. Sunucu her oyuncunun hangi replikte olduğunu bilir, seçeneği
-- ve mesafeyi kontrol eder ve iyileştiren ya da eşya veren tek taraftır.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- DialogueData'dakiyle aynı şekiller, böylece Studio'nun tip denetleyicisi onları burada da bilir
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 -- stud: prompt'un menzili ve bir oyuncunun ne kadar yakın kalması gerektiği
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30
local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")
-- Bu script DialogueEvent'i kendisi oluşturur, o yüzden elle bir tane ekleme
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 -- karakter yok, ölü ya da NPC artık yok
end
-- biraz pay, çünkü oyuncunun konumu sunucuya küçük bir gecikmeyle ulaşır
return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end
-- Bir seçeneğin eylemi olduğunda sunucunun yaptığı şey. Her biri yaptıysa true döndürür.
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 -- çok kısa süre önce iyileşti
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 -- henüz backpack yok ya da zaten bir tane var
end
local item = template:Clone() :: Tool
item.CanBeDropped = false -- böylece kimse onu bırakıp yenisini isteyemez
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 -- zaten konuşuyor, bu NPC için "start" repliği yok, ölü ya da çok uzakta
end
local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
conversations[player] = conversation
showLine(player, conversation)
end
-- Oyuncu choiceIndex numaralı seçeneğe tıkladı (0 kutuyu kapattığı anlamına gelir)
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
-- Çok hızlı. Aynı repliği tekrar gönder, çünkü kutu tıklamadan sonra butonlarını
-- zaten kilitledi ve yoksa sonsuza kadar bir cevap bekler.
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 -- bu oyuncunun okuduğu replikte böyle bir seçenek yok
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 -- örneğin "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)
-- Her NPC'de bir Talk prompt'u
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() -- bir NPC kopyası eski prompt'u getirir, onu hiçbir şey dinlemez
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)
-- Konuşmanın ortasında uzaklaşan ya da ölen birinin kutusunu kapat
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, oyun başladığında DialogueEvent RemoteEvent'ini kendisi oluşturur, yani ReplicatedStorage'a elle eklenecek bir şey yok. O adla zaten bir RemoteEvent yaptıysan onu sil: LocalScript seninkini bulabilir ve onu sunucuda hiçbir şey dinlemiyor.
| Ayar | Buradaki değer | Neyi değiştirir |
|---|---|---|
TALK_DISTANCE | 12 | Talk prompt'unun çıkması için bir oyuncunun stud cinsinden ne kadar yakın olması gerektiği. Sunucu kutuyu kapatmadan önce oyuncunun 4 stud daha uzaklaşmasına izin verir, çünkü konumu sunucuya küçük bir gecikmeyle ulaşır. |
MIN_SECONDS_BETWEEN_CHOICES | 0.3 | Sunucunun kabul ettiği iki tıklama arasındaki en kısa süre. Daha hızlı bir tıklama cevap yerine aynı repliği tekrar alır. |
HEAL_COOLDOWN_SECONDS | 30 | Her oyuncunun Heal eyleminin iki iyileştirmesi arasında ne kadar beklediği. |
Sunucu conversations içinde her oyuncu için bir girdi tutar: hangi NPC ile konuştuğu, hangi repliği okuduğu ve son tıklamasının ne zaman kabul edildiği. Talk prompt'u tetiklendiğinde startConversation bu girdiyi sadece oyuncu zaten konuşmuyorsa, NPC'nin bir start repliği varsa ve oyuncu canlı ve menzil içindeyse oluşturur. Ondan sonra her tıklama şu kontrollerden geçer:
| Kontrol | Kod | Başarısız olursa |
|---|---|---|
| Oyuncu bir konuşmada | conversations[player] | Tıklama yok sayılır. |
| Seçenek bir tam sayı | typeof ve math.floor | Yok sayılır. String'ler, tablolar, kesirler ve NaN burada durur. |
| 0, oyuncunun X'e bastığı anlamına gelir | choiceIndex == 0 | Konuşma biter. |
| Canlı ve hâlâ 16 studdan yakın (12 artı 4) | isClose | Konuşma biter ve kutu kapanır. |
| Son kabul edilen tıklamadan bu yana en az 0.3 saniye | conversation.lastChoice | Aynı replik tekrar gönderilir, böylece kutu sonsuza kadar beklemek yerine yeni butonlar alır. |
| Seçenek bu oyuncunun okuduğu replikte var | line.choices[choiceIndex] | Yok sayılır. |
| Eylem çalıştı | her eylem true ya da false döndürür | next yerine failNext repliği gösterilir. |
Prompt NPC'nin HumanoidRootPart'ına gidiyor, çünkü bir ProximityPrompt Workspace'teki bir parçanın (ya da bir attachment'ın veya PrimaryPart'ı olan bir modelin) içindeyken çalışır. RequiresLineOfSight varsayılan olarak açık gelir ve kameradan o parçaya bakışı bir şey kapattığında prompt'u gizler. Roblox prompt'un kendi parçasını bu kontrolün dışında tutar ama vücudun geri kalanını değil, HumanoidRootPart da gövdenin içinde; bu yüzden script görüş hattını kapatıyor. Prompt'un adı TalkPrompt ve script kendisininkini eklemeden önce parçada zaten olan her TalkPrompt'u siler: oyun çalışırken yapılan bir NPC kopyası orijinalin prompt'uyla gelir ve kopyalanmış bir prompt'u hiçbir şey dinlemez. DialogueData'da NPC'nin adı için start repliği olan bir konuşma yoksa Output NPC'nin adıyla bir uyarı gösterir.
Bir döngü her açık konuşmayı saniyede iki kez kontrol eder ve oyuncu 16 studdan uzaktaysa ya da karakteri öldüyse onu kapatır; böylece konuşmanın ortasında ölen bir oyuncu kutu hâlâ açıkken yeniden doğmaz. Biri çıktığında PlayerRemoving iki tabloyu da temizler.
4. adım: konuşma kutusunu ekle
StarterPlayer'ı aç, fareyle StarterPlayerScripts üzerine gel, DialogueClient adlı bir LocalScript ekle ve bunu yapıştır. Konuşma kutusunu kodla kurar, yani elle çizilecek bir GUI yok.
-- StarterPlayer > StarterPlayerScripts içinde DialogueClient adlı LocalScript.
-- Sunucunun gönderdiği konuşmayı çizer: NPC'nin adı, harf harf yazılan
-- repliği, başının üstünde bir konuşma balonu ve her seçenek için bir buton. Bir seçeneğe
-- tıklamak sadece numarasını gönderir; sonra ne olacağına sunucu karar verir.
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)
-- Konuşma kutusu, kodla yapılmış
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 piksel yukarıda, böylece Roblox'un araç çubuğu seçenekleri asla kapatmaz
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 -- uzun bir replik telefonun küçük ekranına sığmak için küçülür
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- ve büyük bir ekranda asla 20 pikseli geçmez
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 -- her yeni replikte artar, böylece eski bir yazma döngüsü durur
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 -- sadece bu cihazda değiştirildi
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'nin üstünde bir konuşma balonu (DisplayBubble sadece bir LocalScript'te çalışır)
local head = npc:FindFirstChild("Head")
if head then
TextChatService:DisplayBubble(head, text)
end
-- Repliği harf harf yaz. Sayı geçen süreden hesaplanır,
-- yani hız her kare hızında aynıdır.
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 -- daha yeni bir replik ya da bir kapatma bunun yerini aldı
end
shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
lineLabel.MaxVisibleGraphemes = shown
end
lineLabel.MaxVisibleGraphemes = -1
-- Her seçenek için bir buton; sunucu sadece butonun numarasını alır
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 -- replik başına bir tıklama
dialogueEvent:FireServer(index)
end
end)
if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = button -- böylece bir kumanda bir seçenek seçebilir
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)
Renkleri, boyutları ve LETTERS_PER_SECOND'u istediğin gibi değiştirebilirsin. Son iki handler'ı olduğu gibi bırak: kutunun sunucuyla konuşmasının tek yolu onlar.
DialogueClient'in her parçası ne yapıyor:
- Kutu. Ekranın alt ortasına sabitlenmiş, genişliğinin %60'ı ve yüksekliğinin %34'ü kadar bir Frame içeren bir ScreenGui; büyük bir monitörde enine yayılmasın diye bir
UISizeConstraintile 720 x 300 pikselle sınırlı. NPC'nin repliği, telefonun küçük ekranında etiketine sığması için metni küçültenTextScaled'i kullanıyor; birUITextSizeConstraintde büyük bir ekranda 20 pikseli geçmesini engelliyor. BirUIGridLayoutseçenekleri ikişer ikişer dizer.ResetOnSpawnfalse, çünkü bu LocalScript oturum başına bir kez çalışır: yeniden doğarken silinen bir kutu asla geri gelmezdi. - Daktilo. Repliğin tamamı TextLabel'a bir seferde girer ve kaç karakterin görüneceğine
MaxVisibleGraphemeskarar verir; Roblox'unutf8.graphemesile yaptığı daktilo örneğinin kullandığı özellik de bu. Roblox metni tüm karakterler görünüyormuş gibi yerleştirir, yani kelimeler belirirken başka satıra atlamaz ya da boyut değiştirmez. Script kaç karakter gösterileceğini geçen süreden, saniyede 45 olarak hesaplar, yani hız her kare hızında aynıdır; sonunda da özelliği her şeyi gösteren -1'e ayarlar. - Butonlar. Replik yazılmayı bitirince çıkarlar. Her biri sadece numarasını bir kez gönderir:
lineNumberkontrolü çift tıklamanın iki kez göndermesini engeller ve kutu sonra sunucudan bir sonraki repliği bekler. - Konuşma balonu.
TextChatService:DisplayBubble(head, text)repliği NPC'nin Head'inin üstünde bir sohbet balonuna koyar. Roblox buna sadece istemci scriptlerinde izin verir ve balon sohbeti varsayılan olarak açık gelir. Onu bu oyuncunun cihazı çizdiği için balon sadece ona aittir. - Prompt. Bir oyuncu konuşurken onun Talk prompt kopyası (adıyla, TalkPrompt, bulunur) kapatılır, böylece konuşmanın üstünde kalmaz. Diğer oyuncular kendi prompt'larını görmeye devam eder.
- Tüm cihazlar.
Activatedbir fare tıklamasıyla, telefonda bir dokunuşla ve bir kumandanın A butonuyla tetiklenir. Bir kumanda sadece seçili bir butona basabilir, bu yüzdenPreferredInputoyuncunun gamepad kullandığını söylediğinde script ilk seçeneğiGuiService.SelectedObjectile seçer. - X butonu. Sunucunun "konuşmayı bitir" olarak anladığı 0'ı gönderir ve kutuyu hemen kapatır.
Kendi eylemlerini ekle
Bir eylem, DialogueService'in başına yakın ACTIONS tablosundaki bir fonksiyondur. Oyuncuyu ve seçeneği alır ve işini yaptığında true döndürür. Bir tane eklemek için, örneğin bir NPC'nin verdiği bir görev:
ACTIONS'aStartQuestadlı bir girdi ekle. Önce kontrol et, sonra değiştir:player:GetAttribute("Quest")'in zaten bir değeri varsafalsedöndür; yoksaplayer:SetAttribute("Quest", "Cave")'i çağır vetruedöndür.- DialogueData'da bir seçeneğe
action = "StartQuest", çalıştığında için birnextrepliği ve çalışmadığında için "You are already on a quest." gibi birfailNextrepliği ver. - Play'e bas ve seçeneği iki kez seç. DialogueData'daki ad
ACTIONSanahtarıyla uyuşmuyorsa (büyük küçük harf önemli), OutputDialogueService: no action named StartQuestgösterir ve konuşmafailNextrepliğine geçer.
Eylem yazma kuralları:
- Kontrolü ve değişikliği eylemin içinde, sunucuda yap. Oyuncunun cihazının gönderdiği tek şey bir seçenek numarası.
- Eylemin ihtiyacı olanı seçenekten (
itemgibi) ya da sunucunun kendi durumundan oku, asla remote'tan değil. - Değerli her şeyi eylemin kendi içinde sınırla, tıpkı Heal'in kendi 30 saniyelik bekleme süresini
lastHeal'de tutması gibi. Tıklamalar arasındaki 0.3 saniyelik sınır sadece tıklamaları yavaşlatır; bir oyuncunun aynı seçeneği tekrar tekrar dolaşmasını engellemez. - Mağaza gibi başka bir pencere açmak için bir eylem o oyuncuya bir RemoteEvent tetikleyip
truedöndürebilir. O pencerede olanlar yine kendi sunucu kontrollerine ihtiyaç duyar, Satıcı bir NPC'deki gibi.
Diğer NPC diyaloğu eğitimleri nerede hata yapıyor
Bu rehberi bir videoyla ya da bir forum gönderisiyle karşılaştırıyorsan önemli farklar bunlar, her kalıbın neden sorun olduğuyla birlikte.
| Eğitim | Sorun | Bu rehber |
|---|---|---|
Dialog nesnesini, ödül vermek için DialogChoiceSelected'i dinleyen bir sunucu Script'iyle kullanıyor | Roblox referansı bu event'in sadece istemciye ait olduğunu ve sunucuda tetiklenmediğini söylüyor, yani ödül asla gelmez. | Seçenek sunucuya bir numara olarak ulaşır ve ödülü sunucu çalıştırır. |
| Ödülü bir LocalScript'ten veriyor | Bir LocalScript'in yaptığı değişiklik o cihazda kalır (bkz. neyin replike edildiği, İngilizce) ve bir hileci aynı kodu istediği zaman çalıştırabilir. | Tüm eylemler DialogueService'te yaşar. |
NPC'yi game:GetService("Chat"):Chat(head, text) ile konuşturuyor | Chat servisi kullanımdan kalktı ve yerine TextChatService geldi. | LocalScript'te TextChatService:DisplayBubble. |
| Ödülün adını ya da bir sonraki repliğin id'sini istemciden gönderiyor | Bir hileci herhangi bir eşya adını gönderebilir ya da doğrudan ödülü veren repliğe atlayabilir. | İstemci sadece seçeneğin numarasını gönderir. Sunucu onu oyuncunun okuduğunu bildiği replikte arar. |
| Prompt tetiklendikten sonra hiçbir şeyi kontrol etmiyor | Roblox'un güvenlik rehberi ProximityPrompt'ları istemcilerin kötüye kullanabileceği şeyler olarak remote'ların yanına koyuyor ve harekete geçmeden önce oyuncunun yeterince yakın olup olmadığını kontrol etmeyi istiyor. | Mesafe konuşma başlarken, her tıklamada ve konuşma açıkken saniyede iki kez kontrol edilir. |
Metni bir döngüde wait() ile yazıyor | Global wait kullanımdan kalktı ve yerine task.wait geldi. | Görünecek harf sayısını os.clock()'tan hesaplar ve task.wait() ile bekler. |
Bir oyuncu neyi taklit edebilir, neyi edemez
Bir hilecinin kendi cihazındaki her şeyi kontrol ettiğini varsay. LocalScript'lerini ve ReplicatedStorage'daki her şeyi okuyabilir, DialogueEvent'i istediği argümanlarla istediği kadar tetikleyebilir ve Talk prompt'unu koddan tetikleyebilir; Roblox'un güvenlik rehberi de bu konuda uyarıyor. DialogueService buna, bir RemoteEvent'in argümanlarını doğrulama rehberinin anlattığı türden sunucu kontrolleriyle karşılık veriyor. Hilecinin bununla elde ettiği şu.
| Hilecinin denediği | Sonuç | Neden |
|---|---|---|
| Talk prompt'unu haritanın öbür ucundan tetiklemek | Hiçbir şey olmaz | startConversation 16 studdan (12 artı 4) yakın olduğunu kontrol eder. |
| 99 numaralı seçeneği, bir string'i, bir kesri ya da NaN göndermek | Yok sayılır | Tam sayı değil ya da okuduğu replikte böyle bir seçenek yok. |
| Bir ödülün adını ya da bir repliğin id'sini göndermek | Asla okunmaz | Sunucu sadece seçeneğin numarasını okur. Ödüller, repliğin sunucudaki kopyasının item ve action alanlarından gelir. |
| Ağın izin verdiği kadar hızlı tıklamak | Konuşma başına 0.3 saniyede bir tıklama | Daha hızlı tıklamalara kendi replikleri geri gönderilir. Konuşmayı bitirip yeniden başlatmak bu beklemeyi atlar, bu yüzden Heal ve GiveItem'ın kendi sınırları var. |
| Konuşmadan meşaleyi istemek | İmkânsız | Eşyalar sadece sunucunun oyuncunun bulunduğunu bildiği replikteki bir seçenekten gelir. |
| Bir sürü meşale toplamak | Birer birer | Sunucu önce Backpack'inde ve karakterinde bir Torch arar ve verdiği meşale bırakılamaz, yani bırakıp yenisini isteyerek farm yapılamaz. |
| İyileştirme repliğini spam'lemek | 30 saniyede bir iyileştirme | Bekleme süresi sunucuda oyuncu başına tutulur ve NPC bunu healTooSoon repliğiyle söyler. |
| Uzaklaşıp kutuyu açık bırakmak | Yarım saniyeden kısa sürede kapanır | Sunucu her açık konuşmayı saniyede iki kez kontrol eder. |
| Henüz ulaşmadığı replikler dahil bütün konuşmayı okumak | Mümkün | DialogueData, her cihaza kopyalanan ReplicatedStorage'da. Bu önemliyse onu ServerStorage'a taşı (bkz. 2. adım). |
Bir sınır doğrudan bir cevabı hak ediyor: Guide'a yaklaşıp seçenekleri seçen bir hileci, dürüst bir oyuncuyla tam olarak aynı şeyi alır. Sunucu ne sıklıkla ve nereden olduğunu kontrol eder, kim olduğunu değil. Her oyuncunun sadece bir kez alabileceği bir ödül gibi kıt olan her şey, sunucuya ait bir kontrol ister; örneğin alındığında ayarlanan bir attribute ya da bir data store ile kaydedilen bir işaret.
5. adım: test et
- Play'e (F5) bas ve Guide'a yürü. 12 studdan yakında Guide adıyla bir Talk prompt'u çıkar. E'ye bas.
- Kutu "Guide" gösterir, hoş geldin repliğini yazar, sonra dört buton gösterir. Aynı replik NPC'nin başının üstünde bir konuşma balonunda görünür.
- "Any tips?"'i, sonra "Anything else?"'i seç: tekrar ilk replikteyiz. "Bye!"'ı seç: kutu kapanır ve Talk prompt'u geri gelir.
- Önce kendine hasar ver: Server'a geçmek için Client/Server anahtarına tıkla, Workspace'te karakterinin Humanoid'ini seç, Properties penceresinde Health'i 50 yap ve Client'a geri dön. Oyuncu karakterleri her saniye MaxHealth'lerinin %1'ini geri kazanır, bu yüzden hemen Guide ile konuş ve "I'm hurt. Can you help?"'ı seç: canın tam dolar. 30 saniye dolmadan tekrar konuş ve tekrar seç: iyileştirme yok ve Guide seni az önce iyileştirdiğini söylüyor.
- "Got anything for the cave?"'ı seç: Torch araç çubuğunda belirir. Onu kuşan ve Backspace'e bas: elinde kalır. Tekrar iste: ikinci bir meşale yok ve Guide onun zaten sende olduğunu söylüyor.
- Konuşmaya başla, sonra uzaklaş. Guide'dan 16 stud uzaklaştığın anda kutu aşağı yukarı kapanır.
- Test modu açılır menüsünde Server & Clients'ı seç, 2 istemci ayarla ve Play'e bas. İki oyuncu da aynı anda Guide ile konuşabilir, her biri kendi repliğinde.
- Bir oyun testi sırasında Controller Emulator (Emulation sekmesinde Controller) ile bir kumandayı dene. Emüle edilen kumandayla yaklaş ve prompt'un butonuna bas (varsayılan olarak ButtonX): seçenekler çıktığında ilki seçilidir ve A onu seçer.
- Studio'nun Device Simulator'ıyla bir telefon ekranını dene (bu yazı yazılırken beta: File, Beta Features'ta New Device Simulator'ı aç ve Studio'yu yeniden başlat). Bir telefon seç, yatay olana kadar Rotate'e tıkla, Play'e bas, Guide'a yürü ve Talk prompt'una dokun. "Any tips?"'i seç: repliğin tamamı seçenek butonlarının üstünde, gerekirse daha küçük metinle, onlara çarpmadan görünür.
Output penceresini (Window menüsü, sonra Output) baştan sona açık tut. Bu scriptler çalıştıklarında hiçbir şey yazdırmaz, yani kırmızı her hata ya da DialogueService: ile başlayan her uyarı gerçek bir sorundur. Bkz. Yaygın hatalar.
Nasıl genişletilir
Daha fazla NPC ve daha uzun konuşmalar
NPCs klasörüne kendi adıyla başka bir rig ekle ve DialogueData'ya aynı adı taşıyan, start repliği olan bir tablo ekle. DialogueService, oyun çalışırken eklenenler dahil, klasördeki HumanoidRootPart'ı olan her modele Talk prompt'unu ekler; bir NPC kopyası getirdiği prompt yerine yeni bir tane alır. Aynı adlı iki NPC aynı tabloyu kullanır. Replikler herhangi bir sırayla bağlanabilir ve bir seçenek, "Anything else?"'in yaptığı gibi, önceki bir repliğe geri götürebilir. Her replikte en fazla dört seçenek bırak, çünkü kutu onları ikişer ikişer diziyor.
İlerlemeye bağlı replikler
Geri dönen oyuncuları farklı selamlamak için ilk repliği sunucuya ait bir şeye göre seç. startConversation içinde onu local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start" ile seç, scriptin lines.start'ı kontrol ettiği gibi repliğin var olduğunu kontrol et ve konuşma oluşturulurken "start" yerine firstLine kullan. Attribute'u bir eylemde ayarla ve Guide'ın tablosuna bir welcomeBack repliği ekle. Attribute'lar bir oturum sürer; oyuncuyu ziyaretler arasında hatırlamak için işareti DataStore eğitimindeki gibi bir data store ile kaydet.
Satıcı bir NPC
Mağazayı mağaza GUI'si rehberiyle kur, sonra o oyuncuya bir RemoteEvent tetikleyip true döndüren bir OpenShop eylemi ekle ve mağazanın LocalScript'inin o event geldiğinde penceresini açmasını sağla. Satın almalar yine mağazanın kendi sunucu kontrollerinden geçer. Satın almanın sadece NPC'nin yakınında çalışması gerekiyorsa mesafeyi satın alma handler'ının içinde de kontrol et, çünkü bir istemci mağazanın remote'unu her yerden çağırabilir.
Yürüyen NPC'ler
Guide'ın dolaşması ya da oyuncuları takip etmesi için NPC pathfinding rehberini (İngilizce) kullan ve hareket edebilmesi için HumanoidRootPart'taki Anchored işaretini kaldır. Talk prompt'u o parçada, yani NPC ile birlikte hareket eder ve mesafe kontrolleri de aynı parçayı kullanır. Bir konuşma açıkken yürümeyi duraklat, yoksa NPC oyuncudan 16 studdan fazla uzaklaştığı anda kutu kapanır.
Anahtarlar, görevler ve diğer ödüller
GiveItem, DialogueItems'taki herhangi bir Tool'u verir, yani bir NPC kilitli bir kapının kontrol ettiği anahtarı verebilir, kapı rehberindeki gibi. Kullanıldığında bir şey yapan eşyalar için, örneğin iyileştiren yiyecek, envanter rehberine bak.
Sesler ve kamera
Her replikte bir ses kaydı ya da bir bip için NPC'nin Head'ine bir Sound koy ve onu DialogueClient'taki show'dan çal. NPC konuşurken kamerayı ona çevirmek için ara sahne rehberi bir LocalScript'in kamerayı nasıl devralıp geri verdiğini gösteriyor.
Sık yapılan hatalar ve çözümleri
Play'e basmadan önce Output penceresini (Window menüsü, sonra Output) aç. Diyalog sorunlarının çoğu orada bir uyarı yazdırır ya da uyuşmayan bir addan gelir.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'
DialogueClient, DialogueService'in oluşturduğu remote'u bekliyor, yani DialogueService o noktaya gelmedi. Onun bir LocalScript değil bir Script olduğunu, doğrudan ServerScriptService içinde olduğunu ve devre dışı olmadığını kontrol et. DialogueService önce ReplicatedStorage'daki DialogueData'yı ve Workspace'teki NPCs klasörünü bekler, yani biri eksikse ya da yanlış yazılmışsa o da durur; Output da o zaman DialogueService'ten onu adlandıran bir infinite yield uyarısı gösterir.
NPC'min üstünde hiç Talk prompt'u çıkmıyor
DialogueService prompt'ları sadece doğrudan Workspace, NPCs içinde olan ve HumanoidRootPart adlı bir parçası olan modellere ekler. İkisini de kontrol et ve 12 studdan yakına gel. Toolbox'tan gelen bir rig'de bu parça eksik olabilir ya da bir klasöre sarılmış başka türden bir nesne olabilir.
Prompt çıkıyor ama E'ye basmak hiçbir şey yapmıyor
Sunucu o NPC için hiçbir konuşma bulamadı ve oyun başladığında Output, NPC'nin adıyla DialogueService: no conversation with a start line for Guide in DialogueData gösterir. DialogueData'daki tablonun adı büyük küçük harf dahil tam olarak modelin adı olmalı ve start adlı bir repliği olmalı.
Bir seçenek bir sonraki repliğe geçmek yerine kutuyu kapatıyor
Output senin adlarınla DialogueService: no line named tip for Guide in DialogueData gösterir: seçeneğin next'i (ya da failNext'i) o NPC'nin tablosunda olmayan bir repliği adlandırıyor. Replik adları büyük küçük harfe duyarlı, bu yüzden tablodaki yazılışa bak, burada tips.
Kutu çalışıyor ama konuşma balonu yok
Balon, doğrudan NPC modelinin içinde Head adlı bir parçaya ve açık bir balon sohbetine ihtiyaç duyar: Explorer'da TextChatService içindeki BubbleChatConfiguration'ı seç ve Enabled'ın işaretli olduğunu kontrol et. Varsayılan olarak açık gelir.
Output DialogueService: no Tool named Torch in ServerStorage.DialogueItems diyor
Sunucu eşyayı bulamadı. ServerStorage'daki klasörün adının DialogueItems olduğunu ve içinde seçeneğin item'iyle tam olarak aynı adı taşıyan bir Tool (Model ya da Part değil) olduğunu kontrol et. Bunu düzeltene kadar Guide hasTorch repliğiyle cevap verir, çünkü eylem başarısız oldu.
Output DialogueService: no action named ... diyor
Bir seçeneğin action'ı ACTIONS tablosundaki hiçbir anahtarla uyuşmuyor. Adlar büyük küçük harfe duyarlı: heal, Heal değildir.
RoCode ile yap
NPC'yi elle kurmak yerine anlatmayı tercih ediyorsan RoCode bu scriptleri açık olan place'ine yazabilir. Roblox Studio için bağımsız bir yapay zeka ajanı, Roblox yapmıyor: bir web sohbetine yazarsın ve Studio plugin'i scriptleri Explorer'ında oluşturur ve düzenler.
Workspace.NPCs içindeki Guide modelini konuştur: bir Talk prompt'u, harf harf yazılan replikler ve seçenek butonları olan bir konuşma kutusu, bir konuşma balonu, 30 saniye beklemeli bir iyileştirme seçeneği ve ServerStorage'daki Torch tool'unu sadece bir kez veren bir seçenek. Konuşmayı bir ModuleScript'te tut ve tüm ödülleri sunucuda ver.
- Önce modeli inceleyebilir; parçalarındaki Anchored ve Humanoid'indeki WalkSpeed gibi önemli değerleri okumak için Get Properties kullanır. Modelin tam yolunu eklemek için sohbete / yaz
- DialogueData ModuleScript'ini, DialogueService Script'ini ve DialogueClient LocalScript'ini Create Script ile yazar
- Yazdığı her scriptin derlendiğini, onu Studio'da çalıştırmadan derleyen Check Script ile kontrol etmesi söylenmiştir
- Değişikliklerini gruplar halinde gönderir ve her grup Studio geçmişinde bir geri alma noktasıdır
Plugin 3.9 ya da üstüyle RoCode kısa bir test yapıp hataları okuyabilir, plugin 3.9.11 ya da üstüyle de oyunun çalıştığını kontrol etmek için bir test karakterini yönetebilir, ama oyun çalışırken ekran görüntüsü almaz; bu yüzden NPC'ye yaklaş ve onunla kendin konuş. Bir şey düzgün çalışmazsa RoCode'a ne gördüğünü söyle: Check Output son oyun testinin Server ve Client satırlarını okuyabilir. Konuşan bir NPC birçok sistemden biri; yapay zeka ile Roblox oyunu yapmak, her prompt'ta bir sistem bunların nasıl bir araya geldiğini gösteriyor. RoCode Studio'ya nasıl bağlanır.
Sık sorulan sorular
Roblox Studio'da bir NPC'yi nasıl konuştururum?
NPC'ye bir ProximityPrompt ekle ve bir oyuncu onu tetiklediğinde NPC'nin repliğini bir konuşma kutusunda, bir konuşma balonunda ya da ikisinde birden göster. Bu rehberdeki üç script ikisini de yapıyor ve seçenekler ekliyor. Sadece bir balon için, Roblox'un balon sohbeti sayfasındaki NPC örneğindeki gibi, prompt tetiklendiğinde bir LocalScript'ten TextChatService:DisplayBubble(npc.Head, "Hello!")'yu çağır.
Dialog nesnesini mi yoksa kendi diyalog GUI'mi mi kullanmalıyım?
Dialog nesnesi kod gerektirmez ve tıklanabilir bir konuşma balonu gösterir; atmosfer metni için bu yeterli. Seçenek event'i sadece oyuncunun cihazında tetiklenir, yani ödülleri güvenle veremez ve varsayılan olarak onunla aynı anda sadece bir oyuncu konuşabilir. Bu rehberdeki gibi kendi kutun, her ödülü sunucunun çalıştırmasını sağlar ve her oyuncuya kendi konuşmasını verir.
Bir NPC'den oyuncuya nasıl eşya veririm?
Tool'u ServerStorage'da tut ve oyuncu o seçeneği seçtiğinde bir sunucu Script'inin onu oyuncunun Backpack'ine klonlamasını sağla, GiveItem eyleminin yaptığı gibi. Oyuncuda zaten bir tane olmadığını kontrol et ve kopyada CanBeDropped'ı kapat, böylece bırakılıp yenisi istenemez. Hangi eşyanın verileceğini asla oyuncunun cihazına söyletme.
Daktilo efektli bir konuşma kutusu nasıl yapılır?
Repliğin tamamını bir TextLabel'a koy, MaxVisibleGraphemes'ini 0'dan her seferinde birkaç karakter artır ve sonunda her şeyi göstermek için -1'e ayarla. Roblox'un UI animasyonu sayfası aynı özelliği utf8.graphemes ile kullanıyor. DialogueClient kaç karakter gösterileceğini geçen süreden, saniyede 45 olarak hesaplar, yani hız kare hızına bağlı değil.
İki oyuncu aynı NPC ile aynı anda konuşabilir mi?
Bu rehberdeki scriptlerle evet: sunucu her oyuncu için bir konuşma tutar ve her oyuncu sadece kendi kutusunu görür. Yerleşik Dialog nesnesi farklı: varsayılan BehaviorType'ı SinglePlayer ile aynı anda bir oyuncu konuşur ve diğerleri o oyuncunun seçeneklerini görür.
Bir NPC'nin diyalog metnini filtrelemem gerekiyor mu?
Kendi yazdığın replikleri hayır. Roblox, üzerinde açık bir kontrolün olmayan gösterilen metni filtrelemekten seni sorumlu tutar; oyuncuların yazdıkları, rastgele karakterlerle üretilen kelimeler ya da dış bir web sitesinden getirilen metin gibi. Bir NPC bir oyuncunun yazdığı bir şeyi tekrarlıyorsa o kısmı filtrele.
Kaynaklar ve ek okumalar
- Roblox Creator Docs: Proximity prompts (İngilizce). prompt oluşturmak, MaxActivationDistance ve RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (İngilizce). bir prompt nerede çalışır, varsayılan metni ve tuşları, Triggered ve görüş hattı kontrolü
- Roblox Creator Docs: Securing the client-server boundary (İngilizce). saldırı yüzeyi olarak ProximityPrompt'lar, mesafe ve izin kontrolleri
- Roblox Engine API: Dialog (İngilizce). BehaviorType ve sadece istemciye ait DialogChoiceSelected event'i
- Roblox Engine API: TextChatService:DisplayBubble (İngilizce). istemci scriptlerinden NPC'ler için konuşma balonları
- Roblox Creator Docs: Customize bubble chat (İngilizce). NPC balonları ve BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (İngilizce). gösterilen hangi metni filtrelemen gerektiği
- Roblox Creator Docs: UI animation and tweens (İngilizce). MaxVisibleGraphemes ile daktilo efekti
- Roblox Engine API: Tool.CanBeDropped (İngilizce). Backspace bir tool ile ne yapar
- Roblox Engine API: UserInputService.PreferredInput (İngilizce). kumandalı bir oyuncuyu algılamak
- Roblox Creator Docs: Rig Generator (İngilizce). bir R15 ya da R6 rig eklemek
Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.