Plugin Minecraft TitleManager

🔌 Tentang TitleManager

TitleManager adalah plugin Minecraft yang mengelola elemen presentasi yang terlihat oleh pemain: judul tengah layar dan subjudul yang dianimasikan, actionbar, header dan footer daftar tab yang dianimasikan, serta sidebar scoreboard yang dapat dikonfigurasi. Plugin ini berfungsi sebagai lapisan presentasi untuk server yang ingin menampilkan pesan bergabung, pengumuman, dan tampilan tab/scoreboard yang lebih rapi.

🎯 Tujuan

Plugin ini memusatkan fitur tampilan (titles, actionbar, tab-list, sidebar) agar pemilik server dapat menyajikan informasi yang konsisten, dianimasikan, dan berbasis placeholder kepada pemain tanpa perlu coding khusus. Plugin ini ditujukan untuk administrator server yang ingin mengelola pesan join/welcome, pengumuman bergilir, dan UI TAB/scoreboard yang dinamis.

⚙️ Fitur

• Title dan actionbar saat join dan first join yang dapat dikonfigurasi, dengan opsi waktu dan varian.
• Header dan footer tab-list yang dianimasikan dan mendukung gradient, dengan placeholder untuk jumlah pemain online, waktu dunia/server, dan nilai dinamis lainnya.
• Sidebar scoreboard yang dapat dikonfigurasi dengan hingga 15 baris animasi yang didukung oleh sistem scoreboard server.
• Broadcast dan pengumuman terjadwal yang dikirim sebagai title atau actionbar.
• Mesin animasi dengan file animasi yang dapat digunakan ulang dan pratinjau (animation playground tersedia di dokumentasi resmi).
• Integrasi placeholder (placeholder bawaan TitleManager dan dukungan untuk sistem placeholder eksternal jika tersedia).
• Reload transaksional: pemuatan ulang konfigurasi diterapkan dengan aman dan dapat dibatalkan jika config baru tidak valid.
• API kecil untuk developer guna integrasi opsional dan penggunaan antar-plugin.

🧩 Untuk Siapa Plugin Ini

• Server Survival dan SMP yang menginginkan UI join/pengumuman yang lebih rapi.
• Server yang menggunakan placeholder dan integrasi eksternal (untuk nilai dinamis di tampilan).
• Administrator yang membutuhkan tampilan tab dan scoreboard yang dianimasikan tanpa menulis plugin khusus.
• Developer yang ingin mengintegrasikan fitur presentasi ke plugin lain melalui API yang disediakan.

🏗️ Contoh Penggunaan

• Menampilkan title sambutan dan actionbar yang dianimasikan saat pemain bergabung, dengan pesan berbeda saat first join.
• Membuat daftar pemain di tab tetap hidup dengan menampilkan waktu server, jumlah pemain online, serta header/footer gradient.
• Memutar title atau actionbar pengumuman yang dianimasikan sesuai jadwal untuk menyampaikan event atau aturan.
• Menggunakan sidebar scoreboard untuk menampilkan leaderboard, statistik, atau informasi server yang dinamis.

⌨️ Perintah

Catatan: perintah di atas didokumentasikan oleh proyek. Node izin spesifik tidak tercantum dalam sumber yang digunakan di sini dan sebaiknya dilihat di dokumentasi plugin untuk node dan default yang tepat.

⚙️ Instalasi

📥 Penyiapan

• Unduh JAR plugin dari rilis proyek atau halaman resource plugin.
• Letakkan JAR di direktori plugins/ pada server Anda.
• Restart server.
• Edit file konfigurasi yang dibuat di plugins/TitleManager/ untuk menyesuaikan title, animasi, dan pengaturan daftar pemain.
• Gunakan /tm reload untuk menerapkan perubahan konfigurasi; plugin melakukan reload transaksional agar config yang rusak tidak diterapkan.

📦 Dependensi

• PlaceholderAPI (integrasi opsional untuk placeholder eksternal).
• Vault (opsional, digunakan untuk nilai placeholder jika tersedia).
• BungeeCord (perilaku yang memperhatikan integrasi saat digunakan dalam setup proxy).

Integrasi ini bersifat opsional dan digunakan saat tersedia; plugin tetap berjalan tanpa semuanya, tetapi dapat memakai datanya jika ada.

🧠 Catatan Teknis

• Target runtime resmi mencakup Minecraft 1.8 hingga 1.21.x (materi proyek merujuk dukungan eksplisit hingga 1.21.11). Perilaku berbeda menurut versi server: versi Minecraft yang lebih baru menggunakan API Bukkit/Paper modern, sedangkan versi lama bergantung pada modul kompatibilitas per versi.
• TitleManager menyediakan API kecil untuk Bukkit bagi integrasi opsional dan menyediakan dokumentasi API yang dihasilkan otomatis.
• Perintah safe reload dan diagnostics tersedia untuk membantu pemecahan masalah konfigurasi dan runtime.

🤝 Kapan Plugin Ini Berguna

Jika Anda ingin kontrol presentasi yang terpusat, dianimasikan, dan berbasis placeholder (titles, actionbar, tab-list, dan sidebar) yang dikelola dari konfigurasi alih-alih kode khusus, TitleManager menyediakan plugin dan API yang terdokumentasi untuk menampilkan elemen UI tersebut secara konsisten di seluruh lingkungan server Anda.