مقدمة في البرمجة النصية

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

إعداد المشهد

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

1. قم بإدراج جزء وأعد تسميته إلى DisappearingPlatform.

2. قم بتغيير حجمه ليكون كبيرًا بما يكفي للقفز عليه.

3. قم بنقله إلى مكان مناسب بحيث يمكنك الوصول إليه والقفز عليه عند اختبار تجربتك.

   

4. قم بتعيين خاصية مثبت إلى صحيح في نافذة الخصائص.

   

إدراج نص برمجي

يتم كتابة الكود في Roblox بلغة تُسمى Luau التي يمكنك وضعها في النصوص داخل حاويات مختلفة في المستكشف. إذا وضعت نصًا برمجيًا تحت جزء، ستشغل Roblox كود النص البرمجي عندما يتم تحميل الجزء في التجربة.

1. مرر فوق الجزء DisappearingPlatform في نافذة المست explorer وانقر على زر + لإدراج نص برمجي جديد إلى المنصة. قم بإعادة تسمية النص الجديد إلى Disappear.

   

2. احذف الكود الافتراضي الموجود بداخله.

المتغير الأول

فكرة جيدة أن تبدأ نصك البرمجي بإنشاء متغير للمنصة. المتغير هو اسم مرتبط بــ قيمة. بمجرد إنشاء المتغير، يمكن استخدامه مرة أخرى ومرة أخرى. يمكنك تغيير القيمة حسب الحاجة.

في Luau، يتم إنشاء المتغير على النحو التالي: local variableName = variableValue.

مصطلح local يعني أن المتغير سيستخدم فقط في كتلة النص البرمجي حيث يتم إعلانه. يتم استخدام علامة = لتعيين قيمة المتغير. الأسماء للمتغيرات عادة ما تُكتب بأسلوب camel case. هذا هو الحروف الصغيرة مع كل كلمة بعد الأولى مكتوبة بحروف كبيرة، justLikeThis.

انسخ الكود التالي لإنشاء متغير للمنصة يسمى platform، حيث القيمة هي script.Parent.

local platform = script.Parent

وظيفة الاختفاء

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

local platform = script.Parent

local function disappear()

end

السطر الجديد الأول يعلن الوظيفة - يشير إلى بداية الوظيفة ويسميها disappear. يذهب الكود لوظيفة بين السطر الأول وend.

الأقواس مخصصة لتضمين معلومات إضافية حسب الحاجة. ستتعلم المزيد عن تمرير المعلومات إلى الوظائف في دورة لاحقة.

خصائص الجزء

عندما تختفي المنصة، تحتاج إلى أن تكون غير مرئية ويجب أن يمر المستخدمون من خلالها - لكن لا يمكنك ببساطة تدمير المنصة لأنها تحتاج إلى الظهور لاحقًا.

تمتلك الأجزاء خصائص متنوعة يمكن استخدامها هنا. تذكر أنه يمكنك رؤية خصائص الجزء إذا قمت بتحديده والنظر إلى نافذة الخصائص.

يمكن جعل الجزء غير مرئي عن طريق تغيير خاصية Transparency. يمكن أن تكون الشفافية قيمة تتراوح بين 0 و 1، حيث 1 يعني "شفاف بالكامل" وبالتالي غير مرئي.

تحدد خاصية CanCollide ما إذا كانت الأجزاء الأخرى (والمستخدمين) يمكن أن تمر مباشرة عبر الجزء. إذا قمت بتعيينها إلى غير صحيح، فسوف يسقط المستخدمون من خلال المنصة.

تمامًا كما هو الحال مع script.Parent، يتم الوصول إلى الخصائص باستخدام نقطة. يتم تعيين القيم باستخدام علامة التساوي.

1. في وظيفة disappear، قم بتعيين خاصية CanCollide للمنصة إلى غير صحيح.

2. في السطر التالي، قم بتعيين خاصية Transparency إلى 1.

   local platform = script.Parent
   
   local function disappear()
       platform.CanCollide = false
       platform.Transparency = 1
   end

استدعاء الوظيفة

بمجرد أن تعلن عن وظيفة، يمكنك تشغيلها بكتابة اسمها مع الأقواس بجوارها. على سبيل المثال، disappear() ستشغل وظيفة disappear. يُعرف هذا بـ استدعاء الوظيفة.

1. استدعِ وظيفة disappear في نهاية النص البرمجي.

   local platform = script.Parent
   
   local function disappear()
       platform.CanCollide = false
       platform.Transparency = 1
   end
   
   disappear()

2. قم ببدء اختبار اللعب. إذا عمل كودك، يجب أن تكون المنصة قد اختفت بحلول الوقت الذي يظهر فيه المستخدم.

وظيفة الظهور

يمكنك بسهولة جعل المنصة تعود للظهور من خلال كتابة دالة تفعل عكس وظيفة disappear.

1. احذف سطر disappear() من النص البرمجي.

2. أعلن وظيفة جديدة باسم appear.

3. في جسم الوظيفة، قم بتعيين خاصية CanCollide إلى صحيح وخاصية Transparency إلى 0.

   local platform = script.Parent
   
   local function disappear()
       platform.CanCollide = false
       platform.Transparency = 1
   end
   
   local function appear()
       platform.CanCollide = true
       platform.Transparency = 0
   end

حلقة الكود

يجب أن تستمر المنصة في الاختفاء والظهور باستمرار، مع بضع ثوانٍ بين كل تغيير. من المستحيل كتابة عدد لا نهائي من استدعاءات الوظائف - لحسن الحظ، مع حلقة while، لا تحتاج إلى ذلك.

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

local platform = script.Parent

local function disappear()
    platform.CanCollide = false
    platform.Transparency = 1
end

local function appear()
    platform.CanCollide = true
    platform.Transparency = 0
end

while true do

end

تبديل المنصة

داخل حلقة while، تحتاج إلى كتابة كود للانتظار لبضع ثوانٍ بين اختفاء المنصة وظهورها مرة أخرى.

يمكن استخدام الوظيفة المدمجة task.wait() لذلك. في الأقواس، تحتاج إلى عدد الثواني المراد الانتظار إليها: على سبيل المثال task.wait(3).

ثلاث ثوانٍ هي نقطة انطلاق عقلانية لفترة الوقت بين كل حالة للمنصة.

1. في حلقة while، قم باستدعاء وظيفة task.wait() مع 3 في الأقواس.
2. استدعِ وظيفة disappear.
3. استدعِ وظيفة task.wait() مرة أخرى مع 3 في الأقواس.
4. استدعِ وظيفة appear.

while true do
   task.wait(3)
   disappear()
   task.wait(3)
   appear()
end

الكود الخاص بالمنصة الآن مكتمل! اختبر كودك الآن ويجب أن تجد أن المنصة تختفي بعد ثلاث ثوانٍ وتظهر مرة أخرى ثلاث ثوانٍ لاحقة في حلقة.

يمكنك تكرار هذه المنصة لتغطية فجوة أوسع، لكن يجب عليك تغيير أوقات الانتظار في كل نص برمجي. بخلاف ذلك، ستختفي جميع المنصات في نفس الوقت ولن يتمكن المستخدمون من العبور.

الكود النهائي

local platform = script.Parent

local function disappear()
    platform.CanCollide = false
    platform.Transparency = 1
end

local function appear()
    platform.CanCollide = true
    platform.Transparency = 0
end

while true do
   task.wait(3)
   disappear()
   task.wait(3)
   appear()
end