إضافة Minecraft SuperVanish

🔌 حول SuperVanish

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

🎯 الهدف

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

⚙️ الميزات

• يخفي اللاعبين الذين أصبحوا vanished بالكامل عن اللاعبين الآخرين (الظهور داخل العالم).
• يخفي اللاعبين vanished في قائمة اللاعبين (tab) مع مظهر قابل للتخصيص للمراقبين.
• يضبط عدد اللاعبين المتصلين/قائمة الخادم المُبلَّغ عنه عند توفر ProtocolLib.
• نموذج صلاحيات متعدد الطبقات لضبط من يمكنه رؤية من بدقة.
• يحافظ على حالة vanish عبر الانضمام وإعادة التشغيل وإعادة التحميل.
• نقاط تكامل اختيارية تتطلب ProtocolLib لميزات متقدمة تعتمد على الحزم.
• توصية اختيارية بتثبيت OpenInv لتحسين سلوك "silent chest".
• VanishAPI عامة للإضافات الأخرى: طرق لإخفاء/إظهار اللاعبين، والاستعلام عن اللاعبين غير المرئيين، والاستماع إلى PlayerHideEvent/PlayerShowEvent.

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

• خوادم Survival وSMP التي تحتاج إلى أدوات إشراف خفية.
• الخوادم التي تريد API vanish لإضافات أخرى خاصة بالإشراف أو الأدوات.
• المديرون الذين يحتاجون إلى قواعد رؤية قابلة للتخصيص والتحكم في tablist.

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

• يدخل أحد المشرفين في وضع غير مرئي للتحقيق في تقرير تخريب دون تنبيه المشتبه بهم.
• تستعلم إضافة عن VanishAPI لاستبعاد اللاعبين vanished من آليات اللعب أو التقارير.
• يخفى مسؤولو الخادم وجودهم أثناء الاختبارات المباشرة لمحاكاة ظروف اللاعبين فقط.

⚙️ التثبيت

📥 الإعداد

• قم بتنزيل ملف JAR الرسمي للإضافة وضعه في دليل plugins/ الخاص بخادمك.
• أعد تشغيل الخادم وتحقق من تحميل SuperVanish عبر سجلات وحدة التحكم.
• إذا كنت تستخدم ProtocolLib للميزات الموسعة، فقم بتثبيت ProtocolLib أيضًا ثم أعد التشغيل.

📦 المتطلبات

• ProtocolLib (اختياري): مطلوب للميزات المعتمدة على الحزم مثل تعديل عدد اللاعبين وبعض ميزات شريط الإجراءات.
• OpenInv (توصية اختيارية): يحسن سلوك silent chest عند التفاعل مع المخازن أثناء حالة vanish.

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

• المنصة: مُنفذة كإضافة Bukkit/Spigot وتوفر Java API للإضافات الأخرى.
• API: توفر VanishAPI بطرق لإخفاء/إظهار اللاعبين، والتحقق من حالة vanish، واسترجاع قوائم اللاعبين غير المرئيين؛ وتتضمن PlayerHideEvent وPlayerShowEvent للتكامل القائم على الأحداث.
• الاستمرارية: يمكنها إرجاع قوائم بجميع اللاعبين غير المرئيين (المتصلين وغير المتصلين) عبر API؛ وقد يتطلب استرجاع جميع اللاعبين غير المرئيين الوصول إلى قاعدة البيانات ويجب استخدامه بحذر خارج الـ main thread.
• الترخيص: صدرت تحت رخصة MIT، والشفرة المصدرية متاحة في مستودع المشروع.

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

إذا كنت بحاجة إلى تطبيق vanish يتكامل مع إضافات أخرى ويدعم قواعد رؤية دقيقة للإشراف، فإن SuperVanish يوفر vanish قائمًا على API وقابلًا للتخصيص، مع تكاملات ProtocolLib/OpenInv اختيارية لتحسين السلوك.