Eğitim · Oyun sistemleri

Roblox Studio'da NPC diyaloğu nasıl yapılır

Roblox'ta bir NPC diyaloğunun üç parçası var: konuşmayı başlatan bir prompt, NPC'nin söylediğini oyuncunun cevapları için butonlarla gösteren bir kutu ve her cevabın nereye götürdüğüne karar veren bir script. Bu rehber üçünü de kuruyor: konuşmayı basit bir tablo olarak yazıyorsun, oyuncular konuşmak için E'ye basıyor ve bir cevabın verdiği her şeyi (can, eşya) oyuncunun cihazı değil, her zaman sunucu veriyor.

Güncellendi: 20 Kasım 202618 dk okumaYazan:

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 DialogChoiceSelected event'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. Eski Chat servisi 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
  1. Nasıl çalışır
  2. 1. NPC ekle
  3. 2. Konuşma
  4. 3. Sunucu scripti
  5. 4. Konuşma kutusu
  6. Kendi eylemlerin
  7. Diğer eğitimler
  8. Exploit sınırları
  9. 5. Test
  10. Genişletme
  11. Common errors
  12. RoCode ile
  13. Sık sorulan sorular
  14. Kaynaklar ve ek okumalar

NPC diyaloğu nasıl çalışır

ÇizimHer replik kutuda yazılırken repliğin tamamı bir konuşma balonunda görünüyor, replik yazılmayı bitirince seçenekler çıkıyor ve "Got anything for the cave?"'ı seçtiğinde Torch'u sunucu veriyor.

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:

  1. Oyuncu NPC'ye yaklaşır ve onun Talk prompt'unda E'ye basar. Prompt'un Triggered event'i sunucuda o oyuncuyla tetiklenir.
  2. Sunucu scripti oyuncunun yeterince yakın olduğunu kontrol eder, start adlı replikte olduğunu not eder ve o repliğin metnini ve seçeneklerinin etiketlerini sadece o oyuncuya gönderir.
  3. 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.
  4. Oyuncu bir seçeneğe tıklar, dokunur ya da onu seçer. Sunucuya sadece numarası geri döner.
  5. 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.
Konuşan bir NPC'nin parçaları
ParçaNereye giderNe yapar
Guide rig'iWorkspace, NPCs adlı bir klasördeNPC'nin kendisi. Adı konuşmasını seçer ve prompt'ta görünür.
DialogueData ModuleScript'iReplicatedStorageNPC'nin söyleyebileceği tüm replikler, her repliğin seçenekleri ve her seçeneğin nereye götürdüğü.
DialogueService Script'iServerScriptServiceTalk prompt'unu ekler, her oyuncunun hangi replikte olduğunu hatırlar, her tıklamayı kontrol eder ve eylemleri çalıştırır.
DialogueEvent RemoteEvent'iReplicatedStorage (DialogueService oluşturur)Her repliği oyuncuya, seçilen seçeneğin numarasını da sunucuya geri taşır.
DialogueClient LocalScript'iStarterPlayer, StarterPlayerScriptsKutuyu ç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ördeSeçeneklerden birinin verdiği eşya. ServerStorage'daki hiçbir şey oyunculara gönderilmez.
NPC bittiğinde Explorer. Oyun çalışırken DialogueService, ReplicatedStorage'a DialogueEvent adlı bir RemoteEvent ve her NPC'nin HumanoidRootPart'ına TalkPrompt adlı bir Talk ProximityPrompt'u ekler.
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

  1. 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 Rig adlı bir rig belirir. Bir R6 rig'i de aynı scriptlerle çalışır.
  2. Adını Guide yap. Ad önemli: DialogueService konuşmayı modelin adına göre arar ve prompt bunu oyunculara gösterir.
  3. 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.
  4. Explorer'da fareyle Workspace üzerine gel, + butonuna tıkla ve NPCs adlı bir Folder ekle. Guide'ı içine sürükle ve rig'i oyuncuların yaklaşabileceği bir yere koy.
  5. İsteğe bağlı, eşya seçeneği için: fareyle ServerStorage üzerine gel ve DialogueItems adlı bir Folder ekle. İçine Torch adlı bir Tool koy; içinde de bir karakterin tuttuğu parça olan, anchored olmayan Handle adlı 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.

ModuleScript konum: ReplicatedStorage adı: DialogueData
-- 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şma start adlı replikte başlar.
  • text NPC'nin söylediği şey. choices sırayla oyuncunun butonları. Kutuya dört tane sığar.
  • next o seçenekten sonra gösterilecek repliğin adı. "Bye!" gibi next'i olmayan bir seçenek konuşmayı bitirir. Tabloda olmayan bir repliği adlandıran bir next ya da failNext da konuşmayı bitirir, Output'ta bir uyarıyla.
  • action, DialogueService'in ACTIONS tablosundan sunucunun yaptığı bir şeyin adı: burada Heal ya da GiveItem.
  • item GiveItem için: ServerStorage, DialogueItems içindeki bir Tool'un adı.
  • failNext, eylem yapılamadığında next yerine gösterilen replik; böylece NPC olmayan bir iyileştirmeyi ya da hediyeyi asla iddia etmez.
Guide'ın konuşması, replik replik
ReplikGuide ne diyorSeç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ı.

Script konum: ServerScriptService adı: DialogueService
-- 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.

DialogueService'in başındaki ayarlar
AyarBuradaki değerNeyi değiştirir
TALK_DISTANCE12Talk 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_CHOICES0.3Sunucunun 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_SECONDS30Her 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:

DialogueService her tıklamada neyi kontrol eder
KontrolKodBaşarısız olursa
Oyuncu bir konuşmadaconversations[player]Tıklama yok sayılır.
Seçenek bir tam sayıtypeof ve math.floorYok sayılır. String'ler, tablolar, kesirler ve NaN burada durur.
0, oyuncunun X'e bastığı anlamına gelirchoiceIndex == 0Konuşma biter.
Canlı ve hâlâ 16 studdan yakın (12 artı 4)isCloseKonuşma biter ve kutu kapanır.
Son kabul edilen tıklamadan bu yana en az 0.3 saniyeconversation.lastChoiceAynı replik tekrar gönderilir, böylece kutu sonsuza kadar beklemek yerine yeni butonlar alır.
Seçenek bu oyuncunun okuduğu replikte varline.choices[choiceIndex]Yok sayılır.
Eylem çalıştıher eylem true ya da false döndürürnext 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.

LocalScript konum: StarterPlayer > StarterPlayerScripts adı: DialogueClient
-- 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 UISizeConstraint ile 720 x 300 pikselle sınırlı. NPC'nin repliği, telefonun küçük ekranında etiketine sığması için metni küçülten TextScaled'i kullanıyor; bir UITextSizeConstraint de büyük bir ekranda 20 pikseli geçmesini engelliyor. Bir UIGridLayout seçenekleri ikişer ikişer dizer. ResetOnSpawn false, çü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 MaxVisibleGraphemes karar verir; Roblox'un utf8.graphemes ile 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: lineNumber kontrolü ç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. Activated bir 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üzden PreferredInput oyuncunun gamepad kullandığını söylediğinde script ilk seçeneği GuiService.SelectedObject ile 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:

  1. ACTIONS'a StartQuest adlı bir girdi ekle. Önce kontrol et, sonra değiştir: player:GetAttribute("Quest")'in zaten bir değeri varsa false döndür; yoksa player:SetAttribute("Quest", "Cave")'i çağır ve true döndür.
  2. DialogueData'da bir seçeneğe action = "StartQuest", çalıştığında için bir next repliği ve çalışmadığında için "You are already on a quest." gibi bir failNext repliği ver.
  3. Play'e bas ve seçeneği iki kez seç. DialogueData'daki ad ACTIONS anahtarıyla uyuşmuyorsa (büyük küçük harf önemli), Output DialogueService: no action named StartQuest gösterir ve konuşma failNext repliğ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 (item gibi) 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 true dö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.

NPC diyaloğu eğitimlerindeki yaygın kalıplar ve bu rehberin bunların yerine yaptığı
EğitimSorunBu rehber
Dialog nesnesini, ödül vermek için DialogChoiceSelected'i dinleyen bir sunucu Script'iyle kullanıyorRoblox 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 veriyorBir 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şturuyorChat 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önderiyorBir 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 etmiyorRoblox'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ıyorGlobal 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.

Bir hilecinin neyi deneyebileceği ve DialogueService'in buna karşı ne yaptığı
Hilecinin denediğiSonuçNeden
Talk prompt'unu haritanın öbür ucundan tetiklemekHiçbir şey olmazstartConversation 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öndermekYok sayılırTam 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öndermekAsla okunmazSunucu 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ıklamakKonuşma başına 0.3 saniyede bir tıklamaDaha 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ızEşyalar sadece sunucunun oyuncunun bulunduğunu bildiği replikteki bir seçenekten gelir.
Bir sürü meşale toplamakBirer birerSunucu ö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'lemek30 saniyede bir iyileştirmeBekleme süresi sunucuda oyuncu başına tutulur ve NPC bunu healTooSoon repliğiyle söyler.
Uzaklaşıp kutuyu açık bırakmakYarım saniyeden kısa sürede kapanırSunucu her açık konuşmayı saniyede iki kez kontrol eder.
Henüz ulaşmadığı replikler dahil bütün konuşmayı okumakMümkünDialogueData, 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

  1. Play'e (F5) bas ve Guide'a yürü. 12 studdan yakında Guide adıyla bir Talk prompt'u çıkar. E'ye bas.
  2. 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.
  3. "Any tips?"'i, sonra "Anything else?"'i seç: tekrar ilk replikteyiz. "Bye!"'ı seç: kutu kapanır ve Talk prompt'u geri gelir.
  4. Ö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.
  5. "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.
  6. Konuşmaya başla, sonra uzaklaş. Guide'dan 16 stud uzaklaştığın anda kutu aşağı yukarı kapanır.
  7. 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.
  8. 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.
  9. 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.

Sen yazarsın

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.

RoCode yapar
  • Ö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

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.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.