إضافة Minecraft PluginConstructorAPI

🔌 حول PluginConstructorAPI

PluginConstructorAPI هو إضافة Minecraft متوافقة مع Bukkit توفّر مكتبة مشتركة وأدوات مساعدة وقت التشغيل تُستخدم من عدة إضافات للمؤلف Zombie_Striker_Dev. وهي توحّد الشيفرة الشائعة حتى لا تتضمن الإضافات التابعة أصنافًا مكررة، كما تتيح API يمكن لمطوري الإضافات الآخرين استدعاؤها أو توسيعها.

🎯 الغرض

توجد هذه الإضافة كمكتبة موجهة للمطورين من أجل:

• تقليل تكرار الذاكرة والتخزين عبر وضع الأدوات الشائعة في JAR واحد للإضافة.
• توفير ميزات وقت تشغيل قابلة لإعادة الاستخدام وأدوات مساعدة تُستخدم عبر مجموعة إضافات المؤلف.
• السماح للإضافات التابعة بجلب المكتبة المشتركة أو تحديثها عند الحاجة إليها.

⚙️ الميزات

• API/مكتبة مشتركة لعدة إضافات من المؤلف نفسه.
• أداة فحص وتنزيل تحديثات تلقائية (قابلة للضبط).
• توفّر أدوات مساعدة وأصنافًا شائعة تستخدمها الإضافات التابعة لتجنب NoClassDefFoundError عند غياب المكتبة.

🧩 لمن هذه الإضافة

• مطورو الإضافات الذين يعتمدون على مجموعة إضافات Zombie_Striker_Dev أو يساهمون فيها.
• مشرفو الخوادم الذين يشغّلون إضافة واحدة أو أكثر تعلن PluginConstructorAPI كاعتماد.
• الخوادم التي تريد توحيد الشيفرة المشتركة المستخدمة بواسطة عدة إضافات فرعية لتقليل التكرار في كل إضافة.

🏗️ أمثلة على الاستخدام

• يثبّت خادم عدة إضافات فرعية من المؤلف نفسه؛ وتثبيت PluginConstructorAPI مرة واحدة يمنع النسخ المتكررة من أصناف المساعدة نفسها.
• تتحقق إضافة تابعة من الأصناف التي توفرها PluginConstructorAPI وتفشل بشكل سلس أو تُحمّل ميزات موسعة عندما تكون API متاحة.

⚙️ التثبيت

📥 الإعداد

• نزّل JAR الرسمي لـ PluginConstructorAPI من صفحة التنزيل الخاصة بالمشروع.
• ضع ملف JAR في دليل plugins/ الخاص بخادمك.
• أعد تشغيل الخادم وتحقق من وحدة تحكم الخادم للتأكد من أن الإضافة تم تحميلها.

📦 سلوك التحديث التلقائي

• يتضمن PluginConstructorAPI محدثًا تلقائيًا يتحقق من التحديثات وينزّلها.
• المحدث قابل للضبط؛ وتشير ملاحظات المشروع إلى أنه يمكنك تعطيل التنزيلات التلقائية عبر تعديل الملف plugins/AUpdater/global.yml وتعيين update: false.

🧠 ملاحظات تقنية

• تصنيف المنصة المؤكد: Bukkit (مدرج المشروع كإضافة Bukkit في صفحات المشروع الرسمية).
• تسرد صفحة المشروع عدة إصدارات من Minecraft؛ ومن الإدخالات المؤكدة الشائعة: 1.13، 1.12، 1.11، 1.10، 1.9، 1.8، 1.7.9.
• يوزَّع المشروع بموجب رخصة GNU GPL v2.

🤝 متى تكون هذه الإضافة مفيدة

إذا كنت تشغّل إضافة واحدة أو أكثر تعتمد على الشيفرة المشتركة نفسها من Zombie_Striker_Dev، فإن PluginConstructorAPI يوحّد تلك الأدوات ويقلل التكرار عبر ملفات JAR الخاصة بالإضافات، مع توفير محدث تلقائي للمكتبة يمكن إيقافه.