Easelt Builderالتوثيق
Feedback
← فتح Easelt Builder
البداية

البدء السريع

أنشئ أول واجهة لك وصدّرها كمورد MTA:SA في دقائق معدودة.

مرحبًا بك في Easelt Builder — مصمّم مرئي يعمل في المتصفح لواجهات dx في MTA:SA، من إنتاج Easelt · C4. يأخذك هذا الدليل السريع في الرحلة كاملةً من لوحة رسم فارغة إلى مورد MTA قابل للتشغيل: ستختار دقة العرض، وتُسقِط أول عنصر لك، وتنسّقه، وتربط بعض المنطق، وتختبره مباشرةً، وتصدّره كملف .zip جاهز للاستخدام مباشرةً.

نظرة عامة في 60 ثانية

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

  1. اختر دقة العرض
    اختر دقة العرض المستهدفة (مثل 1920x1080) في الشريط العلوي حتى تبقى المواضع صحيحة في كل مكان.
  2. أضف عنصرًا
    انقر أداةً من صندوق الأدوات — جرّب Button — فتُسقَط على لوحة الرسم.
  3. نسّقه
    استخدم المُفتّش لضبط لون التعبئة، والزوايا، والنص، والحدّ الخارجي، والظل.
  4. رتّب
    أضف مزيدًا من العناصر وحاذِها باستخدام أدلة المحاذاة والشبكة/الالتقاط.
  5. أضف منطقًا
    يمكنك اختياريًا فتح Blueprint وربط نقرة لفتح نافذة، أو تبديل الرؤية، أو تغيير نص.
  6. اختبر
    اضغط ▶ Test في Blueprint لتجربته مباشرةً، ثم Esc للإيقاف.
  7. احفظ
    اضغط Ctrl S — كما يقوم Easelt بالحفظ التلقائي أثناء عملك.
  8. صدّر
    اذهب إلى File → Export MTA resource للحصول على ملف .zip يمكنك إسقاطه في خادمك.

الخطوة 1 — اختر دقة العرض المستهدفة

قبل أن تضع أي شيء، اضبط دقة العرض المستهدفة في الشريط العلوي — على سبيل المثال 1920x1080. هذا يُخبر Easelt Builder بالشاشة التي تصمّم من أجلها حتى يتطابق التخطيط على لوحة الرسم مع ما سيراه اللاعب عند تلك الدقة.

💡

لأن Easelt يوزّع العناصر بأسلوب متجاوب، تبقى المواضع صحيحة على الدقات الأخرى أيضًا — اختر الدقة التي تصمّم عليها، وستتكيّف واجهتك بشكل نظيف لكل الآخرين.

الخطوة 2 — أضف أول عنصر لك

افتح صندوق الأدوات وانقر أداةً لإضافة عنصرها — ابدأ بـ Button. يُسقَط العنصر مباشرةً على لوحة الرسم، جاهزًا لوضعه وتشكيله. يدعم كل عنصر الإيماءات الثلاث نفسها للتلاعب المباشر:

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

الخطوة 3 — نسّقه في المُفتّش

عند تحديد عنصرك، يعرض المُفتّش كل ما يمكنك تنسيقه. اعمل على كل عنصر تحكّم لتمنح Button المظهر الذي تريده:

عنصر التحكمما يفعله
لون التعبئةاضبط لون خلفية العنصر باستخدام منتقي الألوان.
الزوايادوّر زوايا العنصر حسب رغبتك.
النصحرّر التسمية ومظهر نصها.
الحدّ الخارجيأضف حدًّا/خطًّا حول العنصر.
الظلاطرح ظلًّا خلف العنصر لإضفاء عمق.
💡

انقر منتقي الألوان بجانب لون التعبئة لاختيار أي لون — إنها أسرع طريقة لجعل العنصر يطابق سِمة خادمك.

الخطوة 4 — أضف مزيدًا من العناصر ورتّبها

تتكوّن الواجهات الحقيقية من عدة عناصر. أضف مزيدًا من صندوق الأدوات، ثم حاذِها بدقة باستخدام أداتَي التموضع في Easelt:

  • أدلة المحاذاة — تظهر خطوط ذكية أثناء السحب، بحيث تلتقط الحواف والمراكز لتتوافق مع العناصر المجاورة.
  • الشبكة / الالتقاط — تلتقط العناصر إلى الشبكة لتباعد مرتّب ومتساوٍ دون تقدير البكسلات بالعين.

الخطوة 5 — أضف منطقًا في Blueprint (اختياري)

هل تريد أن *تفعل* واجهتك شيئًا بالفعل؟ افتح Blueprint واربط السلوك بصريًّا — دون الحاجة إلى Lua. من نقرة واحدة يمكنك، على سبيل المثال:

  • فتح نافذة
  • تبديل رؤية عنصر
  • تغيير نص عنصر
ℹ️

Blueprint اختياري — التخطيط المرئي البحت يُصدَّر ويعمل بشكل ممتاز دون أي منطق مربوط.

الخطوة 6 — اختبره مباشرةً

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

Esc
إيقاف جلسة الاختبار المباشر

الخطوة 7 — احفظ عملك

اضغط Ctrl S للحفظ. كما يقوم Easelt Builder بـالحفظ التلقائي أثناء عملك، فيبقى مشروعك محميًّا حتى لو نسيت — لكن الحفظ اليدوي عادة جيدة قبل التصدير.

CtrlS
حفظ المشروع (يعمل الحفظ التلقائي أيضًا في الخلفية)

الخطوة 8 — صدّر مورد MTA الخاص بك

عندما تكون راضيًا، حوّل تصميمك إلى مورد حقيقي. اذهب إلى File → Export MTA resource لتنزيل ملف .zip. ذلك الأرشيف هو مورد MTA:SA كامل وجاهز للاستخدام مباشرةً، ويحتوي على:

الملفما هو
gui.luaواجهتك المُولَّدة: العناصر التي رسمتها وتخطيطها.
lib.luaالمكتبة الداعمة التي يعتمد عليها الكود المُولَّد.
meta.xmlبيان المورد الذي يُخبر MTA:SA بما يجب تحميله.
الأصولأي صور وملفات أخرى يستخدمها تصميمك.
💡

فُكّ ضغط ملف .zip داخل مجلد resources في خادمك، ثم شغّله مثل أي مورد MTA آخر — دون الحاجة إلى أي تحرير يدوي.

مفيد: المعاينة دون واجهة المحرّر

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

P
تبديل المعاينة — إخفاء واجهة المحرّر لرؤية واجهتك بشكل نظيف

الخطوات التالية

لقد أنشأت أول واجهة لك وصدّرتها — عمل رائع. توجّه إلى هذه الصفحات تاليًا للتعمّق أكثر:

الواجهة
جولة كاملة في الشريط العلوي، وصندوق الأدوات، ولوحة الرسم، والمُفتّش، وBlueprint.
العناصر
كل نوع عنصر يمكنك إضافته، وما الغرض من كل منها.
المُفتّش
مرجع كامل لكل قسم تنسيق وخاصية.
Got feedback or an idea?Share it →