باختصار
لتكتب سكربتًا في 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.
في هذه الصفحة
قبل البدء: Studio وBaseplate ونافذة Output
تحتاج إلى Roblox Studio وحساب Roblox، ولا شيء غير ذلك: لا محرر أكواد ولا إضافة. كل سكربت في هذا الدليل يُكتب في Script Editor الخاص بـ Studio نفسه.
- ثبّت Roblox Studio، وهو تطبيق Roblox المجاني لـ Windows وMac، وسجّل الدخول بحساب Roblox.
- افتح Studio. في صفحة البداية قوالب: اختر Baseplate. ستحصل على أرضية بنقش شبكة 4x4 وSpawnLocation، وهو المكان الذي تظهر فيه شخصيتك عند اللعب.
- إذا لم تكن نافذتا Explorer وProperties ظاهرتين، فافتحهما من قائمة Window أو من تبويب Home. يعرض Explorer كل كائنات المكان، ويعرض Properties إعدادات الكائن المحدد.
- افتح Output من قائمة Window أو من تبويب Script. هنا تظهر رسائل سكربتاتك وأخطاؤها.
- في إعدادات العرض لنافذة Output فعّل Show Context، الذي يضع على كل رسالة علامة Client أو Server، وShow Source، الذي يُظهر السكربت ورقم السطر الذي جاءت منه.
| السكربت | النوع | أين يوضع | ماذا يعلّم |
|---|---|---|---|
FirstScript | Script | ServerScriptService | المتغيرات، ودالة، وشرط if، والحلقات، وجدول |
ColourChanger | Script | داخل Part في Workspace | تغيير الخصائص، وscript.Parent، وحلقة مع انتظار |
TouchPad | Script | داخل Part باسم Pad | الأحداث، والعثور على اللاعب الذي لمس القطعة، وdebounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts، داخل StarterPlayer | الكود على جهاز لاعب واحد، وضغطات الأزرار، وما يبقى على هذا الجهاز |
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: اكتب أول سكربت
- في Explorer مرّر المؤشر فوق ServerScriptService، واضغط + واختر Script (الاختصار Ctrl+I أو ⌘I على Mac). سينشئ Studio السكربت ويفتحه في Script Editor.
- انقر بالزر الأيمن على السكربت الجديد، واختر Rename وسمّه
FirstScript. الاسم لا يغيّر ما يفعله السكربت، لكنه يخبرك أي سكربت طبع ماذا. - تبدأ السكربتات الجديدة بسطر واحد،
print("Hello world!"). احذفه والصق الكود أدناه. - اضغط Play (F5)، بعد اختيار Test من القائمة على يساره. سيبدأ Studio اختبار لعب ويضع شخصيتك على SpawnLocation.
- اقرأ السطور في Output، ثم اضغط Stop (Shift+F5). يعيد Stop أيضًا كل الكائنات إلى حالتها قبل الضغط على Play، لذلك سيعود كل ما حرّكته أو أعدت تلوينه أثناء اللعب.
-- 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 مع رقم السطر.
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 المجانية في المتصفح. غيّر قيمة هناك وشغّله مجددًا لترى ما الذي يتغير.
| الكود | الفكرة | ماذا يعني |
|---|---|---|
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 للقطعة، هي خصائص، والسكربت أيضًا يستطيع ضبطها.
- في تبويب Home اضغط Part. سيضيف Studio كتلة إلى Workspace. اسمها غير مهم.
- في Explorer مرّر المؤشر فوق القطعة الجديدة، واضغط + وأدرج Script. أعد تسميته إلى
ColourChangerواستبدل محتواه بالكود أدناه. - اضغط Play. تصبح القطعة حمراء ثم زرقاء ثم خضراء، فتتغير مرة كل ثانية، ثم تبدأ من جديد.
-- 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 ذلك أحداثًا. لتنفّذ كودًا عندما ينطلق حدث، تصل به دالة.
- أدرج Part أخرى وأعد تسميتها إلى
Padبالضبط، بحرف P كبير. اتركها مباشرة في Workspace، لا في مجلد ولا في نموذج، لأن LocalScript في الخطوة 4 يبحث عنها هناك. - اجعلها منصة مسطحة يمكنك الوقوف عليها، مثلًا اضبط
Sizeعلى6, 1, 6في نافذة Properties. ضعها على الأرض بجانب SpawnLocation وفعّل Anchored حتى لا تتحرك. - مرّر المؤشر فوق Pad، واضغط + وأدرج Script، وأعد تسميته إلى
TouchPadوالصق الكود أدناه. - اضغط Play وقف على المنصة. تصفرّ لثانيتين، ويذكر Output اسمك.
-- 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)
| الكود | ماذا يفعل |
|---|---|
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 فيعمل على جهاز لاعب واحد. ضغطات الأزرار والكاميرا والقوائم على الشاشة تُعالج هناك، لأن هذا الجهاز وحده يعرف عنها.
- في Explorer افتح StarterPlayer، ومرّر المؤشر فوق StarterPlayerScripts، واضغط + وأدرج LocalScript. أعد تسميته إلى
MyFirstLocalScriptوالصق الكود أدناه. - اضغط Play. سيُظهر Output الكلمة
Hello,واسمك مع علامة Client. - انقر على نافذة اللعبة واضغط E. تصبح المنصة أكثر شفافية. اضغط E مرة أخرى لتعيدها.
- أثناء اختبار اللعب اضغط مفتاح التبديل Client/Server في أدوات الاختبار في Studio، لتنتقل إلى نسخة الخادم من اللعبة. هناك تكون المنصة غير شفافة: لم يعرف الخادم شيئًا عن التغيير.
-- 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 | على الخادم | إلى كل اللاعبين | قواعد اللعبة: العملات، الضرر، الأبواب، الجولات، الحفظ | ServerScriptService أو داخل قطعة ما دمت تتعلم |
| LocalScript | على جهاز لاعب واحد | إلى هذا الجهاز فقط، باستثناء حركة شخصيته | الإدخال، الكاميرا، القوائم على الشاشة، تأثيرات للاعب واحد | StarterPlayerScripts أو StarterGui |
| ModuleScript | على الجانب الذي يستدعي له require() | إلى المكان نفسه الذي تصل إليه تغييرات السكربت الذي استدعاه | كود مشترك بين عدة سكربتات | ReplicatedStorage للجانبين، وServerScriptService للخادم فقط |
ما الذي يستطيع الغشاش تغييره
افترض أن الغشاش يتحكم في كل شيء على جهازه. يستطيع تشغيل سكربتات LocalScript خاصة به وتغيير سكربتاتك، لذلك يستطيع أن يجعل المنصة شفافة أو أي شيء آخر على شاشته. هذا غير مؤذٍ هنا: الشفافية للمظهر فقط وتبقى على جهازه. ولهذا السبب بالذات يقرر Script على الخادم كل ما هو مهم.
وسكربت الخادم ليس آمنًا تلقائيًا أيضًا. يعمل TouchPad على الخادم، لكن جهاز كل لاعب يتحكم في فيزياء شخصيته، ويذكر توثيق Roblox للأمان، ضمن ما يستطيع العميل فعله بالقطع التي يتحكم بها، التحكمَ في لحظة انطلاق Touched أو منعه تمامًا. هذا غير مهم لمنصة متوهجة. أما المنصة التي تدفع، فافحص فيها أيضًا ما يتتبعه الخادم بنفسه، مثل القاعدة في دليل الأوبي بأن نقاط التفتيش لا تُحتسب إلا بالترتيب.
الخطوة 5: اختبر السكربتات الأربعة معًا
- امسح Output بـ Ctrl+K (⌘K على Mac) واضغط Play (F5). سيُظهر Output سطور FirstScript الثمانية مع علامة Server، وسطر Hello الخاص بك مع علامة Client. وقطعة ColourChanger تغيّر لونها كل ثانية.
- قف على المنصة. تصفرّ لثانيتين، ويُظهر Output مرة واحدة اسمك و«stepped on the pad». تجوّل عليها: يظهر سطر جديد مرة كل ثانيتين على الأكثر، لا مع كل انطلاق لـ Touched.
- اضغط E. تصبح المنصة شبه شفافة (Transparency 0.6). اضغط E مجددًا فتعود غير شفافة.
- اضغط Stop. في قائمة الاختبار اختر Server & Clients، واضبط العملاء على 2 واضغط Play (أو F7). سيفتح Studio نافذة للخادم ونافذتين للعميلين. في أحد العميلين اضغط E: ستصبح المنصة أكثر شفافية هناك، بينما يُظهرها العميل الآخر والخادم غير شفافة. اضغط End Session عندما تنتهي.
- اكسر شيئًا عمدًا. أعد تسمية Pad إلى
Pad2وشغّل اللعبة. الدوس على المنصة ما زال يجعلها صفراء، لأن TouchPad يجد قطعته عبرscript.Parentلا بالاسم. أما الضغط على E فلا يفعل شيئًا الآن، ولا يظهر خطأ: أعادFindFirstChild("Pad")القيمةnil، وتجاوز الفحصif pad and ...الباقي بصمت. أضفprint(pad)في السطر بعدFindFirstChild، وشغّل واضغط E: سيُظهر Output القيمةnil. هذا النوع من print هو أسرع طريقة لتفهم لماذا لا يفعل السكربت شيئًا. أوقف اللعبة، واحذف سطر print وأعد اسم القطعة إلى Pad.
أين تضع السكربتات
يتوقف على مكان السكربت هل سيعمل أصلًا، ولن يحذّرك Studio إذا كان لن يعمل أبدًا. لسكربتاتك القادمة:
| الحاوية | ماذا تضع فيها | لماذا |
|---|---|---|
| ServerScriptService | السكربتات التي تحمل معظم قواعد اللعبة: الجوائز، الجولات، الحفظ | تعمل على الخادم، ولا يُرسل أي شيء من ServerScriptService إلى اللاعبين. |
| داخل قطعة في Workspace | Script يخص قطعة واحدة، مثل 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:
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 والمنصة صفراء: يرى العميل اللون الذي ضبطه الخادم، لأن التغييرات على الخادم تصل إلى كل العملاء.
ماذا تتعلم بعد ذلك
لقد استخدمت الآن الأجزاء التي تُبنى منها معظم سكربتات الألعاب. ترتيب جيد لما بعد ذلك:
- LocalScript vs Script vs ModuleScript: أين يعمل كل نوع من السكربتات وما الذي يستطيع تغييره، بعمق أكبر من الخطوة 4.
- RemoteEvents: كيف يطلب LocalScript من الخادم أن يفعل شيئًا، وكيف يفحص الخادم الطلب.
- لوحة الصدارة: أول إحصائيات لك، تُنشأ وتُغيَّر على الخادم.
- أول لعبة لك: مسار قصير فيه حمم وعملات ومنصة نهاية بسكربتين على الخادم، ثم النشر.
- بعد ذلك اختر نظامًا: متجر 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.
- في وضع 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؟
لن يعطيك أحد رقمًا صادقًا: هذا يعتمد على مقدار ما تبنيه. أكثر ما يساعد هو كتابة سكربتات صغيرة كثيرًا في مكانك. غيّر السكربتات الأربعة من هنا، وجرّب مهام التدريب، ثم اتبع دليل أول لعبة وأضف نظامًا واحدًا في كل مرة.
المصادر والقراءات
- Roblox Creator Docs: Luau (بالإنجليزية). ما هي Luau ومن أين جاءت
- Roblox Creator Docs: Roblox Studio setup (بالإنجليزية). Windows وMac، ومتطلبات النظام
- Roblox Creator Docs: Output (بالإنجليزية). فتح Output، والفلاتر، وShow Context وShow Source
- Roblox Creator Docs: Studio testing modes (بالإنجليزية). Play وRun وStop، ومفتاح التبديل Client/Server، وServer & Clients
- Roblox Creator Docs: Script Editor (بالإنجليزية). أين تُفتح السكربتات الجديدة، وScript Analysis
- Roblox Creator Docs: Script types and locations (بالإنجليزية). أين يعمل كل نوع من السكربتات، والوسوم بدلًا من السكربتات داخل القطع
- Roblox Creator Docs: Script (بالإنجليزية). متى يبدأ Script بالعمل
- Roblox Creator Docs: Control structures (بالإنجليزية). الشروط والحلقات، ولماذا تحتاج الحلقة اللانهائية إلى انتظار
- Roblox Creator Docs: Events (بالإنجليزية). Connect وما يمرّره Touched إلى الدالة
- Roblox Creator Docs: Debounce patterns (بالإنجليزية). لماذا ينطلق Touched عدة مرات من لمسة واحدة
- Roblox Creator Docs: wait (بالإنجليزية). الدالة العامة wait() وtask.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (بالإنجليزية). ما يستطيع العميل فعله بشخصيته
- Roblox Creator Docs: Coding fundamentals (بالإنجليزية). سلسلة Roblox للمبتدئين
كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.