التفاعل

Blueprint

أضف المنطق باستخدام رسم بياني مرئي للعُقد: الأحداث والشروط والإجراءات — دون كتابة أي كود.

Blueprint هو محرّر الرسم البياني المرئي للعُقد في Easelt Builder — المكان الذي يتوقّف فيه تصميمك عن كونه نموذجًا ثابتًا ويبدأ في *أداء أشياء فعلية*. تفتحه بالضغط على زر Blueprint، وتُسقط العُقد من لوحة NODES، وتوصّلها ببعضها بحيث تفتح ضغطة نافذةً، أو يكشف مفتاح لوحةً، أو يغيّر زرٌّ نصَّ عنصرٍ ولونه. عند التصدير، يُترجَم الرسم البياني بالكامل إلى gui.lua ويعمل مباشرةً داخل اللعبة.

فتح Blueprint

اضغط على زر Blueprint للانتقال من لوحة التصميم إلى محرّر الرسم البياني للعُقد. بدلًا من سحب العناصر المرئية، أنت الآن تسحب *عُقدًا* — كتلًا منطقية صغيرة — من لوحة NODES إلى لوحة الرسم البياني، ثم توصّل أطرافها (pins) لوصف السلوك. كل ما توصّله هنا يصبح منطقًا حقيقيًا للعبة، وليس مجرّد تأثير معاينة.

كيف يعمل الرسم البياني

يُقرأ رسم Blueprint البياني من اليسار إلى اليمين على امتداد الأسلاك. يُطلَق حدث (شيء يفعله اللاعب)، ثم يقرّر شرط اختياري أيّ مسارٍ يُتّبع، وينفّذ إجراء واحد أو أكثر النتيجة. تبني السلوك بإسقاط هذه الأنواع الثلاثة من العُقد وتوصيل طرف out لواحدةٍ بطرف in للتالية.

عُقد الأحداث (خضراء)

نقطة بداية السلسلة. ترتبط بعنصر محدّد وتُطلَق عندما يتفاعل معه اللاعب.

عُقد الشرط / "If"

تفرّع تدفّق المنطق. تطرح سؤالًا بنعم/لا وترسل الرسم البياني عبر مسار then أو else.

عُقد الإجراءات

الحمولة الفعلية. تفتح النوافذ، وتُظهر العناصر أو تخفيها، وتغيّر النص واللون، وتشغّل الرسوم المتحركة والأصوات، أو تبدّل التصاميم.

عُقد الأحداث

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

الحدث	ما الذي يفعله
`onClick`	يُطلَق عندما يضغط اللاعب على العنصر المرتبط.
`onHover`	يُطلَق عندما يتحرّك المؤشّر فوق العنصر المرتبط.
`onLeave`	يُطلَق عندما يبتعد المؤشّر عن العنصر المرتبط.
`onChange`	يُطلَق عندما يغيّر مربّع اختيار أو مفتاح حالته (تشغيل/إيقاف).
`onOpen`	يُطلَق عندما تُفتَح نافذة.
`onClose`	يُطلَق عندما تُغلَق نافذة.

عُقد الشروط

عُقد الشرط (أو "If") تفرّع منطقك. لكلٍّ منها مخرج then ومخرج else — وصّل الإجراءات التي تريدها على كل مسار. اضغط على حقل الهدف في العُقدة لاختيار العنصر أو النافذة التي تختبرها.

الشرط	ما الذي يتحقّق منه
`ifWin`	ما إذا كانت نافذة مفتوحة حاليًا.
`ifSwitch`	ما إذا كان مفتاح أو مربّع اختيار مُفعّلًا حاليًا.
`ifVis`	ما إذا كان عنصر ظاهرًا حاليًا.

عُقد الإجراءات

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

الإجراء	ما الذي يفعله
`openWin`	يفتح نافذة.
`closeWin`	يغلق نافذة.
`toggleWin`	يبدّل حالة نافذة بين مفتوحة ومغلقة.
`showEl`	يُظهر عنصرًا.
`hideEl`	يخفي عنصرًا.
`toggleEl`	يبدّل ظهور عنصر.
`setText`	يغيّر نص عنصر (يدعم العربية).
`setColor`	يغيّر لون تعبئة عنصر.
`playAnim`	يشغّل الرسم المتحرك للعنصر.
`sound`	يشغّل صوتًا.
`switchDesign`	يبدّل إلى تصميم أو شاشة أخرى.

💡

setText يدعم العربية دعمًا كاملًا، لذا يمكنك التحكّم في التسميات من اليمين إلى اليسار مباشرةً من الرسم البياني.

النوافذ واللوحات

يمكن لأي عنصر أن يتصرّف كنافذة. هذا ما يتيح لـ openWin وcloseWin وtoggleWin وifWin وonOpen وonClose استهدافه.

افتح لوحة Blueprint
حدّد العنصر وافتح قسم "Blueprint panel" في المفتّش (Inspector).
التصرّف كنافذة / لوحة
فعّل "Act as window / panel" لتحويل العنصر إلى نافذة قابلة للفتح.
يبدأ مفتوحًا (اختياري)
يمكنك اختياريًا تفعيل "Starts open" ليكون العنصر ظاهرًا عند أوّل تحميل للواجهة.

العناصر التي ترسمها فوق لوحةٍ وداخلها تصبح أعضاءً لها وتُفتَح وتُغلَق معها. أمّا في حالة المجموعة، فإنّ عناصرها الفرعية تعمل كأعضاءٍ لها تلقائيًا — فيؤدّي فتح المجموعة أو إغلاقها إلى جلب محتواها بالكامل معها.

توصيل العُقد ببعضها

توصّل العُقد بالسحب بين أطرافها. هكذا تشكّل عُقد الأحداث والشروط والإجراءات سلسلةً عاملة.

اسحب من طرف out لحدثٍ إلى طرف in لإجراءٍ لإطلاقه.
اربط الإجراءات بالتسلسل لتشغيل عدّةٍ منها الواحدة تلو الأخرى.
من الشرط، وصّل طرفَي then وelse بالإجراءات التي يجب أن يشغّلها كل مسار.
اضغط على حقل الهدف في العُقدة لاختيار عنصرها أو نافذتها من قائمة منسدلة.

عناصر التحكّم في اللوحة

لوحة الرسم البياني قابلة للتحريك والتكبير بالكامل حتى تتمكّن من ترتيب السلوكيات الكبيرة براحة.

التحكّم	الإجراء
عجلة التمرير	التكبير باتجاه المؤشّر.
سحب مساحة فارغة	تحريك اللوحة.
لوحة NODES	تضيف عُقدًا إلى الرسم البياني.

التصدير إلى gui.lua

عند التصدير، يُترجَم رسم Blueprint البياني بالكامل إلى gui.lua. الضغطات، والشروط، وفتح النوافذ وإغلاقها، وتغييرات النص واللون، كلها تعمل داخل اللعبة — وليس فقط في وضع الاختبار (Test). يصبح رسمك البياني للعُقد منطقًا حقيقيًا وقابلًا للشحن في MTA:SA.

ℹ️

بما أنّ كل شيء يُترجَم إلى gui.lua، فإنّ السلوك الذي توصّله في Blueprint يعمل على لاعبين حقيقيين، وليس فقط داخل معاينة أداة البناء.