هل عليّ إعادة تشغيل السيرفر بالكامل؟
لا، تكفي إعادة تشغيل السكربت لتغييرات الإعدادات واللغة. ويُنفَّذ الـ SQL مرة واحدة فقط، ولا تفيد إعادة التشغيل الكاملة إلا إذا غيّرت ترتيب تشغيل السكربتات.
دليل
تثبيت سكربت FiveM
الخطوات التالية هي نفسها لكل سكربت نبيعه. وتكرّر كل صفحة منتج ما يخصّها وحدها، فاقرأ هذه المرة واحدة وسيمضي الباقي بسرعة.
من أين تأتي الملفات
تُسلَّم المشتريات عبر Tebex وتصل إلى حسابك في Keymaster لدى Cfx.re، تحت Granted assets. حمّل من هناك لا من رابط يرسله لك أحدهم. فالسكربت الذي يصلك خارج هذه القناة لا يحمل أي entitlement مرتبط بمفتاح ترخيصك، ما يعني لا تحديثات ولا حق في الدعم.
وضع السكربت في مكانه
انسخ المجلد إلى مجلد resources لديك، مع إبقاء الاسم كما سُلّم تمامًا. فهذا الاسم هو ما تستخدمه استدعاءات exports، وتغييره يكسر كل تكامل لديك أو لدى سكربت آخر. ثم أضف سطر التشغيل إلى إعدادات السيرفر.
ensure oxmysql
ensure avenida_barberلماذا يهمّ الترتيب
شغّل طبقة قاعدة البيانات قبل السكربت، لأن السكربت يكتب عند الإقلاع. وإذا بدأ الفريمورك بعدنا فسيعيد الـ bridge المحاولة ويجده على أي حال، لكن تأخير تشغيل oxmysql يعطيك خطأ SQL بدل محاولة جديدة.
تنفيذ الـ SQL
يأتي مع كل سكربت ملف INSTALL.sql مقسّم إلى أقسام معنونة. القسم [A] إلزامي ويُنفَّذ دائمًا. أما الأقسام اللاحقة فمشروطة، ويقول رأس الملف بالضبط متى تحتاجها، وغالبًا ما تكون تخزين المظهر للسيرفرات التي لا تملك واحدًا بالفعل.
التأكّد من نجاح التثبيت
اضبط Config.Debug = true، وأعد التشغيل، واقرأ الكونسول. سطر واحد لكل فئة bridge يذكر الهدف المختار. كما تتيح معظم السكربتات أمر فحص يطبع تقريرًا كاملًا داخل اللعبة، مثل /avenida_barber_check، بعد أن تمنح نفسك الـ ace.
add_ace group.admin avenida_barber.admin allowما يجب ضبطه قبل الافتتاح
أمران يستحقّان الحسم قبل وصول اللاعبين: اللغة في Config.Locale، والأسعار التي تسكن في ملف الإعدادات المسمّى باسم السكربت. وكل ما عداهما له قيمة افتراضية تعمل على معظم السيرفرات.
التحديث لاحقًا
حمّل النسخة الجديدة من Keymaster واستبدل المجلد، مع الاحتفاظ بملفات config/ وlocales/ الخاصة بك. هذان المجلدان خارج الإسكرو تحديدًا لتبقى تعديلاتك بعد التحديث، ويذكر الـ changelog كل ما تغيّر مكانه.
أسئلة
السكربت لا يبدأ، أين أنظر أولًا؟
في كونسول السيرفر عند الإقلاع. فالاعتماد الناقص، واسم المجلد الخاطئ، وفشل الـ SQL، كلها تطبع سطرًا هناك. اضبط Config.Debug = true وأعد التشغيل لتحصل على سطر لكل فئة bridge، فيتبيّن لك إن كان الاكتشاف قد وجد ما تتوقّعه.
هل يمكنني تغيير اسم مجلد السكربت؟
لا. اسم المجلد هو ما تستخدمه استدعاءات exports، لدينا ولديك، وتغييره يكسر كل التكاملات بصمت. وإن احتجت اسمًا مختلفًا في إعدادات السيرفر فاستخدم رابطًا رمزيًا بدل إعادة التسمية.
أين أجد ملفاتي بعد إعادة التثبيت؟
في حسابك على Keymaster لدى Cfx.re، تحت Granted assets. فالـ entitlement يتبع الحساب الذي اشترى السكربت، ولا يغيّر ذلك سيرفر جديد ولا جهاز آخر.
