باختصار
ضع نموذج الـ 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: صفِّ أي نص معروض لا تتحكم فيه مباشرة، مثل ما يكتبه اللاعبون.
في هذه الصفحة
كيف يعمل حوار الـ NPC
الـ NPC المتكلم الذي يعمل في لعبة حقيقية مقسوم بين الخادم وجهاز كل لاعب. الجهاز يرسم النافذة والأزرار. أما الخادم، وهو الطرف الوحيد الذي يمكن الوثوق به، فيعرف أي جملة يقرؤها كل لاعب، ويقرر ماذا يفعل كل رد. وتبدو جولة واحدة من المحادثة هكذا:
- يقترب اللاعب من الـ NPC ويضغط E على تلميح Talk الخاص به. ينطلق الحدث
Triggeredللتلميح على الخادم مع هذا اللاعب. - يتحقق سكربت الخادم من أن اللاعب قريب بما يكفي، ويتذكر أنه على الجملة المسماة
start، ويرسل نص هذه الجملة وعناوين خياراتها إلى هذا اللاعب وحده. - يكتب LocalScript الجملة في نافذة الحوار، ويُظهر فقاعة فوق الـ NPC، ثم يضيف زرًا لكل خيار.
- ينقر اللاعب أو يلمس أو يختار خيارًا. ولا يعود إلى الخادم إلا رقمه.
- يجد الخادم هذا الرقم في الجملة التي يعرف أن اللاعب يقرؤها، وينفذ إجراء الخيار إن وُجد (علاج، غرض)، ثم يرسل الجملة التالية أو يغلق النافذة.
| العنصر | أين يوجد | ماذا يفعل |
|---|---|---|
هيكل الشخصية Guide | Workspace، داخل مجلد اسمه NPCs | الـ NPC نفسه. اسمه يحدد المحادثة ويظهر على التلميح. |
ModuleScript DialogueData | ReplicatedStorage | كل الجمل التي قد يقولها الـ NPC، والخيارات تحت كل جملة، وإلى أين يقود كل خيار. |
Script DialogueService | ServerScriptService | يضيف تلميح Talk، ويتذكر الجملة التي وصل إليها كل لاعب، ويفحص كل نقرة، وينفذ الإجراءات. |
RemoteEvent DialogueEvent | ReplicatedStorage (ينشئه DialogueService) | يحمل كل جملة إلى اللاعب، ويعيد رقم الخيار المختار إلى الخادم. |
LocalScript DialogueClient | StarterPlayer، StarterPlayerScripts | يرسم النافذة، ويكتب الجملة، ويُظهر الفقاعة وأزرار الخيارات. |
Tool Torch (اختياري) | ServerStorage، داخل مجلد اسمه DialogueItems | الغرض الذي يمنحه أحد الخيارات. لا شيء من ServerStorage يُرسل إلى اللاعبين. |
Workspace
NPCs Folder new
Guide Model new
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (أجزاء الجسم)
ReplicatedStorage
DialogueData ModuleScript new
ServerScriptService
DialogueService Script new
ServerStorage
DialogueItems Folder new
Torch Tool new
Handle Part new
StarterPlayer
StarterPlayerScripts
DialogueClient LocalScript new
الخطوة 1: أضف الـ NPC
- في تبويب Avatar أو Home اضغط Character لفتح Rig Generator. اختر R15 وشكل الجسم والنمط. سيظهر في Workspace هيكل اسمه
Rig. وهيكل R6 يعمل مع السكربتات نفسها. - غيّر اسمه إلى
Guide. الاسم مهم: يبحث DialogueService عن المحادثة باسم النموذج، والتلميح يعرضه للاعبين. - وسّع الهيكل، وحدد HumanoidRootPart فيه، وفعّل Anchored في نافذة Properties. القطعة المثبّتة لا تتحرك أبدًا بفعل الفيزياء، فيقف الـ NPC حيث وضعته، ولا يستطيع اللاعبون دفعه.
- مرّر المؤشر فوق Workspace في Explorer، واضغط زر +، وأدرج Folder باسم
NPCs. اسحب Guide إليه، وضع الهيكل في مكان يستطيع اللاعبون الوصول إليه. - اختياري، لخيار الغرض: مرّر المؤشر فوق ServerStorage وأدرج Folder باسم
DialogueItems. ضع فيه Tool باسمTorchفيه Part واحد غير مثبّت اسمهHandle، وهو القطعة التي تمسكها الشخصية بيدها. ووضع PointLight داخل Handle يجعله يضيء.
الأسماء حساسة لحالة الأحرف، فاكتب NPCs وGuide وDialogueItems وTorch كما هي بالضبط. ويمكن أن يكون الـ NPC أي نموذج فيه Humanoid وHumanoidRootPart، ومنها نماذج Toolbox، ما دام موجودًا مباشرة داخل مجلد NPCs.
الخطوة 2: اكتب المحادثة
مرّر المؤشر فوق ReplicatedStorage، وأدرج ModuleScript باسم DialogueData، والصق فيه هذا الكود. لا منطق فيه، بل الكلمات والروابط بينها فقط، ولذلك سيكون هذا الملف هو الذي تعدّله أكثر من غيره.
-- ModuleScript في ReplicatedStorage باسم DialogueData.
-- كل المحادثات، حسب اسم الـ NPC في Workspace.NPCs. لكل جملة
-- نص يقوله الـ NPC وخيارات رد اللاعب. قد يقود الخيار إلى جملة أخرى (next)،
-- أو ينهي المحادثة (دون next)، أو يطلب من الخادم فعل شيء (action). إذا لم يستطع الخادم
-- تنفيذ الإجراء فإنه يعرض الجملة failNext بدل next.
export type Choice = {
text: string,
next: string?, -- الجملة التي تُعرض بعد هذا الخيار؛ وnil ينهي المحادثة
action: string?, -- إجراء على الخادم من جدول ACTIONS في DialogueService
item: string?, -- لإجراء GiveItem: اسم الـ Tool في ServerStorage.DialogueItems
failNext: string?, -- الجملة التي تُعرض بدل next عندما يتعذر تنفيذ الإجراء
}
export type Line = {
text: string,
choices: { Choice },
}
local DialogueData: { [string]: { [string]: Line } } = {
Guide = {
start = {
text = "Welcome to the village! What can I do for you?",
choices = {
{ text = "Any tips?", next = "tips" },
{ text = "I'm hurt. Can you help?", next = "healed", action = "Heal", failNext = "healTooSoon" },
{ text = "Got anything for the cave?", next = "torch", action = "GiveItem", item = "Torch", failNext = "hasTorch" },
{ text = "Bye!" },
},
},
tips = {
text = "Stay off the red bricks, and come back if you get hurt.",
choices = {
{ text = "Anything else?", next = "start" },
{ text = "Thanks!" },
},
},
healed = {
text = "There you go, good as new.",
choices = {
{ text = "Thank you!" },
},
},
torch = {
text = "Take this torch. The cave is dark.",
choices = {
{ text = "Thanks!" },
},
},
healTooSoon = {
text = "I healed you a moment ago. Come back in a little while.",
choices = {
{ text = "OK" },
},
},
hasTorch = {
text = "You already have my torch. Keep it lit!",
choices = {
{ text = "Will do!" },
},
},
},
}
return DialogueData
أسطر export type في البداية تصف شكل الجملة والخيار. لا تغيّر شيئًا أثناء اللعب؛ بل تصف بياناتك كي يستطيع فاحص الأنواع التحقق منها.
كيف ترتبط الأجزاء ببعضها:
- لكل NPC جدول مسمى باسم نموذجه في مجلد NPCs، وهنا هو
Guide. وكل محادثة تبدأ بالجملةstart. textهو ما يقوله الـ NPC. وchoicesهي أزرار اللاعب، بالترتيب. وفي النافذة مكان لأربعة.nextيسمّي الجملة التي تُعرض بعد هذا الخيار. والخيار الذي ليس فيهnext، مثل "Bye!"، ينهي المحادثة. وكذلك ينهيهاnextأوfailNextيسمّي جملة غير موجودة في الجدول، مع تحذير في Output.actionيسمّي ما يفعله الخادم، من جدولACTIONSفي DialogueService: وهنا هوHealأوGiveItem.itemيلزم لـ GiveItem: وهو اسم الـ Tool في ServerStorage، DialogueItems.failNextهي الجملة التي تُعرض بدلnextعندما يتعذر تنفيذ الإجراء، كي لا يدّعي الـ NPC أبدًا علاجًا أو هدية لم تحدث.
| الجملة | يقول Guide | الخيارات وإلى أين تقود |
|---|---|---|
start | "Welcome to the village! What can I do for you?" | "Any tips?" يقود إلى tips. و"I'm hurt. Can you help?" يعالج، ثم healed (أو healTooSoon). و"Got anything for the cave?" يمنح Torch، ثم torch (أو hasTorch). و"Bye!" ينهي المحادثة. |
tips | "Stay off the red bricks, and come back if you get hurt." | "Anything else?" يعيد إلى start. و"Thanks!" ينهي المحادثة. |
healed | "There you go, good as new." | "Thank you!" ينهي المحادثة. |
torch | "Take this torch. The cave is dark." | "Thanks!" ينهي المحادثة. |
healTooSoon | "I healed you a moment ago. Come back in a little while." | "OK" ينهي المحادثة. |
hasTorch | "You already have my torch. Keep it lit!" | "Will do!" ينهي المحادثة. |
هذه الوحدة لا يقرؤها إلا الخادم. فـ LocalScript لا يستدعيها أبدًا عبر require: يرسل الخادم كل جملة عندما يصل اللاعب إليها. لكن الوحدة في ReplicatedStorage تُنسخ مع ذلك إلى جهاز كل لاعب، فإذا كانت في المحادثة معلومات تحرق المفاجأة (مثل حل لغز)، فانقل DialogueData إلى ServerStorage. ثم في سطر require داخل DialogueService استبدل ReplicatedStorage بـ ServerStorage، ليصبح السطر كله هكذا: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.
الخطوة 3: أضف سكربت الخادم
مرّر المؤشر فوق ServerScriptService، وأدرج Script باسم DialogueService، والصق فيه الكود أدناه. هذا هو المكان الوحيد الذي تتقدم فيه المحادثة، والمكان الوحيد الذي تُمنح فيه المكافأة.
-- Script في ServerScriptService باسم DialogueService.
-- يضيف تلميح Talk لكل NPC في Workspace.NPCs ويدير كل محادثة.
-- جهاز اللاعب لا يفعل إلا عرض النص وإرسال رقم الخيار
-- الذي نقر عليه. الخادم يعرف الجملة التي وصل إليها كل لاعب، ويتحقق من الخيار
-- والمسافة، وهو وحده من يعالج أو يمنح الأغراض.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- الأشكال نفسها التي في DialogueData، كي يعرفها فاحص الأنواع في Studio هنا أيضًا
type Choice = { text: string, next: string?, action: string?, item: string?, failNext: string? }
type Line = { text: string, choices: { Choice } }
local DialogueData = require(ReplicatedStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }
local TALK_DISTANCE = 12 -- بالستاد: نصف قطر التلميح، ومدى القرب الذي يجب أن يبقى فيه اللاعب
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30
local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")
-- هذا السكربت ينشئ DialogueEvent بنفسه، فلا تضفه يدويًا
local dialogueEvent = Instance.new("RemoteEvent")
dialogueEvent.Name = "DialogueEvent"
dialogueEvent.Parent = ReplicatedStorage
type Conversation = { npc: Model, npcName: string, lineId: string, lastChoice: number }
local conversations: { [Player]: Conversation } = {}
local lastHeal: { [Player]: number } = {}
local function rootOf(model: Model?): BasePart?
local root = model and model:FindFirstChild("HumanoidRootPart")
return if root and root:IsA("BasePart") then root else nil
end
local function isClose(player: Player, npc: Model): boolean
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local playerRoot = rootOf(character)
local npcRoot = rootOf(npc)
if not (humanoid and humanoid.Health > 0 and playerRoot and npcRoot) then
return false -- لا شخصية، أو أنها ميتة، أو اختفى الـ NPC
end
-- هامش صغير، لأن موقع اللاعب يصل إلى الخادم متأخرًا قليلًا
return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end
-- ما يفعله الخادم عندما يكون للخيار إجراء. كل إجراء يعيد true إذا نُفّذ.
local ACTIONS: { [string]: (player: Player, choice: Choice) -> boolean } = {
Heal = function(player)
local now = os.clock()
if now - (lastHeal[player] or -math.huge) < HEAL_COOLDOWN_SECONDS then
return false -- عولج منذ وقت قريب جدًا
end
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if not (humanoid and humanoid.Health > 0) then
return false
end
lastHeal[player] = now
humanoid.Health = humanoid.MaxHealth
return true
end,
GiveItem = function(player, choice)
local itemName = choice.item
local template = itemFolder and itemName and itemFolder:FindFirstChild(itemName)
if not (itemName and template and template:IsA("Tool")) then
warn(`DialogueService: no Tool named {itemName} in ServerStorage.DialogueItems`)
return false
end
local backpack = player:FindFirstChildOfClass("Backpack")
local character = player.Character
if not backpack or backpack:FindFirstChild(itemName) or (character and character:FindFirstChild(itemName)) then
return false -- لا حقيبة بعد، أو أن الغرض معه أصلًا
end
local item = template:Clone() :: Tool
item.CanBeDropped = false -- كي لا يستطيع أحد رميه وطلب واحد آخر
item.Parent = backpack
return true
end,
}
local function showLine(player: Player, conversation: Conversation)
local line = DialogueData[conversation.npcName][conversation.lineId]
local choiceTexts = {}
for _, choice in line.choices do
table.insert(choiceTexts, choice.text)
end
dialogueEvent:FireClient(player, "show", conversation.npc, line.text, choiceTexts)
end
local function endConversation(player: Player)
if conversations[player] then
conversations[player] = nil
dialogueEvent:FireClient(player, "close")
end
end
local function startConversation(player: Player, npc: Model)
local npcName = npc.Name
local lines = DialogueData[npcName]
if conversations[player] or not (lines and lines.start) or not isClose(player, npc) then
return -- يتحدث أصلًا، أو ليس لهذا الـ NPC جملة "start"، أو ميت، أو بعيد جدًا
end
local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
conversations[player] = conversation
showLine(player, conversation)
end
-- نقر اللاعب الخيار رقم choiceIndex (والرقم 0 يعني أنه أغلق النافذة)
dialogueEvent.OnServerEvent:Connect(function(player: Player, choiceIndex: unknown)
local conversation = conversations[player]
if not conversation then
return
end
if typeof(choiceIndex) ~= "number" or choiceIndex ~= math.floor(choiceIndex) then
return
end
if choiceIndex == 0 or not isClose(player, conversation.npc) then
endConversation(player)
return
end
local now = os.clock()
if now - conversation.lastChoice < MIN_SECONDS_BETWEEN_CHOICES then
-- سريع جدًا. نرسل الجملة نفسها مجددًا، لأن النافذة قد عطّلت
-- الأزرار بعد النقر وإلا لانتظرت ردًا إلى الأبد.
showLine(player, conversation)
return
end
conversation.lastChoice = now
local line = DialogueData[conversation.npcName][conversation.lineId]
local choice = line.choices[choiceIndex]
if not choice then
return -- لا يوجد خيار كهذا في الجملة التي يقرؤها هذا اللاعب
end
local nextLine = choice.next
if choice.action then
local action = ACTIONS[choice.action]
local done = false
if action then
done = action(player, choice)
else
warn(`DialogueService: no action named {choice.action}`)
end
if not done and choice.failNext then
nextLine = choice.failNext -- مثل "I healed you a moment ago"
end
end
if nextLine and not DialogueData[conversation.npcName][nextLine] then
warn(`DialogueService: no line named {nextLine} for {conversation.npcName} in DialogueData`)
nextLine = nil
end
if nextLine then
conversation.lineId = nextLine
showLine(player, conversation)
else
endConversation(player)
end
end)
-- تلميح Talk على كل NPC
local function setUpNpc(npc: Instance)
local root = if npc:IsA("Model") then rootOf(npc) else nil
if not (npc:IsA("Model") and root) then
return
end
if not (DialogueData[npc.Name] and DialogueData[npc.Name].start) then
warn(`DialogueService: no conversation with a start line for {npc.Name} in DialogueData`)
end
local leftover = root:FindFirstChild("TalkPrompt")
if leftover then
leftover:Destroy() -- نسخة الـ NPC تجلب معها تلميحًا قديمًا لا يستمع إليه أحد
end
local prompt = Instance.new("ProximityPrompt")
prompt.Name = "TalkPrompt"
prompt.ActionText = "Talk"
prompt.ObjectText = npc.Name
prompt.MaxActivationDistance = TALK_DISTANCE
prompt.RequiresLineOfSight = false
prompt.Parent = root
prompt.Triggered:Connect(function(player: Player)
startConversation(player, npc)
end)
end
for _, npc in npcFolder:GetChildren() do
setUpNpc(npc)
end
npcFolder.ChildAdded:Connect(setUpNpc)
-- نغلق النافذة لكل من ابتعد أو مات في منتصف المحادثة
task.spawn(function()
while true do
task.wait(0.5)
for player, conversation in conversations do
if not isClose(player, conversation.npc) then
endConversation(player)
end
end
end
end)
Players.PlayerRemoving:Connect(function(player: Player)
conversations[player] = nil
lastHeal[player] = nil
end)
ينشئ DialogueService حدث RemoteEvent المسمى DialogueEvent بنفسه عند تشغيل اللعبة، فلا حاجة إلى إدراج أي شيء يدويًا في ReplicatedStorage. وإذا كنت قد أنشأت RemoteEvent بهذا الاسم فاحذفه: قد يعثر LocalScript على حدثك، ولا أحد على الخادم يستمع إليه.
| الإعداد | القيمة هنا | ماذا يغيّر |
|---|---|---|
TALK_DISTANCE | 12 | مدى القرب، بالستاد، الذي يجب أن يكون فيه اللاعب ليظهر تلميح Talk. ويسمح له الخادم بالابتعاد 4 ستاد إضافية قبل إغلاق النافذة، لأن موقع اللاعب يصل إلى الخادم متأخرًا قليلًا. |
MIN_SECONDS_BETWEEN_CHOICES | 0.3 | أقصر وقت بين نقرتين يقبله الخادم. وعلى النقرة الأسرع تُرسل الجملة نفسها مجددًا بدل الرد. |
HEAL_COOLDOWN_SECONDS | 30 | كم ينتظر كل لاعب بين مرات العلاج من إجراء Heal. |
يحفظ الخادم في conversations سجلًا واحدًا لكل لاعب: مع أي NPC يتحدث، وأي جملة يقرأ، ومتى قُبلت نقرته الأخيرة. عندما ينطلق تلميح Talk تنشئ startConversation هذا السجل فقط إذا لم يكن اللاعب يتحدث بعد، وكان للـ NPC جملة start، وكان اللاعب حيًا وداخل النطاق. بعد ذلك تمر كل نقرة بهذه الفحوص:
| الفحص | الكود | إذا لم ينجح |
|---|---|---|
| اللاعب في محادثة | conversations[player] | تُتجاهل النقرة. |
| الخيار عدد صحيح | typeof وmath.floor | تُتجاهل. النصوص والجداول والكسور وNaN تتوقف هنا. |
| الرقم 0 يعني أن اللاعب ضغط X | choiceIndex == 0 | تنتهي المحادثة. |
| حي وما زال على بعد لا يزيد على 16 ستاد (12 زائد 4) | isClose | تنتهي المحادثة وتُغلق النافذة. |
| مرّت 0.3 ثانية على الأقل منذ آخر نقرة مقبولة | conversation.lastChoice | تُرسل الجملة نفسها مجددًا، فتحصل النافذة على أزرار جديدة بدل الانتظار إلى الأبد. |
| الخيار موجود في الجملة التي يقرؤها هذا اللاعب | line.choices[choiceIndex] | تُتجاهل. |
| نجح الإجراء | كل إجراء يعيد true أو false | تُعرض الجملة 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.
-- يرسم المحادثة التي يرسلها الخادم: اسم الـ 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:
- أضف إلى
ACTIONSمدخلًا باسمStartQuest. الفحص أولًا ثم التغيير: إذا كانplayer:GetAttribute("Quest")مضبوطًا أصلًا فأعدfalse؛ وإلا فاستدعِplayer:SetAttribute("Quest", "Cave")وأعدtrue. - في DialogueData اضبط للخيار
action = "StartQuest"، وجملةnextلحالة النجاح، وجملةfailNextلحالة الفشل، مثل "You are already on a quest." - اضغط Play واختر الخيار مرتين. إذا لم يطابق الاسم في DialogueData المفتاح في
ACTIONS(حالة الأحرف مهمة)، فسيظهر في OutputDialogueService: no action named StartQuest، وتنتقل المحادثة إلى جملةfailNext.
قواعد لكتابة الإجراءات:
- اجعل الفحص والتغيير داخل الإجراء، على الخادم. فالشيء الوحيد الذي يرسله جهاز اللاعب هو رقم الخيار.
- اقرأ ما يحتاجه الإجراء من الخيار (مثل
item) أو من حالة الخادم نفسه، لكن لا تقرأه أبدًا من الـ Remote. - قيّد كل شيء ثمين داخل الإجراء نفسه، كما يحتفظ Heal بفترة انتظاره الخاصة البالغة 30 ثانية في
lastHeal. فحد 0.3 ثانية لكل نقرة لا يفعل إلا إبطاء النقرات؛ ولا يمنع اللاعب من المرور بالخيار نفسه مرة بعد مرة. - لفتح نافذة أخرى، كالمتجر، يستطيع الإجراء إرسال RemoteEvent إلى هذا اللاعب وإعادة
true. وكل ما يحدث في تلك النافذة يحتاج مع ذلك إلى فحوصه الخاصة على الخادم، كما في قسم الـ NPC البائع.
أين تخطئ دروس حوار الـ NPC الأخرى
إذا كنت تقارن هذا الدليل بفيديو أو منشور في المنتدى، فهذه هي الفروق المهمة وسبب أن كل أسلوب منها يسبب مشكلة.
| الدرس | المشكلة | هذا الدليل |
|---|---|---|
يستخدم كائن Dialog، ويستمع Script الخادم إلى DialogChoiceSelected ليمنح المكافأة | يقول مرجع Roblox إن هذا الحدث يعمل على جانب العميل فقط ولن ينطلق على الخادم، فلا تصل المكافأة أبدًا. | يصل الخيار إلى الخادم رقمًا، والخادم يمنح المكافأة بنفسه. |
| يمنح المكافأة من LocalScript | التغيير الذي يجريه LocalScript يبقى على ذلك الجهاز وحده (انظر ما الذي يُنسخ)، ويستطيع الغشاش تشغيل الكود نفسه متى شاء. | كل الإجراءات تعيش في DialogueService. |
يجعل الـ NPC يتكلم عبر game:GetService("Chat"):Chat(head, text) | خدمة Chat قديمة، وتُستخدم TextChatService بدلًا منها. | TextChatService:DisplayBubble في LocalScript. |
| يرسل من العميل اسم المكافأة أو معرّف الجملة التالية | يستطيع الغشاش إرسال أي اسم غرض أو القفز مباشرة إلى الجملة التي تمنح المكافأة. | العميل لا يرسل إلا رقم الخيار. والخادم يجده في الجملة التي يعرف أن اللاعب يقرؤها. |
| لا يفحص شيئًا بعد انطلاق التلميح | يضع دليل الأمان في Roblox الـ ProximityPrompt بجانب الـ Remotes بوصفه شيئًا قد يسيء العملاء استخدامه، وينصح بالتحقق من قرب اللاعب قبل تنفيذ الإجراء. | تُفحص المسافة عند بدء المحادثة، وعند كل نقرة، ومرتين في الثانية ما دامت مفتوحة. |
يكتب النص عبر wait() داخل حلقة | الدالة العامة wait قديمة، وتُستخدم task.wait بدلًا منها. | يحسب عدد الحروف الظاهرة من os.clock() وينتظر عبر task.wait(). |
ما الذي يستطيع اللاعب تزويره وما الذي لا يستطيعه
افترض أن الغشاش يتحكم في كل شيء على جهازه. يستطيع قراءة سكربتات LocalScript عندك وكل ما في ReplicatedStorage، واستدعاء DialogueEvent بأي معاملات وبأي عدد من المرات، وتشغيل تلميح Talk من الكود، كما يحذّر دليل الأمان في Roblox. ويرد DialogueService بفحوص على الخادم من النوع نفسه الذي يشرحه قسم التحقق من معاملات RemoteEvent. وإليك ما يكسبه الغشاش من ذلك.
| يحاول الغشاش | النتيجة | لماذا |
|---|---|---|
| تشغيل تلميح Talk من الطرف الآخر للخريطة | لا يحدث شيء | startConversation تتحقق من أنه على بعد لا يزيد على 16 ستاد (12 زائد 4). |
| إرسال الخيار 99، أو نص، أو كسر، أو NaN | يُتجاهل | ليس عددًا صحيحًا، أو لا يوجد خيار كهذا في الجملة التي يقرؤها. |
| إرسال اسم مكافأة أو معرّف جملة | لا يُقرأ أبدًا | الخادم لا يقرأ إلا رقم الخيار. والمكافآت تؤخذ من الحقلين item وaction في نسخة الخادم من الجملة. |
| النقر بأسرع ما تسمح به الشبكة | نقرة واحدة كل 0.3 ثانية لكل محادثة | النقرات الأسرع تعود إليها جملتها نفسها. إنهاء المحادثة وإعادة بدئها يتجاوزان هذا الانتظار، لذلك يحتفظ Heal وGiveItem بحدودهما الخاصة. |
| طلب المصباح دون محادثة | مستحيل | لا تُمنح الأغراض إلا بخيار في الجملة التي يعرف الخادم أن اللاعب عليها. |
| جمع كومة من المصابيح | واحد في كل مرة | يبحث الخادم أولًا عن Torch في Backpack اللاعب وشخصيته، والمصباح الممنوح لا يمكن رميه، فلا يمكن تكديسه بالرمي والطلب من جديد. |
| تكرار جملة العلاج بلا توقف | علاج واحد كل 30 ثانية | فترة الانتظار محفوظة على الخادم لكل لاعب، ويبلغه الـ NPC بذلك بالجملة healTooSoon. |
| الابتعاد وترك النافذة مفتوحة | تُغلق في غضون نصف ثانية | يفحص الخادم كل محادثة مفتوحة مرتين في الثانية. |
| قراءة المحادثة كلها، ومنها الجمل التي لم يصل إليها | ممكن | DialogueData موجود في ReplicatedStorage الذي يُنسخ إلى كل جهاز. انقله إلى ServerStorage إن كان ذلك مهمًا (انظر الخطوة 2). |
وهناك قيد يستحق أن يُقال بوضوح: الغشاش الذي يقترب من Guide ويختار الخيارات يحصل على ما يحصل عليه اللاعب النزيه بالضبط. فالخادم يتحكم في عدد المرات ومن أين، لا في من. وكل شيء نادر، كمكافأة لا يحصل عليها كل لاعب إلا مرة واحدة، يحتاج إلى فحص يملكه الخادم، مثل سمة تُضبط عند الاستلام أو علامة محفوظة في مخزن بيانات.
الخطوة 5: اختبره
- اضغط Play (F5) واقترب من Guide. على بعد 12 ستاد يظهر تلميح Talk باسم Guide. اضغط E.
- تُظهر النافذة "Guide"، وتكتب جملة الترحيب، ثم تُظهر أربعة أزرار. وتظهر الجملة نفسها في فقاعة فوق رأس الـ NPC.
- اختر "Any tips?"، ثم "Anything else?": عدت إلى الجملة الأولى. اختر "Bye!": تُغلق النافذة ويعود تلميح Talk.
- ألحق بنفسك ضررًا أولًا: اضغط مفتاح التبديل Client/Server للانتقال إلى Server، وحدد Humanoid شخصيتك في Workspace، واضبط Health على 50 في نافذة Properties، ثم عد إلى Client. تستعيد شخصيات اللاعبين 1% من MaxHealth كل ثانية، فتحدث إلى Guide فورًا واختر "I'm hurt. Can you help?": تقفز الصحة إلى الامتلاء. تحدث مجددًا خلال 30 ثانية واختره مرة أخرى: لا علاج، ويقول Guide إنه عالجك قبل قليل.
- اختر "Got anything for the cave?": يظهر Torch في شريط الأدوات. جهّزه واضغط Backspace: يبقى في يدك. اطلب مجددًا: لا مصباح ثانٍ، ويقول Guide إنه معك أصلًا.
- ابدأ محادثة وابتعد. تُغلق النافذة تقريبًا عندما تصبح على بعد 16 ستاد من Guide.
- اختر Server & Clients من القائمة المنسدلة لأوضاع الاختبار، وحدد عميلين، واضغط Play. يستطيع اللاعبان كلاهما التحدث إلى Guide في الوقت نفسه، كل منهما على جملته.
- اختبر ذراع التحكم عبر Controller Emulator (Controller في تبويب Emulation) أثناء تجربة اللعب. بذراع التحكم المحاكى اقترب واضغط زر التلميح (ButtonX افتراضيًا): عندما تظهر الخيارات يكون الأول محددًا، وA يضغطه.
- اختبر شاشة الهاتف عبر Device Simulator في Studio (وقت كتابة هذا الدليل هي ميزة تجريبية: فعّل New Device Simulator من File، ثم Beta Features، وأعد تشغيل Studio). اختر هاتفًا، واضغط Rotate حتى يصبح في الوضع الأفقي، ثم اضغط Play، واقترب من Guide، والمس تلميح Talk. اختر "Any tips?": تظهر الجملة كلها فوق أزرار الخيارات، بخط أصغر إن لزم، ولا تتداخل معها.
أبقِ نافذة Output مفتوحة طوال الوقت (قائمة Window، ثم Output). عندما تعمل هذه السكربتات لا تطبع شيئًا، لذا فأي خطأ أحمر أو تحذير يبدأ بـ DialogueService: مشكلة حقيقية. انظر الأخطاء الشائعة.
كيف توسّعه
شخصيات NPC أكثر ومحادثات أطول
أضف إلى مجلد NPCs هيكلًا آخر باسمه الخاص، وأضف إلى DialogueData جدولًا بالاسم نفسه فيه جملة start. يضيف DialogueService تلميح Talk لكل نموذج في المجلد له HumanoidRootPart، ومنها النماذج المضافة أثناء اللعب؛ ونسخة الـ NPC تحصل على تلميح جديد بدل التلميح الذي نُسخت معه. والـ NPC اللذان يحملان الاسم نفسه يستخدمان الجدول نفسه. يمكن ربط الجمل بأي ترتيب، ويمكن أن يقود خيار إلى جملة سابقة، مثل "Anything else?". لا تضع في الجملة أكثر من أربعة خيارات، لأن النافذة ترتبها اثنين في اثنين.
جمل تعتمد على التقدم
لتحيي اللاعبين العائدين بطريقة مختلفة، اختر الجملة الأولى بناءً على ما يملكه الخادم. في startConversation اخترها عبر local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start"، وتحقق من وجود الجملة كما يتحقق السكربت من lines.start، واستخدم firstLine بدل "start" عند إنشاء المحادثة. اضبط السمة في إجراء، وأضف الجملة welcomeBack إلى جدول Guide. السمات تعيش جلسة واحدة؛ ولتذكّر اللاعب بين الزيارات احفظ العلامة في مخزن بيانات، كما في درس DataStore.
الـ NPC البائع
ابنِ متجرًا وفق دليل واجهة المتجر، ثم أضف إجراء 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 وامنح كل المكافآت على الخادم.
- يستطيع أن يفحص النموذج أولًا عبر 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 يكرر شيئًا كتبه لاعب فصفِّ ذلك الجزء.
المصادر والقراءات
- Roblox Creator Docs: Proximity prompts (بالإنجليزية). إنشاء التلميحات، وMaxActivationDistance وRequiresLineOfSight
- Roblox Engine API: ProximityPrompt (بالإنجليزية). أين يعمل التلميح، ونصه ومفاتيحه الافتراضية، وTriggered وفحص خط الرؤية
- Roblox Creator Docs: Securing the client-server boundary (بالإنجليزية). الـ ProximityPrompt بوصفه سطح هجوم، وفحوص المسافة والصلاحيات
- Roblox Engine API: Dialog (بالإنجليزية). BehaviorType والحدث DialogChoiceSelected على العميل فقط
- Roblox Engine API: TextChatService:DisplayBubble (بالإنجليزية). فقاعات الكلام لشخصيات NPC من سكربتات العميل
- Roblox Creator Docs: Customize bubble chat (بالإنجليزية). فقاعات الـ NPC وBubbleChatConfiguration
- Roblox Creator Docs: Text filtering (بالإنجليزية). أي نص معروض يجب تصفيته
- Roblox Creator Docs: UI animation and tweens (بالإنجليزية). تأثير الآلة الكاتبة عبر MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (بالإنجليزية). ماذا يفعل Backspace بالأداة
- Roblox Engine API: UserInputService.PreferredInput (بالإنجليزية). كيف تتعرف على اللاعب الذي يستخدم ذراع التحكم
- Roblox Creator Docs: Rig Generator (بالإنجليزية). إدراج هيكل R15 أو R6
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.