Plugin Minecraft PlaceholderAPI

🔌 Tentang PlaceholderAPI

PlaceholderAPI adalah plugin Minecraft yang menyediakan sistem placeholder terpusat dan ekosistem ekspansi (eCloud). Plugin ini memungkinkan plugin lain membaca dan mengganti ribuan placeholder dinamis (data pemain, nilai ekonomi, nilai spesifik plugin, dll.) tanpa memerlukan integrasi langsung atau dependensi yang berat.

🎯 Tujuan

Plugin ini mengatasi hambatan integrasi antar-plugin dengan menyediakan satu API placeholder yang dapat diperluas. Pembuat plugin menerbitkan "ekspansi" yang menyediakan placeholder bernama; administrator server memasang ekspansi agar plugin yang menampilkan informasi server (scoreboard, chat, hologram, GUI) dapat menampilkan data langsung dengan sintaks yang konsisten.

⚙️ Fitur

• API inti untuk parsing placeholder agar plugin lain dapat menggunakannya.
• Sistem ekspansi: ekspansi dikemas terpisah atau disertakan di dalam plugin.
• eCloud (cloud ekspansi) untuk menemukan dan mengunduh ekspansi terverifikasi di dalam game.
• Perintah pengelolaan saat runtime untuk menampilkan daftar, mendaftarkan, membatalkan pendaftaran, dan memuat ulang ekspansi.
• Perintah debug/parsing untuk mengevaluasi placeholder untuk seorang pemain atau menyiarkan hasilnya, berguna untuk pemecahan masalah.
• Utilitas seperti perintah dump untuk membagikan ekspansi yang terpasang dan status plugin saat meminta bantuan.

🧩 Untuk Siapa

• Administrator server yang membutuhkan teks dinamis terpadu di berbagai plugin (scoreboard, tablist, hologram, GUI).
• Pengembang plugin yang ingin mengekspos atau memakai placeholder tanpa memaksa dependensi yang berat.
• Server Survival, minigame, dan network yang menggabungkan banyak plugin dan membutuhkan sintaks placeholder yang konsisten.

🏗️ Contoh Penggunaan

• Sebuah server memasang ekspansi Vault sehingga placeholder ekonomi seperti saldo pemain dapat digunakan di plugin scoreboard dan chat.
• Seorang admin mengunduh ekspansi spesifik plugin dari eCloud sehingga plugin hologram dapat menampilkan data objektif secara langsung.
• Seorang pengembang mengekspos data plugin melalui PlaceholderExpansion agar server lain dapat menampilkan data tersebut tanpa bergantung langsung pada plugin itu.

⌨️ Perintah

(Catatan: perintah-perintah di atas didokumentasikan dalam referensi perintah resmi PlaceholderAPI. Node izin untuk perintah individual tidak tercantum dalam dokumentasi perintah yang dirujuk.)

⚙️ Instalasi

📥 Penyiapan

• Unduh file jar PlaceholderAPI resmi dan letakkan di direktori plugins/ server Anda.
• Jalankan atau mulai ulang server dan pastikan PlaceholderAPI dimuat di konsol.
• Pasang ekspansi dengan menaruh file jar ekspansi ke plugins/PlaceholderAPI/expansions/ atau dengan menggunakan perintah eCloud di dalam game (untuk ekspansi terverifikasi).

📦 Dependensi

• PlaceholderAPI sendiri tidak memerlukan dependensi plugin umum agar berfungsi. Beberapa placeholder yang disediakan oleh ekspansi bergantung pada plugin lain (misalnya, ekspansi yang menampilkan nilai ekonomi akan memerlukan plugin ekonomi yang sesuai). Persyaratan tersebut bergantung pada ekspansi tertentu.

🧠 Catatan Teknis

• PlaceholderAPI disediakan untuk server berbasis Spigot dan juga umum digunakan di Paper. Plugin ini menyediakan API bagi pengembang plugin untuk mendaftarkan PlaceholderExpansions.
• Ekspansi dapat didistribusikan sebagai file jar mandiri atau disertakan di dalam plugin lain; ekspansi mandiri biasanya dipasang ke plugins/PlaceholderAPI/expansions/.
• Fitur eCloud memungkinkan penemuan dan pengunduhan ekspansi terverifikasi di dalam game; server harus mengizinkan HTTPS keluar agar unduhan eCloud berfungsi.
• Plugin ini menyertakan perintah debug dan parsing untuk membantu administrator memastikan placeholder terselesaikan dengan benar.

🤝 Kapan Plugin Ini Berguna

Jika server Anda menggunakan banyak plugin yang perlu menampilkan data dinamis lintas plugin (chat, tab, hologram, scoreboard, atau GUI), PlaceholderAPI berguna karena memusatkan penyelesaian placeholder dan memungkinkan Anda menambahkan dukungan untuk plugin tambahan melalui ekspansi modular tanpa memodifikasi setiap plugin konsumen.