ESX Legacy هو الأكثر استخداماً في سيرفرات Roleplay العربية. هذا الدليل يمشيك خطوة بخطوة من سيرفر FiveM فاضي إلى ESX شغّال. الوقت المتوقّع: ٣٠ إلى ٤٥ دقيقة لأول مرة.
قبل ما تبدأ — المتطلبات
- سيرفر FiveM شغّال (مفتاح Cfx.re مفعّل)
- قاعدة بيانات MySQL (متوفّرة بـ تبويب "قواعد البيانات" في Panel، ولا تنشئها يدوياً)
- وصول SFTP أو "مدير الملفات"
الخطوة 1: حمّل ESX Legacy من المصدر الرسمي
الـ repository الرسمي على GitHub:github.com/esx-framework/esx_core
- اضغط على Releases
- حمّل آخر إصدار stable (مو pre-release/dev)
- فك الضغط على جهازك
💡 لا تنزّل من "leaked" sources. ESX مجاني ومفتوح المصدر، وأي نسخة مدفوعة من خارج الـ repo الرسمي تكون منسوخة من حد آخر.
الخطوة 2: ارفع الملفات للسيرفر
من "مدير الملفات" في Panel، ادخل مجلد resources/وأنشئ مجلد جديد [esx] (الأقواس مهمّة — تخبر FiveM إنه يحمّل كل اللي بداخلها). ارفع محتويات الـ zip فيه.
الخطوة 3: استيراد قاعدة البيانات
- افتح تبويب "قواعد البيانات" في Panel
- أنشئ database جديدة، احفظ بيانات الاتصال
- افتح phpMyAdmin من Panel
- اختر الـ database واضغط Import
- اختر ملف
essentialmode.sqlمن ESX
الخطوة 4: عدّل server.cfg
افتح server.cfg من "مدير الملفات" وأضف في النهاية:
# قاعدة البيانات set mysql_connection_string "mysql://USER:PASS@HOST:PORT/DB_NAME" # Resources الأساسية ensure oxmysql ensure es_extended ensure esx_menu_default ensure esx_menu_dialog ensure esx_menu_list # Jobs و Spawns (اختياري) ensure esx_jobs ensure esx_society ensure esx_addonaccount
الخطوة 5: شغّل وراقب
ارجع لـ Panel، أوقف السيرفر ثم شغّله. راقب الـ console — لازم تشوف:
Started resource oxmysqlStarted resource es_extended- ما تشوف أي error أحمر
ادخل السيرفر من FiveM client، ولو ظهر لك menu "Choose Character"، مبروك — ESX يشتغل ✅
مشاكل شائعة
"Database connection failed" — تأكد من mysql_connection_string، الـ password ما فيها أحرف خاصة (مثل @) بدون URL-encode.
"Resource not found" — تأكد إن المجلد اسمه [esx] مع الأقواس، وإن كل مجلد بداخل بداخله ملف fxmanifest.lua.
💡 ESX يشتغل مع oxmysql (الموصى به)، مو mysql-async القديم. لو لقيت أمثلة قديمة تستخدم mysql-async، تجاوزها.