Minecraft Servers HQ

Plugin Minecraft PlaceholderAPI

Informasi tentang PlaceholderAPI dan server tempat ditemukan

🔌 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

PerintahDeskripsiIzinAkses
`/papi parse <playerme> `Mem-parsing placeholder dalam sebuah string dan menampilkan hasilnya untuk debugging.tidak disebutkan
`/papi bcparse <playerme> `Mem-parsing placeholder dan menyiarkan hasilnya ke semua pemain.tidak disebutkan
`/papi cmdparse <playerme> `Mem-parsing placeholder dan menjalankan perintah yang dihasilkan.tidak disebutkan
/papi parserel <player1> <player2> <text>Mem-parsing placeholder relasional dengan membandingkan dua pemain.tidak disebutkanAdmin
/papi listMenampilkan daftar ekspansi yang aktif/terdaftar.tidak disebutkanAdmin
/papi info <expansion>Menampilkan informasi tentang ekspansi yang terdaftar.tidak disebutkanAdmin
/papi register <filename>Mendaftarkan jar ekspansi dari folder expansions tanpa memulai ulang.tidak disebutkanAdmin
/papi unregister <filename>Membatalkan/menghapus pendaftaran ekspansi yang terdaftar.tidak disebutkanAdmin
/papi reloadMemuat ulang konfigurasi PlaceholderAPI dan mendaftarkan ekspansi yang baru diunduh.tidak disebutkanAdmin
/papi versionMenampilkan versi plugin dan para penulisnya.tidak disebutkanAdmin
/papi dumpMengeluarkan info plugin/versi/ekspansi untuk dukungan (layanan paste).tidak disebutkanAdmin
/papi ecloud download <expansion> [version]Mengunduh ekspansi terverifikasi dari eCloud ke server.tidak disebutkanAdmin
`/papi ecloud list [allinstalled]`Menampilkan daftar ekspansi yang tersedia di eCloud atau ekspansi yang terpasang.
/papi ecloud placeholders <expansion>Menampilkan placeholder yang disediakan oleh ekspansi eCloud.tidak disebutkanAdmin
/papi ecloud statusMenampilkan koneksi/status layanan eCloud.tidak disebutkanAdmin

(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.

Server dengan plugin PlaceholderAPI

Halaman plugin PlaceholderAPI menampilkan di server mana monitoring menemukan plugin ini, dengan platform dan versi apa ia ditemukan.

Plugin dapat menambahkan perintah, ekonomi, perlindungan, hak akses, mini-game, integrasi, atau mekanik lainnya. Peran sebenarnya dari PlaceholderAPI bergantung pada konfigurasi server yang bersangkutan.

Data terbentuk otomatis dari respons teknis server. Jika server menyembunyikan daftar plugin, server tersebut mungkin tidak muncul di bagian ini meskipun menggunakan PlaceholderAPI.

Gunakan daftar server dengan PlaceholderAPI untuk membandingkan proyek, memeriksa versi yang kompatibel, atau menemukan contoh penggunaan plugin di server publik.