دليل · تصحيح الأخطاء

كيف تصلح أخطاء السكربتات في Roblox Studio

عندما يتعطل سكربت في Roblox، يكتب Studio عادةً أين ولماذا في نافذة Output. في هذا الدليل نشرح كيف تقرأ هذه الرسالة، وما معنى الأخطاء الشائعة وكيف تصلح كل واحد منها، وما الذي تفحصه إذا لم يعمل السكربت إطلاقًا دون أي خطأ، وترتيب خطوات يجد السبب بدل التخمين.

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

باختصار

افتح نافذة Output من قائمة Window أو من تبويب Script، واضغط Play، ثم انقر على أول خطأ أحمر. سيفتح Studio السكربت على السطر الذي تعطل فيه. تقول الرسالة ما الذي حدث: attempt to index nil with 'Humanoid' تعني أن القيمة التي تسبق .Humanoid مباشرةً كانت nil. أصلح سبب غياب هذه القيمة، وشغّل اللعبة من جديد.

  • ابدأ بأول خطأ في القائمة. الأخطاء التي تحته غالبًا مجرد نتائج له.
  • الأخطاء الشائعة أثناء اللعب ترجع إلى ثلاثة أسباب: القيمة تساوي nil، أو الاسم مكتوب خطأ أو لم يُحمَّل بعد، أو الكود يعمل في الجهة الخاطئة (الخادم أو العميل).
  • إذا لم يظهر أي خطأ فغالبًا لم يعمل الكود أصلًا. افحص نوع السكربت، ومكانه في Explorer، وخاصية Enabled فيه، وهل يُطلق الحدث الذي ينتظره أصلًا.
  • لتعرف القيمة الحقيقية في السطر المطلوب، اطبعها عبر print مع وصف، أو ضع نقطة توقف (breakpoint) على هذا السطر.
في هذه الصفحة
  1. قراءة Output
  2. ترتيب التصحيح
  3. الأخطاء الشائعة
  4. لا أخطاء ولا شيء يحدث
  5. أدوات التصحيح
  6. مع RoCode
  7. الأسئلة الشائعة
  8. المصادر والقراءات

كيف تفتح Output وتقرأ الخطأ

رسم توضيحيمثال كتلة القتل من الدليل، بسرعة مضاعفة: السطر المعطوب يعطي خطأ، وبعد Stop والإصلاح واختبار لعب جديد تسقط القطعة دون خطأ.

نافذة Output هي المكان الذي يبلّغ فيه Roblox عن أخطاء السكربتات وتحذيرات المحرك وكل ما يطبعه كودك. ليست مفتوحة دائمًا، لذا افتحها قبل الاختبار. وإذا لم تشغّل أي سكربت من قبل، فإن دليل البرمجة للمبتدئين يبدأ بفتح Output وطباعة أول سطر من سكربت.

  1. افتح Output من قائمة Window في Studio أو بالزر في تبويب Script.
  2. امسح الرسائل القديمة بـ Ctrl+K (⌘K على Mac)، لترى رسائل هذا الاختبار وحده.
  3. اضغط Play (F5) وافعل ما يعطّل اللعبة.
  4. ابحث عن أول سطر أحمر. الأخطاء حمراء. أما التحذيرات، مثل Infinite yield possible، فتظهر باللون البرتقالي.

هكذا يبدو خطأ أثناء اللعب في Output. وبحسب إعدادات عرض Output قد يظهر لكل سطر أيضًا الوقت، والوسم Client أو Server، واسم السكربت.

Output (مثال)
ServerScriptService.CoinPad:14: attempt to index nil with 'Coins'
Stack Begin
Script 'ServerScriptService.CoinPad', Line 14 - function award
Script 'ServerScriptService.CoinPad', Line 27
Stack End
  • ServerScriptService.CoinPad هو مكان السكربت في Explorer: سكربت باسم CoinPad داخل ServerScriptService.
  • :14 هو السطر الذي حدث فيه الخطأ.
  • الرسالة بعد رقم السطر تقول ما الذي حدث. كل رسالة مشروحة في قائمة الأخطاء الشائعة أدناه.
  • المكدس بين Stack Begin وStack End يُظهر الاستدعاءات التي أوصلت إلى هنا، بدءًا من آخرها: السطر 14 داخل الدالة award، التي استُدعيت من السطر 27.

انقر على الخطأ الأحمر، فيفتح Studio هذا السكربت والمؤشر على السطر المطلوب. في الاختبار الفردي تذهب رسائل الخادم ورسائل عميلك إلى Output واحد: رسائل الخادم معلّمة بالأخضر، ورسائل العميل بالأزرق. المرشحات في الأعلى تضيّق القائمة بحسب نوع الرسالة (Error وWarning)، أو بحسب السياق (Client وServer)، أو بحسب النص.

ترتيب لتصحيح الأخطاء يناسب أي سكربت

التخمين وتغيير عدة أشياء دفعة واحدة طريقة بطيئة لإصلاح سكربت. هذا الترتيب يضيّق المشكلة خطوة بعد خطوة، سواء ظهرت رسالة خطأ أم لا.

  1. كرّر المشكلة. امسح Output، واضغط Play، وافعل بالضبط ما يعطّل اللعبة. دوّن ما كنت تتوقعه وما حدث بدلًا منه.
  2. خذ أول خطأ. اقرأ أول سطر أحمر جديد: مسار السكربت، ورقم السطر، والرسالة. وإذا لم يوجد خطأ فانتقل إلى قسم السكربتات التي تعمل دون أخطاء.
  3. اذهب إلى السطر. انقر على الخطأ. اقرأ السطر كاملًا واسأل نفسك: أي قيمة فيه قد تكون nil، أو مكتوبة خطأ، أو من نوع خاطئ؟
  4. افحص القيمة ولا تخمّن. أضف print فوق السطر مباشرةً، أو ضع عليه نقطة توقف وانظر إلى القيم في نافذة Watch. يخبرك typeof(x) بما لديك: رقم، أو نص، أو Instance، أو nil.
  5. تتبّع الأثر إلى الخلف. إذا كانت القيمة خاطئة فابحث عن المكان الذي ضُبطت فيه: FindFirstChild لم يجد شيئًا، أو دالة لم تُرجع شيئًا، أو وسيط لم يمرّره الكود المستدعي أبدًا.
  6. أصلح السبب، تغييرًا واحدًا في كل مرة. صحّح الاسم، أو انتظر الكائن، أو انقل الكود إلى الجهة الصحيحة، ثم شغّل اللعبة من جديد. لا تلفّ السطر بـ pcall لإسكاته: هكذا يُخفى الخلل ولا يُصلح.
  7. تأكّد. كرّر الخطوة 1. يجب أن يختفي الخطأ، وأن تفعل الميزة ما توقعته. وإذا كان الأمر يخص لاعبين آخرين فاختبر أيضًا في وضع Server & Clients مع عميلين.
  8. نظّف بعدك. احذف أوامر print الخاصة بالتصحيح أو عطّلها، ليسهل ملاحظة المشكلة التالية.

أخطاء سكربتات Roblox الشائعة وكيف تصلحها

كل رسالة مبنية على قالب واحد تُدرج فيه أسماؤك، لذلك نص الخطأ نفسه أفضل دليل. الأسماء بين علامات الاقتباس أدناه، مثل 'Health' أو "Workspace"، أمثلة فقط.

الأخطاء الشائعة في Output. اختر رسالة لتفتح شرحها الكامل.
ما يكتبه Outputماذا يعنيالإصلاح المعتاد
attempt to index nil with 'Health'القيمة التي تسبق .Health كانت nil.اعرف لماذا هي nil، وافحصها بـ if قبل استخدامها.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild ينتظر منذ 5 ثوانٍ ولم يظهر الكائن.صحّح الاسم أو المسار، وتأكد أن شيئًا ما ينشئ الكائن، أو أضف مهلة.
Bridge is not a valid member of Workspace "Workspace"لا يوجد هناك الآن كائن فرعي أو خاصية بهذا الاسم بالضبط.طابق الكتابة والأحرف الكبيرة مع Explorer. وفي العميل استخدم WaitForChild.
attempt to call a nil valueاستدعيت شيئًا ليس دالة.افحص اسم الدالة، وأنها معرّفة فوق الاستدعاء.
attempt to perform arithmetic (add) on Instance and numberعملية حسابية على شيء ليس رقمًا.استخدم .Value في كائنات القيم، وtonumber للنصوص.
attempt to concatenate string with nilحاول .. وصل نص بقيمة nil أو بكائن.استخدم tostring() أو .Name أو استيفاء النصوص.
Expected 'end' (to close 'function' at line 3), got <eof>خطأ في الصياغة. لا يعمل السكربت إطلاقًا.أصلح ما يُبرزه Script Editor بخط أحمر.
Requested module experienced an error while loadingModuleScript نفسه تعطل بخطأ أثناء تنفيذه.أصلح خطأ الوحدة نفسها، وهو ظاهر فوقه مباشرةً في Output.
Argument 1 missing or nilدالة من Roblox تلقت nil حيث تحتاج إلى قيمة.تتبّع المكان الذي كان يجب أن يأتي منه هذا الوسيط.
FireServer can only be called from the clientاستُدعي RemoteEvent من الجهة الخاطئة.الخادم يستخدم FireClient، وLocalScript يستخدم FireServer.
خطأ مخزن البيانات 403، StudioAccessToApisNotAllowedغير مسموح لـ Studio باستخدام مخازن بيانات هذه اللعبة.انشر اللعبة وفعّل Studio Access to API Services.

لكل رسالة من هنا، ولغيرها، صفحة خاصة تضم كل سبب، والكود الذي يسببه، والإصلاح: راجع رسائل أخطاء Roblox Studio، مثل attempt to index nil وInfinite yield possible وis not a valid member of.

attempt to index nil with 'X'

الفهرسة هي قراءة شيء عبر النقطة أو الأقواس المربعة: part.Position وplayer.Character وlist[1]. هذا الخطأ يقول إن ما على اليسار كان nil، والاسم بين علامات الاقتباس هو ما حاولت قراءته منه. إذن في السطر player.Character.Humanoid يعني الخطأ attempt to index nil with 'Humanoid' أن player.Character كان nil. وإذا كان المفتاح رقمًا فتنتهي الرسالة بـ with number.

الأسباب المعتادة لكون القيمة nil:

  • FindFirstChild أو FindFirstChildOfClass أو FindFirstAncestor لم يجد شيئًا، لأن الاسم مختلف أو لأن الكائن غير موجود بعد.
  • استُخدم Players.LocalPlayer في Script على الخادم. هو موجود فقط في LocalScript وفي ModuleScript التي تستدعيها عبر require، وعلى الخادم يكون nil دائمًا. استخدم بدلًا منه player الذي يعطيه PlayerAdded أو معالج RemoteEvent.
  • قُرئ player.Character قبل ظهور الشخصية، أو أثناء إعادة ظهورها.
  • لم يُضبط إدخال في الجدول أبدًا، مثل playerData[player] قبل تحميل بيانات هذا اللاعب، أو أن الدالة المستدعاة لم تُرجع شيئًا.

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

Script في Part في Workspace باسم KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- النسخة المعطوبة:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- إذا لم تكن القطعة الملامسة جزءًا من جسم شخصية، يُرجع FindFirstChild
	-- القيمة nil، ويُظهر Output:
	--   attempt to index nil with 'Health'

	-- بعد الإصلاح: نفحص كل خطوة قبل استخدامها
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

إذا كتبت hit.Parent.Humanoid فستظهر رسالة مختلفة، Humanoid is not a valid member of ...، وهي مشروحة أدناه. يجد FindFirstAncestorOfClass("Model") الشخصية حتى عندما تكون القطعة الملامسة داخل إكسسوار أو أداة في يد الشخصية، لذا تُحتسب أيضًا الأداة في اليد إذا لمست الكتلة.

القالب الذي يصلح هذا الخطأ: احصل على القيمة، وافحصها، ثم استخدمها. على الخادم يناسب FindFirstChild مع فحص if ما قد لا يكون موجودًا أصلًا. وفي LocalScript استخدم WaitForChild لما ينشئه الخادم، لأنه قد يظهر بعد بدء تشغيل السكربت.

Infinite yield possible on ...

يوقف WaitForChild("Name") السكربت مؤقتًا حتى يظهر كائن فرعي بهذا الاسم. وإذا انتظر أكثر من 5 ثوانٍ ولم تحدد مهلة، يطبع Roblox هذا التحذير. إنه تحذير وليس خطأ: السكربت ما زال ينتظر، ولن يُنفَّذ شيء بعد هذا السطر حتى يظهر الكائن، وقد لا يحدث ذلك أبدًا. الأسباب المعتادة:

  • اسم أو أب خاطئ. WaitForChild("leaderStats") لن يجد أبدًا المجلد leaderstats.
  • لا أحد ينشئ الكائن: سكربت الخادم الذي يصنعه معطّل، أو في المكان الخطأ، أو تعطل بخطأ قبل ذلك. ابحث عن خطأ أسبق في Output.
  • LocalScript ينتظر شيئًا في ServerStorage أو ServerScriptService. محتواهما لا يُرسل إلى اللاعبين أبدًا، لذلك لن ينتهي الانتظار.
  • أنت تنتظر خاصية لا كائنًا فرعيًا. المثال الشائع player:WaitForChild("Character"): الـ Character خاصية في Player، لا كائن داخله.
  • بث الكائنات مفعّل (Workspace.StreamingEnabled)، والقطعة بعيدة جدًا عن اللاعب، فلم تُرسل إلى هذا العميل بعد.
LocalScript في StarterPlayerScripts باسم DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- النسخة المعطوبة:
--   local character = player:WaitForChild("Character")
-- الـ Character خاصية في Player وليست كائنًا فرعيًا، لذا يحذّر Output:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- مع المهلة يُرجع WaitForChild القيمة nil بدل الانتظار إلى الأبد
	local humanoid = character:WaitForChild("Humanoid", 10)
	if not (humanoid and humanoid:IsA("Humanoid")) then
		warn(`[DeathMessage] no Humanoid in {character:GetFullName()} after 10 seconds`)
		return
	end
	humanoid.Died:Connect(function()
		print(`[DeathMessage] {player.Name} died`)
	end)
end

-- نعالج الشخصية التي قد تكون موجودة أصلًا، ثم كل إعادة ظهور
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

الرقم في الوسيط الثاني لـ WaitForChild هو المهلة بالثواني. عندها يستطيع السكربت الإبلاغ عن المشكلة عبر warn والتوقف بهدوء، بدل التعليق صامتًا.

X is not a valid member of Y

وصلت عبر النقطة إلى كائن فرعي أو خاصية غير موجودة في تلك اللحظة، مثل workspace.Bridge عندما لا توجد في Workspace قطعة باسم Bridge. في الرسالة يأتي أولًا ما طلبته، ثم الصنف والمسار الكامل للكائن الذي بحثت فيه. افحص ثلاثة أشياء:

  • الكتابة والأحرف الكبيرة مطابقة تمامًا لـ Explorer. اسم المجلد leaderstats بأحرف صغيرة كلها، وhumanoid ليس Humanoid.
  • أسماء الخصائص بالتهجئة الأمريكية. part.Colour يتعطل بالخطأ Colour is not a valid member of Part "Workspace.Part"، فالخاصية اسمها Color.
  • الكائن حُمّل. في العميل قد تصل الكائنات التي ينشئها الخادم بعد بدء LocalScript، لذا استخدم هناك WaitForChild.
LocalScript في StarterPlayerScripts باسم CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- النسخة المعطوبة:
--   local coins = player.leaderstats.Coins
-- الخادم ينشئ leaderstats، وقد يصل إلى هذا العميل بعد
-- بدء تشغيل هذا السكربت. عندها يُظهر Output:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- الخادم يصنع Coins كـ IntValue

print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
	print(`[CoinsWatcher] coins changed to {newValue}`)
end)

تحتاج هنا إلى سكربت خادم ينشئ leaderstats مع IntValue باسم Coins، كما في دليل لوحة الصدارة.

attempt to call a nil value

وضع الكود أقواسًا بعد شيء يساوي nil، فلم يكن هناك ما يُشغَّل. الأسباب المعتادة:

  • اسم الدالة مكتوب خطأ أو يختلف في الأحرف الكبيرة. الوحدة تعرّف Format.clock، والكود المستدعي يكتب Format.Clock(95).
  • تُستدعى local function في سطر يسبق تعريفها. في تلك اللحظة لا يوجد الاسم بعد، لذا انقل التعريف إلى الأعلى.
  • لا يضيف ModuleScript الدالة أبدًا إلى الجدول الذي يُرجعه.

رسالتان متشابهتان تشيران إلى الخطأ نفسه. استدعاء دالة غير موجودة في جدول عبر النقطتين يعطي attempt to call missing method 'Kill' of table. وخطأ إملائي في دالة كائن Roblox، مثل part:Destory()، يعطي Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

حاول Luau إجراء عملية حسابية (add وsub وmul وdiv وغيرها)، وأحد الطرفين لم يكن رقمًا. أسماء الأنواع في نهاية الرسالة تدلك على حالتك:

  • on Instance and number: أجريت الحساب على كائن قيمة لا على رقمه. يجب أن يكون coins + 10 هو coins.Value + 10.
  • on nil and number: لم يُضبط المتغير أو إدخال الجدول أبدًا. أعطه قيمة أولية، أو اكتب (x or 0) حيث يعني غياب القيمة صفرًا فعلًا.
  • on string and number: نص ليس رقمًا، وكثيرًا ما يأتي من TextBox. حوّله عبر tonumber(text) وتأكد أن النتيجة ليست nil. أما النص الذي يحوي رقمًا، مثل "5"، فيُحوَّل تلقائيًا.

المقارنات تتعطل بالطريقة نفسها، مع attempt to compare nil < number. يعيد Luau كتابة a > b على صورة b < a، لذا قد يكون الترتيب في الرسالة معكوسًا عن كودك.

Script في ServerScriptService باسم CoinDrip
local Players = game:GetService("Players")

local REWARD = 5
local INTERVAL_SECONDS = 60

local function addCoins(player: Player, amount: number)
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if not (coins and coins:IsA("IntValue")) then
		-- نكتب لماذا لم يحدث شيء بدل الصمت
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- النسخة المعطوبة:
	--   coins = coins + amount
	-- الـ coins كائن IntValue وليس رقمه، لذا يُظهر Output:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- كل دقيقة نعطي كل لاعب على الخادم بعض العملات
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

العامل .. يصل النصوص والأرقام فقط. لا يمكن الوصل مع nil، ولا مع كائن: "Hi " .. player يعطي attempt to concatenate string with Instance. استخدم player.Name، أو لفّ القيمة بـ tostring()، أو استخدم استيفاء النصوص بعلامات الاقتباس المائلة، print(`Coins: {coins}`)، الذي يطبع nil بدل أن يوقف السكربت.

Expected 'end' وأخطاء الصياغة الأخرى

الرسائل التي تبدأ بـ Expected أخطاء صياغة: الكود ليس Luau صحيحًا، ولا يستطيع Roblox ترجمته، ولا يُنفَّذ أي سطر من هذا السكربت، حتى الأسطر التي فوق الخطأ. يُبرزها Script Editor بخط أحمر أثناء الكتابة، فيمكنك إصلاحها قبل الضغط على Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: الـ function أو if أو for أو while الذي يبدأ في السطر 3 ليس له end. رقم السطر قبل الرسالة يشير غالبًا إلى نهاية الملف، لذا انظر إلى السطر المذكور بين القوسين.
  • Expected 'then' when parsing if statement, got '=': علامة = مفردة في الشرط. المقارنة تحتاج إلى ==.
  • Expected ')' (to close '(' at line 1), got 'local': لم يُغلق القوس أبدًا.
  • Expected <eof>, got 'end': كلمة end زائدة واحدة.

مع إزاحة منتظمة يسهل ملاحظة end ناقص أو زائد، لأن كل كتلة تقف على مستوى واحد مع end الذي يغلقها.

Requested module experienced an error while loading

أول require() لـ ModuleScript يشغّل كوده. وإذا تعطلت الوحدة بخطأ أثناء التنفيذ، يتلقى السكربت الذي استدعاها هذه الرسالة. المشكلة الحقيقية هي خطأ الوحدة نفسها قبل سطر أو سطرين في Output: أصلحه. رسالتان متشابهتان:

  • Module code did not return exactly one value: الوحدة لا تنتهي بـ return. يجب أن يُرجع ModuleScript قيمة واحدة ليست nil، وعادةً جدوله.
  • Requested module was required recursively: وحدتان تستدعي كل منهما الأخرى. انقل الجزء المشترك إلى وحدة ثالثة تستدعيها الاثنتان.
ModuleScript في ReplicatedStorage باسم Format
local Format = {}

-- يحوّل عدد الثواني إلى دقائق وثوانٍ: 95 تصبح "1:35"
function Format.clock(seconds: number): string
	local whole = math.max(0, math.floor(seconds))
	return string.format("%d:%02d", whole // 60, whole % 60)
end

-- يجب أن تُرجع الوحدة جدولها في النهاية. دون هذا السطر يتعطل كل
-- require لهذه الوحدة بالخطأ: Module code did not return exactly one value
return Format

يستدعيه السكربت عبر local Format = require(ReplicatedStorage:WaitForChild("Format"))، ثم يستدعي Format.clock(95). وإذا كتبت Format.Clock(95) فستحصل على الخطأ attempt to call a nil value.

Argument 1 missing or nil

تلقت دالة من Roblox القيمة nil في وسيط تحتاجه، والرقم يقول أي وسيط بالتحديد. يتعطل workspace:FindFirstChild(itemName) بهذا الشكل عندما يكون itemName يساوي nil. نادرًا ما يكون الخلل في هذا السطر. إنه في المكان الذي كان يجب أن تأتي منه القيمة: متغير فيه خطأ إملائي، أو سمة لم تُضبط أبدًا، أو وسيط RemoteEvent لم يرسله العميل. وسائط RemoteEvent تأتي من جهاز اللاعب، لذا يجب أن يفحصها الخادم قبل استخدامها. طريقة ذلك يشرحها دليل RemoteEvent.

FireServer can only be called from the client

للـ RemoteEvent اتجاه. LocalScript يستدعي FireServer، وScript على الخادم يستمع عبر OnServerEvent. وScript على الخادم يستدعي FireClient أو FireAllClients، وسكربتات LocalScript تستمع عبر OnClientEvent. استدعاء الدالة من الجهة الخاطئة يعطي هذا الخطأ أو نظيره المعاكس، FireClient can only be called from the server. الإصلاح عادةً نقل الكود إلى سكربت من النوع الصحيح: راجع Script وLocalScript وModuleScript.

خطأ مخزن البيانات 403 في Studio

استدعاءات مخزن البيانات في Studio تتعطل برمز الخطأ 403 (StudioAccessToApisNotAllowed) حتى تسمح بها. انشر المكان، وافتح File ثم Experience Settings ثم Security، وفعّل Enable Studio Access to API Services واحفظ. بعدها يستخدم Studio مخازن البيانات نفسها التي تستخدمها اللعبة الحية، لذا تنصح Roblox بفعل ذلك في نسخة اختبار منفصلة، لا في لعبة يلعبها الناس فعلًا. لفّ كل استدعاء لمخزن البيانات بـ pcall، لأن هذه الاستدعاءات قد تتعطل لأسباب خارج كودك. طريقة الحفظ الآمن مشروحة في درس DataStore.

السكربت يعمل دون أخطاء لكنه لا يفعل شيئًا

السكربت الصامت غالبًا لم يعمل أصلًا، أو ما زال ينتظر شيئًا، أو عمل في الجهة الخاطئة. قبل تغيير الكود اجعل أول سطر فيه print(script:GetFullName(), "started") وشغّل اللعبة. إذا لم يظهر هذا السطر في Output أبدًا، فالمشكلة في مكان السكربت أو إعداده، لا في ما كُتب فيه.

لماذا قد لا يفعل السكربت شيئًا دون خطأ
ما تفحصهما الخطأكيف تصلحه
نوع السكربت ومكانهيعمل LocalScript فقط إذا وضعته في StarterPlayerScripts أو StarterCharacterScripts أو StarterGui أو StarterPack أو ReplicatedFirst (من حاويات Starter يعمل كنسخة للاعب). وإذا وضعته في Workspace أو ServerScriptService أو ReplicatedStorage فلن يعمل أبدًا. أما Script بقيمة RunContext الافتراضية فيعمل فقط في Workspace أو ServerScriptService.انقله أو استخدم نوع سكربت آخر. كود الواجهة والتحكم يذهب إلى LocalScript، وقواعد اللعبة تذهب إلى Script في ServerScriptService.
Enabledالسكربت الذي أُزيلت منه علامة Enabled لا يعمل.حدّده وفعّل Enabled في نافذة Properties.
RunContextخاصية RunContext في Script تحدد أين يعمل. Legacy، وهي القيمة الافتراضية، تعمل على الخادم من Workspace أو ServerScriptService. Server تعمل على الخادم، وClient تعمل على جهاز كل لاعب، مثلًا من ReplicatedStorage.اضبطها عن وعي. توثيق Roblox ينصح بوضع Client Script في ReplicatedStorage أو ReplicatedFirst، وLocalScript في حاويات Starter.
الحدث لا يُطلقلا يُطلق Touched إلا من حركة فيزيائية، ويجب أن تكون إحدى القطعتين على الأقل غير مثبتة، وأن يكون CanTouch مفعّلًا في الاثنتين. ولا يُطلق PlayerAdded للاعبين الذين كانوا على الخادم أصلًا عندما ربطت الحدث. ولن يعمل معالج RemoteEvent إذا لم تستدعِ الجهة الأخرى الحدث أبدًا.ضع print داخل المعالج لتعرف بالتأكيد هل يعمل، ثم أصلح ما يجب أن يستدعيه.
كود بعد حلقة أو انتظارالأسطر تحت حلقة while true do لا تُنفَّذ أبدًا، لأن الحلقة لا تنتهي. وكذلك الأسطر تحت WaitForChild لا يجد الكائن أبدًا.اربط الأحداث قبل الحلقة أو شغّل الحلقة عبر task.spawn. وأعطِ الانتظارات مهلة.
فحص يخرج بصمتحماية مثل if not coins then return end توقف الدالة بصمت عندما يغيب الكائن.أضف warn بالتفاصيل قبل return.
مرشحات Outputيمكن ترشيح Output بحسب نوع الرسالة، وبحسب Client أو Server، وبحسب النص. مرشح منسي قد يخفي الخطأ الذي تبحث عنه.أزل المرشحات وامسح خانة البحث.
تراه أنت فقطأجرى LocalScript التغيير، لذا يراه هذا اللاعب وحده. الخادم واللاعبون الآخرون لا يرونه.أجرِ التغيير على الخادم. راجع أين تعمل السكربتات.

كثيرون يقعون في حالة PlayerAdded، لأنك في اختبار Studio تدخل فور بدء الخادم تقريبًا. إذا كان شيء فوق سطر Connect ينتظر، مثل WaitForChild أو task.wait أو require لوحدة تنتظر، فقد تدخل قبل أن يُنشأ الربط. عالج اللاعبين الجدد ومن دخلوا أصلًا:

Script في ServerScriptService باسم Welcome
local Players = game:GetService("Players")

local function onPlayerAdded(player: Player)
	print(`[Welcome] {player.Name} joined`)
end

Players.PlayerAdded:Connect(onPlayerAdded)

-- للاعبين الذين كانوا هنا عندما نُفّذ السطر أعلاه،
-- لن يُطلق PlayerAdded في هذا السكربت، لذا نعالجهم الآن
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

أدوات تصحيح الأخطاء في Roblox Studio

يكتب print سطرًا في Output، ويكتب warn تحذيرًا. هذه أسرع طريقة للإجابة عن سؤالي "هل عمل هذا أصلًا؟" و"ما قيمة هذا؟". الـ print(x) المجرد يصعب العثور عليه لاحقًا، لذا أضف وصفًا والتفاصيل المهمة. يُظهر typeof(x) نوع القيمة: رقم، أو نص، أو Instance، أو nil، ويُظهر GetFullName() أي كائن لديك بالتحديد.

Script في ServerScriptService باسم ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- اجعلها false عندما تنتهي
local TAG = "[ShopServer]"

local function debugPrint(...: any)
	if DEBUG then
		print(TAG, ...)
	end
end

Players.PlayerAdded:Connect(function(player: Player)
	debugPrint("joined:", player.Name, player.UserId)

	local leaderstats = player:WaitForChild("leaderstats", 10)
	if not leaderstats then
		warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
		return
	end

	local coins = leaderstats:FindFirstChild("Coins")
	-- يُظهر typeof وClassName حقيقة القيمة
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

خانة البحث في Output ترشّح بحسب النص، لذا يتيح وسم ثابت مثل [ShopServer] إظهار أسطر هذا النظام وحده. وإذا أردت معرفة كيف وصل الكود إلى سطر ما، فإن debug.traceback() يُرجع مكدس الاستدعاءات الحالي كنص.

نقاط التوقف والتنفيذ خطوة بخطوة

نقطة التوقف (breakpoint) توقف اللعبة مؤقتًا عند سطر، لتتمكن من فحص كل شيء في تلك اللحظة. في Script Editor انقر على الهامش بجانب رقم السطر (ستظهر دائرة حمراء)، ثم شغّل اختبار اللعب. عندما يصل التنفيذ إلى هذا السطر تتوقف اللعبة مؤقتًا، ويُظهر سهم أصفر السطر التالي. وتنقلك أزرار التنفيذ خطوة بخطوة عبر الكود:

  • Step Over (F10) ينفّذ السطر الحالي ويتوقف عند التالي.
  • Step Into (F11) يدخل إلى الدالة المستدعاة في هذا السطر.
  • Step Out (Shift+F11) يكمل الدالة الحالية حتى نهايتها ويتوقف في الكود الذي استدعاها.
  • Resume Scripts يتابع حتى نقطة التوقف التالية.

النقر بالزر الأيمن على الهامش يعطي نوعين مفيدين آخرين. نقطة التوقف الشرطية توقف اللعبة فقط عندما يكون تعبير مثل amount < 0 صحيحًا. وLogpoint يطبع رسالة في Output دون توقف، فتستطيع تسجيل قيمة دون تغيير السكربت.

Watch وCall Stack

أثناء توقف اللعبة، مرّر المؤشر فوق متغير في Script Editor لترى قيمته. تُظهر نافذة Watch في تبويب Variables كل المتغيرات في النطاق، وفي تبويب My Watches يمكنك إدخال أي تعبير، مثل coins.Value + amount، ورؤية قيمته الحالية. وتُظهر نافذة Call Stack أي دالة استدعت أيها حتى الوصول إلى السطر المتوقف. تُفتح الاثنتان من تبويب Script أو من قائمة Window.

Script Analysis والوضع الصارم

يُبرز Script Editor المشكلات أثناء الكتابة، ونافذة Script Analysis، التي تُفتح بزر Analysis في تبويب Script، تعرض الأخطاء والتحذيرات في كل السكربتات. تلتقط أخطاء الصياغة والأسماء المجهولة قبل الضغط على Play. وإذا جعلت أول سطر في السكربت --!strict يُفعَّل فحص الأنواع الصارم في Luau، الذي يبلّغ أيضًا عن الأخطاء الإملائية في الخصائص، والأنواع الخاطئة للوسائط، والقيم التي قد تكون nil. لكنه لا يرى اللعبة أثناء تشغيلها: القطعة الغائبة عن Workspace لن يُظهرها إلا Output.

Command bar

ينفّذ Command bar (في تبويب Script أو بـ Ctrl+9، و⌘9 على Mac) كود Luau فورًا. أثناء تشغيل اللعبة هذه طريقة سريعة لطرح سؤال: print(workspace:FindFirstChild("Bridge")) يخبرك هل توجد هذه القطعة، وprint(#game:GetService("Players"):GetPlayers()) يعدّ اللاعبين. في وضع التحرير يغيّر الكود في command bar مكانك فعلًا، لذا احذر من كل ما ينقل الكائنات أو يحذفها.

Developer Console في اللعبة الحية

Output في Studio يعمل في Studio فقط. في اللعبة الحية اضغط F9 أو اكتب /console في الدردشة لتفتح Developer Console. يُظهر سجلها (Log) المخرجات من جهازك، ومخرجات الخادم إذا كنت مالك اللعبة أو عضوًا في مجموعة لها صلاحية تعديلها.

يستطيع Assistant المدمج في Roblox أيضًا المساعدة في رسالة بعينها: دليل Roblox نفسه ينصح بلصق الخطأ من Output وطلب شرحه من Assistant. وإذا توقف Assistant عن الرد أو كتب أنك بلغت الحد، فراجع حدود Assistant وأخطاءه.

إصلاح الأخطاء مع RoCode

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

ما تكتبه

ضغطت Play، والنقر على زر المتجر لا يفعل شيئًا. يُظهر Output السطر attempt to index nil with 'Coins'. ابحث عن السبب وأصلحه.

ما يفعله RoCode
  • يقرأ Output في Studio بأداته Check Output، بما في ذلك أسطر Server وClient من آخر اختبار لعب لك، حتى بعد أن تضغط Stop
  • يفتح السكربت المذكور في الخطأ عبر Read Script ويقرأ الكود حول هذا السطر، ويمكنه عبر Search Scripts أن يجد أين كان يجب أن تُنشأ القيمة الغائبة
  • يجري تعديلًا دقيقًا عبر Edit Script، أي بحثًا واستبدالًا دقيقين في هذا السكربت، ثم يشغّل Check Script الذي يترجم السكربت داخل Studio (لا يفحص الأنواع، ولا يشغّل أداة lint، ولا ينفّذ كودك)
  • يرسل التغييرات إلى Studio على دفعات، وكل دفعة نقطة تراجع في سجل Studio

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

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

لماذا لا يعمل السكربت في Roblox مع أنه لا توجد أخطاء؟

غالبًا لم يعمل السكربت أصلًا (نوع سكربت أو حاوية خاطئة، أو Enabled معطّل)، أو ما زال ينتظر شيئًا، أو أن الحدث الذي يستمع إليه لا يُطلق أبدًا. سطر print في البداية يُظهر أي الاحتمالات هو. راجع قائمة الفحص أعلاه.

ما معنى "attempt to index nil" في Roblox؟

القيمة التي تسبق النقطة أو النقطتين كانت nil، فلم يستطع Roblox النظر داخلها. في السطر player.Character.Humanoid يعني الخطأ attempt to index nil with 'Humanoid' أن player.Character كان nil: غير موجود أو لم يُحمَّل بعد. افحص القيمة بـ if قبل استخدامها، وفي LocalScript انتظر الكائنات التي ينشئها الخادم عبر WaitForChild. المزيد عن الأسباب.

ما معنى "infinite yield possible" في Roblox؟

ينتظر WaitForChild منذ أكثر من 5 ثوانٍ كائنًا فرعيًا لم يظهر، وما زال ينتظر. غالبًا السبب اسم أو أب خاطئ، أو أن لا أحد ينشئ الكائن. المزيد عن الأسباب.

لماذا نافذة Output فارغة أو لا تظهر؟

افتحها من قائمة Window أو من تبويب Script. وإذا كانت مفتوحة لكنها تبقى فارغة أثناء الاختبار، فأزل المرشحات وامسح خانة البحث، ثم تأكد أن السكربتات التي يجب أن تطبع شيئًا تعمل.

هل في Roblox فاحص للأخطاء في السكربتات؟

نعم، وهو مدمج في Studio: يُبرز Script Editor المشكلات أثناء الكتابة، وتعرضها نافذة Script Analysis في قائمة. يجدان أخطاء الصياغة وأخطاء الأنواع، لكن لا يجدان الكائنات الغائبة ولا منطق اللعبة الخاطئ: هذا لا يظهر إلا عند تشغيل الكود.

هل يجب لفّ الكود بـ pcall كي لا تظهر أخطاء؟

فقط الاستدعاءات التي قد تتعطل لأسباب خارج كودك، مثل طلبات مخازن البيانات وHTTP وMarketplaceService. إذا لففت خطأ nil بـ pcall فستختفي الرسالة، لكن الميزة لن تعمل مع ذلك.

كيف أرى أخطاء السكربتات في اللعبة الحية؟

اضغط F9 في اللعبة أو اكتب /console في الدردشة لتفتح Developer Console. تُظهر الأخطاء من جهازك، ومن الخادم إذا كنت مالك اللعبة أو عضوًا في مجموعة يمكنه تعديلها.

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

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

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

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