إضافة Minecraft nightcore

🔌 حول NightCore

NightCore هي مكتبة خفيفة الوزن لتطوير إضافات خوادم Minecraft. وهي توفر أدوات مساعدة قابلة لإعادة الاستخدام، وأدوات للبيانات، وجسور تكامل بحيث لا تحتاج الإضافات الأخرى إلى إعادة تنفيذ الوظائف الشائعة. يُوزَّع المشروع بموجب GPL-3.0 ويُصان إلى جانب مجموعة من الإضافات التي تعتمد عليه.

🎯 الهدف

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

⚙️ المزايا

• جسر للخادم يوفر دعماً موحداً لـ Spigot وPaper وFolia.
• جسر للاقتصاد للتكامل مع عدة إضافات للعملة/الاقتصاد.
• جسر للعناصر ودعم مزود عناصر مخصص لأنظمة العناصر التابعة لجهات خارجية.
• جسر للصلاحيات للتكامل مع إضافات صلاحيات مختلفة.
• أدوات للأوامر: تحليل الوسائط، أنواع وسائط مخصصة، ومساعدات الإكمال عبر التبويب.
• أدوات إعدادات YAML مع قراءة/كتابة بأسلوب المخطط والحفاظ على التعليقات.
• أدوات ترجمة للملفات اللغوية المنظمة والرسائل ذات المعاملات.
• أدوات قواعد بيانات مع دعم SQLite وMySQL ومساعدات لمزامنة بيانات الجداول.
• أدوات مساعدة لـ Inventory GUI وشاشات الحوار.
• أدوات مساعدة وواجهات لفئات Player والكيانات والمواقع وItemStack.
• مساعدات PersistentDataContainer وأدوات reflection للمهام المتقدمة.
• متتبع للبلوكات التي يضعها اللاعب ويخزن بيانات الوضع في تخزين chunk الأصلي.

🧩 لمن هذا؟

• مطورو الإضافات الذين يبنون أو يحافظون على إضافات Spigot/Paper/Folia، وخاصة عائلة إضافات NightExpress.
• مسؤولو الخوادم الذين يشغّلون عدة إضافات ويفضّلون طبقة أدوات مشتركة.

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

• تستخدم إضافة ما جسر الاقتصاد في NightCore للتفاعل مع أي إضافة اقتصاد موجودة على الخادم.
• يستخدم مطور مخططات الإعدادات والترجمة في NightCore لتجنب كتابة كود معالجة ملفات متكرر.
• يثبت خادم إضافة NightExpress تتطلب NightCore كمكتبة مشتركة.

⚙️ التثبيت

📥 الإعداد

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

📦 الاعتمادات

• لا توجد اعتمادات خارجية مطلوبة موثقة على أنها إلزامية؛ يوفر NightCore جسوراً للتكامل مع الأنظمة الشائعة (الاقتصاد، الصلاحيات، العناصر المخصصة) عندما تكون هذه الأنظمة موجودة.

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

• المنصات المدعومة المؤكدة: Spigot وPaper وPurpur وFolia.
• تتضمن إدخالات التوافق الموثقة نطاقات إصدارات Minecraft الحديثة (تظهر أمثلة على صفحات التوزيع الرسمية). ينبغي لمالكي الخوادم استخدام نسخة NightCore المطابقة لإصدار Minecraft في خوادمهم.
• مرخّص بموجب GPL-3.0.

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

إذا كنت تحافظ على إضافات أو تطورها وتحتاج إلى أدوات خادم شائعة (config، الترجمة، مساعدات قاعدة البيانات، تحليل الأوامر، التكامل مع الاقتصاد/العناصر/الصلاحيات)، فإن NightCore يقلل العمل المكرر من خلال توفير طبقة مكتبة مشتركة ومُصانة.