التثبيت

المتطلبات

الريسورس	مطلوب
OneSync	نعم
oxmysql	نعم
ox_lib	نعم
فريموورك واحد: qbx_core أو qb-core أو es_extended أو vrp	نعم
إنفنتوري مدعوم	نعم (Qbox يحتاج ox_inventory)
ox_target أو qb-target	اختياري. بدونهما يضغط اللاعب E.
lb-phone	اختياري، لإشعارات السبراي

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

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

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

خذ نسخة احتياطية من قاعدة البيانات، ثم استورد ملفًا واحدًا من install/sql/:

الفريموورك	الملف
Qbox	qbx_core.sql
QBCore	qb-core.sql
ESX	es_extended.sql
vRP 1 / vRP 2	vrp.sql

ملفات QB و Qbox تنسخ أيضًا أرصدة العصابات الموجودة من management_funds إلى جدول أموال العصابات.

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

ox_inventory

-- ox_inventory/data/items.lua
['moh_alphaspray'] = {
    label = 'Gang Spray', weight = 3300, stack = true, close = true, consume = 0,
    client = { image = 'moh_alphaspray.png' }, server = { export = 'MOH-sprays.useItem' }
},
['moh_kingspray'] = {
    label = 'King Spray', weight = 3300, stack = true, close = true, consume = 0,
    client = { image = 'moh_kingspray.png' }, server = { export = 'MOH-sprays.useItem' }
},
['moh_ganglap'] = {
    label = 'Gang Tablet', weight = 5000, stack = false, close = true, consume = 0,
    client = { image = 'moh_ganglap.png' }, server = { export = 'MOH-sprays.useItem' }
},
['moh_sprayremove'] = {
    label = 'Spray Remover', weight = 3300, stack = true, close = true, consume = 0,
    client = { image = 'moh_sprayremover.png' }
},
['moh_policesprayremove'] = {
    label = 'Police Spray Remover', weight = 3300, stack = true, close = true, consume = 0,
    client = { image = 'moh_policesprayremove.png' }
},

qb-inventory

Copy the five entries from install/qb_items.lua
into QBCore.Shared.Items in qb-core/shared/items.lua.

ESX

es_extended.sql adds the five items to the ESX items table.
If you use ox_inventory with ESX, also add the ox_inventory entries.

• qb-inventory: انسخ الأيتمات الخمسة من install/qb_items.lua إلى QBCore.Shared.Items في qb-core/shared/items.lua.
• ESX: ملف es_extended.sql يضيف الأيتمات الخمسة إلى جدول items. وإذا كنت تستخدم ox_inventory مع ESX فأضف أيضًا أيتمات ox_inventory.

انسخ install/inventory/*.png إلى مجلد صور الإنفنتوري:

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

WARNING

اترك consume = 0 في ox_inventory، لأن السكربت يحذف الأيتم بنفسه بعد وضع السبراي بنجاح.

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

الأدمن يستطيع إنشاء العصابات من اللابتوب. أضف معرّفات الديسكورد في server/server.lua:

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

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

Qbox

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
ensure ox_target

ensure MOH-sprays

QBCore

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure qb-inventory
ensure qb-target

ensure MOH-sprays

ESX

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_inventory
ensure ox_target

ensure MOH-sprays

اترك MOH-sprays شغّالًا دائمًا، لأن العصابات التي تُنشأ من اللابتوب يسجّلها هذا السكربت.

6. السرقة من القائمة الدائرية (اختياري)

لإظهار خيار Rob player في qbx_radialmenu أثناء حروب السبراي، الصق محتوى install/qbx_radialmenu.lua في config.lua الخاص بذلك الريسورس، بعد تعريف Config.Menu. ومع ox_target أو qb-target يظهر الخيار أيضًا على اللاعبين، والأمر /robwarzone يعمل كبديل.

7. إنشاء أول عصابة

1. أعطِ نفسك moh_ganglap وافتحه.
2. اذهب إلى Gang Admin ← Create Gang.
3. أدخل الاسم الداخلي، والاسم الظاهر، واللون، ورابطًا مباشرًا لصورة PNG/JPG عبر HTTPS.
4. عيّن أول قائد:
   • QBCore / Qbox: /setgang <id> <gang> 3
   • ESX / vRP: /mohgangassign <id> <gang> 3