التثبيت

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

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

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

استورد ملفًا واحدًا من install/SQL/ حسب الفريموورك:

الفريموورك	الملف
Qbox	qbx.sql
QBCore	qbcore.sql
ESX	esx.sql
vRP 1	vrp1.sql
vRP 2	vrp2.sql

سينشئ جداول mg_payload_* للمواسم واللاعبين والمباريات والمكافآت.

INFO

قاعدة البيانات مطلوبة للإحصائيات والوضع التنافسي ولوحة الصدارة والمكافآت. بدونها تعمل المباريات لكن لا يُحفظ شيء.

3. إضافة أيتم التابلت (اختياري)

يستطيع اللاعبون فتح القائمة بأمر /payload. وإذا أردت أيضًا أيتم تابلت:

ox_inventory

-- ox_inventory/data/items.lua
['paytab'] = {
    label = 'Payload Tablet',
    description = 'Open Payload matchmaking.',
    weight = 500,
    stack = false,
    close = true,
    consume = 0,
    client = { image = 'paytab.png' },
    server = { export = 'MG-payload.UseOxPayloadTablet' }
},

qb-inventory

-- qb-core/shared/items.lua
['paytab'] = {
    name = 'paytab',
    label = 'Payload Tablet',
    weight = 500,
    type = 'item',
    image = 'paytab.png',
    unique = true,
    useable = true,
    shouldClose = true,
    description = 'Open Payload matchmaking.'
},

انسخ install/images/paytab.png إلى مجلد صور الإنفنتوري. ملفات أيتمات vRP موجودة في install/vrp1.lua و install/vrp2.lua.

بعدها اضبط إعدادات الأيتم في config.lua:

Config.MenuItem = {
    Enabled = true,
    Name = 'paytab',
    RequireForMenu = false,   -- true = /payload only works while holding the tablet
    RegisterUsableItem = false,
    AllowCommand = true
}

إذا وضعت RequireForMenu = true فلن يعمل /payload إلا إذا كان التابلت مع اللاعب.

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

أضف معرّفات الديسكورد لفريق الإدارة في Config.Admins داخل config.lua:

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

هؤلاء فقط يستطيعون استخدام أوامر الأدمن ومحرر المسارات.

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

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory

ensure MG-payload

تأكد أن OneSync مفعّل في سيرفرك.

6. التجربة

1. أعد تشغيل السيرفر.
2. اكتب /payload لفتح القائمة.
3. كأدمن، اكتب /payloadtest لبدء جولة تجريبية وحدك.