Plugin Minecraft QuickShop-Hikari

🔌 Tentang QuickShop-Hikari

QuickShop-Hikari adalah plugin Minecraft yang menyediakan toko beli/jual berbasis chest (ChestShops). Pemain membuat dan menggunakan toko dengan berinteraksi dengan chest; sebagian besar gameplay tidak memerlukan perintah apa pun. Proyek ini dikelola oleh QuickShop-Community dan berfokus pada kompatibilitas modern, keamanan data, dan integrasi yang dapat diperluas.

🎯 Tujuan

Menyediakan ekonomi dalam game berbasis item, di mana pemain dapat memasang item untuk dijual atau membuat toko beli menggunakan chest. Plugin ini ditujukan untuk administrator server yang menginginkan ekonomi fisik berbasis chest dan kontrol per toko tanpa memaksa pemain mempelajari perintah.

⚙️ Fitur

• Membuat toko beli dan jual menggunakan chest dan sign (toko berbasis chest).
• Dukungan untuk data NBT, enchantment, damage item, data potion, dan telur mob.
• Item tampilan virtual di atas toko yang dapat diaktifkan/nonaktifkan (didukung ProtocolLib atau PacketEvents).
• Dukungan chest tak terbatas dan perilaku campuran beli/jual pada double chest.
• Dukungan blacklist dengan opsi izin bypass.
• Pengelolaan izin per toko dan manfaat toko antara pemilik dan pemain lain.
• Dukungan i18n untuk nama item dan enchantment serta sintaks MiniMessage untuk pesan.
• Dukungan datasource H2 (lokal) dan MySQL (jarak jauh).
• Hook integrasi untuk plugin proteksi dan utilitas yang umum (modul kompatibilitas tersedia).
• API developer (koordinat Maven/Gradle disediakan) untuk mengambil data toko dan mengintegrasikan fitur.
• Telemetri bStats dengan opsi opt-out melalui konfigurasi.

🧩 Untuk Siapa Ini

Pemilik dan administrator server yang menjalankan Survival/SMP atau server berfokus ekonomi yang menginginkan marketplace fisik berbasis chest. Plugin ini cocok untuk server kecil hingga besar yang memakai plugin ekonomi kompatibel Vault dan membutuhkan kontrol per toko serta penyimpanan berbasis database.

🏗️ Contoh Kasus Penggunaan

• Pemain menaruh item di chest dan memberi label untuk menjual tumpukan secara otomatis ke pemain lain.
• Admin mengaktifkan izin per toko agar moderator dapat mengelola toko di world atau region tertentu.
• Sebuah jaringan memakai penyimpanan MySQL untuk menjaga toko tetap persisten di berbagai instance server.

⌨️ Perintah

Catatan: dokumentasi proyek menyatakan bahwa gameplay pemain biasa tidak memerlukan perintah; perintah utamanya bersifat administratif.

🔐 Izin

⚙️ Instalasi

📥 Penyiapan

• Unduh jar QuickShop-Hikari resmi dari distribusi proyek (rilis Modrinth/Spigot/GitHub).
• Letakkan file jar ke folder plugins/ di server Anda.
• Jalankan server dan pastikan plugin berhasil dimuat (dokumentasi menunjukkan menjalankan perintah qs di konsol untuk menampilkan bantuan/output uji).

📦 Dependensi

Integrasi yang dikonfirmasi sebagai wajib/opsional oleh proyek:

• Vault (wajib untuk penghubung ekonomi)
• Plugin ekonomi yang kompatibel dengan Vault (contoh diberikan oleh proyek)
• ProtocolLib atau PacketEvents (wajib untuk item tampilan virtual / lokalisasi per pemain)
• LuckPerms (disarankan untuk manajemen izin)

🧾 Konfigurasi

• Plugin membuat dan menggunakan config.yml (dokumentasi merujuk ke kunci config.yml untuk protokol tampilan dan pengaturan privasi).
• Penyimpanan data mendukung H2 lokal atau MySQL jarak jauh; opsi konfigurasi tersedia di file konfigurasi plugin.

🧠 Catatan Teknis

• Dokumentasi resmi merekomendasikan menjalankannya di server berbasis Paper dan mendokumentasikan kebutuhan Java 21.
• Proyek ini menyediakan API developer dan koordinat Maven/Gradle untuk penggunaan saat kompilasi.
• QuickShop-Hikari menyertakan modul kompatibilitas untuk plugin pihak ketiga (mis. WorldGuard, WorldEdit, OpenInv) sebagai unduhan opsional.
• Telemetri: menggunakan bStats; opt-out melalui pengaturan config.

🤝 Kapan Plugin Ini Berguna

Jika Anda menginginkan marketplace yang berinteraksi langsung dengan chest, terlihat oleh pemain, memiliki penyimpanan persisten, dan kontrol per toko (bukan toko berbasis GUI saja atau perintah), QuickShop-Hikari menyediakan implementasi modern berbasis database dengan hook untuk plugin ekonomi dan proteksi yang umum.