يرشدك هذا الدليل خلال إعداد سيرفر FiveM (اللعب الجماعي لـ GTA V) المستضاف لدى Legion Hosting — بدءاً من الحصول على مفتاح ترخيص CFX وتهيئة TXAdmin، وصولاً إلى تعديل server.cfg وتوصيل اللاعبين.
قبل أن تبدأ: تأكد من أن لديك بيانات تسجيل الدخول إلى GPanel من بريد الترحيب الإلكتروني وأن سيرفر FiveM الخاص بك قد تم إنشاؤه في حسابك. إذا لم تقم بتشغيل سيرفر من قبل، اقرأ دليل بدء تشغيل السيرفر أولاً.
المتطلبات الأساسية
- سيرفر FiveM من Legion Hosting (نشط في حسابك)
- حساب في منتدى Cfx.re (مجاني — مطلوب لإنشاء مفتاح الترخيص الخاص بك)
- الوصول إلى GPanel
- عميل FiveM مثبت على جهاز الكمبيوتر الخاص بك (fivem.net)
الخطوة 1: الحصول على مفتاح ترخيص CFX
يتطلب كل سيرفر FiveM مفتاح ترخيص فريد من Cfx.re (مطورو FiveM). هذا المفتاح مجاني ومرتبط بحسابك في Cfx.re.
- اذهب إلى https://keymaster.fivem.net/ وسجل الدخول بحساب منتدى Cfx.re الخاص بك.
- انقر على New Server (أو Register a new server).
- املأ التفاصيل:
- Label: اسم مألوف لسيرفرك (مثلاً "My Legion FiveM Server")
- Server IP Address: أدخل عنوان IP الخاص بسيرفرك من GPanel (انظر كيفية العثور على عنوان IP والمنفذ الخاص بسيرفرك)
- Server Type: اختر النوع المناسب (عادةً "Other / Apache / nginx")
- انقر على Generate.
- انسخ مفتاح الترخيص المُنشأ — ستحتاجه في الخطوات التالية.
حافظ على سرية مفتاح الترخيص. لا تشاركه علنياً. إذا تم اختراق مفتاحك، يمكنك إلغاؤه من صفحة Keymaster وإنشاء مفتاح جديد.
الخطوة 2: التشغيل الأول للسيرفر وإعداد TXAdmin
تتضمن سيرفرات FiveM المستضافة لدى Legion Hosting TXAdmin — لوحة إدارة عبر الويب تعمل بجانب سيرفر FiveM الخاص بك. عند التشغيل الأول، سيرشدك TXAdmin خلال الإعداد الأولي.
تشغيل السيرفر
- سجل الدخول إلى GPanel واختر سيرفر FiveM الخاص بك.
- اذهب إلى تبويب Startup وحدد موقع متغير FIVEM_LICENSE (أو متغير بتسمية مشابهة). الصق مفتاح ترخيص CFX هنا واحفظ.
- اذهب إلى تبويب Console وانقر على Start.
- راقب مخرجات وحدة التحكم. عند التشغيل الأول، سيقوم السيرفر بتنزيل ملفات FiveM المطلوبة — قد يستغرق ذلك بضع دقائق.
- بمجرد أن يصبح TXAdmin جاهزاً، سترى رسالة في وحدة التحكم تحتوي على رابط TXAdmin ورمز PIN.
العثور على رابط TXAdmin: يعمل TXAdmin على منفذ مختلف عن منفذ سيرفر اللعبة. تحقق من مخرجات وحدة التحكم أو تبويب Network في GPanel للعثور على منفذ TXAdmin. صيغة الرابط هي
http://YOUR_SERVER_IP:TXADMIN_PORT.
إكمال إعداد TXAdmin
- افتح رابط TXAdmin في متصفحك.
- أدخل رمز PIN المعروض في مخرجات وحدة تحكم GPanel.
- أنشئ حساب مسؤول TXAdmin الخاص بك (اسم المستخدم وكلمة المرور).
- سيرشدك TXAdmin خلال معالج الإعداد:
- Server Name: اختر الاسم المعروض في متصفح سيرفرات FiveM.
- Deployment Type: اختر قالباً (مثلاً "Popular Recipes" لقاعدة مُعدة مسبقاً، أو "Remote URL / Template" إذا كان لديك إعداد مخصص).
- Server Data Folder: اتركه على الإعداد الافتراضي ما لم يكن لديك سبب محدد لتغييره.
- CFX Key: إذا طُلب منك مرة أخرى، الصق مفتاح الترخيص الخاص بك.
- أكمل المعالج ودع TXAdmin ينتهي من نشر ملفات السيرفر. قد يستغرق ذلك بضع دقائق.
احفظ بيانات اعتماد TXAdmin الخاصة بك. إذا فقدت الوصول إلى حساب مسؤول TXAdmin، ستحتاج إلى حذف ملف تعريف TXAdmin وإعادة تشغيل الإعداد. دوّن اسم المستخدم وكلمة المرور.
الخطوة 3: تهيئة server.cfg
ملف server.cfg هو ملف التهيئة الرئيسي لسيرفر FiveM الخاص بك. يقوم TXAdmin بإنشاء ملف أساسي أثناء الإعداد، لكنك ستحتاج إلى مراجعته وتخصيصه.
الوصول إلى server.cfg
- في GPanel، انقر على تبويب Files.
- انتقل إلى مجلد بيانات السيرفر (عادةً المجلد الجذر أو مجلد تم إنشاؤه بواسطة قالب TXAdmin).
- انقر على
server.cfgلفتحه في المحرر المدمج.
الإعدادات الأساسية
| الإعداد | الوصف | مثال |
|---|---|---|
sv_hostname |
اسم السيرفر المعروض في متصفح سيرفرات FiveM | "My Legion FiveM Server" |
sv_licenseKey |
مفتاح ترخيص CFX من Keymaster | "cfxk_xxxxxxxxxxxxxxxxxxxx" |
sv_maxclients |
الحد الأقصى للاعبين المسموح بهم على السيرفر | 48 |
endpoint_add_tcp |
عنوان ومنفذ الاستماع TCP | "0.0.0.0:YOUR_PORT" |
endpoint_add_udp |
عنوان ومنفذ الاستماع UDP | "0.0.0.0:YOUR_PORT" |
sv_endpointprivacy |
إخفاء عناوين IP الخاصة باللاعبين في قائمة السيرفرات | true |
sets sv_projectName |
اسم المشروع المختصر المعروض في تفاصيل متصفح السيرفرات | "My RP Server" |
sets sv_projectDesc |
وصف مختصر معروض في تفاصيل متصفح السيرفرات | "A custom roleplay server" |
مثال بسيط لملف server.cfg:
# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"
# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"
# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"
# Player Limit
sv_maxclients 48
# Privacy
sv_endpointprivacy true
# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat
يجب أن يتطابق المنفذ مع GPanel. يجب أن يتطابق المنفذ في
endpoint_add_tcp و endpoint_add_udp مع منفذ اللعبة المعين لسيرفرك في GPanel. تحقق من تبويب Network في GPanel لمعرفة المنفذ المحدد لك.
الخطوة 4: الاتصال بسيرفر FiveM الخاص بك
بمجرد تهيئة السيرفر وتشغيله، يمكن للاعبين الاتصال عبر متصفح سيرفرات FiveM أو الاتصال المباشر.
الاتصال المباشر
- افتح عميل FiveM.
- اضغط F8 لفتح وحدة تحكم FiveM، أو انقر على زر Direct Connect في الشاشة الرئيسية.
- أدخل عنوان IP ومنفذ اللعبة الخاص بسيرفرك بالصيغة
IP:PORT. - انقر على Connect.
العثور على عنوان IP والمنفذ: تحقق من تبويب Network في GPanel أو انظر كيفية العثور على عنوان IP والمنفذ الخاص بسيرفرك.
متصفح السيرفرات
- افتح عميل FiveM وانقر على Play.
- في متصفح السيرفرات، ابحث عن اسم سيرفرك (قيمة
sv_hostnameمن server.cfg). - انقر على سيرفرك ثم انقر على Connect.
السيرفر لا يظهر في المتصفح؟ قد تستغرق السيرفرات الجديدة من 5 إلى 15 دقيقة للظهور في قائمة سيرفرات FiveM بعد التشغيل. استخدم الاتصال المباشر في هذه الأثناء. تحقق أيضاً من أن
sv_licenseKey صالح وأن المنافذ في server.cfg تتطابق مع تهيئة الشبكة في GPanel.
إدارة سيرفرك باستخدام TXAdmin
بعد الإعداد الأولي، يوفر TXAdmin لوحة تحكم عبر الويب لإدارة السيرفر اليومية. يمكنك الوصول إليها على http://YOUR_SERVER_IP:TXADMIN_PORT.
| الميزة | الوصف |
|---|---|
| Dashboard | عرض حالة السيرفر وعدد اللاعبين ومقاييس الأداء بنظرة سريعة. |
| Players | عرض اللاعبين المتصلين، طرد أو حظر اللاعبين، عرض سجل اللاعبين. |
| Live Console | تنفيذ أوامر السيرفر في الوقت الفعلي، مثل وحدة التحكم داخل اللعبة. |
| Resources | تشغيل وإيقاف وإعادة تشغيل الموارد الفردية دون إعادة تشغيل السيرفر بالكامل. |
| Server Log | عرض سجلات الإجراءات لمراجعة إجراءات اللاعبين والمسؤولين. |
| CFG Editor | تعديل server.cfg مباشرة من TXAdmin دون الحاجة لمدير ملفات GPanel. |
| Scheduled Restarts | تهيئة إعادة تشغيل تلقائية على فترات محددة للحفاظ على أداء السيرفر. |
الحصول على المساعدة
إذا اتبعت هذا الدليل ولا تزال تواجه مشاكل:
- انسخ أي رسائل خطأ من وحدة تحكم GPanel أو سجل TXAdmin.
- دوّن الخطوة التي توقفت عندها وما جربته بالفعل.
- افتح تذكرة دعم على https://legionhosting.net/submitticket.php مع هذه المعلومات. سيساعدك فريقنا في أسرع وقت ممكن.
