يغطي هذا الدليل كيفية تثبيت الموارد (السكريبتات) على خادم FiveM الخاص بك، وإعداد قاعدة بيانات MySQL لأطر العمل مثل ESX أو QBCore، وفهم ترتيب تحميل الموارد. إذا لم تكن قد أكملت الإعداد الأولي للخادم بعد، ابدأ بـ دليل إعداد خادم FiveM أولاً.

تثبيت الموارد والسكريبتات

يتم توسيع خوادم FiveM باستخدام الموارد (وتسمى أيضًا السكريبتات). تضيف الموارد ميزات مثل معارض السيارات والوظائف وعناصر واجهة المستخدم وأطر العمل والمزيد.

كيفية تثبيت مورد

1. قم بتنزيل المورد من مصدره (GitHub، منتديات Cfx.re، Tebex، إلخ.).
2. استخرج مجلد المورد من ملف ZIP/الأرشيف إذا لزم الأمر.
3. ارفع مجلد المورد إلى مجلد resources/ في خادمك باستخدام علامة تبويب Files في GPanel أو عبر SFTP.
4. افتح server.cfg وأضف سطر ensure للمورد:

# Add your custom resources
ensure my-new-resource

5. أعد تشغيل الخادم من GPanel أو TXAdmin لتحميل المورد.

ملفات بيان الموارد

يجب أن يحتوي كل مورد صالح على ملف بيان. تستخدم الموارد الحديثة fxmanifest.lua، بينما تستخدم الأقدم __resource.lua. إذا كان مجلد المورد الذي تم تنزيله لا يحتوي على أي من هذين الملفين، فلن يتم تحميل المورد. بعض التنزيلات تضع مجلد المورد الفعلي داخل مجلد خارجي — تأكد من أن المجلد الذي تضعه في resources/ هو الذي يحتوي على ملف البيان.

ترتيب تحميل الموارد

يتم تحميل الموارد بالترتيب الذي تظهر به في server.cfg. إذا كان مورد يعتمد على مورد آخر (مثلاً، سكريبت وظائف يعتمد على إطار عمل مثل ESX أو QBCore)، تأكد من إدراج التبعية قبل المورد الذي يحتاجها:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

تنظيم الموارد باستخدام مجلدات الفئات

يمكنك تنظيم الموارد في مجلدات فرعية داخل مجلد resources/. استخدم تنسيق الأقواس في server.cfg لتفعيل مجلد فئة كامل:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

يؤدي هذا إلى تحميل كل مورد داخل المجلد الفرعي المحدد. إنها طريقة مريحة لتجميع السكريبتات المرتبطة دون الحاجة إلى إدراج كل واحد منها على حدة.

التحميل الفوري للموارد عبر TXAdmin

لا تحتاج دائمًا إلى إعادة تشغيل كاملة للخادم لتحميل مورد جديد. يمكن لـ TXAdmin بدء وإيقاف وإعادة تشغيل الموارد الفردية من صفحة Resources. بعد رفع مورد جديد وإضافة سطر ensure الخاص به، يمكنك تشغيل الأمر التالي في وحدة تحكم TXAdmin المباشرة:

refresh
ensure my-new-resource

يخبر الأمر refresh الخادم بإعادة فحص مجلد resources/ بحثًا عن إدخالات جديدة.

إعداد قاعدة البيانات (MySQL / MariaDB)

تتطلب العديد من أطر عمل وموارد FiveM (مثل ESX أو QBCore أو vRP) قاعدة بيانات MySQL أو MariaDB. توفر Legion Hosting بيانات اعتماد قاعدة البيانات مع خادمك.

العثور على بيانات اعتماد قاعدة البيانات

1. في GPanel، انتقل إلى علامة تبويب Databases.
2. إذا لم تكن هناك قاعدة بيانات بعد، انقر على New Database لإنشاء واحدة.
3. دوّن التفاصيل التالية:
   • مضيف قاعدة البيانات (العنوان والمنفذ)
   • اسم قاعدة البيانات
   • اسم المستخدم
   • كلمة المرور (انقر على أيقونة العين لإظهارها)

تكوين اتصال قاعدة البيانات

يتم تعيين تفاصيل اتصال قاعدة البيانات في server.cfg باستخدام سلسلة اتصال. يعتمد التنسيق الدقيق على مورد MySQL الذي تستخدمه، لكن التنسيق الأكثر شيوعًا هو:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

استبدل العناصر النائبة ببيانات الاعتماد الفعلية من علامة تبويب Databases. على سبيل المثال:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

اختيار مورد MySQL

أيًا كان مورد MySQL الذي تستخدمه، يجب تفعيله في server.cfg قبل أي موارد تعتمد عليه:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

أساسيات أطر العمل

يوفر إطار العمل أنظمة اللعب الأساسية التي تبني عليها الموارد الأخرى — أشياء مثل هوية اللاعب والمال والمخزون والوظائف والمركبات. أكثر أطر عمل FiveM شيوعًا هما:

يتم تثبيت معظم أطر العمل عبر نظام الوصفات في TXAdmin أثناء الإعداد الأولي. إذا اخترت وصفة مثل "QBCore" أو "ESX" أثناء إعداد TXAdmin، فإن إطار العمل وتبعياته الأساسية مثبتة بالفعل. إذا كنت بحاجة لتثبيت إطار عمل يدويًا، اتبع الوثائق الرسمية:

• وثائق ESX
• وثائق QBCore

الحصول على المساعدة

إذا كنت بحاجة إلى مساعدة في تثبيت الموارد أو تكوين قاعدة البيانات:

1. تحقق من وثائق المورد أو صفحته على GitHub للحصول على تعليمات التثبيت والمشاكل المعروفة.
2. راجع وحدة تحكم GPanel أو سجلات TXAdmin بحثًا عن رسائل الخطأ.
3. افتح تذكرة دعم على https://legionhosting.net/submitticket.php مع رسائل الخطأ واسم المورد الذي تحاول تثبيته.

مقالات ذات صلة

• دليل إعداد خادم FiveM
• استكشاف أخطاء FiveM وإصلاحها
• كيفية رفع الملفات عبر SFTP
• كيفية العثور على عنوان IP الخادم والمنفذ