Plugin Minecraft SuperVanish

🔌 Tentang SuperVanish

SuperVanish adalah plugin Minecraft untuk server Bukkit/Spigot yang memungkinkan operator server dan staf menjadi sepenuhnya tidak terlihat oleh pemain lain. Plugin ini bertujuan menyediakan kondisi vanish yang tidak terdeteksi, cocok untuk moderasi dan pengujian, sekaligus menyediakan API agar plugin lain bisa berinteraksi dengan status vanish.

🎯 Tujuan

Tujuan utama plugin ini adalah moderasi dan pemantauan administratif: memungkinkan staf tepercaya mengamati perilaku pemain tanpa muncul di daftar pemain, pesan masuk/keluar, atau kehadiran di dunia untuk sebagian besar pemain. Plugin ini ditujukan untuk pemilik server, administrator, dan pengembang plugin yang membutuhkan implementasi vanish yang andal.

⚙️ Fitur

• Sepenuhnya menyembunyikan pemain yang vanish dari pemain lain (visibilitas di dalam dunia).
• Menyembunyikan pemain yang vanish di daftar pemain (tab) dengan tampilan yang dapat dikonfigurasi untuk pengamat.
• Menyesuaikan jumlah pemain online/server list yang dilaporkan saat ProtocolLib tersedia.
• Model izin berlapis untuk mengatur dengan tepat siapa yang dapat melihat siapa.
• Mempertahankan status vanish saat join, restart, dan reload.
• Titik integrasi opsional yang memerlukan ProtocolLib untuk fitur lanjutan berbasis paket.
• Rekomendasi opsional untuk memasang OpenInv demi perilaku "silent chest" yang lebih baik.
• VanishAPI publik untuk plugin lain: metode untuk menyembunyikan/menampilkan pemain, menanyakan pemain yang tak terlihat, dan mendengarkan PlayerHideEvent/PlayerShowEvent.

🧩 Untuk Siapa Plugin Ini

• Server Survival dan SMP yang membutuhkan alat moderasi sembunyi-sembunyi.
• Server yang menginginkan API vanish untuk plugin moderasi atau utilitas lainnya.
• Administrator yang membutuhkan aturan visibilitas yang dapat dikonfigurasi dan kontrol tablist.

🏗️ Contoh Penggunaan

• Seorang moderator menjadi tidak terlihat untuk menyelidiki laporan grief tanpa memperingatkan tersangka.
• Sebuah plugin menanyakan VanishAPI untuk mengecualikan pemain yang vanish dari mekanik gameplay atau laporan.
• Operator server menyembunyikan kehadiran mereka selama pengujian langsung untuk mensimulasikan kondisi hanya-pemain.

⚙️ Instalasi

📥 Pengaturan

• Unduh JAR plugin resmi dan letakkan di direktori plugins/ server Anda.
• Restart server dan pastikan SuperVanish berhasil dimuat dengan memeriksa log konsol.
• Jika menggunakan ProtocolLib untuk fitur tambahan, instal ProtocolLib juga dan restart.

📦 Dependensi

• ProtocolLib (opsional): diperlukan untuk fitur berbasis paket seperti menyesuaikan jumlah pemain dan fitur action-bar tertentu.
• OpenInv (rekomendasi opsional): meningkatkan perilaku silent chest saat berinteraksi dengan inventaris ketika vanish.

🧠 Catatan Teknis

• Platform: diimplementasikan sebagai plugin Bukkit/Spigot dan menyediakan Java API untuk plugin lain.
• API: menyediakan VanishAPI dengan metode untuk menyembunyikan/menampilkan pemain, memeriksa status vanish, dan mengambil daftar pemain yang tak terlihat; termasuk PlayerHideEvent dan PlayerShowEvent untuk integrasi berbasis event.
• Persistensi: dapat mengembalikan daftar semua pemain yang tak terlihat (online dan offline) melalui API; mengambil semua pemain yang tak terlihat mungkin melibatkan akses basis data dan sebaiknya digunakan dengan hati-hati di luar main thread.
• Lisensi: dirilis di bawah lisensi MIT dan kode sumber tersedia di repositori proyek.

🤝 Kapan Plugin Ini Berguna

Jika Anda membutuhkan implementasi vanish yang terintegrasi dengan plugin lain dan mendukung aturan visibilitas yang terperinci untuk moderasi, SuperVanish menyediakan vanish berbasis API yang dapat dikonfigurasi dengan integrasi opsional ProtocolLib/OpenInv untuk perilaku yang lebih baik.