إضافة Minecraft DecentHolograms

🔌 حول Decent Holograms

Decent Holograms هو إضافة Minecraft توفر هولوغرامات عائمة قابلة للتخصيص (نص متعدد الأسطر وعروض أيقونات) لخوادم Spigot/Bukkit. يركز على العرض المرن وتكامل المطورين، مع توفير public API ونقاط تكامل لإضافات أخرى.

🎯 الهدف

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

⚙️ المميزات

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

🧩 لمن هذا؟

• مالكو الخوادم والمديرون الذين يحتاجون إلى لافتات داخل العالم أو لوحات معلومات أو نصوص زخرفية.
• مطورو الإضافات الذين يريدون دمج الهولوغرامات عبر API.
• خوادم Survival وSMP وminigame التي تستخدم placeholders للعروض الديناميكية.

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

• عرض لوحة صدارة ديناميكية باستخدام placeholders لإظهار أفضل اللاعبين.
• وضع لافتات معلوماتية عند spawn يتم تحديثها تلقائيًا.
• استخدام API لإنشاء هولوغرامات من إضافات أخرى أو سكربتات مخصصة.

⚙️ التثبيت

📥 الإعداد

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

📦 الاعتماديات

• لا توجد اعتماديات مطلوبة. يتم دعم PlaceholderAPI للـ placeholders الديناميكية (اختياري).

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

• يتم الحفاظ على الشيفرة المصدرية والإصدارات في المستودع العام للمشروع.
• مرخصة تحت GPL-3.0 كما هو منشور في المستودع.
• يوفر المشروع API للمطورين وتعليمات لبناء الإضافة من المصدر.
• يتم اختبار الإضافة عبر عدة إصدارات من Minecraft (راجع صفحة التوزيع الرسمية لمعرفة الإصدارات المختبرة بدقة).

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

إذا كنت تحتاج إلى نص داخل العالم قابل للتخصيص والبرمجة، أو عروض أيقونات صغيرة مع دعم placeholders وAPI للتكامل، فإن Decent Holograms تقدم حلاً مُدارًا وخفيف الاعتماديات لخوادم Spigot/Bukkit.