درس · أنظمة اللعب

كيف تصنع حوارًا مع NPC في Roblox Studio

يتكون حوار الـ NPC في Roblox من ثلاثة أجزاء: تلميح لبدء المحادثة، ونافذة تعرض كلام الـ NPC وأزرار ردود اللاعب، وسكربت يقرر إلى أين يقود كل رد. في هذا الدليل نبني الأجزاء الثلاثة: تكتب المحادثة على شكل جدول بسيط، ويضغط اللاعبون E للتحدث، وكل ما يمنحه الرد (علاج، غرض) يمنحه الخادم، لا جهاز اللاعب.

آخر تحديث ٢٠ نوفمبر ٢٠٢٦القراءة في 18 دبقلم

باختصار

ضع نموذج الـ NPC في مجلد NPCs داخل Workspace، واكتب محادثته في ModuleScript داخل ReplicatedStorage: لكل جملة نص يقوله الـ NPC وقائمة خيارات تقود إلى جملة أخرى. يضيف Script في ServerScriptService لكل NPC تلميح ProximityPrompt ("Talk")، ويتذكر الجملة التي وصل إليها كل لاعب، ويرسلها عبر RemoteEvent. ويعرض LocalScript النص وزرًا لكل خيار، ولا يرسل في المقابل إلا رقم الزر المضغوط.

  • امنح المكافآت على الخادم. الحدث DialogChoiceSelected في كائن Dialog المدمج لا ينطلق إلا على العميل، فلن يسمعه Script الخادم أبدًا، والعلاج أو الغرض الذي يُمنح في LocalScript لا يغيّر إلا نسخة اللعبة عند ذلك اللاعب.
  • اعرض فقاعة الكلام عبر TextChatService:DisplayBubble(npc.Head, text) من LocalScript. خدمة Chat القديمة أصبحت قديمة (Deprecated)، وتُستخدم TextChatService بدلًا منها.
  • الجمل التي كتبتها بنفسك لا تحتاج إلى تصفية. قاعدة Roblox: صفِّ أي نص معروض لا تتحكم فيه مباشرة، مثل ما يكتبه اللاعبون.
في هذه الصفحة
  1. طريقة العمل
  2. 1. إضافة الـ NPC
  3. 2. المحادثة
  4. 3. سكربت الخادم
  5. 4. نافذة الحوار
  6. إجراءاتك الخاصة
  7. الدروس الأخرى
  8. حدود الحماية
  9. 5. الاختبار
  10. التوسيع
  11. Common errors
  12. مع RoCode
  13. الأسئلة الشائعة
  14. المصادر والقراءات

كيف يعمل حوار الـ NPC

توضيحكل جملة تُكتب في النافذة بينما تظهر كاملة في الفقاعة، وتظهر الخيارات عندما تكتمل الجملة، ويمنح الخادم Torch عندما تختار "Got anything for the cave?".

الـ NPC المتكلم الذي يعمل في لعبة حقيقية مقسوم بين الخادم وجهاز كل لاعب. الجهاز يرسم النافذة والأزرار. أما الخادم، وهو الطرف الوحيد الذي يمكن الوثوق به، فيعرف أي جملة يقرؤها كل لاعب، ويقرر ماذا يفعل كل رد. وتبدو جولة واحدة من المحادثة هكذا:

  1. يقترب اللاعب من الـ NPC ويضغط E على تلميح Talk الخاص به. ينطلق الحدث Triggered للتلميح على الخادم مع هذا اللاعب.
  2. يتحقق سكربت الخادم من أن اللاعب قريب بما يكفي، ويتذكر أنه على الجملة المسماة start، ويرسل نص هذه الجملة وعناوين خياراتها إلى هذا اللاعب وحده.
  3. يكتب LocalScript الجملة في نافذة الحوار، ويُظهر فقاعة فوق الـ NPC، ثم يضيف زرًا لكل خيار.
  4. ينقر اللاعب أو يلمس أو يختار خيارًا. ولا يعود إلى الخادم إلا رقمه.
  5. يجد الخادم هذا الرقم في الجملة التي يعرف أن اللاعب يقرؤها، وينفذ إجراء الخيار إن وُجد (علاج، غرض)، ثم يرسل الجملة التالية أو يغلق النافذة.
مما يتكون الـ NPC المتكلم
العنصرأين يوجدماذا يفعل
هيكل الشخصية GuideWorkspace، داخل مجلد اسمه NPCsالـ NPC نفسه. اسمه يحدد المحادثة ويظهر على التلميح.
ModuleScript DialogueDataReplicatedStorageكل الجمل التي قد يقولها الـ NPC، والخيارات تحت كل جملة، وإلى أين يقود كل خيار.
Script DialogueServiceServerScriptServiceيضيف تلميح Talk، ويتذكر الجملة التي وصل إليها كل لاعب، ويفحص كل نقرة، وينفذ الإجراءات.
RemoteEvent DialogueEventReplicatedStorage (ينشئه DialogueService)يحمل كل جملة إلى اللاعب، ويعيد رقم الخيار المختار إلى الخادم.
LocalScript DialogueClientStarterPlayer، StarterPlayerScriptsيرسم النافذة، ويكتب الجملة، ويُظهر الفقاعة وأزرار الخيارات.
Tool Torch (اختياري)ServerStorage، داخل مجلد اسمه DialogueItemsالغرض الذي يمنحه أحد الخيارات. لا شيء من ServerStorage يُرسل إلى اللاعبين.
نافذة Explorer عندما يصبح الـ NPC جاهزًا. أثناء تشغيل اللعبة يضيف DialogueService حدث RemoteEvent اسمه DialogueEvent إلى ReplicatedStorage، وتلميح ProximityPrompt من نوع Talk اسمه TalkPrompt إلى HumanoidRootPart في كل NPC.
Workspace
  NPCs Folder new
    Guide Model new
      Humanoid Humanoid
      HumanoidRootPart Part
      Head, UpperTorso, LowerTorso ... (أجزاء الجسم)
ReplicatedStorage
  DialogueData ModuleScript new
ServerScriptService
  DialogueService Script new
ServerStorage
  DialogueItems Folder new
    Torch Tool new
      Handle Part new
StarterPlayer
  StarterPlayerScripts
    DialogueClient LocalScript new

الخطوة 1: أضف الـ NPC

  1. في تبويب Avatar أو Home اضغط Character لفتح Rig Generator. اختر R15 وشكل الجسم والنمط. سيظهر في Workspace هيكل اسمه Rig. وهيكل R6 يعمل مع السكربتات نفسها.
  2. غيّر اسمه إلى Guide. الاسم مهم: يبحث DialogueService عن المحادثة باسم النموذج، والتلميح يعرضه للاعبين.
  3. وسّع الهيكل، وحدد HumanoidRootPart فيه، وفعّل Anchored في نافذة Properties. القطعة المثبّتة لا تتحرك أبدًا بفعل الفيزياء، فيقف الـ NPC حيث وضعته، ولا يستطيع اللاعبون دفعه.
  4. مرّر المؤشر فوق Workspace في Explorer، واضغط زر +، وأدرج Folder باسم NPCs. اسحب Guide إليه، وضع الهيكل في مكان يستطيع اللاعبون الوصول إليه.
  5. اختياري، لخيار الغرض: مرّر المؤشر فوق ServerStorage وأدرج Folder باسم DialogueItems. ضع فيه Tool باسم Torch فيه Part واحد غير مثبّت اسمه Handle، وهو القطعة التي تمسكها الشخصية بيدها. ووضع PointLight داخل Handle يجعله يضيء.

الأسماء حساسة لحالة الأحرف، فاكتب NPCs وGuide وDialogueItems وTorch كما هي بالضبط. ويمكن أن يكون الـ NPC أي نموذج فيه Humanoid وHumanoidRootPart، ومنها نماذج Toolbox، ما دام موجودًا مباشرة داخل مجلد NPCs.

الخطوة 2: اكتب المحادثة

مرّر المؤشر فوق ReplicatedStorage، وأدرج ModuleScript باسم DialogueData، والصق فيه هذا الكود. لا منطق فيه، بل الكلمات والروابط بينها فقط، ولذلك سيكون هذا الملف هو الذي تعدّله أكثر من غيره.

ModuleScript في ReplicatedStorage باسم DialogueData
-- ModuleScript في ReplicatedStorage باسم DialogueData.
-- كل المحادثات، حسب اسم الـ NPC في Workspace.NPCs. لكل جملة
-- نص يقوله الـ NPC وخيارات رد اللاعب. قد يقود الخيار إلى جملة أخرى (next)،
-- أو ينهي المحادثة (دون next)، أو يطلب من الخادم فعل شيء (action). إذا لم يستطع الخادم
-- تنفيذ الإجراء فإنه يعرض الجملة failNext بدل next.

export type Choice = {
	text: string,
	next: string?, -- الجملة التي تُعرض بعد هذا الخيار؛ وnil ينهي المحادثة
	action: string?, -- إجراء على الخادم من جدول ACTIONS في DialogueService
	item: string?, -- لإجراء GiveItem: اسم الـ Tool في ServerStorage.DialogueItems
	failNext: string?, -- الجملة التي تُعرض بدل next عندما يتعذر تنفيذ الإجراء
}

export type Line = {
	text: string,
	choices: { Choice },
}

local DialogueData: { [string]: { [string]: Line } } = {
	Guide = {
		start = {
			text = "Welcome to the village! What can I do for you?",
			choices = {
				{ text = "Any tips?", next = "tips" },
				{ text = "I'm hurt. Can you help?", next = "healed", action = "Heal", failNext = "healTooSoon" },
				{ text = "Got anything for the cave?", next = "torch", action = "GiveItem", item = "Torch", failNext = "hasTorch" },
				{ text = "Bye!" },
			},
		},
		tips = {
			text = "Stay off the red bricks, and come back if you get hurt.",
			choices = {
				{ text = "Anything else?", next = "start" },
				{ text = "Thanks!" },
			},
		},
		healed = {
			text = "There you go, good as new.",
			choices = {
				{ text = "Thank you!" },
			},
		},
		torch = {
			text = "Take this torch. The cave is dark.",
			choices = {
				{ text = "Thanks!" },
			},
		},
		healTooSoon = {
			text = "I healed you a moment ago. Come back in a little while.",
			choices = {
				{ text = "OK" },
			},
		},
		hasTorch = {
			text = "You already have my torch. Keep it lit!",
			choices = {
				{ text = "Will do!" },
			},
		},
	},
}

return DialogueData

أسطر export type في البداية تصف شكل الجملة والخيار. لا تغيّر شيئًا أثناء اللعب؛ بل تصف بياناتك كي يستطيع فاحص الأنواع التحقق منها.

كيف ترتبط الأجزاء ببعضها:

  • لكل NPC جدول مسمى باسم نموذجه في مجلد NPCs، وهنا هو Guide. وكل محادثة تبدأ بالجملة start.
  • text هو ما يقوله الـ NPC. وchoices هي أزرار اللاعب، بالترتيب. وفي النافذة مكان لأربعة.
  • next يسمّي الجملة التي تُعرض بعد هذا الخيار. والخيار الذي ليس فيه next، مثل "Bye!"، ينهي المحادثة. وكذلك ينهيها next أو failNext يسمّي جملة غير موجودة في الجدول، مع تحذير في Output.
  • action يسمّي ما يفعله الخادم، من جدول ACTIONS في DialogueService: وهنا هو Heal أو GiveItem.
  • item يلزم لـ GiveItem: وهو اسم الـ Tool في ServerStorage، DialogueItems.
  • failNext هي الجملة التي تُعرض بدل next عندما يتعذر تنفيذ الإجراء، كي لا يدّعي الـ NPC أبدًا علاجًا أو هدية لم تحدث.
محادثة Guide، جملة بعد جملة
الجملةيقول Guideالخيارات وإلى أين تقود
start"Welcome to the village! What can I do for you?""Any tips?" يقود إلى tips. و"I'm hurt. Can you help?" يعالج، ثم healed (أو healTooSoon). و"Got anything for the cave?" يمنح Torch، ثم torch (أو hasTorch). و"Bye!" ينهي المحادثة.
tips"Stay off the red bricks, and come back if you get hurt.""Anything else?" يعيد إلى start. و"Thanks!" ينهي المحادثة.
healed"There you go, good as new.""Thank you!" ينهي المحادثة.
torch"Take this torch. The cave is dark.""Thanks!" ينهي المحادثة.
healTooSoon"I healed you a moment ago. Come back in a little while.""OK" ينهي المحادثة.
hasTorch"You already have my torch. Keep it lit!""Will do!" ينهي المحادثة.

هذه الوحدة لا يقرؤها إلا الخادم. فـ LocalScript لا يستدعيها أبدًا عبر require: يرسل الخادم كل جملة عندما يصل اللاعب إليها. لكن الوحدة في ReplicatedStorage تُنسخ مع ذلك إلى جهاز كل لاعب، فإذا كانت في المحادثة معلومات تحرق المفاجأة (مثل حل لغز)، فانقل DialogueData إلى ServerStorage. ثم في سطر require داخل DialogueService استبدل ReplicatedStorage بـ ServerStorage، ليصبح السطر كله هكذا: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.

الخطوة 3: أضف سكربت الخادم

مرّر المؤشر فوق ServerScriptService، وأدرج Script باسم DialogueService، والصق فيه الكود أدناه. هذا هو المكان الوحيد الذي تتقدم فيه المحادثة، والمكان الوحيد الذي تُمنح فيه المكافأة.

Script في ServerScriptService باسم DialogueService
-- Script في ServerScriptService باسم DialogueService.
-- يضيف تلميح Talk لكل NPC في Workspace.NPCs ويدير كل محادثة.
-- جهاز اللاعب لا يفعل إلا عرض النص وإرسال رقم الخيار
-- الذي نقر عليه. الخادم يعرف الجملة التي وصل إليها كل لاعب، ويتحقق من الخيار
-- والمسافة، وهو وحده من يعالج أو يمنح الأغراض.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

-- الأشكال نفسها التي في DialogueData، كي يعرفها فاحص الأنواع في Studio هنا أيضًا
type Choice = { text: string, next: string?, action: string?, item: string?, failNext: string? }
type Line = { text: string, choices: { Choice } }
local DialogueData = require(ReplicatedStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }

local TALK_DISTANCE = 12 -- بالستاد: نصف قطر التلميح، ومدى القرب الذي يجب أن يبقى فيه اللاعب
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30

local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")

-- هذا السكربت ينشئ DialogueEvent بنفسه، فلا تضفه يدويًا
local dialogueEvent = Instance.new("RemoteEvent")
dialogueEvent.Name = "DialogueEvent"
dialogueEvent.Parent = ReplicatedStorage

type Conversation = { npc: Model, npcName: string, lineId: string, lastChoice: number }
local conversations: { [Player]: Conversation } = {}
local lastHeal: { [Player]: number } = {}

local function rootOf(model: Model?): BasePart?
	local root = model and model:FindFirstChild("HumanoidRootPart")
	return if root and root:IsA("BasePart") then root else nil
end

local function isClose(player: Player, npc: Model): boolean
	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	local playerRoot = rootOf(character)
	local npcRoot = rootOf(npc)
	if not (humanoid and humanoid.Health > 0 and playerRoot and npcRoot) then
		return false -- لا شخصية، أو أنها ميتة، أو اختفى الـ NPC
	end
	-- هامش صغير، لأن موقع اللاعب يصل إلى الخادم متأخرًا قليلًا
	return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end

-- ما يفعله الخادم عندما يكون للخيار إجراء. كل إجراء يعيد true إذا نُفّذ.
local ACTIONS: { [string]: (player: Player, choice: Choice) -> boolean } = {
	Heal = function(player)
		local now = os.clock()
		if now - (lastHeal[player] or -math.huge) < HEAL_COOLDOWN_SECONDS then
			return false -- عولج منذ وقت قريب جدًا
		end
		local character = player.Character
		local humanoid = character and character:FindFirstChildOfClass("Humanoid")
		if not (humanoid and humanoid.Health > 0) then
			return false
		end
		lastHeal[player] = now
		humanoid.Health = humanoid.MaxHealth
		return true
	end,
	GiveItem = function(player, choice)
		local itemName = choice.item
		local template = itemFolder and itemName and itemFolder:FindFirstChild(itemName)
		if not (itemName and template and template:IsA("Tool")) then
			warn(`DialogueService: no Tool named {itemName} in ServerStorage.DialogueItems`)
			return false
		end
		local backpack = player:FindFirstChildOfClass("Backpack")
		local character = player.Character
		if not backpack or backpack:FindFirstChild(itemName) or (character and character:FindFirstChild(itemName)) then
			return false -- لا حقيبة بعد، أو أن الغرض معه أصلًا
		end
		local item = template:Clone() :: Tool
		item.CanBeDropped = false -- كي لا يستطيع أحد رميه وطلب واحد آخر
		item.Parent = backpack
		return true
	end,
}

local function showLine(player: Player, conversation: Conversation)
	local line = DialogueData[conversation.npcName][conversation.lineId]
	local choiceTexts = {}
	for _, choice in line.choices do
		table.insert(choiceTexts, choice.text)
	end
	dialogueEvent:FireClient(player, "show", conversation.npc, line.text, choiceTexts)
end

local function endConversation(player: Player)
	if conversations[player] then
		conversations[player] = nil
		dialogueEvent:FireClient(player, "close")
	end
end

local function startConversation(player: Player, npc: Model)
	local npcName = npc.Name
	local lines = DialogueData[npcName]
	if conversations[player] or not (lines and lines.start) or not isClose(player, npc) then
		return -- يتحدث أصلًا، أو ليس لهذا الـ NPC جملة "start"، أو ميت، أو بعيد جدًا
	end
	local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
	conversations[player] = conversation
	showLine(player, conversation)
end

-- نقر اللاعب الخيار رقم choiceIndex (والرقم 0 يعني أنه أغلق النافذة)
dialogueEvent.OnServerEvent:Connect(function(player: Player, choiceIndex: unknown)
	local conversation = conversations[player]
	if not conversation then
		return
	end
	if typeof(choiceIndex) ~= "number" or choiceIndex ~= math.floor(choiceIndex) then
		return
	end
	if choiceIndex == 0 or not isClose(player, conversation.npc) then
		endConversation(player)
		return
	end
	local now = os.clock()
	if now - conversation.lastChoice < MIN_SECONDS_BETWEEN_CHOICES then
		-- سريع جدًا. نرسل الجملة نفسها مجددًا، لأن النافذة قد عطّلت
		-- الأزرار بعد النقر وإلا لانتظرت ردًا إلى الأبد.
		showLine(player, conversation)
		return
	end
	conversation.lastChoice = now

	local line = DialogueData[conversation.npcName][conversation.lineId]
	local choice = line.choices[choiceIndex]
	if not choice then
		return -- لا يوجد خيار كهذا في الجملة التي يقرؤها هذا اللاعب
	end
	local nextLine = choice.next
	if choice.action then
		local action = ACTIONS[choice.action]
		local done = false
		if action then
			done = action(player, choice)
		else
			warn(`DialogueService: no action named {choice.action}`)
		end
		if not done and choice.failNext then
			nextLine = choice.failNext -- مثل "I healed you a moment ago"
		end
	end
	if nextLine and not DialogueData[conversation.npcName][nextLine] then
		warn(`DialogueService: no line named {nextLine} for {conversation.npcName} in DialogueData`)
		nextLine = nil
	end
	if nextLine then
		conversation.lineId = nextLine
		showLine(player, conversation)
	else
		endConversation(player)
	end
end)

-- تلميح Talk على كل NPC
local function setUpNpc(npc: Instance)
	local root = if npc:IsA("Model") then rootOf(npc) else nil
	if not (npc:IsA("Model") and root) then
		return
	end
	if not (DialogueData[npc.Name] and DialogueData[npc.Name].start) then
		warn(`DialogueService: no conversation with a start line for {npc.Name} in DialogueData`)
	end
	local leftover = root:FindFirstChild("TalkPrompt")
	if leftover then
		leftover:Destroy() -- نسخة الـ NPC تجلب معها تلميحًا قديمًا لا يستمع إليه أحد
	end
	local prompt = Instance.new("ProximityPrompt")
	prompt.Name = "TalkPrompt"
	prompt.ActionText = "Talk"
	prompt.ObjectText = npc.Name
	prompt.MaxActivationDistance = TALK_DISTANCE
	prompt.RequiresLineOfSight = false
	prompt.Parent = root
	prompt.Triggered:Connect(function(player: Player)
		startConversation(player, npc)
	end)
end

for _, npc in npcFolder:GetChildren() do
	setUpNpc(npc)
end
npcFolder.ChildAdded:Connect(setUpNpc)

-- نغلق النافذة لكل من ابتعد أو مات في منتصف المحادثة
task.spawn(function()
	while true do
		task.wait(0.5)
		for player, conversation in conversations do
			if not isClose(player, conversation.npc) then
				endConversation(player)
			end
		end
	end
end)

Players.PlayerRemoving:Connect(function(player: Player)
	conversations[player] = nil
	lastHeal[player] = nil
end)

ينشئ DialogueService حدث RemoteEvent المسمى DialogueEvent بنفسه عند تشغيل اللعبة، فلا حاجة إلى إدراج أي شيء يدويًا في ReplicatedStorage. وإذا كنت قد أنشأت RemoteEvent بهذا الاسم فاحذفه: قد يعثر LocalScript على حدثك، ولا أحد على الخادم يستمع إليه.

الإعدادات في بداية DialogueService
الإعدادالقيمة هناماذا يغيّر
TALK_DISTANCE12مدى القرب، بالستاد، الذي يجب أن يكون فيه اللاعب ليظهر تلميح Talk. ويسمح له الخادم بالابتعاد 4 ستاد إضافية قبل إغلاق النافذة، لأن موقع اللاعب يصل إلى الخادم متأخرًا قليلًا.
MIN_SECONDS_BETWEEN_CHOICES0.3أقصر وقت بين نقرتين يقبله الخادم. وعلى النقرة الأسرع تُرسل الجملة نفسها مجددًا بدل الرد.
HEAL_COOLDOWN_SECONDS30كم ينتظر كل لاعب بين مرات العلاج من إجراء Heal.

يحفظ الخادم في conversations سجلًا واحدًا لكل لاعب: مع أي NPC يتحدث، وأي جملة يقرأ، ومتى قُبلت نقرته الأخيرة. عندما ينطلق تلميح Talk تنشئ startConversation هذا السجل فقط إذا لم يكن اللاعب يتحدث بعد، وكان للـ NPC جملة start، وكان اللاعب حيًا وداخل النطاق. بعد ذلك تمر كل نقرة بهذه الفحوص:

ما يفحصه DialogueService عند كل نقرة
الفحصالكودإذا لم ينجح
اللاعب في محادثةconversations[player]تُتجاهل النقرة.
الخيار عدد صحيحtypeof وmath.floorتُتجاهل. النصوص والجداول والكسور وNaN تتوقف هنا.
الرقم 0 يعني أن اللاعب ضغط XchoiceIndex == 0تنتهي المحادثة.
حي وما زال على بعد لا يزيد على 16 ستاد (12 زائد 4)isCloseتنتهي المحادثة وتُغلق النافذة.
مرّت 0.3 ثانية على الأقل منذ آخر نقرة مقبولةconversation.lastChoiceتُرسل الجملة نفسها مجددًا، فتحصل النافذة على أزرار جديدة بدل الانتظار إلى الأبد.
الخيار موجود في الجملة التي يقرؤها هذا اللاعبline.choices[choiceIndex]تُتجاهل.
نجح الإجراءكل إجراء يعيد true أو falseتُعرض الجملة failNext بدل next.

يُعلَّق التلميح على HumanoidRootPart الخاص بالـ NPC، لأن ProximityPrompt يعمل عندما يكون داخل قطعة (أو Attachment، أو نموذج له PrimaryPart) في Workspace. خاصيته RequiresLineOfSight مفعّلة افتراضيًا، وتخفي التلميح كلما حجب شيء الرؤية بين الكاميرا وتلك القطعة. يستثني Roblox من هذا الفحص قطعة التلميح نفسها، لكنه لا يستثني باقي الجسم، وHumanoidRootPart موجود داخل الجذع، لذلك يعطّل السكربت فحص خط الرؤية. يُسمى التلميح TalkPrompt، ويحذف السكربت أي TalkPrompt موجود أصلًا على القطعة قبل أن يضيف تلميحه: فنسخة الـ NPC المصنوعة أثناء اللعب تأتي ومعها تلميح الأصل، ولا أحد يستمع إلى التلميح المنسوخ. وإذا لم يكن في DialogueData محادثة فيها جملة start لاسم الـ NPC، فيظهر في Output تحذير باسم ذلك الـ NPC.

تفحص حلقة مرتين في الثانية كل محادثة مفتوحة وتغلقها عندما يبتعد اللاعب أكثر من 16 ستاد أو تموت شخصيته، كي لا يعود اللاعب الذي مات في منتصف المحادثة إلى الحياة والنافذة مفتوحة. ويمسح PlayerRemoving الجدولين كليهما عندما يغادر أحد.

الخطوة 4: أضف نافذة الحوار

افتح StarterPlayer، ومرّر المؤشر فوق StarterPlayerScripts، وأدرج LocalScript باسم DialogueClient، والصق فيه هذا الكود. إنه يبني نافذة الحوار بالكود، فلا حاجة إلى رسم الواجهة يدويًا.

LocalScript في StarterPlayer > StarterPlayerScripts باسم DialogueClient
-- LocalScript في StarterPlayer > StarterPlayerScripts باسم DialogueClient.
-- يرسم المحادثة التي يرسلها الخادم: اسم الـ NPC، وجملته التي تُكتب حرفًا
-- بعد حرف، وفقاعة فوق الرأس، وزرًا لكل خيار. النقر على
-- خيار لا يرسل إلا رقمه؛ والخادم يقرر ما يحدث بعد ذلك.

local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TextChatService = game:GetService("TextChatService")
local UserInputService = game:GetService("UserInputService")

local dialogueEvent = ReplicatedStorage:WaitForChild("DialogueEvent") :: RemoteEvent
local player = Players.LocalPlayer

local LETTERS_PER_SECOND = 45
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)

-- نافذة الحوار، مبنية بالكود
local gui = Instance.new("ScreenGui")
gui.Name = "Dialogue"
gui.ResetOnSpawn = false
gui.Enabled = false

local box = Instance.new("Frame")
box.AnchorPoint = Vector2.new(0.5, 1)
box.Position = UDim2.new(0.5, 0, 1, -84) -- أعلى بـ 84 بكسل كي لا يغطي شريط أدوات Roblox الخيارات
box.Size = UDim2.fromScale(0.6, 0.34)
box.BackgroundColor3 = Color3.fromRGB(24, 24, 32)
box.BackgroundTransparency = 0.1
box.Parent = gui
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(0, 12)
corner.Parent = box
local sizeLimit = Instance.new("UISizeConstraint")
sizeLimit.MaxSize = Vector2.new(720, 300)
sizeLimit.Parent = box

local nameLabel = Instance.new("TextLabel")
nameLabel.Position = UDim2.fromScale(0.04, 0.04)
nameLabel.Size = UDim2.fromScale(0.8, 0.14)
nameLabel.BackgroundTransparency = 1
nameLabel.TextXAlignment = Enum.TextXAlignment.Left
nameLabel.TextColor3 = Color3.fromRGB(190, 160, 255)
nameLabel.TextScaled = true
nameLabel.FontFace = BOLD
nameLabel.Parent = box

local lineLabel = nameLabel:Clone()
lineLabel.Position = UDim2.fromScale(0.04, 0.2)
lineLabel.Size = UDim2.fromScale(0.92, 0.3)
lineLabel.TextColor3 = Color3.new(1, 1, 1)
lineLabel.TextScaled = true -- الجملة الطويلة تصغر لتتسع على شاشة هاتف صغيرة
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- ولا تكبر أبدًا عن 20 بكسل على الشاشة الكبيرة
lineTextLimit.Parent = lineLabel

local closeButton = Instance.new("TextButton")
closeButton.AnchorPoint = Vector2.new(1, 0)
closeButton.Position = UDim2.new(1, -8, 0, 8)
closeButton.Size = UDim2.fromOffset(32, 32)
closeButton.BackgroundTransparency = 1
closeButton.Text = "X"
closeButton.TextColor3 = Color3.new(1, 1, 1)
closeButton.TextSize = 20
closeButton.FontFace = BOLD
closeButton.Parent = box

local choiceList = Instance.new("Frame")
choiceList.Position = UDim2.fromScale(0.04, 0.52)
choiceList.Size = UDim2.fromScale(0.92, 0.44)
choiceList.BackgroundTransparency = 1
choiceList.Parent = box
local layout = Instance.new("UIGridLayout")
layout.CellSize = UDim2.new(0.5, -6, 0.5, -6)
layout.CellPadding = UDim2.fromOffset(6, 6)
layout.SortOrder = Enum.SortOrder.LayoutOrder
layout.Parent = choiceList

gui.Parent = player:WaitForChild("PlayerGui")

local talkingTo: Model? = nil
local lineNumber = 0 -- يزيد مع كل جملة جديدة، كي تتوقف حلقة الكتابة القديمة

local function setPromptVisible(npc: Model?, visible: boolean)
	local root = npc and npc:FindFirstChild("HumanoidRootPart")
	local prompt = root and root:FindFirstChild("TalkPrompt")
	if prompt and prompt:IsA("ProximityPrompt") then
		prompt.Enabled = visible -- يتغير على هذا الجهاز فقط
	end
end

local function clearChoices()
	for _, child in choiceList:GetChildren() do
		if child:IsA("TextButton") then
			child:Destroy()
		end
	end
end

local function close()
	lineNumber += 1
	clearChoices()
	gui.Enabled = false
	setPromptVisible(talkingTo, true)
	talkingTo = nil
	GuiService.SelectedObject = nil
end

local function show(npc: Model, text: string, choices: { string })
	lineNumber += 1
	local thisLine = lineNumber
	if talkingTo ~= npc then
		setPromptVisible(talkingTo, true)
		talkingTo = npc
		setPromptVisible(npc, false)
	end
	gui.Enabled = true
	nameLabel.Text = npc.Name
	clearChoices()

	-- فقاعة فوق الـ NPC (DisplayBubble لا تعمل إلا في LocalScript)
	local head = npc:FindFirstChild("Head")
	if head then
		TextChatService:DisplayBubble(head, text)
	end

	-- نكتب الجملة حرفًا بعد حرف. العدد يُحسب من الوقت المنقضي،
	-- فتكون السرعة واحدة مع أي معدل إطارات.
	lineLabel.Text = text
	lineLabel.MaxVisibleGraphemes = 0
	local letters = 0
	for _ in utf8.graphemes(text) do
		letters += 1
	end
	local startTime = os.clock()
	local shown = 0
	while shown < letters do
		task.wait()
		if lineNumber ~= thisLine then
			return -- حلّت محل هذه الجملة جملة أحدث أو إغلاق
		end
		shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
		lineLabel.MaxVisibleGraphemes = shown
	end
	lineLabel.MaxVisibleGraphemes = -1

	-- زر لكل خيار؛ والخادم لا يتلقى إلا رقم الزر
	for index, choiceText in choices do
		local button = Instance.new("TextButton")
		button.LayoutOrder = index
		button.BackgroundColor3 = Color3.fromRGB(124, 77, 255)
		button.TextColor3 = Color3.new(1, 1, 1)
		button.TextScaled = true
		button.FontFace = BOLD
		button.Text = choiceText
		local buttonCorner = Instance.new("UICorner")
		buttonCorner.CornerRadius = UDim.new(0, 8)
		buttonCorner.Parent = button
		button.Parent = choiceList
		button.Activated:Connect(function()
			if lineNumber == thisLine then
				lineNumber += 1 -- نقرة واحدة لكل جملة
				dialogueEvent:FireServer(index)
			end
		end)
		if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
			GuiService.SelectedObject = button -- كي يمكن اختيار الخيار بذراع التحكم
		end
	end
end

closeButton.Activated:Connect(function()
	dialogueEvent:FireServer(0)
	close()
end)

dialogueEvent.OnClientEvent:Connect(function(kind: string, npc: Model?, text: string?, choices: { string }?)
	if kind == "show" and npc and text and choices then
		show(npc, text, choices)
	elseif kind == "close" then
		close()
	end
end)

يمكنك تغيير الألوان والأحجام وLETTERS_PER_SECOND كما تشاء. واترك المعالجين الأخيرين كما هما: فهما الطريقة الوحيدة التي تتواصل بها النافذة مع الخادم.

ماذا يفعل كل جزء من DialogueClient:

  • النافذة. ScreenGui فيه Frame مثبّت في أسفل وسط الشاشة، بعرض 60% منها وارتفاع 34%، مع حد 720 في 300 بكسل عبر UISizeConstraint كي لا يتمدد على الشاشة العريضة كلها. تستخدم جملة الـ NPC الخاصية TextScaled التي تصغّر النص ليتسع في عنصره على شاشة هاتف صغيرة، وUITextSizeConstraint يمنعه من أن يكبر عن 20 بكسل على الشاشة الكبيرة. ويرتب UIGridLayout الخيارات اثنين في اثنين. وResetOnSpawn قيمته false لأن هذا الـ LocalScript يعمل مرة واحدة في الجلسة: النافذة التي تُحذف عند العودة إلى الحياة لن تعود مرة أخرى.
  • تأثير الآلة الكاتبة. الجملة كلها تدخل الـ TextLabel دفعة واحدة، وMaxVisibleGraphemes يحدد كم حرفًا يظهر؛ وهي الخاصية نفسها التي يستخدمها مثال الآلة الكاتبة الخاص بـ Roblox مع utf8.graphemes. يرتب Roblox النص كأن كل الحروف ظاهرة، فلا تقفز الكلمات إلى سطر جديد ولا يتغير حجمها أثناء ظهورها. يحسب السكربت عدد الحروف التي يُظهرها من الوقت المنقضي، 45 في الثانية، فتكون السرعة واحدة مع أي معدل إطارات، ثم يضبط الخاصية على -1، وهذا يُظهر كل شيء.
  • الأزرار. تظهر عندما تكتمل كتابة الجملة. كل زر لا يرسل إلا رقمه ومرة واحدة: فحص lineNumber يمنع النقر المزدوج من الإرسال مرتين، وبعد ذلك تنتظر النافذة الجملة التالية من الخادم.
  • فقاعة الكلام. TextChatService:DisplayBubble(head, text) تضع الجملة في فقاعة دردشة فوق Head الخاص بالـ NPC. لا يسمح Roblox بذلك إلا في سكربتات العميل، والـ Bubble Chat مفعّل افتراضيًا. الفقاعة يرسمها جهاز هذا اللاعب، فلا يراها أحد غيره.
  • التلميح. ما دام اللاعب يتحدث، تكون نسخته من تلميح Talk (يُعثر عليها باسم TalkPrompt) معطّلة، كي لا تبقى معلّقة فوق المحادثة. والآخرون يظلون يرون تلميحاتهم.
  • أي جهاز. Activated ينطلق عند النقر بالفأرة، واللمس على الهاتف، وزر A في ذراع التحكم. ذراع التحكم لا يستطيع ضغط إلا الزر المحدد، لذلك عندما تقول PreferredInput إن اللاعب يستخدم ذراع تحكم يحدد السكربت الخيار الأول عبر GuiService.SelectedObject.
  • زر X. يرسل 0، وهو ما يفهمه الخادم على أنه «أنهِ المحادثة»، ويغلق النافذة فورًا.

أضف إجراءاتك الخاصة

الإجراء دالة في جدول ACTIONS في بداية DialogueService. تتلقى اللاعب والخيار وتعيد true عندما تؤدي عملها. لإضافة إجراء خاص بك، كمهمة (Quest) يمنحها الـ NPC:

  1. أضف إلى ACTIONS مدخلًا باسم StartQuest. الفحص أولًا ثم التغيير: إذا كان player:GetAttribute("Quest") مضبوطًا أصلًا فأعد false؛ وإلا فاستدعِ player:SetAttribute("Quest", "Cave") وأعد true.
  2. في DialogueData اضبط للخيار action = "StartQuest"، وجملة next لحالة النجاح، وجملة failNext لحالة الفشل، مثل "You are already on a quest."
  3. اضغط Play واختر الخيار مرتين. إذا لم يطابق الاسم في DialogueData المفتاح في ACTIONS (حالة الأحرف مهمة)، فسيظهر في Output DialogueService: no action named StartQuest، وتنتقل المحادثة إلى جملة failNext.

قواعد لكتابة الإجراءات:

  • اجعل الفحص والتغيير داخل الإجراء، على الخادم. فالشيء الوحيد الذي يرسله جهاز اللاعب هو رقم الخيار.
  • اقرأ ما يحتاجه الإجراء من الخيار (مثل item) أو من حالة الخادم نفسه، لكن لا تقرأه أبدًا من الـ Remote.
  • قيّد كل شيء ثمين داخل الإجراء نفسه، كما يحتفظ Heal بفترة انتظاره الخاصة البالغة 30 ثانية في lastHeal. فحد 0.3 ثانية لكل نقرة لا يفعل إلا إبطاء النقرات؛ ولا يمنع اللاعب من المرور بالخيار نفسه مرة بعد مرة.
  • لفتح نافذة أخرى، كالمتجر، يستطيع الإجراء إرسال RemoteEvent إلى هذا اللاعب وإعادة true. وكل ما يحدث في تلك النافذة يحتاج مع ذلك إلى فحوصه الخاصة على الخادم، كما في قسم الـ NPC البائع.

أين تخطئ دروس حوار الـ NPC الأخرى

إذا كنت تقارن هذا الدليل بفيديو أو منشور في المنتدى، فهذه هي الفروق المهمة وسبب أن كل أسلوب منها يسبب مشكلة.

أساليب شائعة في دروس حوار الـ NPC وما يفعله هذا الدليل بدلًا منها
الدرسالمشكلةهذا الدليل
يستخدم كائن Dialog، ويستمع Script الخادم إلى DialogChoiceSelected ليمنح المكافأةيقول مرجع Roblox إن هذا الحدث يعمل على جانب العميل فقط ولن ينطلق على الخادم، فلا تصل المكافأة أبدًا.يصل الخيار إلى الخادم رقمًا، والخادم يمنح المكافأة بنفسه.
يمنح المكافأة من LocalScriptالتغيير الذي يجريه LocalScript يبقى على ذلك الجهاز وحده (انظر ما الذي يُنسخ)، ويستطيع الغشاش تشغيل الكود نفسه متى شاء.كل الإجراءات تعيش في DialogueService.
يجعل الـ NPC يتكلم عبر game:GetService("Chat"):Chat(head, text)خدمة Chat قديمة، وتُستخدم TextChatService بدلًا منها.TextChatService:DisplayBubble في LocalScript.
يرسل من العميل اسم المكافأة أو معرّف الجملة التاليةيستطيع الغشاش إرسال أي اسم غرض أو القفز مباشرة إلى الجملة التي تمنح المكافأة.العميل لا يرسل إلا رقم الخيار. والخادم يجده في الجملة التي يعرف أن اللاعب يقرؤها.
لا يفحص شيئًا بعد انطلاق التلميحيضع دليل الأمان في Roblox الـ ProximityPrompt بجانب الـ Remotes بوصفه شيئًا قد يسيء العملاء استخدامه، وينصح بالتحقق من قرب اللاعب قبل تنفيذ الإجراء.تُفحص المسافة عند بدء المحادثة، وعند كل نقرة، ومرتين في الثانية ما دامت مفتوحة.
يكتب النص عبر wait() داخل حلقةالدالة العامة wait قديمة، وتُستخدم task.wait بدلًا منها.يحسب عدد الحروف الظاهرة من os.clock() وينتظر عبر task.wait().

ما الذي يستطيع اللاعب تزويره وما الذي لا يستطيعه

افترض أن الغشاش يتحكم في كل شيء على جهازه. يستطيع قراءة سكربتات LocalScript عندك وكل ما في ReplicatedStorage، واستدعاء DialogueEvent بأي معاملات وبأي عدد من المرات، وتشغيل تلميح Talk من الكود، كما يحذّر دليل الأمان في Roblox. ويرد DialogueService بفحوص على الخادم من النوع نفسه الذي يشرحه قسم التحقق من معاملات RemoteEvent. وإليك ما يكسبه الغشاش من ذلك.

ما قد يحاوله الغشاش وما يفعله DialogueService معه
يحاول الغشاشالنتيجةلماذا
تشغيل تلميح Talk من الطرف الآخر للخريطةلا يحدث شيءstartConversation تتحقق من أنه على بعد لا يزيد على 16 ستاد (12 زائد 4).
إرسال الخيار 99، أو نص، أو كسر، أو NaNيُتجاهلليس عددًا صحيحًا، أو لا يوجد خيار كهذا في الجملة التي يقرؤها.
إرسال اسم مكافأة أو معرّف جملةلا يُقرأ أبدًاالخادم لا يقرأ إلا رقم الخيار. والمكافآت تؤخذ من الحقلين item وaction في نسخة الخادم من الجملة.
النقر بأسرع ما تسمح به الشبكةنقرة واحدة كل 0.3 ثانية لكل محادثةالنقرات الأسرع تعود إليها جملتها نفسها. إنهاء المحادثة وإعادة بدئها يتجاوزان هذا الانتظار، لذلك يحتفظ Heal وGiveItem بحدودهما الخاصة.
طلب المصباح دون محادثةمستحيللا تُمنح الأغراض إلا بخيار في الجملة التي يعرف الخادم أن اللاعب عليها.
جمع كومة من المصابيحواحد في كل مرةيبحث الخادم أولًا عن Torch في Backpack اللاعب وشخصيته، والمصباح الممنوح لا يمكن رميه، فلا يمكن تكديسه بالرمي والطلب من جديد.
تكرار جملة العلاج بلا توقفعلاج واحد كل 30 ثانيةفترة الانتظار محفوظة على الخادم لكل لاعب، ويبلغه الـ NPC بذلك بالجملة healTooSoon.
الابتعاد وترك النافذة مفتوحةتُغلق في غضون نصف ثانيةيفحص الخادم كل محادثة مفتوحة مرتين في الثانية.
قراءة المحادثة كلها، ومنها الجمل التي لم يصل إليهاممكنDialogueData موجود في ReplicatedStorage الذي يُنسخ إلى كل جهاز. انقله إلى ServerStorage إن كان ذلك مهمًا (انظر الخطوة 2).

وهناك قيد يستحق أن يُقال بوضوح: الغشاش الذي يقترب من Guide ويختار الخيارات يحصل على ما يحصل عليه اللاعب النزيه بالضبط. فالخادم يتحكم في عدد المرات ومن أين، لا في من. وكل شيء نادر، كمكافأة لا يحصل عليها كل لاعب إلا مرة واحدة، يحتاج إلى فحص يملكه الخادم، مثل سمة تُضبط عند الاستلام أو علامة محفوظة في مخزن بيانات.

الخطوة 5: اختبره

  1. اضغط Play (F5) واقترب من Guide. على بعد 12 ستاد يظهر تلميح Talk باسم Guide. اضغط E.
  2. تُظهر النافذة "Guide"، وتكتب جملة الترحيب، ثم تُظهر أربعة أزرار. وتظهر الجملة نفسها في فقاعة فوق رأس الـ NPC.
  3. اختر "Any tips?"، ثم "Anything else?": عدت إلى الجملة الأولى. اختر "Bye!": تُغلق النافذة ويعود تلميح Talk.
  4. ألحق بنفسك ضررًا أولًا: اضغط مفتاح التبديل Client/Server للانتقال إلى Server، وحدد Humanoid شخصيتك في Workspace، واضبط Health على 50 في نافذة Properties، ثم عد إلى Client. تستعيد شخصيات اللاعبين 1% من MaxHealth كل ثانية، فتحدث إلى Guide فورًا واختر "I'm hurt. Can you help?": تقفز الصحة إلى الامتلاء. تحدث مجددًا خلال 30 ثانية واختره مرة أخرى: لا علاج، ويقول Guide إنه عالجك قبل قليل.
  5. اختر "Got anything for the cave?": يظهر Torch في شريط الأدوات. جهّزه واضغط Backspace: يبقى في يدك. اطلب مجددًا: لا مصباح ثانٍ، ويقول Guide إنه معك أصلًا.
  6. ابدأ محادثة وابتعد. تُغلق النافذة تقريبًا عندما تصبح على بعد 16 ستاد من Guide.
  7. اختر Server & Clients من القائمة المنسدلة لأوضاع الاختبار، وحدد عميلين، واضغط Play. يستطيع اللاعبان كلاهما التحدث إلى Guide في الوقت نفسه، كل منهما على جملته.
  8. اختبر ذراع التحكم عبر Controller Emulator (Controller في تبويب Emulation) أثناء تجربة اللعب. بذراع التحكم المحاكى اقترب واضغط زر التلميح (ButtonX افتراضيًا): عندما تظهر الخيارات يكون الأول محددًا، وA يضغطه.
  9. اختبر شاشة الهاتف عبر Device Simulator في Studio (وقت كتابة هذا الدليل هي ميزة تجريبية: فعّل New Device Simulator من File، ثم Beta Features، وأعد تشغيل Studio). اختر هاتفًا، واضغط Rotate حتى يصبح في الوضع الأفقي، ثم اضغط Play، واقترب من Guide، والمس تلميح Talk. اختر "Any tips?": تظهر الجملة كلها فوق أزرار الخيارات، بخط أصغر إن لزم، ولا تتداخل معها.

أبقِ نافذة Output مفتوحة طوال الوقت (قائمة Window، ثم Output). عندما تعمل هذه السكربتات لا تطبع شيئًا، لذا فأي خطأ أحمر أو تحذير يبدأ بـ DialogueService: مشكلة حقيقية. انظر الأخطاء الشائعة.

كيف توسّعه

شخصيات NPC أكثر ومحادثات أطول

أضف إلى مجلد NPCs هيكلًا آخر باسمه الخاص، وأضف إلى DialogueData جدولًا بالاسم نفسه فيه جملة start. يضيف DialogueService تلميح Talk لكل نموذج في المجلد له HumanoidRootPart، ومنها النماذج المضافة أثناء اللعب؛ ونسخة الـ NPC تحصل على تلميح جديد بدل التلميح الذي نُسخت معه. والـ NPC اللذان يحملان الاسم نفسه يستخدمان الجدول نفسه. يمكن ربط الجمل بأي ترتيب، ويمكن أن يقود خيار إلى جملة سابقة، مثل "Anything else?". لا تضع في الجملة أكثر من أربعة خيارات، لأن النافذة ترتبها اثنين في اثنين.

جمل تعتمد على التقدم

لتحيي اللاعبين العائدين بطريقة مختلفة، اختر الجملة الأولى بناءً على ما يملكه الخادم. في startConversation اخترها عبر local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start"، وتحقق من وجود الجملة كما يتحقق السكربت من lines.start، واستخدم firstLine بدل "start" عند إنشاء المحادثة. اضبط السمة في إجراء، وأضف الجملة welcomeBack إلى جدول Guide. السمات تعيش جلسة واحدة؛ ولتذكّر اللاعب بين الزيارات احفظ العلامة في مخزن بيانات، كما في درس DataStore.

الـ NPC البائع

ابنِ متجرًا وفق دليل واجهة المتجر، ثم أضف إجراء OpenShop يرسل RemoteEvent إلى هذا اللاعب ويعيد true، ودع LocalScript المتجر يفتح نافذته عندما يصل هذا الحدث. وتظل المشتريات تمر بفحوص المتجر الخاصة على الخادم. وإذا كان الشراء مسموحًا فقط قرب الـ NPC، فافحص المسافة داخل معالج الشراء أيضًا، لأن العميل يستطيع استدعاء Remote المتجر من أي مكان.

شخصيات NPC تمشي

لتجعل Guide يتجول أو يتبع اللاعبين، خذ دليل إيجاد المسار للـ NPC وأزل Anchored عن HumanoidRootPart كي يستطيع الحركة. تلميح Talk معلّق على هذه القطعة، فيتحرك مع الـ NPC، وفحوص المسافة تستخدم القطعة نفسها. أوقف المشي مؤقتًا ما دامت المحادثة مفتوحة، وإلا فستُغلق النافذة بمجرد أن يبتعد الـ NPC عن اللاعب أكثر من 16 ستاد.

مفاتيح ومهام ومكافآت أخرى

يمنح GiveItem أي Tool من DialogueItems، فيستطيع الـ NPC أن يعطي مفتاحًا يتحقق منه باب مقفل، كما في دليل الأبواب. وعن الأغراض التي تفعل شيئًا عند استخدامها، كطعام يعالج، اقرأ دليل المخزون.

الأصوات والكاميرا

لمقطع صوتي أو صوت قصير مع كل جملة، ضع Sound في Head الخاص بالـ NPC وشغّله من show في DialogueClient. ولتوجيه الكاميرا نحو الـ NPC أثناء كلامه، يشرح دليل المشاهد السينمائية كيف يتولى LocalScript التحكم بالكاميرا ثم يعيده.

الأخطاء الشائعة وحلولها

افتح نافذة Output (قائمة Window، ثم Output) قبل الضغط على Play. معظم مشكلات الحوار تطبع هناك تحذيرًا أو تنتج عن اسم غير مطابق.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'

ينتظر DialogueClient الـ Remote الذي ينشئه DialogueService، أي أن DialogueService لم يصل إلى هذه النقطة. تأكد أنه Script لا LocalScript، وأنه موجود مباشرة داخل ServerScriptService وغير معطّل. ينتظر DialogueService أولًا DialogueData في ReplicatedStorage والمجلد NPCs في Workspace، فغيابهما أو خطأ إملائي في اسميهما يوقفه أيضًا؛ وعندها يُظهر Output تحذير infinite yield من DialogueService بذلك الاسم.

لا يظهر تلميح Talk فوق الـ NPC

لا يضيف DialogueService التلميحات إلا للنماذج الموجودة مباشرة في Workspace، NPCs والتي فيها قطعة اسمها HumanoidRootPart. تحقق من الشرطين واقترب لأقل من 12 ستاد. قد لا يكون في هيكل من Toolbox هذه القطعة، أو قد يكون كائنًا من نوع آخر ملفوفًا داخل مجلد.

يظهر التلميح لكن الضغط على E لا يفعل شيئًا

لم يجد الخادم محادثة لهذا الـ NPC، وعند تشغيل اللعبة يُظهر Output DialogueService: no conversation with a start line for Guide in DialogueData باسم الـ NPC عندك. يجب أن يكون اسم الجدول في DialogueData مطابقًا تمامًا لاسم النموذج، بما في ذلك الأحرف الكبيرة، وأن يحتوي على جملة start.

الخيار يغلق النافذة بدل الانتقال إلى الجملة التالية

يُظهر Output DialogueService: no line named tip for Guide in DialogueData بالأسماء عندك: الـ next (أو failNext) في الخيار يسمّي جملة غير موجودة في جدول هذا الـ NPC. أسماء الجمل حساسة لحالة الأحرف، فطابق الكتابة مع الجدول، وهنا هي tips.

النافذة تعمل لكن لا توجد فقاعة كلام

تحتاج الفقاعة إلى قطعة اسمها Head مباشرة داخل نموذج الـ NPC، وإلى تفعيل الـ Bubble Chat: في Explorer حدد BubbleChatConfiguration تحت TextChatService وتأكد من تفعيل Enabled. وهو مفعّل افتراضيًا.

يقول Output DialogueService: no Tool named Torch in ServerStorage.DialogueItems

لم يستطع الخادم العثور على الغرض. تأكد أن المجلد في ServerStorage اسمه DialogueItems وأن فيه Tool (لا Model ولا Part) اسمه مطابق تمامًا لـ item في الخيار. وحتى تصلح ذلك يرد Guide بجملة hasTorch، لأن الإجراء فشل.

يقول Output DialogueService: no action named ...

الـ action في الخيار لا يطابق أي مفتاح في جدول ACTIONS. الأسماء حساسة لحالة الأحرف: heal ليست Heal.

اصنعه مع RoCode

إذا كان وصف الـ NPC أسهل عليك من بنائه يدويًا، فيستطيع RoCode كتابة هذه السكربتات مباشرة في المكان المفتوح عندك. إنه وكيل ذكاء اصطناعي مستقل لـ Roblox Studio، لا يتبع Roblox: تكتب في دردشة الويب، وتنشئ إضافته لـ Studio السكربتات وتعدّلها في Explorer عندك.

ما تكتبه

اجعل النموذج Guide في Workspace.NPCs يتكلم: تلميح Talk، ونافذة حوار بجمل تُكتب حرفًا حرفًا وأزرار للخيارات، وفقاعة فوق الرأس، وخيار علاج بفترة انتظار 30 ثانية، وخيار يمنح أداة Torch من ServerStorage مرة واحدة. احفظ المحادثة في ModuleScript وامنح كل المكافآت على الخادم.

ما يفعله RoCode
  • يستطيع أن يفحص النموذج أولًا عبر Get Properties ليقرأ القيم الأساسية، مثل Anchored في قطعه وWalkSpeed في الـ Humanoid الخاص به. اكتب / في الدردشة لترفق المسار الدقيق للنموذج
  • يكتب ModuleScript باسم DialogueData وScript باسم DialogueService وLocalScript باسم DialogueClient عبر Create Script
  • مطلوب منه أن يفحص ترجمة كل سكربت يكتبه عبر Check Script، الذي يترجمه داخل Studio دون تشغيله
  • يرسل التغييرات على دفعات، وكل دفعة نقطة تراجع في سجل Studio

مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل تجربة لعب قصيرة وقراءة الأخطاء، ومع الإضافة 3.9.11 أو أحدث يستطيع التحكم بشخصية اختبار ليتحقق من أن اللعبة تعمل، لكنه لا يلتقط صورًا أثناء اللعب، لذا اقترب من الـ NPC وتحدث إليه بنفسك. إذا لم يعمل شيء كما يجب فأخبر RoCode بما رأيته: يستطيع Check Output قراءة أسطر Server وClient من آخر تجربة لعب أجريتها. الـ NPC المتكلم نظام واحد من أنظمة كثيرة؛ وصفحة كيف تصنع لعبة Roblox بالذكاء الاصطناعي، نظامًا واحدًا في كل طلب تشرح كيف تجتمع معًا. كيف يتصل RoCode بـ Studio.

الأسئلة الشائعة

كيف أصنع NPC يتكلم في Roblox Studio؟

أضف إلى الـ NPC تلميح ProximityPrompt، وعندما يشغّله اللاعب اعرض جملة الـ NPC في نافذة حوار، أو في فقاعة، أو في كليهما. السكربتات الثلاثة في هذا الدليل تفعل الأمرين وتضيف خيارات للرد. وإذا كنت تحتاج إلى الفقاعة فقط، فاستدعِ TextChatService:DisplayBubble(npc.Head, "Hello!") من LocalScript عند انطلاق التلميح، كما في مثال الـ NPC في صفحة Roblox عن الـ Bubble Chat.

ماذا أختار: كائن Dialog أم واجهة حوار خاصة بي؟

كائن Dialog لا يحتاج إلى كود، ويُظهر فقاعة قابلة للنقر، وهذا يكفي للنص التزييني. حدث الاختيار فيه لا ينطلق إلا على جهاز اللاعب، فلا يستطيع منح المكافآت بأمان، وافتراضيًا لا يستطيع التحدث معه إلا لاعب واحد في الوقت نفسه. أما نافذتك الخاصة، كما في هذا الدليل، فتتيح للخادم منح كل مكافأة، وتعطي كل لاعب محادثته الخاصة.

كيف أمنح اللاعب غرضًا من NPC؟

احفظ الـ Tool في ServerStorage، ودع Script على الخادم يستنسخه إلى Backpack اللاعب عندما يختار ذلك الخيار، كما يفعل الإجراء GiveItem. تحقق من أن اللاعب لا يملك واحدًا أصلًا، وعطّل CanBeDropped في النسخة كي لا يمكن رميها وطلبها من جديد. ولا تسمح أبدًا لجهاز اللاعب بأن يحدد الغرض الذي يُمنح.

كيف أصنع نافذة حوار بتأثير الآلة الكاتبة؟

ضع الجملة كلها في TextLabel، وزِد MaxVisibleGraphemes من 0 ببضعة أحرف في كل مرة، وفي النهاية اضبطها على -1 ليظهر كل شيء. صفحة Roblox عن تحريك الواجهات تستخدم الخاصية نفسها مع utf8.graphemes. ويحسب DialogueClient عدد الحروف التي يُظهرها من الوقت المنقضي، 45 في الثانية، فلا تعتمد السرعة على معدل الإطارات.

هل يستطيع لاعبان التحدث إلى NPC واحد في الوقت نفسه؟

مع سكربتات هذا الدليل نعم: يدير الخادم محادثة واحدة لكل لاعب، ولا يرى كل لاعب إلا نافذته. أما كائن Dialog المدمج فيعمل بطريقة أخرى: مع قيمة BehaviorType الافتراضية، SinglePlayer، يتحدث لاعب واحد في كل مرة، ويرى الباقون خياراته.

هل يجب تصفية نص حوار الـ NPC؟

الجمل التي كتبتها بنفسك لا تحتاج إلى ذلك. يحمّلك Roblox مسؤولية تصفية النص المعروض الذي لا تتحكم فيه مباشرة، مثل ما يكتبه اللاعبون، أو الكلمات المركبة من حروف عشوائية، أو النص المحمّل من موقع خارجي. وإذا كان الـ NPC يكرر شيئًا كتبه لاعب فصفِّ ذلك الجزء.

المصادر والقراءات

كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.

جرّب RoCode على لعبتك أنت.

رصيد مجاني كل يوم ودون بطاقة. ثبّت الإضافة، وصف الميزة، وراجع ما يظهر في Studio.