لماذا لا يتم تحميل إضافة CounterStrikeSharp الخاصة بك

تأكد من أن CounterStrikeSharp يعمل

قبل أن تلوم الإضافة، تأكد من أن الإطار نفسه يعمل. اكتب meta list في وحدة تحكم الخادم. يجب أن يظهر CounterStrikeSharp في القائمة. إذا كان غائبًا فالمشكلة في تثبيت Metamod أو CounterStrikeSharp وليست في إضافتك. يغطي دليل إعداد Metamod لدينا هذا الجزء.

meta list

اقرأ الخطأ في وحدة التحكم

عندما تفشل إضافة، تعرض وحدة التحكم أيّ إضافة فشلت ولماذا. ظهور <ERROR> في قائمة الإضافات يعني أن الملف وُجد لكن تعذّر تحميله. انسخ الرسالة كاملة وليس السطر الأول فقط، لأن السبب الحقيقي يكون عادةً بعد عدة أسطر.

[META] Failed to load plugin addons/counterstrikesharp/bin/linuxsteamrt64/counterstrikesharp
Listing 1 plugin:
  [01] <ERROR>

تم تحديث الخادم وتوقف كل شيء

بعد تحديث Counter-Strike 2 غالبًا ما يلزم تحديث CounterStrikeSharp و Metamod أيضًا، لأن ملفات اللعبة التي يرتبطان بها تغيّرت. إذا توقفت جميع الإضافات في اللحظة نفسها فهذا هو السبب. حدّث CounterStrikeSharp و Metamod إلى أحدث إصدار وأعد تشغيل الخادم. يوضح دليل تحديث CounterStrikeSharp لدينا الطريقة الآمنة.

اعرف ما يظنه الخادم أنه مثبّت

نفّذ css_plugins list في وحدة التحكم. يعرض كل إضافة وجدها الإطار مع حالتها. إذا لم تظهر إضافتك إطلاقًا فالملفات في مكان خاطئ أو أن اسم المجلد لا يطابق اسم ملف DLL. وإذا ظهرت مع خطأ فعُد إلى الخطوة الثانية واقرأ الرسالة.

css_plugins list

افحص بنية المجلدات

تحتاج كل إضافة إلى مجلد خاص بها داخل plugins، ويجب أن يكون اسم ملف DLL الرئيسي مطابقًا تمامًا لاسم هذا المجلد. أما الملفات المجاورة له مثل deps.json فيجب أن تبقى مع ملف DLL.

انسخ مجلد الإضافة فقط وليس dependencies

يضع المترجم لدينا شيئين في ملف zip: مجلد الإضافة ومجلد dependencies. انسخ إلى خادمك مجلد الإضافة فقط. يحتوي مجلد dependencies على ملفات يوفّرها CounterStrikeSharp أصلًا، ونسخها قد يسبب تعارضًا في الإصدارات.

إضافات تعتمد أطرًا ثقيلة أو إصدارًا مختلفًا من API

قد تُترجم إضافة كُتبت لإصدار أقدم من CounterStrikeSharp.API ثم تفشل على خادم أحدث، أو العكس. إذا ذكرت وحدة التحكم دالة أو نوعًا مفقودًا فإصدارات API غير متطابقة. يشرح دليل عدم تطابق الإصدارات لدينا أيّ خيار ترجمة تختار. وتذكّر أيضًا أن الأطر الكبيرة مثل ASP.NET غير مدعومة داخل إضافة لخادم لعبة.

ماذا تذكر عند طلب المساعدة

إذا لم تحل المشكلة بعد، فاسأل مؤلف الإضافة أو مجتمع CounterStrikeSharp وأرفق: مخرجات meta list و css_plugins list، والخطأ الكامل من وحدة التحكم، وإصدار CounterStrikeSharp، وكيف ترجمت الإضافة. بهذه المعلومات تُحل معظم المشكلات في رد واحد.