Plugin Minecraft CommandButtons

🔌 Tentang CommandButtons

CommandButtons adalah plugin Minecraft untuk mengikat perintah ke interaksi blok. Plugin ini memungkinkan administrator server menambahkan kumpulan perintah ke blok (tombol, tanda, pressure plate, atau blok yang bisa diklik) sehingga perintah tersebut dijalankan saat pemain berinteraksi dengan blok yang dikonfigurasi. Plugin ini mendukung menjalankan perintah sebagai konsol dan/atau sebagai pemain yang memicu blok, serta menyediakan editor GUI di dalam game untuk mengelola tombol dan propertinya.

🎯 Tujuan

Plugin ini mengatasi masalah membuat elemen dunia interaktif yang menjalankan aksi administrasi atau gameplay tanpa mengharuskan pemain mengetik perintah. Penggunaan umum termasuk papan teleport, pemilih kit, aksi yang dapat dibeli, dan mekanik kustom yang dipicu oleh interaksi blok.

⚙️ Fitur

• Mengikat jumlah perintah tak terbatas ke satu command button (perintah konsol dan pemain).
• GUI editor di dalam game untuk membuat dan mengedit command button serta lokasinya.
• Cooldown per pemain dan global; cooldown tetap tersimpan setelah server restart.
• Integrasi ekonomi opsional melalui Vault untuk mengenakan biaya kepada pemain saat memakai tombol.
• Node permission kustom untuk membatasi penggunaan tombol tertentu.
• Pesan yang dapat disesuaikan melalui file pesan.
• Beberapa lokasi per command button sehingga satu konfigurasi bisa berlaku untuk banyak blok.
• Perintah dasar untuk membuat, mengedit, dan memuat ulang data plugin.

🧩 Untuk Siapa

• Administrator server dan builder yang ingin elemen dunia yang bisa diklik dan menjalankan perintah.
• Server minigame dan lobby yang membutuhkan menu interaktif atau papan teleport/pemilihan kit.
• Server yang memakai plugin ekonomi dan ingin mekanik bayar per penggunaan.

🏗️ Contoh Penggunaan

• Papan teleport spawn, di mana setiap tombol memindahkan pemain yang mengklik ke arena yang berbeda.
• Dinding pemilihan kit: menekan tombol menjalankan serangkaian perintah untuk memberi kit dan pesan.
• Aksi berbayar: tombol mengenakan mata uang dalam game dan menjalankan perintah hadiah.

⌨️ Perintah

🔐 Permissions

⚙️ Instalasi

📥 Penyiapan

• Unduh jar plugin resmi dan letakkan ke direktori plugins/ server.
• Restart server dan periksa log konsol untuk memastikan plugin dimuat dengan benar.
• Gunakan perintah /commandbuttons yang disediakan untuk membuat dan mengedit konfigurasi tombol di dalam game.

📦 Dependensi

• Opsional: Vault untuk mengaktifkan fitur biaya ekonomi. Plugin ekonomi yang terintegrasi dengan Vault (misalnya ekonomi EssentialsX) diperlukan untuk menggunakan fitur bayar per penggunaan.

🧠 Catatan Teknis

• Plugin ini menyediakan editor GUI dan membuat file konfigurasi/pesan untuk kustomisasi.
• Cooldown tetap tersimpan setelah server restart.
• Mode eksekusi perintah sebagai konsol dan sebagai pemain didukung; perintah yang dijalankan sebagai pemain akan menggunakan permission pemain (perintah yang membutuhkan permission lebih tinggi dari pemain tidak akan berjalan saat dijalankan sebagai pemain).
• Fitur ekonomi membutuhkan Vault dan plugin ekonomi yang didukung.

🤝 Kapan Plugin Ini Berguna

Gunakan CommandButtons saat Anda membutuhkan aksi yang dapat dikonfigurasi dan terikat lokasi, dipicu oleh interaksi pemain (tombol, tanda, plate) dengan cooldown bawaan, pengecekan permission, dan biaya ekonomi opsional, yang dikelola melalui editor di dalam game.