Easelt Builderالتوثيق
Feedback
← فتح Easelt Builder
النشر

التصدير إلى MTA

حوّل تصميمك إلى مورد MTA:SA جاهز للتشغيل.

عندما يصبح تصميمك جاهزاً، يقوم Easelt Builder بتجميعه في مورد MTA:SA كامل يمكنك وضعه مباشرةً في خادمك. تغطي هذه الصفحة بالضبط ما الذي يتم تصديره، وما الغرض من كل ملف داخل الـ .zip، والشيء الوحيد الذي يجب أن يقوم به المورد المضيف حتى تستجيب أزرارك ومنزلقاتك فعلياً للنقرات.

كيفية التصدير

توجد طريقتان لتشغيل عملية تصدير المورد، وكلتاهما تنتجان نفس حزمة الـ .zip. اختر أياً منهما يناسب سير عملك.

  1. استخدم زر التصدير
    انقر على زر Export في شريط الأدوات العلوي لإنشاء وتنزيل مورد MTA الخاص بك بصيغة .zip بنقرة واحدة.
  2. أو استخدم قائمة الملف
    افتح File → Export MTA resource… لإنتاج نفس الـ .zip تماماً. استخدم هذا إذا كنت تفضّل العمل من القوائم.
ℹ️

يُقدَّم فقط مسار Export MTA resource (.zip) الوحيد — فهو يجمع كل شيء لتصميم واحد في أرشيف واحد. لا توجد خيارات تصدير جزئية أو لكل ملف على حدة لتهيئتها.

ما بداخل ملف .zip

الأرشيف المُصدَّر هو مورد MTA جاهز للتشغيل. يحتوي على أربعة أشياء: نصّان برمجيان من Lua، وملف بيان (manifest)، ومجلد أصول (assets). إليك ما يقوم به كل منها.

الملف / المجلدما الغرض منه
gui.luaواجهتك. يحتوي على كل استدعاء dxDraw بالإضافة إلى منطق Blueprint المُصرَّف — النقرات، والشروط، وفتح النوافذ وإغلاقها، وتغييرات النص أو اللون.
lib.luaمكتبة مساعِدات رسم يعتمد عليها gui.lua. يتم تحميلها تلقائياً قبل gui.lua بحيث تكون الدوال المساعِدة موجودة بحلول وقت تشغيل واجهتك.
meta.xmlبيان (manifest) المورد. يسرد النصوص البرمجية على أنها من جانب العميل ويعلن عن أي ملفات أصول حتى يقوم MTA بتحميلها بشكل صحيح.
assets/كل صورة وخط قمت باستيرادها، بالإضافة إلى صورة الخلفية إذا كان تصميمك يستخدم واحدة.

gui.lua

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

lib.lua

lib.lua هي مكتبة مشتركة من مساعِدات الرسم تستخدمها واجهتك. لأنه يتم تحميلها تلقائياً قبل gui.lua، فلست بحاجة إلى استدعائها أو ربطها بنفسك — تكون الدوال المساعِدة جاهزة في اللحظة التي يبدأ فيها gui.lua بالرسم.

meta.xml

البيان (manifest) الذي يقرأه MTA لفهم موردك. يسجّل lib.lua وgui.lua كنصوص برمجية من جانب العميل ويسرد أي ملفات في assets/ حتى يعرف المحرك أن يقوم بتنزيلها وبثّها إلى اللاعبين.

assets/

كل ما قمت باستيراده يُشحن هنا — الصور والخطوط — إلى جانب صورة الخلفية إذا كان تصميمك يستخدم واحدة. هذه هي الملفات التي يشير إليها meta.xml وتقوم واجهتك بتحميلها.

ℹ️

كل ملف مُصدَّر يحمل ترويسة حقوق الطبع والنشر الخاصة بـ Easelt Builder (© Easelt · C4).

اجعل واجهتك تفاعلية

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

⚠️

يجب أن يستدعي موردك المضيف showCursor(true) حتى تتلقى الأزرار والمنزلقات النقرات. بدونه، سترسم واجهتك لكنها لن تستجيب للفأرة.

صدّر صورة مسطّحة بدلاً من ذلك

أحياناً تريد فقط صورة لتصميمك — لنموذج أولي، أو منشور في منتدى، أو مراجعة تصميم. استخدم File → Export design as PNG… لحفظ صورة مسطّحة لمخطّطك. هذا منفصل عن تصدير المورد وينتج ملف .png واحداً بدلاً من مورد قابل للتشغيل.

Export MTA resource (.zip)
المورد الكامل القابل للتشغيل — gui.lua وlib.lua وmeta.xml وassets/. استخدم هذا لشحن واجهتك إلى خادم.
Export design as PNG…
صورة مسطّحة لتصميمك. استخدم هذا للمعاينات والنماذج الأولية والمشاركة — وليس للتشغيل داخل اللعبة.

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

لديك الآن مورد MTA كامل بصيغة .zip. توجّه إلى صفحة Installing بعد ذلك لتتعلّم كيفية وضعه في مجلد resources الخاص بخادمك، وإضافته إلى mtaserver.conf، وتشغيله داخل اللعبة.

Got feedback or an idea?Share it →