Plugin Minecraft Citizens

🔌 Tentang Citizens

Citizens adalah plugin Minecraft yang menyediakan sistem lengkap untuk membuat dan mengelola NPC sisi server. Plugin ini mendukung banyak jenis NPC (mirip pemain, mob, penjaga toko, penjaga, patung) dan menyediakan API agar plugin lain serta kode kustom dapat menambahkan perilaku, trait, dan integrasi.

🎯 Tujuan

Citizens menjawab kebutuhan akan karakter non-pemain yang persisten dan dapat dikonfigurasi di server: NPC dapat berperan sebagai penjaga toko interaktif, aktor skrip, penjaga yang mengikuti waypoint, kios informasi, atau patung dekoratif. Plugin ini digunakan baik oleh pemilik server untuk membangun fitur gameplay maupun oleh pengembang untuk memperluas fungsionalitas melalui Citizens API.

⚙️ Fitur

• Membuat dan menghapus NPC dengan perintah dalam game.
• Berbagai jenis NPC (player, berbasis mob, villager, dll.).
• Menetapkan perintah atau aksi skrip ke NPC (trigger klik/jalankan, command attachment).
• Waypoint dan perilaku patroli untuk NPC yang bergerak.
• Trait dan editor untuk menyesuaikan perilaku serta tampilan NPC.
• Template dan persistensi agar NPC tetap ada setelah restart.
• API pengembang untuk addon, trait, dan integrasi.

🧩 Untuk Siapa Plugin Ini

• Pemilik server yang ingin NPC interaktif untuk toko, panduan, atau dekorasi.
• Pengembang plugin yang membutuhkan API NPC untuk membuat integrasi atau mini-game.
• Server komunitas yang memerlukan karakter non-pemain dekoratif atau fungsional.

🏗️ Contoh Penggunaan

• Server Survival menggunakan penjaga toko NPC untuk menukar item tanpa plugin ekonomi.
• Server RPG menskrip NPC untuk memberikan quest dan dialog.
• Admin menempatkan NPC penjaga patroli yang mengikuti waypoint di sekitar kota.
• Pengembang menambahkan trait kustom ke NPC untuk interaksi minigame.

⌨️ Perintah

(Catatan: /npc memiliki banyak subperintah dan node izin yang lebih terperinci untuk fitur tertentu; lihat dokumentasi plugin untuk daftar perintah lengkap.)

🔐 Izin

(Ada banyak node izin tambahan untuk perintah dan trait tertentu; referensi izin plugin menjelaskannya secara detail.)

⚙️ Instalasi

📥 Penyiapan

• Unduh JAR plugin Citizens resmi dari distribusi resmi proyek (katalog plugin atau unduhan proyek).
• Letakkan JAR ke direktori plugins/ server Anda pada server yang kompatibel dengan Spigot atau Paper.
• Restart server dan periksa console untuk memastikan Citizens dimuat dan membuat direktori datanya.

📦 Dependensi

• Tidak ada dependensi eksternal yang wajib secara default. Citizens biasanya diperluas dengan addon opsional (addon pihak ketiga atau plugin lain), tetapi tidak ada yang wajib untuk operasi dasar.

🧠 Catatan Teknis

• Citizens menyediakan API untuk pengembang agar plugin lain dapat membuat trait, berinteraksi dengan NPC, dan menangani event NPC.
• Plugin ini menyimpan data NPC secara persisten sehingga NPC tetap ada setelah restart dan mendukung trait/editor untuk kustomisasi saat runtime.
• Dokumentasi resmi dan wiki komunitas membahas perintah, izin, trait, editor, dan titik integrasi.

🤝 Kapan Plugin Ini Berguna

Jika Anda membutuhkan NPC yang tahan lama, dapat diskriptkan, dan API untuk mengintegrasikan karakter non-pemain ke dalam gameplay atau sistem server, Citizens menyediakan manajemen NPC inti, persistensi, dan titik ekstensi yang dibutuhkan oleh administrator server maupun pengembang plugin.