NagaClan

# NagaClan — Klan modern untuk Kertas
Satukan pemain Anda dengan obrolan tim pribadi, dasbor klan, rumah bersama, bank klan, dan izin peran yang dikendalikan oleh pemimpin.
## Fitur
- Obrolan klan pribadi: aktifkan/nonaktifkan dengan `/clan chat`, atau kirim pesan tunggal dengan `/clan chat <pesan>`. Pesan hanya akan terkirim ke anggota klan saat ini dan akan memiliki label **[Teams Chat]**.
- Menu inventaris untuk anggota, rumah, perbankan, aliansi, pengaturan, dan peringkat klan.
- Peran Pemimpin, Admin, Pembangun, dan Anggota, dengan akses tindakan yang dapat dikonfigurasi dari `/clan settings`.
- Ambang batas peran terpisah untuk obrolan, teleportasi rumah, pengaturan/penghapusan rumah, mengundang, mengeluarkan, aliansi, penugasan peran, setoran, penarikan, tembakan ramah, visibilitas papan peringkat, awalan, dan ikon.
- Berbagi rumah klan dengan `/clan sethome <name>`, `/clan home <name>` dan `/clan delhome <name>`.
- Bank klan bersama melalui Vault dan penyedia ekonomi yang kompatibel.
- Batasan rumah dan bank berdasarkan pemimpin. Peringkat donatur anggota tidak meningkatkan batasan klan.
- Awalan klan yang dapat diedit, ikon material item khusus, dan visibilitas papan peringkat opsional.
- Dialog input teks asli untuk klien Java dan versi Paper yang didukung, dengan input obrolan pribadi sebagai alternatif.
- File bahasa Inggris, Indonesia, Spanyol, Rusia, dan Tionghoa Sederhana.
- Saran perintah yang mempertimbangkan izin dan konfirmasi sebelum tindakan klan yang merusak.
- Integrasi PlaceholderAPI opsional.
- Muat ulang melalui `/nagacore reload NagaClan`; alias `/nc reload` dan `/nagaclan reload` yang sudah ada tetap tersedia.
## Persyaratan dan kompatibilitas
**Diperlukan Paper Server, Java 21, dan NagaCore 1.1.0 atau yang lebih baru.**
Ini adalah plugin Paper, **bukan plugin server Spigot biasa**. Versi 1.0.6 dikompilasi terhadap Paper 1.21.8. Jangan mengiklankan versi server yang belum diuji sebagai versi yang sudah diuji.
Dialog Java Minecraft membutuhkan klien versi 1.21.6 ke atas. API Dialog Paper tersedia mulai dari Paper 1.21.7; server lama atau klien yang tidak didukung/tidak dikenal menggunakan input obrolan pribadi sebagai gantinya. Klien modern saja tidak menambahkan dukungan dialog ke server lama.
ViaVersion yang terpasang pada backend Paper akan dideteksi untuk mendapatkan versi klien asli. Jika terjemahan protokol hanya berjalan pada proxy, atur `dialogs.proxy-translation: true` untuk menggunakan fallback obrolan aman. Atur `dialogs.enabled: false` untuk menonaktifkan dialog untuk semua orang.
Dependensi opsional:
- **Vault + penyedia ekonomi yang kompatibel dengan Vault:** perbankan klan.
- **LuckPerms:** Pencarian izin pemimpin offline untuk batasan berbasis grup.
- **PlaceholderAPI:** placeholder klan.
- **ViaVersion:** deteksi versi klien asli saat diinstal di backend.
Verifikasi lisensi jarak jauh NagaCore harus berhasil agar edisi ini dapat beroperasi. Ketergantungan dan persyaratan ini harus diungkapkan sebelum didistribusikan.
## Instalasi
1. Hentikan server dan buat cadangan `plugins/NagaClan/`.
2. Instal versi NagaCore yang diperlukan dan valid.
3. Hapus JAR NagaClan lama dari direktori plugin, dan pertahankan folder datanya.
4. Instal `NagaClan-1.0.6.jar`, beserta integrasi opsional apa pun yang Anda butuhkan.
5. Mulai server. Pilih `language: en`, `id`, `es`, `ru` atau `zh` di `config.yml`.
6. Sesuaikan terjemahan di `plugins/NagaClan/languages/`, lalu muat ulang NagaClan.
Data klan yang ada tetap dipertahankan. Boolean akses bank lama dipindahkan ke ambang batas peran yang setara.
## Perintah
Perintah pemain:
- `/clan` atau `/clan menu` — membuka dasbor.
- `/clan create <name>` — membuat klan.
- `/clan invite <player>`, `accept`, `deny`, `kick <player>`, `leave`.
- `/clan chat [pesan]` — beralih antara obrolan pribadi atau mengirim satu pesan pribadi.
- `/pengaturan klan` — menu pengaturan klan dan kebijakan akses.
- `/clan sethome <name>`, `home <name>`, `delhome <name>`.
- `/clan setbuilder <player>`, `setadmin <player>`, `setleader <player>`.
- `/clan alliance <clan>` — mencatat aliansi dalam daftar klan Anda.
- `/clan top`, `/clan level`.
- `/clan disband` — ulangi dalam 30 detik untuk konfirmasi.
Administrasi:
- `/nagacore reload NagaClan`
- `/nc muat ulang|simpan|versi`
- `/nagaclan reload|save|version`
Pemain tanpa klan hanya menerima opsi buat, terima, dan tolak sebagai saran argumen pertama.
## Izin dan akses
Node perintah biasa menggunakan `nagaclan.command.<subcommand>`, kecuali obrolan klan yang menggunakan `nagaclan.chat`.
Node tambahan:
- `nagaclan.settings` — mengedit pengaturan klan, tergantung pada akses peran klan.
- `nagaclan.bank.deposit`, `nagaclan.bank.withdraw`.
- `nagaclan.bank.settings` — switch akses anggota lama, hanya pemimpin.
- `nagaclan.admin.reload`, `nagaclan.admin.save`, `nagaclan.admin.version`.
- `nagacore.admin.reload` — perintah muat ulang pusat.
Tingkat batasan pemimpin ditentukan dalam `group-limits.tiers`. Awalan defaultnya adalah `nagaclans.sethome.multiple.<tier>` dan `nagaclans.maxbank.multiple.<tier>`.
Pengaturan akses klan tidak memberikan izin Bukkit/LuckPerms. Peran dengan peringkat lebih tinggi mewarisi akses tindakan yang telah dikonfigurasi. Seorang pemain tidak dapat mengeluarkan atau mempromosikan seseorang pada peringkat yang sama atau lebih tinggi darinya. Hanya pemimpin yang dapat mengubah kebijakan akses, mentransfer kepemimpinan, atau membubarkan klan.
## Placeholder
`%nagaclan_name%`, `%nagaclan_prefix%`, `%nagaclan_level%`, `%nagaclan_role%`, `%nagaclan_bank%`.
## Dukungan dan ucapan terima kasih
Dikembangkan untuk **NagaDEV**. TikTok: **@nagasak**.
Untuk laporan bug, sertakan versi NagaClan/NagaCore, versi Paper, versi klien, log konsol yang relevan, dan langkah-langkah reproduksi. Hapus kata sandi dan informasi lisensi pribadi sebelum membagikan log.
---
## Daftar periksa penerbit — hapus bagian ini dari deskripsi publik
- Tambahkan URL dukungan Anda yang sebenarnya, ketentuan harga/distribusi, dan tangkapan layar dalam game terbaru. Tidak ada tautan fiktif yang disertakan.
- Lakukan pengujian pada server Paper yang aktif sebelum menandai versi Minecraft mana pun sebagai versi yang telah diuji. Pengujian otomatis bukanlah sertifikasi kompatibilitas langsung.
- Deskripsi ini **tidak** menyiratkan persetujuan pasar atau kompatibilitas runtime Spigot secara umum.
- **Jangan mengirimkan build berlisensi ini sebagai sumber daya Spigot Premium tanpa perubahan.** Pedoman Sumber Daya Premium yang diterbitkan melarang sistem lisensi yang memerlukan aktivasi/akses server tertentu dan mensyaratkan dukungan untuk Spigot versi stabil terbaru. Build ini tetap hanya untuk Paper dan bergantung pada lisensi NagaCore, sesuai permintaan; tidak ada cara untuk melewati lisensi yang diperkenalkan.
- Tentukan edisi distribusi yang sesuai dan diotorisasi secara terpisah atau pasar yang sesuai sebelum menerbitkan.
Referensi diperiksa pada 2026-09-20:
- [API Dialog Paper]( https://docs.papermc.io/paper/dev/dialogs/)
- [Panduan Sumber Daya Premium Spigot]( https://www.spigotmc.org/threads/premium-resource-guidelines.31667/)