QBCore هو البديل الحديث لـ ESX، تطوير نشط ومجتمع أكبر للـ resources الجديدة. هذا الدليل مماثل لـ ESX لكن بخصوصيات QBCore.
ليش QBCore وليس ESX؟
- Documentation أوضح — موقع رسمي مع شرح كل function
- Modular — تقدر تشيل أو تضيف modules بدون كسر الـ core
- Active development — updates أسبوعية، bug fixes أسرع
- Ecosystem أكبر — معظم الـ resources الجديدة (٢٠٢٤+) مكتوبة لـ QBCore
المتطلبات
- سيرفر FiveM شغّال
- قاعدة بيانات MySQL (من تبويب "قواعد البيانات")
- وصول لـ "مدير الملفات"
الخطوة 1: حمّل QBCore من المصدر الرسمي
المستودع الرسمي:
- الـ core:
github.com/qbcore-framework/qb-core - الـ resources الأساسية:
github.com/qbcore-framework(كل resource في repo منفصل)
الطريقة الأسرع: حمّل txAdmin recipe الرسمي منgithub.com/Andyyy7666/QBCore-txAdminRecipe— يثبّت QBCore + كل الـ resources الأساسية بضغطة زر.
الخطوة 2: نظّم الـ resources
هيكل المجلدات الموصى به:
resources/
[qb]/ ← QBCore core resources
qb-core/
qb-multicharacter/
qb-spawn/
qb-target/
...
[standalone]/ ← non-QB resources
oxmysql/
PolyZone/
[custom]/ ← الـ scripts اللي تكتبها أنتالخطوة 3: استيراد قاعدة البيانات
- افتح phpMyAdmin من Panel
- أنشئ database جديدة (مثل
qbcore) - استورد
qb-core/qbcore.sql
الخطوة 4: server.cfg
# Database set mysql_connection_string "mysql://USER:PASS@HOST:PORT/qbcore" # Convars المهمّة setr UseTarget false # true لو تبي qb-target set sv_enforceGameBuild 2802 # latest build # Resources order مهم! ensure oxmysql ensure qb-core ensure qb-multicharacter ensure qb-spawn ensure qb-apartments ensure qb-clothing ensure qb-weathersync ensure qb-radialmenu
⚠️ ترتيب ensure مهم — oxmysql دائماً أول شيء، وqb-core ثاني شيء قبل أي qb-* آخر.
الخطوة 5: شغّل + سجّل أول admin
بعد ما السيرفر يبدأ بدون errors:
- ادخل السيرفر من FiveM client
- في console السيرفر (من Panel)، نفّذ:
add_principal identifier.steam:YOUR_STEAM_HEX qbcore.god add_ace qbcore.god command allow
استبدل YOUR_STEAM_HEX بالـ Steam ID الـ hex الخاص فيك (تلاقيه في console لما تدخل السيرفر).
الفرق العملي عن ESX
- QBCore:
QBCore = exports['qb-core']:GetCoreObject() - ESX:
TriggerEvent('esx:getSharedObject', ...)
لو تحوّل scripts من ESX لـ QBCore، اقرأ conversion guides في docs QBCore الرسمية.