توافق إصدارات الإضافات وواجهة البرمجة

تُبنى الإضافة لإصدار محدد من واجهة برمجة تطبيقات الخادم. وأي عدم توافق إما يمنع تحميلها أو يسبب أخطاء أثناء التشغيل.

ما الذي يحدد التوافق

• إصدار اللعبة. الإضافة الخاصة بالإصدار 1.20 لن تعمل عادةً على الإصدار 1.21: فالفئات الداخلية تتغير.
• النواة. تتوافق Bukkit/Spigot/Paper من الأسفل إلى الأعلى: فإضافة Bukkit ستعمل على Paper، لكن العكس غير صحيح إذا استُخدمت واجهات برمجة تطبيقات خاصة بـ Paper.
• الاعتماديات. Vault وPlaceholderAPI وProtocolLib — يجب أن تتوافق إصداراتها أيضًا.

api-version

يحدد ملف plugin.yml الخاص بالإضافة ما يلي:

api-version: 1.21

إذا كان السطر مفقودًا بالكامل، يعامل الخادم الإضافة كقديمة ويفعّل وضع التوافق — فتظهر رسالة تحذير في السجل. وهذا ليس خطأً، بل مؤشر على إضافة قديمة.

الأعراض النموذجية

التحقق قبل التثبيت

يصفّي كتالوج «الإضافات والمودات» في لوحة التحكم حسب نواتك وإصدارك وينبهك إلى عدم التوافق قبل التثبيت — كيفية التثبيت. عند الرفع يدويًا، تحقق من صفحة الإضافة: فهي تسرد دائمًا نطاق الإصدارات المدعومة.