يغطي هذا الدليل المشكلات الشائعة التي قد تواجهها عند تشغيل خادم Garry's Mod المخصص مع Legion Hosting، إلى جانب أسبابها وحلولها.

---

جدول المحتويات

1. نصوص مفقودة / مربعات وردية وسوداء
2. إضافات Workshop لا يتم تنزيلها
3. الخادم لا يظهر في متصفح الخوادم
4. وظائف DarkRP لا تظهر
5. أوامر ULX لا تعمل
6. بينغ عالي / تأخير
7. الخادم يتعطل عند بدء التشغيل
8. اللاعبون عالقون على "جارٍ التنزيل" أو انضمام بطيء

---

1. نصوص مفقودة / مربعات وردية وسوداء

إصلاحات من جانب الخادم

• تركيب Counter-Strike: Source: في GPanel، تحقق مما إذا كانت خطتك تتضمن تركيب محتوى ألعاب إضافي. إذا كان متاحاً، قم بتفعيل تركيب CS:S في إعدادات خادمك.
• إضافة محتوى CSS: أضف حزمة محتوى CS:S مجتمعية من Garry's Mod Workshop إلى مجموعة Workshop الخاصة بخادمك. ابحث عن "Counter-Strike: Source Content" وأضفها.
• رفع يدوي: إذا لم يكن أي من الخيارين أعلاه متاحاً، يمكنك رفع ملفات محتوى CS:S يدوياً عبر SFTP إلى garrysmod/addons/css-content/. راجع دليل الرفع عبر SFTP للحصول على التعليمات.

إصلاح من جانب العميل

يمكن للاعبين الذين يملكون Counter-Strike: Source تركيبها في GMod من خلال الخيارات → محتوى اللعبة. هذا يحل مشكلة النصوص المفقودة من جانبهم دون أي تغييرات على الخادم.

---

2. إضافات Workshop لا يتم تنزيلها

إذا كان خادمك لا يحمّل إضافات Workshop عند بدء التشغيل، تحقق مما يلي:

التحقق	الإصلاح
مفتاح Steam API مفقود أو غير صالح	في GPanel تحت بدء التشغيل، اضبط متغير STEAM_API_KEY على مفتاح صالح من steamcommunity.com/dev/apikey.
المجموعة ليست عامة	يجب أن تكون مجموعة Workshop مضبوطة على عامة. المجموعات غير المدرجة أو الخاصة لن يتم تنزيلها على خادم مخصص.
معرّف المجموعة في المكان الخطأ	يجب أن يكون معامل +host_workshop_collection في سطر أوامر بدء التشغيل في GPanel، وليس في server.cfg.
خطأ 403 / خطأ مصادقة في وحدة التحكم	مفتاح Steam API الخاص بك غير صالح أو تم إلغاؤه. قم بإنشاء مفتاح جديد وحدّثه في GPanel.

---

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

إذا كان خادمك يعمل لكنه لا يظهر في متصفح خوادم Steam:

• تحقق من sv_lan: تأكد من أن sv_lan 0 مضبوط في server.cfg. القيمة 1 تجعل الخادم للشبكة المحلية فقط.
• تحقق من GSLT الخاص بك: تأكد من ضبط رمز تسجيل دخول خادم اللعبة صالح عبر sv_setsteamaccount. الرمز المنتهي أو الملغى سيمنع الإدراج العام. قم بإنشاء رمز جديد من steamcommunity.com/dev/managegameservers.
• انتظر بضع دقائق: قد يستغرق ظهور خادم جديد في قائمة خادم Steam الرئيسية عدة دقائق بعد بدء التشغيل الأول.
• اختبر بالاتصال المباشر: جرب الاتصال عبر IP المباشر أولاً (راجع تعليمات الاتصال) للتأكد من أن الخادم يعمل فعلاً.

---

4. وظائف DarkRP لا تظهر

إذا لم تظهر الوظائف المخصصة في قائمة F4 بعد إعداد DarkRP:

• تحقق من مواقع المجلدات: يجب أن يكون DarkRP نفسه في garrysmod/gamemodes/darkrp/، وليس في addons/. يجب أن يكون DarkRPModification في garrysmod/addons/darkrpmodification/. هذا هو الخطأ الأكثر شيوعاً.
• تحقق من أخطاء Lua: افتح وحدة تحكم الخادم في GPanel وابحث عن أخطاء Lua أثناء بدء التشغيل. خطأ في بناء الجملة في jobs.lua سيمنع تحميل جميع الوظائف المخصصة.
• تحقق من وضع اللعب: تأكد من ضبط sv_gamemode "darkrp" في server.cfg وأن الخادم تمت إعادة تشغيله بالكامل (وليس مجرد تغيير خريطة).
• تحقق من ترميز الملف: إذا قمت بتحرير ملفات Lua على Windows، تأكد من حفظها بتنسيق UTF-8 بدون BOM. بعض محررات النصوص تضيف BOM (علامة ترتيب البايت) التي يمكن أن تعطل تحليل Lua.

خطوات تصحيح سريعة

// Run these in the server console to check gamemode status:
lua_run print(engine.ActiveGamemode())
// Should output: darkrp

lua_run PrintTable(RPExtraTeams)
// Should list all custom jobs if DarkRP loaded correctly

---

5. أوامر ULX لا تعمل

إذا كانت أوامر ULX تُرجع أخطاء أو لا تفعل شيئاً بعد التثبيت:

• هل تم تثبيت كلتا الإضافتين؟ يتطلب ULX كلاً من ULib و ULX. لن يعمل ULX بدون ULib. تحقق من وجود كليهما في garrysmod/addons/ أو في مجموعة Workshop الخاصة بك.
• تحقق من وحدة التحكم بحثاً عن أخطاء: انظر إلى مخرجات وحدة تحكم الخادم في GPanel أثناء بدء التشغيل بحثاً عن أخطاء تذكر ULib أو ULX.
• تحقق من تعيين المستخدم الخاص بك: قم بتشغيل ulx adduser باسم عرض Steam الدقيق الخاص بك، أو استخدم ulx adduserid "STEAM_0:1:12345678" superadmin مع Steam ID الخاص بك لمزيد من الموثوقية.
• تعارضات الإضافات: يمكن لبعض الإضافات أن تتعارض مع ULX. إذا توقفت الأوامر عن العمل بعد إضافة إضافة جديدة، جرب إزالتها وإعادة التشغيل لعزل المشكلة.

---

6. بينغ عالي / تأخير

إذا كان خادمك يعاني من بينغ عالي أو قفزات تأخير:

• إضافات كثيرة جداً: مجموعات Workshop الكبيرة تزيد من استخدام الذاكرة ووقت التحميل. راجع مجموعتك وأزل الإضافات غير المستخدمة فعلياً.
• حمل زائد من الكيانات (DarkRP): خوادم DarkRP التي تحتوي على العديد من الكيانات القابلة للإنشاء (طابعات أموال، مختبرات مخدرات، إلخ) يمكن أن تكون مكثفة على المعالج. اضبط حدود كيانات معقولة في darkrpmodification/lua/darkrp_config/settings.lua.
• قفزات تأخير الحفظ التلقائي: إذا حدثت قفزات التأخير على فترات منتظمة (كل بضع دقائق)، فقد يكون ذلك بسبب الحفظ التلقائي للخادم. هذا سلوك طبيعي لكن يمكن تعديل الفاصل الزمني.
• عدد اللاعبين مقابل الخطة: تأكد من أن عدد اللاعبين لا يتجاوز ما يمكن لموارد خطتك التعامل معه. فكر في تقليل maxplayers في server.cfg إذا كنت قريباً من حدود الموارد.
• تعقيد الخريطة: بعض الخرائط المجتمعية غير محسّنة بشكل جيد. إذا بدأ التأخير بعد تغيير الخرائط، جرب العودة إلى خريطة أبسط لعزل المشكلة.

---

7. الخادم يتعطل عند بدء التشغيل

إذا تعطل خادمك أو فشل في البدء:

• تحقق من سجل وحدة التحكم: في GPanel، راجع مخرجات وحدة التحكم قبل التعطل. عادةً ما تشير الأسطر القليلة الأخيرة إلى السبب.
• إضافة سيئة: قد تكون إضافة تمت إضافتها مؤخراً هي سبب التعطل. أزل آخر إضافة أضفتها وجرب إعادة التشغيل. إذا بدأ الخادم، فالإضافة هي المشكلة.
• ملفات وضع لعب تالفة: إذا كنت تستخدم DarkRP أو وضع لعب آخر من طرف ثالث، جرب إعادة تثبيته من Workshop أو GitHub.
• نفاد الذاكرة: قد يؤدي وجود الكثير من الإضافات إلى تجاوز تخصيص ذاكرة خطتك. تحقق من استخدام الموارد في GPanel وفكر في تقليص قائمة الإضافات.

---

8. اللاعبون عالقون على "جارٍ التنزيل" أو انضمام بطيء

إذا كان اللاعبون عالقين في تنزيل المحتوى لفترة طويلة عند الانضمام:

• إعداد FastDL: بدون FastDL، يقوم العملاء بتنزيل الملفات مباشرة من خادم اللعبة وهو بطيء جداً. راجع قسم FastDL في دليل إعداد الخادم.
• استخدم Workshop للإضافات: الإضافات المقدمة عبر Workshop يتم تنزيلها من خلال CDN الخاص بـ Steam، وهو أسرع من التنزيل المباشر من الخادم. فضّل مجموعات Workshop على رفع الإضافات يدوياً عند الإمكان.
• قلل عدد الإضافات: كل إضافة تضيف إلى وقت تنزيل العميل. أزل الإضافات غير الضرورية لأسلوب لعب خادمك.
• تحقق من استخدام resource.AddFile: إذا كنت تجبر العملاء على تنزيل العديد من الملفات عبر resource.lua، راجع القائمة وأزل الإدخالات للملفات غير المطلوبة فعلياً من جانب العميل.

---

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

• دليل إعداد خادم Garry's Mod — Server.cfg، Workshop، أوضاع اللعب، DarkRP، FastDL
• إعداد الإدارة في Garry's Mod (ULX) — تثبيت ULX/ULib، أوامر الإدارة، مجموعات الصلاحيات
• كيفية رفع الملفات عبر SFTP
• كيفية العثور على IP الخادم والمنفذ

---