النشر

تثبيت المورد (resource)

أسقِط المورد المُصدَّر داخل خادمك وشغّله.

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

ما الذي يحتويه ملف التصدير

عندما تصدّر من Easelt Builder، تحصل على ملف .zip يحتوي على مورد MTA:SA كامل ومكتفٍ ذاتياً. قبل أن تثبّت أي شيء، من المفيد أن تعرف ما الذي يفعله كل جزء.

meta.xml

بيان المورد (manifest). يعلن سكربتاتك على أنها type="client" ويسرد الملفات التي يجب على MTA تحميلها وإرسالها للاعبين.

gui.lua

كود رسم dx على جانب العميل (client-side) الذي يعرض واجهتك — اللوحات والأزرار وأشرطة التمرير والنص الذي صمّمته.

lib.lua

المكتبة الداعمة التي تعتمد عليها واجهتك الرسومية. أبقِها بجانب gui.lua في كل الأوقات.

assets/

المجلد الذي يحتوي على أي صور وأصول أخرى يشير إليها تصميمك.

ℹ️

السكربتات هي رسم dx على جانب العميل — يعلنها meta.xml على أنها type="client"، لذا تُرسم الواجهة الرسومية محلياً لكل لاعب يستقبل المورد.

ثبّته خطوة بخطوة

فُكّ الضغط داخل دليل الموارد الخاص بك
استخرج المجلد المُصدَّر داخل دليل الموارد (resources) الخاص بخادمك، على سبيل المثال server/mods/deathmatch/resources/. أبقِ meta.xml وgui.lua وlib.lua والمجلد assets/ معاً داخل مجلد المورد الواحد ذاك.
حدّث قائمة الموارد
في وحدة تحكم الخادم (console) أو لوحة الإدارة الخاصة بك، شغّل /refresh كي يمسح MTA دليل الموارد ويلتقط المورد المُضاف حديثاً.
شغّل المورد
شغّل /start <resourceName>، مستبدلاً <resourceName> باسم مجلد موردك. سيبدأ MTA بإرسال ملفات العميل إلى اللاعبين المتصلين.
أظهر المؤشر للتفاعل
لكي تسجّل الأزرار وأشرطة التمرير النقرات، تأكد من استدعاء showCursor(true) للاعب — إما من نمط اللعب (gamemode) الخاص بك أو من مورد مُشغِّل صغير خاص بك.

مرجع أوامر الخادم

هذان هما الأمران اللذان ستشغّلهما لجعل المورد مباشراً. اكتبهما في وحدة تحكم الخادم (console) أو لوحة الإدارة الخاصة بك.

الأمر	ما الذي يفعله
/refresh	يعيد مسح دليل الموارد كي يرى MTA المورد المُضاف حديثاً.
/start <resourceName>	يشغّل المورد ويبدأ بإرسال الواجهة الرسومية للعميل إلى اللاعبين.

كيف تصل الواجهة الرسومية إلى اللاعبين

بما أن السكربتات على جانب العميل، فإن الواجهة الرسومية تُرسم بشكل فردي لكل لاعب يستقبل المورد. عندما تشغّل المورد بـ/start، يبثّ MTA ملفات العميل إلى اللاعبين المتصلين ويعمل رسم dx على أجهزتهم — ليس هناك عرض على الخادم لكل لاعب لإدارته.

💡

لكي تعمل عناصر التحكم القابلة للنقر، يجب أن يكون showCursor(true) نشطاً للاعب. من دون مؤشر مرئي، لا تستطيع الأزرار وأشرطة التمرير استقبال النقرات.

إعادة تسمية المورد

أنت حرّ في إعادة تسمية مجلد المورد إلى ما يناسب اصطلاح التسمية الخاص بخادمك. فقط تذكّر أن تشغّله بذلك الاسم الجديد للمجلد باستخدام /start <resourceName>.

⚠️

عند إعادة التسمية، أبقِ meta.xml وgui.lua وlib.lua معاً في المجلد نفسه. فصلها عن بعضها سيؤدي إلى تعطّل المورد.

استكشاف الأخطاء وإصلاحها

العَرَض	الإصلاح
لا يظهر أي شيء على الشاشة	تأكد من أن المورد قد بدأ فعلاً (`/start <resourceName>`) وأن العميل قد نزّله — يجب أن تصل ملفات جانب العميل إلى اللاعب قبل أن يُرسم أي شيء.
النقرات لا تعمل	تأكد من استدعاء `showCursor(true)` للاعب. تحتاج الأزرار وأشرطة التمرير إلى مؤشر مرئي لتسجيل النقرات.

💡

إذا لم يظهر تغيير في تصميمك، شغّل /refresh مرة أخرى بعد إعادة التصدير وإعادة إضافة المورد، ثم شغّله بـ/start كي يعيد MTA إرسال ملفات العميل المُحدَّثة.