إضافة Minecraft eco

🔌 حول eco

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

🎯 الهدف

eco موجودة لتجميع الأنظمة الشائعة التي يحتاجها المطورون في الإضافات الحديثة: تحليل الأوامر، وصيغ الألوان والرسائل، وصيغ الإعدادات، والوصول إلى البيانات الدائمة، ومكونات الواجهات الرسومية، والتعامل مع العناصر، والتكامل مع أنظمة أخرى على جانب الخادم. وهي موجهة لمطوري الإضافات الذين يريدون بناء الميزات بسرعة فوق إطار عمل مشترك تتم صيانته باستمرار.

⚙️ المميزات

• واجهة أوامر حديثة مع التحليل
• تحليل ألوان أصلي مع دعم hex / RGB / MiniMessage
• نظام إعدادات يدعم YAML وJSON وTOML
• واجهة تخزين بيانات دائمة مع واجهات خلفية YAML وMySQL وMongoDB
• واجهة GUI ومكونات جاهزة
• عناصر مخصصة ومعالجة فائقة السرعة لـ ItemStack
• عرض العناصر عبر الحزم ودورة أحداث خفيفة للحزم
• واجهة برمجة تطبيقات AI للكيانات مع خرائط NMS شبه 1:1
• Placeholder API وعمليات تكامل أصلية (أكثر من 30 تكاملًا مدرجة من المشروع)
• تجريد السعر/الاقتصاد (نظام أسعار يدعم إضافات الاقتصاد وXP والعناصر)
• دعم native bStats وفحص تحديثات الإضافة
• نظام امتدادات (إضافات للإضافات) وأدوات dependency injection للمطورين

🧩 لمن هو مناسب

• مطورو الإضافات الذين يبنون إضافات متوافقة مع Spigot/Paper ويريدون إطار عمل قابلًا لإعادة الاستخدام
• مالكو الخوادم الذين يشغلون إضافات تعتمد على eco (يجب تثبيت eco كاعتماد)
• المشاريع التي تحتاج إلى عناصر مخصصة أو واجهات GUI أو أدوات موحدة للتخزين والأوامر

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

• يطبق مطور حزمة عناصر مخصصة تستخدم واجهات eco للبحث عن العناصر والـ GUI.
• تستخدم إضافة واجهة التخزين في eco لدعم YAML المحلي وواجهة MongoDB بعيدة دون تكرار الكود.
• تتشارك عدة إضافات صغيرة eco للتعامل مع الأوامر وتحليل الألوان بشكل متسق.

⚙️ التثبيت

📥 الإعداد

• ثبّت eco كإضافة على أي خادم يحتاجها عبر وضع ملف JAR في مجلد plugins/ الخاص بالخادم ثم إعادة تشغيل الخادم.
• إذا كانت إضافة أخرى تعتمد على eco، فقم بتعريفها في plugin.yml الخاص بتلك الإضافة ضمن depend: مع - eco لكي يحمّل الخادم eco أولًا.

📦 الاعتماد (لمطوري الإضافات)

• ينشر المشروع مستودع Maven وإحداثيات Gradle للاستخدام compile-only. ويوفر المشروع artifact منشورًا (مثلًا مع group com.willfp وعلامات الإصدار) بحيث يضيف المطورون eco كاعتماد provided أثناء البناء.

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

• برمجيات الخادم المدعومة: يشير المشروع الرسمي إلى دعم Spigot وPaper وPurpur وFolia.
• إصدارات Minecraft المدعومة: يذكر المشروع الدعم ابتداءً من 1.21.4، وتستهدف الإصدارات اللاحقة سلسلة 1.21.x الحديثة.
• واجهات التخزين الخلفية: يوفر الإطار محولات YAML وMySQL وMongoDB.
• الترخيص: تم إصدار eco تحت رخصة MIT.

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

إذا كنت تطوّر عدة ميزات أو إضافات تشترك في احتياجات متشابهة (الأوامر، صيغ الإعدادات، مكونات GUI، التخزين، العناصر المخصصة)، فإن eco تقلل العمل المكرر عبر توفير إطار عمل مُدار وعمليات تكامل يمكن للإضافات الأخرى الاعتماد عليها.