Plugin Minecraft ItemJoin

🔌 Tentang ItemJoin

ItemJoin adalah plugin Minecraft untuk memberikan item kustom yang sangat dapat dikonfigurasi kepada pemain secara otomatis. Item dapat diberikan pada event seperti join, first-join, respawn, world-switch, region-enter, dan region-leave. Plugin ini berfokus pada definisi item yang fleksibel (itemflags), event pemicu, dan perintah yang terikat pada item, sehingga server dapat menyediakan menu lobby, starter kit, atau alat yang sesuai konteks tanpa mod client kustom.

🎯 Tujuan

ItemJoin menyelesaikan masalah pemberian item kustom atau item interaktif kepada pemain secara andal, yang terikat pada event dan dunia server. Ini berguna untuk server hub/lobby, server minigame, jaringan survival (saat item harus dibatasi per dunia), dan jaringan yang membutuhkan menu berbasis item atau item yang menjalankan perintah.

⚙️ Fitur

• Memberikan item berdasarkan pemicu yang dapat dikonfigurasi: join, first-join, respawn, world-switch, region-enter/exit, dan event serupa.
• itemflags per item yang mengubah perilaku (slot, overwrite, aturan stack, pemblokiran gerak/pickup, batas gamemode, peluang menerima, cooldown).
• ItemCommands: menautkan perintah ke item dan mengatur konteks eksekusi (console, player, server, message) serta jenis aksi (klik kiri/kanan, klik inventaris, fisik, multi-click).
• Integrasi PlaceholderAPI untuk nama/lore item dinamis dan dukungan placeholder.
• Dukungan kepala pemain kustom (tekstur dan pemilik kustom), gambar map, tipped arrows, buku, banner, kembang api, kustomisasi armor kulit, dan level enchant kustom.
• Secara opsional memblokir pergerakan item atau pengambilan item di dunia tertentu dan membatasi item berdasarkan alamat IP atau status first-join.
• Pembuat GUI dalam game untuk menyusun set item dan alur impor/pembuatan bawaan.
• API untuk plugin lain: tersedia di me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Untuk Siapa

• Pemilik server yang membutuhkan item lobby/hub otomatis atau starter kit.
• Operator minigame dan jaringan yang memerlukan item khusus per dunia atau kompas menu.
• Developer yang ingin sistem item yang bisa di-hook melalui API.

🏗️ Contoh Penggunaan

• Memberikan kompas menu kepada pemain saat join yang menjalankan perintah berbeda ketika diklik.
• Menyediakan starter kit sekali pakai saat first-join sambil mencegah transfer item antar dunia tertentu.
• Membuat item interaktif yang menjalankan perintah economy/shop dengan cooldown dan biaya.

⌨️ Perintah

Catatan: perintah dan subperintah ini diambil dari set perintah yang didokumentasikan oleh plugin. Plugin menyediakan subperintah tambahan di wiki dan output bantuan yang digenerate.

🔐 Izin

Perilaku izin khusus item dapat dikonfigurasi; pengecekan izin item dinonaktifkan secara default dan harus diaktifkan di konfigurasi plugin agar berlaku.

⚙️ Instalasi

📥 Penyiapan

• Unduh file jar resmi ItemJoin dan letakkan ke folder plugins/ di server Anda.
• Pastikan tidak ada file jar ItemJoin duplikat di plugins/ (misalnya ItemJoin(1).jar).
• Restart server agar plugin dapat membuat konfigurasi dan mendaftarkan fitur untuk versi server Anda.
• Periksa log konsol server untuk konfirmasi pemuatan plugin dan lihat wiki plugin untuk penyiapan yang lebih detail.

📦 Dependensi

Plugin ini tidak memiliki kebutuhan runtime wajib, tetapi mencantumkan beberapa soft-dependency dan integrasi umum (opsional dan akan aktif jika tersedia):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Aktifkan atau atur integrasi sesuai kebutuhan; plugin ini tetap berfungsi tanpa semuanya, tetapi fitur seperti placeholder, kepala/skin kustom, dan hook economy bergantung pada plugin yang sesuai.

🧠 Catatan Teknis

• Platform: dikonfirmasi untuk server bergaya Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Rentang Minecraft yang didukung/diuji: 1.8 hingga 1.21.
• Kode sumber dan rilis dipublikasikan, dan proyek ini menyediakan API di me.RockinChaos.itemjoin.api.ItemJoinAPI untuk di-hook oleh plugin lain.
• Lisensi: LGPL-3.0.

🤝 Kapan Plugin Ini Berguna

Jika Anda membutuhkan sistem yang fleksibel dan dapat dikonfigurasi untuk memberi pemain item yang peka konteks dan interaktif (menu, starter kit, alat khusus per dunia) serta ingin API untuk integrasi, ItemJoin menyediakan fitur-fitur tersebut sambil mendukung plugin placeholder dan skin yang umum.