التصدير إلى MTA
حوّل تصميمك إلى مورد MTA:SA جاهز للتشغيل.
عندما يصبح تصميمك جاهزاً، يقوم Easelt Builder بتجميعه في مورد MTA:SA كامل يمكنك وضعه مباشرةً في خادمك. تغطي هذه الصفحة بالضبط ما الذي يتم تصديره، وما الغرض من كل ملف داخل الـ .zip، والشيء الوحيد الذي يجب أن يقوم به المورد المضيف حتى تستجيب أزرارك ومنزلقاتك فعلياً للنقرات.
كيفية التصدير
توجد طريقتان لتشغيل عملية تصدير المورد، وكلتاهما تنتجان نفس حزمة الـ .zip. اختر أياً منهما يناسب سير عملك.
- استخدم زر التصديرانقر على زر Export في شريط الأدوات العلوي لإنشاء وتنزيل مورد MTA الخاص بك بصيغة
.zipبنقرة واحدة. - أو استخدم قائمة الملفافتح 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 واحداً بدلاً من مورد قابل للتشغيل.
gui.lua وlib.lua وmeta.xml وassets/. استخدم هذا لشحن واجهتك إلى خادم.الخطوات التالية
لديك الآن مورد MTA كامل بصيغة .zip. توجّه إلى صفحة Installing بعد ذلك لتتعلّم كيفية وضعه في مجلد resources الخاص بخادمك، وإضافته إلى mtaserver.conf، وتشغيله داخل اللعبة.