درس · أساسيات السكربتات

كيف تكتب السكربتات في Roblox Studio: دليل للمبتدئين

كتابة السكربتات، أو البرمجة، في Roblox Studio تعني الكتابة بلغة Luau، وهي نسخة Roblox من لغة Lua، داخل سكربتات تضيفها إلى المكان. يبدأ هذا الدليل من Baseplate فارغة: ستفتح نافذة Output، وتكتب أول سكربت، وتغيّر قطعة من الكود، وتتفاعل مع لاعب يدوس على منصة، وتجرّب LocalScript، وفي الطريق ستفهم المتغيرات والدوال والشروط والحلقات والأحداث.

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

باختصار

لتكتب سكربتًا في Roblox Studio، مرّر المؤشر فوق ServerScriptService في Explorer، واضغط + وأدرج Script. سيفتحه Studio في Script Editor. اكتب Luau، مثل print("Hello")، واضغط Play (F5) واقرأ النتيجة في نافذة Output (قائمة Window أو تبويب Script). يعمل Script على الخادم ويغيّر كل شيء للجميع، أما LocalScript في StarterPlayerScripts فيعمل على جهاز لاعب واحد.

  • تعلّم أولًا أربع أفكار: المتغيرات (local coins = 3)، والدوال (local function name() ... end)، وشروط if، والأحداث (part.Touched:Connect(...)). السكربتات الأربعة في هذا الدليل مبنية منها، إضافة إلى الحلقات والجداول.
  • استخدم task.wait() لا wait(). يصف مرجع Roblox الدالة العامة wait() بأنها قديمة (deprecated) وحلّت محلها task.wait().
  • في إعدادات العرض لنافذة Output فعّل Show Context، ليُظهر كل سطر هل جاء من Server أم من Client.
في هذه الصفحة
  1. قبل البدء
  2. 1. أول سكربت
  3. 2. تغيير قطعة
  4. 3. الأحداث
  5. 4. أول LocalScript
  6. 5. الاختبار
  7. أين تضع السكربتات
  8. قراءة الأخطاء
  9. الدروس القديمة
  10. تدريب
  11. ماذا بعد
  12. Common errors
  13. مع RoCode
  14. الأسئلة الشائعة
  15. المصادر والقراءات

قبل البدء: Studio وBaseplate ونافذة Output

رسم توضيحيأربعة سكربتات في اختبار لعب واحد: قطعة ColourChanger تغيّر لونها كل ثانية، والدوس على Pad يجعلها صفراء لثانيتين لكل اللاعبين ويكتب اسمك في Output، وE يجعل Pad أكثر شفافية على هذه الشاشة فقط.

تحتاج إلى Roblox Studio وحساب Roblox، ولا شيء غير ذلك: لا محرر أكواد ولا إضافة. كل سكربت في هذا الدليل يُكتب في Script Editor الخاص بـ Studio نفسه.

  1. ثبّت Roblox Studio، وهو تطبيق Roblox المجاني لـ Windows وMac، وسجّل الدخول بحساب Roblox.
  2. افتح Studio. في صفحة البداية قوالب: اختر Baseplate. ستحصل على أرضية بنقش شبكة 4x4 وSpawnLocation، وهو المكان الذي تظهر فيه شخصيتك عند اللعب.
  3. إذا لم تكن نافذتا Explorer وProperties ظاهرتين، فافتحهما من قائمة Window أو من تبويب Home. يعرض Explorer كل كائنات المكان، ويعرض Properties إعدادات الكائن المحدد.
  4. افتح Output من قائمة Window أو من تبويب Script. هنا تظهر رسائل سكربتاتك وأخطاؤها.
  5. في إعدادات العرض لنافذة Output فعّل Show Context، الذي يضع على كل رسالة علامة Client أو Server، وShow Source، الذي يُظهر السكربت ورقم السطر الذي جاءت منه.
السكربتات الأربعة التي ستكتبها
السكربتالنوعأين يوضعماذا يعلّم
FirstScriptScriptServerScriptServiceالمتغيرات، ودالة، وشرط if، والحلقات، وجدول
ColourChangerScriptداخل Part في Workspaceتغيير الخصائص، وscript.Parent، وحلقة مع انتظار
TouchPadScriptداخل Part باسم Padالأحداث، والعثور على اللاعب الذي لمس القطعة، وdebounce
MyFirstLocalScriptLocalScriptStarterPlayerScripts، داخل StarterPlayerالكود على جهاز لاعب واحد، وضغطات الأزرار، وما يبقى على هذا الجهاز
Explorer في النهاية (كائنات هذا الدليل فقط)
Workspace
  Baseplate Part
  SpawnLocation SpawnLocation
  Part Part new
    ColourChanger Script new
  Pad Part new
    TouchPad Script new
ServerScriptService
  FirstScript Script new
StarterPlayer
  StarterPlayerScripts
    MyFirstLocalScript LocalScript new

الخطوة 1: اكتب أول سكربت

  1. في Explorer مرّر المؤشر فوق ServerScriptService، واضغط + واختر Script (الاختصار Ctrl+I أو ⌘I على Mac). سينشئ Studio السكربت ويفتحه في Script Editor.
  2. انقر بالزر الأيمن على السكربت الجديد، واختر Rename وسمّه FirstScript. الاسم لا يغيّر ما يفعله السكربت، لكنه يخبرك أي سكربت طبع ماذا.
  3. تبدأ السكربتات الجديدة بسطر واحد، print("Hello world!"). احذفه والصق الكود أدناه.
  4. اضغط Play (F5)، بعد اختيار Test من القائمة على يساره. سيبدأ Studio اختبار لعب ويضع شخصيتك على SpawnLocation.
  5. اقرأ السطور في Output، ثم اضغط Stop (Shift+F5). يعيد Stop أيضًا كل الكائنات إلى حالتها قبل الضغط على Play، لذلك سيعود كل ما حرّكته أو أعدت تلوينه أثناء اللعب.
Script في ServerScriptService باسم FirstScript
-- Script في ServerScriptService باسم FirstScript.
-- أول كود Luau لك: متغيرات، ودالة، وشرط if، وحلقة، وجدول.
-- اضغط Play (F5) واقرأ النتيجة في نافذة Output.

-- المتغير اسم يحمل قيمة
local gameName = "Coin Run"
local coinsToWin = 3

-- الدالة كتلة كود لها اسم، يمكن تشغيلها بقدر ما تشاء من المرات.
-- name وgoal هما معاملاها، وreturn يُعيد قيمة لمن استدعاها.
local function describe(name: string, goal: number): string
	return `{name}: collect {goal} coins to win`
end

print(describe(gameName, coinsToWin)) --> Coin Run: collect 3 coins to win

-- شرط if ينفّذ الكود فقط عندما يكون الشرط صحيحًا
if coinsToWin > 5 then
	print("That is a long game")
elseif coinsToWin > 1 then
	print("That is a short game")
else
	print("One coin and you win")
end

-- حلقة for تكرر الكود عددًا محددًا من المرات
for count = 1, coinsToWin do
	print("Coin number", count)
end

-- الجدول يحمل قائمة من القيم، وهذه الحلقة تمر عليها بالترتيب
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
	print(position, colour) --> 1 Red، ثم 2 Green، ثم 3 Blue
end

كل ما بعد -- في السطر تعليق: تتجاوزه Luau، لذلك يمكنك ترك ملاحظات لنفسك. وتعليقات --> تُظهر ما يطبعه السطر.

يجب أن يُظهر Output هذه السطور الثمانية مختلطة برسائل Studio نفسه. عندما تستلم print عدة قيم تضع بينها مسافة. ومع تفعيل Show Context وShow Source يحمل كل سطر أيضًا علامة Server وFirstScript مع رقم السطر.

Output (المتوقع)
Coin Run: collect 3 coins to win
That is a short game
Coin number 1
Coin number 2
Coin number 3
1 Red
2 Green
3 Blue

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

يستخدم FirstScript لغة Luau الخالصة فقط دون كائنات Roblox، لذلك يعمل أيضًا في ساحة تجربة Luau المجانية في المتصفح. غيّر قيمة هناك وشغّله مجددًا لترى ما الذي يتغير.

ماذا يفعل كل جزء من FirstScript
الكودالفكرةماذا يعني
local gameName = "Coin Run"متغيراسم يحمل قيمة. تعني local أنه لا يستخدمه إلا هذا السكربت أو الكتلة التي هو فيها. النص بين علامتي التنصيص هو نص (string)، و3 هو رقم. الأسماء حساسة لحالة الأحرف، لذلك coinsToWin وCoinsToWin متغيران مختلفان.
local function describe(name: string, goal: number): stringدالةكتلة كود لها اسم، يمكن تشغيلها بقدر ما تشاء من المرات. name وgoal هما معاملاها: القيم التي تُمرَّر عند كل استدعاء. و: string و: number تعليقات توضيحية اختيارية للأنواع. تستخدمها Luau لتحذّرك من الأخطاء في Script Editor، والكود يعمل بالطريقة نفسها دونها.
returnالقيمة المعادةتسلّم قيمة إلى الكود الذي استدعى الدالة. print(describe(gameName, coinsToWin)) يطبع ما تُعيده describe.
`{name}: collect {goal} coins to win`إدراج القيم في النصالنص بين علامتي backtick يمكن أن يحتوي على قيم: تستبدل Luau {name} و{goal} بقيمهما الحالية.
if، elseif، else، endشرط ifتفحص Luau الشروط من الأعلى إلى الأسفل وتنفّذ أول شرط صحيح فقط. قيمة coinsToWin هي 3، وهي ليست أكبر من 5 لكنها أكبر من 1، لذلك لا يُطبع إلا «That is a short game».
for count = 1, coinsToWin doحلقة for رقميةتنفّذ الكود الذي بداخلها مرة لكل رقم من 1 إلى coinsToWin، حيث تكون count هي 1 ثم 2 ثم 3.
{ "Red", "Green", "Blue" } وfor position, colour in colours doجدول وحلقةجدول على شكل قائمة، وتسمّي Luau ذلك مصفوفة (array). المواضع تبدأ من 1 لا من 0. تمر الحلقة على كل عنصر وتعطي موضعه وقيمته.

كل كتلة تبدأ بالكلمة function أو if أو for أو while تُغلق بالكلمة end. نسيان end واحد يمنع السكربت كله من العمل، ويُريك قسم قراءة الأخطاء الرسالة التي ستظهر لك.

الخطوة 2: غيّر قطعة من سكربت

تصبح السكربتات مفيدة عندما تغيّر شيئًا في العالم. الإعدادات التي تراها في نافذة Properties، مثل Color وTransparency وAnchored للقطعة، هي خصائص، والسكربت أيضًا يستطيع ضبطها.

  1. في تبويب Home اضغط Part. سيضيف Studio كتلة إلى Workspace. اسمها غير مهم.
  2. في Explorer مرّر المؤشر فوق القطعة الجديدة، واضغط + وأدرج Script. أعد تسميته إلى ColourChanger واستبدل محتواه بالكود أدناه.
  3. اضغط Play. تصبح القطعة حمراء ثم زرقاء ثم خضراء، فتتغير مرة كل ثانية، ثم تبدأ من جديد.
Script في أي قطعة في Workspace باسم ColourChanger
-- Script داخل Part في Workspace، باسم ColourChanger.
-- السكربتات تغيّر الخصائص نفسها التي تظهر في نافذة Properties.
-- هذا السكربت يعطي قطعته لونًا جديدًا كل ثانية، لكل اللاعبين.

local part = script.Parent :: BasePart -- القطعة التي يوجد هذا السكربت بداخلها

local colours = {
	Color3.fromRGB(255, 85, 85), -- أحمر
	Color3.fromRGB(85, 170, 255), -- أزرق
	Color3.fromRGB(85, 255, 127), -- أخضر
}

part.Anchored = true -- القطعة المثبتة تبقى حيث وضعتها

local index = 1
while true do
	part.Color = colours[index]
	index = index % #colours + 1 -- 1، 2، 3، ثم 1 من جديد
	task.wait(1) -- توقف لثانية واحدة (wait() القديمة متقادمة)
end
  • script.Parent هو الكائن الذي يوجد السكربت بداخله، وهو هنا القطعة. اسحب السكربت إلى قطعة أخرى، وسيغيّرها هي.
  • :: BasePart تحويل للنوع (type cast). يخبر Script Editor أن الأب قطعة، ليفحص الخصائص المستخدمة. تستخدم Luau الأنواع للتحذيرات والاقتراحات فقط، لذلك لا يغيّر التحويل ما يفعله السطر.
  • part.Color وpart.Anchored هما الخاصيتان نفسهما في نافذة Properties، بالأسماء نفسها. يستخدم Roblox التهجئة الأمريكية، لذلك تُسمى الخاصية Color مع أن السكربت اسمه ColourChanger.
  • Anchored = true يُبقي القطعة في مكانها: يقول مرجع Roblox إن القطعة المثبتة لا تتحرك أبدًا بسبب الجاذبية أو التصادمات أو أي فيزياء أخرى.
  • colours[index] يقرأ عنصرًا واحدًا من القائمة. #colours هو طول القائمة، أي 3، و% يعطي باقي القسمة، لذلك يعدّ index % #colours + 1 هكذا: 1، 2، 3، 1، 2، 3.
  • while true do تتكرر إلى ما لا نهاية، ولهذا فإن task.wait(1) بداخلها مهمة جدًا. يقول توثيق Roblox أن تضع دائمًا تأخيرًا مثل task.wait() في الحلقة اللانهائية: دونه تتجمد اللعبة ويتعطل Studio.

ColourChanger هو Script، لذلك يعمل على الخادم، ويرى كل اللاعبين اللون نفسه في الوقت نفسه. تُريك الخطوة 4 نوعًا آخر من السكربتات.

الخطوة 3: تفاعل مع اللاعب عبر حدث

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

  1. أدرج Part أخرى وأعد تسميتها إلى Pad بالضبط، بحرف P كبير. اتركها مباشرة في Workspace، لا في مجلد ولا في نموذج، لأن LocalScript في الخطوة 4 يبحث عنها هناك.
  2. اجعلها منصة مسطحة يمكنك الوقوف عليها، مثلًا اضبط Size على 6, 1, 6 في نافذة Properties. ضعها على الأرض بجانب SpawnLocation وفعّل Anchored حتى لا تتحرك.
  3. مرّر المؤشر فوق Pad، واضغط + وأدرج Script، وأعد تسميته إلى TouchPad والصق الكود أدناه.
  4. اضغط Play وقف على المنصة. تصفرّ لثانيتين، ويذكر Output اسمك.
Script في Workspace.Pad باسم TouchPad
-- Script داخل Part في Workspace باسم Pad، والسكربت باسم TouchPad.
-- الأحداث: عندما يدوس لاعب على المنصة تتوهج بالأصفر، ويكتب Output من كان.
-- يمنع debounce الكود من الانطلاق مرات كثيرة في الثانية بينما يقف اللاعب عليها.

local Players = game:GetService("Players")

local pad = script.Parent :: BasePart
local COOLDOWN_SECONDS = 2

local normalColour = pad.Color
local busy = false

local function onTouched(otherPart: BasePart)
	if busy then
		return -- ما زالت فترة الانتظار بعد اللمسة السابقة جارية
	end
	-- الشخصية هي Model التي فيها جزء الجسم (أو القبعة) الذي لمس المنصة
	local character = otherPart:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return -- لمستها قطعة حرة أو NPC، لا لاعب
	end

	busy = true
	print(`{player.Name} stepped on the pad`)
	pad.Color = Color3.fromRGB(255, 220, 0)
	task.wait(COOLDOWN_SECONDS)
	pad.Color = normalColour
	busy = false
end

pad.Touched:Connect(onTouched)
كيف يصل TouchPad من اللمسة إلى اللاعب
الكودماذا يفعل
pad.Touched:Connect(onTouched)يصل الدالة بحدث Touched الخاص بالمنصة، فيشغّل Roblox الدالة onTouched في كل مرة يلمس فيها شيء المنصة، ويمرّر القطعة التي لمستها.
otherPartالقطعة التي لمست المنصة: قدم، أو ساق، أو مقبض قبعة، أو أداة في يد اللاعب. ليست اللاعب نفسه أبدًا، لذلك يكتشف السطران التاليان لمن تعود.
otherPart:FindFirstAncestorOfClass("Model")يصعد من هذه القطعة إلى أول سلف صنفه Model بالضبط، أي إلى الشخصية. ولأن اسم الصنف يجب أن يتطابق تمامًا، فإنه يتجاوز القبعة (الصنف Accessory) والأداة في اليد (الصنف Tool).
Players:GetPlayerFromCharacter(character)يُعيد Player الذي تعود إليه هذه الشخصية، أو nil إذا لم تكن شخصية لأحد، مثل NPC. وتتجاوز character and في البداية الاستدعاء إذا لم يُعثر على نموذج، فتبقى player قيمتها nil.
if not player then return endيتوقف هنا لكل ما ليس لاعبًا. تخرج return من الدالة مبكرًا.

لماذا تحتاج المنصة إلى debounce

تحذّر صفحة Roblox عن debounce من أن Touched ينطلق عدة مرات متتالية ما دامت القطع متلامسة، وللشخصية التي تمشي عدة أجزاء جسم. دون فحص قد تطبع خطوة واحدة على المنصة سطورًا كثيرة وتعيد تشغيل التوهج الأصفر مرارًا وتكرارًا.

المتغير busy هو debounce. أول لمسة تضبطه على true، وكل لمسة خلال الثانيتين التاليتين تصل إلى if busy then return end وتتوقف. بعد task.wait(COOLDOWN_SECONDS) تستعيد المنصة لونها، ويعود busy إلى false. كُتب COOLDOWN_SECONDS بأحرف كبيرة لأنه إعداد لا يتغير أثناء اللعب: هكذا ينصح Roblox بتسمية الثوابت.

لهذه المنصة debounce واحد للجميع، لذلك يُتجاهل لاعب ثانٍ يدوس عليها خلال هاتين الثانيتين. هذا مقبول لمنصة متوهجة. أما المنصة التي تمنح جوائز فيجب أن تحفظ فترة انتظار لكل لاعب، مثل منصة العملات في دليل لوحة الصدارة.

الخطوة 4: أول LocalScript وبمَ يختلف

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

  1. في Explorer افتح StarterPlayer، ومرّر المؤشر فوق StarterPlayerScripts، واضغط + وأدرج LocalScript. أعد تسميته إلى MyFirstLocalScript والصق الكود أدناه.
  2. اضغط Play. سيُظهر Output الكلمة Hello, واسمك مع علامة Client.
  3. انقر على نافذة اللعبة واضغط E. تصبح المنصة أكثر شفافية. اضغط E مرة أخرى لتعيدها.
  4. أثناء اختبار اللعب اضغط مفتاح التبديل Client/Server في أدوات الاختبار في Studio، لتنتقل إلى نسخة الخادم من اللعبة. هناك تكون المنصة غير شفافة: لم يعرف الخادم شيئًا عن التغيير.
LocalScript في StarterPlayerScripts باسم MyFirstLocalScript
-- LocalScript في StarterPlayer > StarterPlayerScripts باسم MyFirstLocalScript.
-- يعمل LocalScript على جهاز لاعب واحد. اضغط E: تصبح Pad أكثر شفافية
-- على شاشتك فقط، لأن تغيير القطعة من هنا لا يصل إلى الخادم ولا إلى الآخرين.

local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")

local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- يظهر في Output مع علامة Client

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed then
		return -- الزر ذهب إلى شيء آخر، مثل كتابة نص في الدردشة
	end
	if input.KeyCode == Enum.KeyCode.E then
		local pad = workspace:FindFirstChild("Pad")
		if pad and pad:IsA("BasePart") then
			pad.Transparency = if pad.Transparency == 0 then 0.6 else 0
		end
	end
end)
  • Players.LocalPlayer هو اللاعب الذي يعمل السكربت على جهازه. يحدده Roblox فقط لـ LocalScript ولسكربتات ModuleScript التي تستدعيها، لذلك لا يستطيع كود الخادم استخدامه.
  • UserInputService.InputBegan ينطلق عندما يبدأ اللاعب ضغطة زر أو نقرة أو لمسة. تكون gameProcessed قيمتها true عندما يكون المحرك قد استخدم هذا الإدخال بالفعل، مثل نقرة على زر أو حرف في سطر الدردشة، لذلك يتجاهله السكربت.
  • workspace:FindFirstChild("Pad") يُعيد الابن الذي اسمه Pad، أو nil إذا لم يوجد. ويتحقق pad:IsA("BasePart") من أنه قطعة فعلًا، قبل أن يغيّر السكربت Transparency الخاصة بها.
  • if pad.Transparency == 0 then 0.6 else 0 تعبير if: يختار واحدة من قيمتين. Transparency بقيمة 0 تعني مرئية تمامًا، و1 تعني غير مرئية.
  • سكربت الجري بزر Shift مناسب كثاني LocalScript لك: يستمع إلى زر ويغيّر WalkSpeed للشخصية.
Script وLocalScript وModuleScript
النوعأين يعملإلى أين تصل التغييراتلأي غرضيوضع عادة في
Scriptعلى الخادمإلى كل اللاعبينقواعد اللعبة: العملات، الضرر، الأبواب، الجولات، الحفظServerScriptService أو داخل قطعة ما دمت تتعلم
LocalScriptعلى جهاز لاعب واحدإلى هذا الجهاز فقط، باستثناء حركة شخصيتهالإدخال، الكاميرا، القوائم على الشاشة، تأثيرات للاعب واحدStarterPlayerScripts أو StarterGui
ModuleScriptعلى الجانب الذي يستدعي له require()إلى المكان نفسه الذي تصل إليه تغييرات السكربت الذي استدعاهكود مشترك بين عدة سكربتاتReplicatedStorage للجانبين، وServerScriptService للخادم فقط

ما الذي يستطيع الغشاش تغييره

افترض أن الغشاش يتحكم في كل شيء على جهازه. يستطيع تشغيل سكربتات LocalScript خاصة به وتغيير سكربتاتك، لذلك يستطيع أن يجعل المنصة شفافة أو أي شيء آخر على شاشته. هذا غير مؤذٍ هنا: الشفافية للمظهر فقط وتبقى على جهازه. ولهذا السبب بالذات يقرر Script على الخادم كل ما هو مهم.

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

الخطوة 5: اختبر السكربتات الأربعة معًا

  1. امسح Output بـ Ctrl+K (⌘K على Mac) واضغط Play (F5). سيُظهر Output سطور FirstScript الثمانية مع علامة Server، وسطر Hello الخاص بك مع علامة Client. وقطعة ColourChanger تغيّر لونها كل ثانية.
  2. قف على المنصة. تصفرّ لثانيتين، ويُظهر Output مرة واحدة اسمك و«stepped on the pad». تجوّل عليها: يظهر سطر جديد مرة كل ثانيتين على الأكثر، لا مع كل انطلاق لـ Touched.
  3. اضغط E. تصبح المنصة شبه شفافة (Transparency 0.6). اضغط E مجددًا فتعود غير شفافة.
  4. اضغط Stop. في قائمة الاختبار اختر Server & Clients، واضبط العملاء على 2 واضغط Play (أو F7). سيفتح Studio نافذة للخادم ونافذتين للعميلين. في أحد العميلين اضغط E: ستصبح المنصة أكثر شفافية هناك، بينما يُظهرها العميل الآخر والخادم غير شفافة. اضغط End Session عندما تنتهي.
  5. اكسر شيئًا عمدًا. أعد تسمية Pad إلى Pad2 وشغّل اللعبة. الدوس على المنصة ما زال يجعلها صفراء، لأن TouchPad يجد قطعته عبر script.Parent لا بالاسم. أما الضغط على E فلا يفعل شيئًا الآن، ولا يظهر خطأ: أعاد FindFirstChild("Pad") القيمة nil، وتجاوز الفحص if pad and ... الباقي بصمت. أضف print(pad) في السطر بعد FindFirstChild، وشغّل واضغط E: سيُظهر Output القيمة nil. هذا النوع من print هو أسرع طريقة لتفهم لماذا لا يفعل السكربت شيئًا. أوقف اللعبة، واحذف سطر print وأعد اسم القطعة إلى Pad.

أين تضع السكربتات

يتوقف على مكان السكربت هل سيعمل أصلًا، ولن يحذّرك Studio إذا كان لن يعمل أبدًا. لسكربتاتك القادمة:

أين تضع كل نوع من السكربتات
الحاويةماذا تضع فيهالماذا
ServerScriptServiceالسكربتات التي تحمل معظم قواعد اللعبة: الجوائز، الجولات، الحفظتعمل على الخادم، ولا يُرسل أي شيء من ServerScriptService إلى اللاعبين.
داخل قطعة في WorkspaceScript يخص قطعة واحدة، مثل ColourChanger وTouchPadمقبول ما دمت تتعلم: القطعة هي script.Parent. أما للمشاريع الحقيقية فينصح Roblox بوضع وسوم (tags) على القطع بدلًا من ذلك (انظر أدناه).
StarterPlayerScripts، داخل StarterPlayerمعظم سكربتات LocalScript: الإدخال، الكاميرا، تأثيرات للاعب واحديحصل كل لاعب على نسخته الخاصة عند الدخول.
StarterGuiسكربتات LocalScript داخل ScreenGui تتحكم في قائمة على الشاشةيحصل كل لاعب على نسخته الخاصة من الواجهة.
ReplicatedStorageسكربتات ModuleScript يستدعيها كود الخادم وكود العميل معًايراها الجانبان. ولن يعمل هنا أبدًا LocalScript أو Script بالإعدادات الافتراضية.

تنصح صفحة Roblox عن أماكن السكربتات بعدم وضع السكربتات مباشرة داخل القطع في Workspace أصلًا: ضع وسومًا على القطع وتعامل معها من ModuleScript واحد عبر CollectionService. ومع ذلك يبقى السكربت داخل القطعة أبسط بداية، وهو مقبول لكائن أو اثنين ما دمت تتعلم. يُريك دليل الأبواب نمط الوسوم بسكربت واحد لكل الأبواب، ويحتوي دليل العميل والخادم على جدول كامل يبيّن أي الحاويات تشغّل أي السكربتات.

عندما يحدث خطأ: اقرأ Output

تظهر الأخطاء في Output باللون الأحمر. كل خطأ يبدأ بمكان حدوثه، أي الاسم الكامل للسكربت ورقم السطر، ثم يقول ما المشكلة. انقر على الخطأ، فيفتح Studio السكربت عند ذلك السطر. مثلًا، إذا حذفت الفحص if not player من TouchPad وسقطت قطعة حرة على المنصة، فسيُظهر Output:

Output (مثال)
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'

الأخطاء في طريقة كتابة الكود، مثل نسيان end، تظهر حتى قبل الضغط على Play: يضع Script Editor تحتها خطًا أحمر، وتعدّدها نافذة Script Analysis (زر Analysis في تبويب Script). السكربت الذي فيه خطأ كهذا لا يعمل أبدًا، ولا حتى السطور التي فوقه.

ثلاثة أخطاء يستحق أن تتعرف عليها
الرسالةماذا تعنيكيف تصلحها
Colour is not a valid member of Part "Workspace.Part"لا يوجد لدى هذا الكائن شيء بهذا الاسم بالضبط. الخاصية هنا تُكتب Color.طابق التهجئة والأحرف الكبيرة مع نافذة Properties أو Explorer. المزيد عن هذا الخطأ.
attempt to index nil with 'Name'قرأ الكود شيئًا، وهو هنا .Name، من قيمة nil. في المثال أعلاه كانت player قيمتها nil لأن قطعة حرة لمست المنصة.اكتشف لماذا القيمة nil، وافحصها بـ if قبل استخدامها. المزيد عن هذا الخطأ.
Expected 'end' (to close 'then' at line 2), got <eof>لا يوجد لـ if في السطر 2 ما يقابلها من end. وللدالة تقول الرسالة to close 'function'، و<eof> تعني نهاية الملف.أضف end الناقصة، معتمدًا على السطر الذي بين القوسين لا على السطر الأخير. أحيانًا تنتهي الرسالة بعبارة «did you forget to close ... at line N?». هذا تخمين من Luau بناءً على المسافات البادئة، وقد يشير إلى الكتلة الخطأ، لذلك افحص السطر الذي بين القوسين أولًا. المزيد عن الأخطاء النحوية.

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

ما تفعله الدروس القديمة بشكل مختلف

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

أنماط من الدروس القديمة وما يفعله هذا الدليل بدلًا منها
الدرسالمشكلةهذا الدليل
يتوقف عبر wait(1)يصف مرجع Roblox الدالة العامة wait() بأنها قديمة ويقول إن task.wait() حلّت محلها.task.wait(1)
يجد الشخصية عبر otherPart.Parent، كما في درس Roblox عن الحممعندما تلمس القطعةَ قبعةٌ أو أداة في اليد، يكون otherPart.Parent هو Accessory أو Tool لا الشخصية، فلا يُعثر على Humanoid وتضيع اللمسة.FindFirstAncestorOfClass("Model")، ثم GetPlayerFromCharacter
يستخدم Touched دون debounceينطلق Touched عدة مرات متتالية من خطوة واحدة، فيُنفَّذ الكود مرارًا وتكرارًا.العلَم busy وفترة انتظار
يضع LocalScript داخل قطعة في Workspaceلا يعمل LocalScript هناك أبدًا. فهو يعمل فقط من أماكن تخص لاعبًا واحدًا.LocalScript في StarterPlayerScripts (لماذا)
يكتب part.Touched:connect(...) أو table.getn(list)يقول دليل التسمية في Roblox إن واجهات camelCase البرمجية قديمة في معظمها، والمرجع لا يذكر إلا Connect. وtable.getn قديمة لصالح #list.:Connect(...) و#list
يغيّر العملات أو يُلحق الضرر في LocalScriptيبقى التغيير على جهاز هذا اللاعب، فلا يراه أحد غيره ولا يحتسبه الخادم.قواعد اللعبة في Script على الخادم

تدريب: ثلاثة تغييرات تستحق التجربة

تغيير الكود يعلّمك أكثر من قراءته. جرّب هذه في مكانك واحدًا تلو الآخر، واضغط Play بعد كل واحد.

  • اجعل المنصة تمنح نقطة. أضف سكربت Leaderstats من الخطوة 1 في دليل لوحة الصدارة. ثم في TouchPad بعد busy = true ابحث عن مجلد اللاعب leaderstats وأضف 1 إلى قيمة Coins. تلميح: player:FindFirstChild("leaderstats")، ثم leaderstats:FindFirstChild("Coins")، ثم coins.Value += 1. منصة العملات في دليل لوحة الصدارة هي النسخة الجاهزة، مع فترة انتظار لكل لاعب.
  • اجعل ColourChanger يغيّر الشفافية أيضًا. اجعل ColourChanger يغيّر كل ثانية Transparency القطعة أيضًا. تلميح: أضف جدولًا ثانيًا لأرقام من 0 إلى 1، مثل { 0, 0.3, 0.6 }، واضبط منه part.Transparency في السطر بعد part.Color، بالقيمة نفسها لـ index.
  • اطبع لون المنصة. اجعل MyFirstLocalScript يطبع Color المنصة عند الضغط على E. تلميح: print(pad.Color) داخل الكتلة if pad and pad:IsA("BasePart"). اضغط E والمنصة صفراء: يرى العميل اللون الذي ضبطه الخادم، لأن التغييرات على الخادم تصل إلى كل العملاء.

ماذا تتعلم بعد ذلك

لقد استخدمت الآن الأجزاء التي تُبنى منها معظم سكربتات الألعاب. ترتيب جيد لما بعد ذلك:

  1. LocalScript vs Script vs ModuleScript: أين يعمل كل نوع من السكربتات وما الذي يستطيع تغييره، بعمق أكبر من الخطوة 4.
  2. RemoteEvents: كيف يطلب LocalScript من الخادم أن يفعل شيئًا، وكيف يفحص الخادم الطلب.
  3. لوحة الصدارة: أول إحصائيات لك، تُنشأ وتُغيَّر على الخادم.
  4. أول لعبة لك: مسار قصير فيه حمم وعملات ومنصة نهاية بسكربتين على الخادم، ثم النشر.
  5. بعد ذلك اختر نظامًا: متجر GUI، أو نظام الجولات، أو نقاط التفتيش في الأوبي، أو شاشة التحميل، أو أنيميشن عند ضغط زر. وعندما يتعطل شيء، يساعدك دليل أخطاء السكربتات على قراءة الرسالة. دليل نقاط التفتيش متوفر بالإنجليزية فقط حاليًا.

دروس Roblox الخاصة Coding fundamentals (بالإنجليزية) تكمّل هذا الدليل جيدًا: ست سلاسل من المتغيرات والدوال، مرورًا بالشروط والحلقات والمصفوفات والقواميس، حتى تنظيم الكود في ModuleScript، مع مشاريع صغيرة في Studio.

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

معظم مشكلات السكربتات الأولى هي اسم غير متطابق، أو سكربت في المكان الخطأ، أو حلقة دون انتظار. أبقِ Output مفتوحًا أثناء الاختبار.

يتجمد Studio أو يتوقف عن الاستجابة عند الضغط على Play

في حلقة while true do لا يوجد انتظار، لذلك لا يستطيع أي شيء آخر أن يعمل. يقول توثيق Roblox إن الحلقة اللانهائية دون تأخير مثل task.wait() تجمّد اللعبة وتعطّل Studio. ضع task.wait() في كل حلقة لانهائية، كما في ColourChanger.

لا يحدث شيء عندما أقف على المنصة

تأكد من أن TouchPad هو Script لا LocalScript، وأنه موجود مباشرة داخل قطعة Pad، وغير معطّل، وأن الخاصية CanTouch للمنصة مفعّلة. ثم اجعل print("touched", otherPart.Name) أول سطر داخل onTouched. إذا لم يُطبع هذا، فالحدث لا ينطلق، وإذا طُبع فالمشكلة في ما بعده.

الضغط على E لا يفعل شيئًا

يجب أن يكون MyFirstLocalScript من نوع LocalScript داخل StarterPlayerScripts: لا يعمل LocalScript أبدًا في Workspace أو ServerScriptService. ويجب أن يكون اسم القطعة Pad بالضبط وأن تكون مباشرة في Workspace. انقر أولًا على نافذة اللعبة وتأكد من أنك لا تكتب في الدردشة، لأن السكربت يتجاهل الأزرار التي استخدمتها اللعبة بالفعل.

القطعة تتغير على شاشتي، لكن ليس عند اللاعبين الآخرين

أجرى التغييرَ LocalScript، لذلك بقي على جهازك. أجرِه في Script على الخادم، أو اجعل LocalScript يطلبه من الخادم عبر RemoteEvent.

يعمل ColourChanger داخل القطعة، لكنه يتعطل في ServerScriptService

يستخدم script.Parent على أنه قطعته. وفي ServerScriptService يكون الأب هو ServerScriptService، وليس لديه Anchored ولا Color، لذلك يُظهر Output الخطأ «not a valid member». أبقِه داخل القطعة، أو أعطِ القطعة اسمًا وابحث عنها بالاسم، مثل local part = workspace:WaitForChild("ColourPart") :: BasePart.

لا يُظهر Output أي شيء على الإطلاق

تأكد من أن نافذة Output مفتوحة (قائمة Window أو تبويب Script) وأنه لا يوجد فلتر: يمكن تصفية Output حسب نوع الرسائل، وحسب Client أو Server، وحسب النص. إذا كانت مفتوحة وما زالت فارغة، فالأرجح أن السكربت لم يعمل. انظر قائمة الفحص للسكربتات التي لا تفعل شيئًا.

إذا علقت: RoCode

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

ما دمت تتعلم، فوضع Ask مفيد: أنت من يكتب السكربتات، وRoCode يقرأ ما هو موجود ويجيب عن الأسئلة.

ما تكتبه

اشرح سطرًا بسطر ماذا يفعل سكربت TouchPad داخل قطعة Pad، ولماذا يُستخدم فيه debounce.

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

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

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

أين أكتب السكربتات في Roblox Studio؟

في Explorer مرّر المؤشر فوق حاوية، مثل ServerScriptService، واضغط + واختر Script. سيفتحه Studio في Script Editor، حيث تكتب Luau. سكربتات الخادم توضع عادة في ServerScriptService، وسكربتات LocalScript في StarterPlayerScripts أو StarterGui.

كيف أشغّل سكربتًا في Roblox Studio؟

اضغط Play (F5). سيبدأ Studio اختبار لعب، وكل Script مفعّل في ServerScriptService أو Workspace سيعمل فور بدء اللعبة، أما سكربتات LocalScript في StarterPlayerScripts فتعمل عندما تدخل اختبار اللعب. أما Run (اختره من القائمة بجانب Play أو اضغط F8) فيشغّل اللعبة دون شخصية، لذلك استخدم Play لهذا الدليل. وStop (Shift+F5) ينهي الاختبار. لتفتح سكربتًا موجودًا، انقر عليه نقرًا مزدوجًا في Explorer.

ما لغة البرمجة التي يستخدمها Roblox؟

Luau. يصفها Roblox بأنها لغة سكربتات سريعة وصغيرة وآمنة ذات أنواع تدريجية، مشتقة من Lua 5.1، لذلك ما زالت معظم دروس Lua مفيدة. تضيف Luau ميزات مثل إدراج القيم في النصوص بين علامتي backtick والتعليقات التوضيحية الاختيارية للأنواع، ويضيف Roblox مكتباته وكائناته الخاصة، مثل task.wait.

ما الفرق بين Script وLocalScript؟

يعمل Script على الخادم، وتصل تغييراته إلى كل اللاعبين. ويعمل LocalScript على جهاز لاعب واحد، للإدخال والكاميرا والقوائم على الشاشة، وتغييراته على القطع والقيم والواجهة تبقى على هذا الجهاز. يشرح دليل العميل والخادم (بالإنجليزية) الاثنين، إضافة إلى ModuleScript.

هل يمكن كتابة السكربتات في Roblox Studio على الهاتف أو iPad؟

تصف صفحة تثبيت Roblox تطبيق Studio بأنه تطبيق مجاني لـ Windows وMac ولا تذكر نسخة للهاتف أو الجهاز اللوحي، لذلك تحتاج إلى حاسوب لكتابة السكربتات.

لماذا لا يفعل سكربتي شيئًا ولا يُظهر خطأ؟

عادةً يكون في مكان لا يعمل فيه هذا النوع من السكربتات (LocalScript في Workspace أو Script في StarterPlayerScripts)، أو يكون معطّلًا، أو أن الحدث الذي ينتظره لا ينطلق. في دليل الأخطاء قائمة فحص.

كم من الوقت يلزم لتعلّم البرمجة في Roblox؟

لن يعطيك أحد رقمًا صادقًا: هذا يعتمد على مقدار ما تبنيه. أكثر ما يساعد هو كتابة سكربتات صغيرة كثيرًا في مكانك. غيّر السكربتات الأربعة من هنا، وجرّب مهام التدريب، ثم اتبع دليل أول لعبة وأضف نظامًا واحدًا في كل مرة.

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

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

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

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