Plugin Minecraft AxRewards

🔌 Tentang AxRewards

AxRewards adalah plugin Minecraft yang menyediakan sistem reward yang ringan dan dapat dikonfigurasi. Administrator server menentukan reward dengan cooldown arbitrer, menampilkannya dalam GUI yang dapat diedit, dan menjalankan command klaim saat pemain mengklaim reward. Proyek ini dikelola oleh Artillex-Studios dan menyertakan penyimpanan berbasis database serta dukungan multi-server.

🎯 Tujuan

AxRewards menyelesaikan kebutuhan umum akan reward pemain yang terjadwal atau dapat diulang (misalnya reward login harian atau mingguan) sambil menawarkan cooldown yang fleksibel, penguncian permission, dan presentasi GUI. Ini ditujukan untuk server yang menginginkan sistem reward terintegrasi dan dapat dikonfigurasi tanpa memerlukan sistem caching eksternal.

⚙️ Fitur

• Reward yang dapat dikonfigurasi dengan cooldown arbitrer (dinyatakan dalam detik).
• Menu GUI yang dapat diedit untuk menampilkan reward; item GUI dapat menampilkan status berbeda (bisa diklaim / tidak bisa diklaim / tidak punya permission).
• Penyimpanan database dengan dukungan untuk H2, SQLite, MySQL, dan PostgreSQL.
• Dukungan multi-server tanpa memerlukan Redis.
• GUI yang diperbarui otomatis (GUI menyegarkan secara berkala tanpa perlu dibuka ulang).
• Kemampuan mengunci reward di balik permission (setiap reward dapat memerlukan permission).
• Aksi klaim diimplementasikan sebagai daftar command server (mendukung placeholder %player%).
• Integrasi PlaceholderAPI dan dukungan untuk beberapa format warna.

🧩 Untuk Siapa

• Server Survival dan SMP yang menginginkan reward yang bisa diklaim harian/mingguan/kustom.
• Operator server yang membutuhkan penyimpanan berbasis database untuk bertahan di antara restart atau di beberapa server.
• Admin yang lebih suka presentasi reward berbasis GUI dan reward yang dikunci dengan permission.

🏗️ Contoh Penggunaan

• Menawarkan reward login harian yang memberi item atau menjalankan command saat diklaim.
• Menyediakan reward VIP mingguan yang dibatasi dan memerlukan permission rank untuk diklaim.
• Menjalankan reward berbasis command yang memberi uang, item, atau menjalankan command server kustom menggunakan %player%.

⌨️ Commands

(Hanya command yang dikonfirmasi dalam dokumentasi resmi yang dicantumkan.)

⚙️ Instalasi

📥 Setup

• Unduh file JAR plugin dan letakkan di folder plugins/ server Anda untuk server yang kompatibel dengan Bukkit/Spigot/Paper.
• Mulai atau restart server agar plugin dapat membuat folder data dan konfigurasinya.
• File konfigurasi dan menu ditempatkan di dalam folder plugin (misalnya plugins/AxRewards/menus).

📦 Dependensi

• PlaceholderAPI (integrasi opsional untuk placeholder) — dukungan dikonfirmasi.

🧠 Catatan Teknis

• Backend database yang dikonfirmasi: H2, SQLite, MySQL, PostgreSQL.
• Plugin mendukung PlaceholderAPI dan format warna umum (termasuk MiniMessage dan format legacy).
• GUI menyegarkan otomatis (auto-updating) tanpa pemain perlu membukanya lagi.
• Reward menentukan cooldown dalam detik; mengatur cooldown ke -1 membuat reward tidak pernah refresh.
• Proyek ini bersifat open-source dan berlisensi MIT.
• Perangkat lunak server dan topik yang didukung yang dikonfirmasi mencakup Bukkit, Spigot, Paper, dan Folia.
• Persyaratan yang dikonfirmasi: runtime Java modern (catatan proyek menunjukkan Java 21 atau lebih tinggi untuk rilis terbaru).

🤝 Kapan Plugin Ini Berguna

Jika Anda membutuhkan sistem reward yang dapat dikonfigurasi, berbasis GUI, dengan penyimpanan persisten dan dukungan lintas server, AxRewards menyediakan menu yang dapat diedit, penanganan cooldown, dan aksi klaim berbasis command sambil terintegrasi dengan PlaceholderAPI dan database umum.