التثبيت

المتطلبات

الريسورس	مطلوب
oxmysql	نعم
qbx_core أو qb-core	نعم
ox_inventory أو qb-inventory	نعم
interact أو ox_target أو qb-target	نعم (واحد منها)
ox_lib	اختياري، لإشعارات ox_lib
lb-phone أو npwd أو qb-phone	اختياري، لإشعارات الجوال
سكربت إسعاف	اختياري، راجع الإسعاف

Escrow

MG-Contest مشفّر بنظام Cfx.re Escrow. لتشغيله:

• حمّله من Cfx.re Portal بنفس الحساب الذي اشتراه.
• مفتاح الترخيص في سيرفرك (sv_licenseKey) يجب أن يكون من نفس حساب Cfx.re.
• استخدم نسخة حديثة من ملفات السيرفر (artifacts).

1. إضافة السكربت

انسخ المجلد إلى مجلد resources في سيرفرك. يجب أن يكون اسم المجلد MG-Contest بالضبط، لأن إكسبورت أيتم التابلت يعتمد على هذا الاسم.

2. استيراد قاعدة البيانات

استورد ملف install/mg_contest.sql في قاعدة بيانات السيرفر (HeidiSQL أو phpMyAdmin أو أي برنامج MySQL). سينشئ كل جداول mg_contest_* مع المفاتيح والفهارس. راجع قاعدة البيانات للتفاصيل.

3. إضافة أيتم التابلت

يفتح اللاعبون الواجهة بأيتم tablet. أضفه إلى الإنفنتوري الذي تستخدمه.

ox_inventory

-- ox_inventory/data/items.lua
['tablet'] = {
    label = 'Contest Tablet',
    weight = 100,
    stack = true,
    close = true,
    consume = 0,
    description = 'Access clan management, contests, leaderboards, and the Battle Pass.',
    client = {
        image = 'tablet.png',
        export = 'MG-Contest.UseTabletItem',
    },
},

qb-inventory

-- qb-core/shared/items.lua
['tablet'] = {
    name = 'tablet',
    label = 'Contest Tablet',
    weight = 100,
    type = 'item',
    image = 'tablet.png',
    unique = false,
    useable = true,
    shouldClose = true,
    description = 'Access clan management, contests, leaderboards, and the Battle Pass.',
},

بعدها انسخ install/img/tablet.png إلى مجلد صور الإنفنتوري:

• ox_inventory: ox_inventory/web/images/
• qb-inventory: qb-inventory/html/images/

WARNING

اسم الأيتم يجب أن يطابق Config.LaptopItem (الافتراضي tablet). في ox_inventory اترك consume = 0 حتى لا يُستهلك الأيتم، وأعد تشغيل ox_inventory بعد تعديل الأيتمات.

4. تحديد الأدمنز

افتح server/server.lua وأضف معرّفات الديسكورد لكل من تريد أن يدخل لوحة الأدمن:

Config.Admins = {
    'discord:123456789012345678',
    'discord:987654321098765432',
}

راجع لوحة الأدمن لمعرفة طريقة عمل الصلاحيات.

5. ترتيب التشغيل

أضف السكربت في server.cfg بعد كل الريسورسات التي يعتمد عليها:

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure ox_target

ensure MG-Contest

6. سطر الأنتي تشيت

السطر الأول في fxmanifest.lua يحمّل WaveShield:

shared_script '@WaveShield/resource/include.lua'

لا تستخدم WaveShield؟

احذف هذا السطر. إذا لم يكن ريسورس WaveShield موجودًا في سيرفرك، لن يعمل MG-Contest.

7. التجربة

1. أعد تشغيل السيرفر (أو refresh ثم ensure MG-Contest).
2. أعطِ نفسك الأيتم: /giveitem <id> tablet 1.
3. استخدم التابلت. يجب أن يفتح، ويُغلق بزر Esc، ولا يُستهلك.
4. اكتب /cmafia للتأكد من صلاحية الأدمن.