يغطي هذا الدليل إعداد الإدارة، والموارد من جانب الخادم، والخرائط المخصصة، وإدارة المركبات، واستكشاف الأخطاء وإصلاحها لخادم BeamMP الخاص بك على Legion Hosting. للإعداد الأولي للخادم، ومفاتيح المصادقة، والتهيئة الأساسية، راجع دليل إعداد خادم BeamMP.

---

إعداد الإدارة

لا يملك BeamMP نظام تسجيل دخول إداري تقليدي أو نظام كلمات مرور. بدلاً من ذلك، يتم تنفيذ أوامر الإدارة عبر وحدة تحكم الخادم أو عبر إضافات Lua من جانب الخادم التي تتحقق من معرّفات اللاعبين.

أوامر وحدة التحكم

توفر وحدة تحكم الخادم في GPanel وصولاً مباشراً إلى أوامر الخادم المدمجة. اكتب الأوامر مباشرة في حقل إدخال وحدة التحكم:

---

هيكل مجلد الموارد

يستخدم BeamMP مجلد Resources لتنظيم محتوى الخادم. يحتوي هذا المجلد على مجلدين فرعيين بأغراض مختلفة:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

موارد العميل

الملفات الموضوعة في Resources/Client/ يتم تنزيلها تلقائياً من قبل اللاعبين عند الاتصال. يُستخدم هذا لـ:

• الخرائط المخصصة — ملفات .zip لتعديلات الخرائط التي يحتاجها اللاعبون لتحميل خريطة الخادم.
• المركبات المخصصة — ملفات .zip لتعديلات المركبات التي تضيف سيارات جديدة أو تعدّل الموجودة.
• تعديلات العميل الأخرى — أي تعديل لـ BeamNG.drive يجب أن يكون موجوداً على جهاز العميل.

موارد الخادم (إضافات Lua)

يحتوي مجلد Resources/Server/ على إضافات Lua من جانب الخادم. تعمل هذه على الخادم فقط ولا يتم إرسالها للاعبين. كل إضافة تكون في مجلد فرعي خاص بها يحتوي على ملف main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

يمكن لإضافات جانب الخادم:

• الاستجابة لأحداث اللاعبين (الانضمام، المغادرة، رسائل الدردشة، إنشاء المركبات).
• تنفيذ أوامر مخصصة عبر الدردشة (مثل /tp، /give).
• إدارة صلاحيات وحدود المركبات.
• إضافة أنظمة اقتصادية، ونقل فوري، وميزات لعب مخصصة أخرى.
• تسجيل نشاط اللاعبين وتطبيق القواعد.

---

إضافة خرائط مخصصة

لتشغيل خريطة مخصصة (غير افتراضية) على خادم BeamMP الخاص بك:

1. قم بتنزيل تعديل الخريطة كملف .zip من مصدر تعديلات BeamNG.drive (مثل مستودع تعديلات BeamNG.drive).
2. أوقف خادمك في GPanel.
3. ارفع ملف .zip إلى Resources/Client/ عبر تبويب Files أو SFTP. لا تقم بفك ضغط الملف.
4. حدّث متغير التشغيل MAP (أو Map في ServerConfig.toml) إلى مسار الخريطة الصحيح للخريطة المخصصة. عادةً ما يكون هذا المسار بتنسيق /levels/map_name/info.json — تحقق من وثائق التعديل للمسار الدقيق.
5. شغّل الخادم.

---

إدارة المركبات

تتم إدارة المركبات على خوادم BeamMP من خلال إعداد MaxCars واختيارياً من خلال إضافات Lua من جانب الخادم.

إعداد MaxCars

يتحكم إعداد MaxCars في ServerConfig.toml (أو متغير التشغيل MAX_CARS) في عدد المركبات التي يمكن لكل لاعب إنشاؤها في وقت واحد:

• 1 — يمكن لكل لاعب امتلاك مركبة واحدة في كل مرة (موصى به للخوادم الكبيرة).
• 2–3 — يسمح للاعبين بامتلاك مركبتين، مفيد للخوادم الصغيرة أو معارض السيارات.
• القيم الأعلى تزيد من حمل الخادم بشكل متناسب.

تعديلات المركبات المخصصة

لإضافة مركبات مخصصة إلى خادمك:

1. قم بتنزيل تعديل المركبة كملف .zip.
2. ضعه في Resources/Client/.
3. أعد تشغيل الخادم. سيقوم اللاعبون بتنزيل تعديل المركبة تلقائياً عند الاتصال.

تقييد المركبات عبر الإضافات

للتحكم الأكثر دقة (مثل حظر مركبات معينة، تقييد أنواع المركبات)، ستحتاج إلى إضافة Lua من جانب الخادم. يمكن لهذه الإضافات اعتراض أحداث إنشاء المركبات والسماح بها أو رفضها بناءً على قواعد مخصصة. تحقق من منتديات BeamMP للعثور على إضافات إدارة المركبات.

---

تثبيت وإدارة الإضافات

تعمل إضافات Lua من جانب الخادم على توسيع وظائف خادمك. إليك كيفية تثبيتها وإدارتها:

تثبيت إضافة

1. قم بتنزيل ملفات الإضافة (عادةً مجلد يحتوي على main.lua وربما ملفات أخرى).
2. أوقف خادمك.
3. ارفع مجلد الإضافة إلى Resources/Server/ عبر تبويب Files أو SFTP.
4. تأكد من صحة هيكل المجلد: Resources/Server/PluginName/main.lua.
5. شغّل الخادم. ستظهر رسائل في وحدة التحكم أثناء تحميل الإضافات.

إزالة إضافة

1. أوقف خادمك.
2. احذف مجلد الإضافة من Resources/Server/.
3. شغّل الخادم.

---

استكشاف الأخطاء وإصلاحها

أخطاء مفتاح المصادقة

• تحقق من أن المفتاح تم لصقه بشكل صحيح في متغير التشغيل AUTH_KEY — بدون مسافات أو أسطر إضافية.
• تأكد من أن المفتاح لم يتم إلغاؤه أو انتهاء صلاحيته على BeamMP Keymaster.
• يمكن استخدام كل مفتاح على خادم واحد فقط في كل مرة. إذا كنت تستخدم نفس المفتاح في مكان آخر، فسيفشل.
• ستعرض وحدة التحكم أخطاء المصادقة عند بدء التشغيل إذا كان المفتاح غير صالح.

اللاعبون لا يستطيعون الاتصال

• تأكد من أن الخادم قد بدأ بالكامل ويظهر كمتصل في GPanel.
• تحقق من أن اللاعب يستخدم مشغّل BeamMP، وليس مشغّل BeamNG.drive العادي.
• إذا كان الخادم مضبوطاً على Private = true، يجب على اللاعبين استخدام الاتصال المباشر مع IP والمنفذ الصحيحين. راجع كيفية العثور على IP الخادم والمنفذ.
• تأكد من أن إصدار مشغّل BeamMP الخاص باللاعب متوافق مع إصدار الخادم. المشغّلات القديمة قد تفشل في الاتصال.
• إذا كان الخادم ممتلئاً (تم الوصول إلى MaxPlayers)، لا يمكن للاعبين الإضافيين الانضمام حتى يغادر أحدهم.

مشاكل مزامنة التعديلات

• إذا توقف اللاعبون عند التنزيل أو تلقوا أخطاء بشأن تعديلات مفقودة، تحقق من أن ملفات .zip الخاصة بالتعديلات في Resources/Client/ ليست تالفة.
• أعد تنزيل ورفع ملف التعديل إذا كان ملف .zip تالفاً.
• ملفات التعديلات الكبيرة جداً قد تسبب انتهاء المهلة للاعبين ذوي الاتصالات البطيئة. فكّر في إزالة التعديلات الكبيرة غير الضرورية.
• تأكد من أن ملفات .zip الخاصة بالتعديلات ليست متداخلة (أي ملف .zip داخل مجلد داخل ملف .zip آخر).

مشاكل الأداء مع عدد كبير من اللاعبين/المركبات

• قلّل MaxCars إلى 1 لكل لاعب.
• قلّل MaxPlayers إذا كان الخادم يعاني من تأخير مستمر.
• انتقل إلى خريطة أبسط (Grid Map أو Industrial) لأداء أفضل مع عدد كبير من اللاعبين.
• أزل تعديلات العميل غير الضرورية من Resources/Client/ لتقليل أوقات التنزيل واستخدام الذاكرة.
• تحقق من رسوم استخدام الموارد في GPanel — إذا كان المعالج أو الذاكرة عند الحد الأقصى باستمرار، فكّر في ترقية خطة خادمك. افتح تذكرة دعم لمناقشة الخيارات.

الخادم لا يظهر في متصفح الخوادم

• تأكد من أن Private مضبوط على false في تهيئتك.
• تحقق من أن مفتاح المصادقة صالح وغير مستخدم من خادم آخر.
• انتظر 1–2 دقيقة بعد بدء التشغيل حتى يتم تسجيل الخادم لدى خوادم BeamMP الخلفية.
• تحقق من وحدة التحكم بحثاً عن أي أخطاء متعلقة بالاتصال بالخادم الرئيسي.

---

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

• دليل إعداد خادم BeamMP — الإعداد الأولي، ومفتاح المصادقة، والتهيئة، وتعليمات الاتصال
• كيفية العثور على IP الخادم والمنفذ
• كيفية رفع الملفات عبر SFTP
• دليل بدء تشغيل الخادم — دليل عام لبدء تشغيل أي خادم ألعاب على Legion Hosting

---

هل تحتاج مزيداً من المساعدة؟

إذا كنت تواجه مشاكل غير مذكورة في هذا الدليل، فإن فريق الدعم لدينا متاح للمساعدة. افتح تذكرة على legionhosting.net/submitticket.php مع تفاصيل خادمك، ووصف للمشكلة، وأي رسائل خطأ ذات صلة من وحدة تحكم GPanel.