Minecraft eklentisi TitleManager

🔌 TitleManager hakkında

TitleManager, Minecraft’ta oyunculara görünen sunum öğelerini yöneten bir eklentidir: animasyonlu orta ekran title ve subtitle’lar, actionbar’lar, animasyonlu tab-list başlık ve altlıkları ve yapılandırılabilir bir sidebar scoreboard. Daha özenli giriş mesajları, duyurular ve canlı tab/scoreboard gösterimleri isteyen sunucular için bir sunum katmanı olarak çalışır.

🎯 Amaç

Eklenti, görüntüleme özelliklerini (titles, actionbar’lar, tab-list, sidebars) merkezileştirir; böylece sunucu sahipleri özel kod yazmadan oyunculara tutarlı, animasyonlu ve placeholder tabanlı bilgiler sunabilir. Giriş/karşılama mesajlarını, dönen duyuruları ve dinamik bir TAB/scoreboard arayüzünü yönetmek isteyen sunucu yöneticileri için tasarlanmıştır.

⚙️ Özellikler

• Giriş ve ilk giriş için zamanlama seçenekleri ve varyantlarla yapılandırılabilir titles ve actionbar’lar.
• Çevrimiçi oyuncu sayıları, dünya/sunucu zamanı ve diğer dinamik değerler için placeholder’lar içeren, animasyonlu ve gradient destekli tab-list başlık ve altlıkları.
• Sunucunun scoreboard sistemi tarafından desteklenen, en fazla 15 animasyonlu satıra sahip yapılandırılabilir sidebar scoreboard.
• Title veya actionbar olarak iletilen yayınlar ve planlanmış duyurular.
• Yeniden kullanılabilir animasyon dosyaları ve önizlemeleri olan bir animasyon motoru (animation playground resmi dokümanlarda mevcut).
• Placeholder entegrasyonları (yerleşik TitleManager placeholder’ları ve mevcut olduğunda harici placeholder sistemleri için destek).
• İşlemsel yeniden yüklemeler: yapılandırma yeniden yüklemeleri güvenli şekilde uygulanır ve yeni yapı geçersizse geri alınabilir.
• İsteğe bağlı entegrasyonlar ve eklenti-ile-eklenti kullanımı için küçük bir geliştirici API’si.

🧩 Kimler için

• İyi hazırlanmış giriş/duyuru arayüzü isteyen Survival ve SMP sunucuları.
• Gösterimlerde dinamik değerler için placeholder’lar ve harici entegrasyonlar kullanan sunucular.
• Özel eklenti yazmadan animasyonlu tab ve scoreboard gösterimlerine ihtiyaç duyan yöneticiler.
• Sağlanan API üzerinden sunum özelliklerini başka eklentilere entegre etmek isteyen geliştiriciler.

🏗️ Kullanım örnekleri

• Oyuncular sunucuya girerken animasyonlu bir karşılama title’ı ve actionbar gösterin; ilk girişte farklı bir mesaj kullanın.
• Sunucu zamanını, çevrimiçi oyuncu sayısını ve gradient başlık/altlıkları göstererek tab oyuncu listesini canlı tutun.
• Etkinlikleri veya kuralları iletmek için animasyonlu duyuru title’larını veya actionbar’ları planlı şekilde döndürün.
• Sidebar scoreboard’u kullanarak lider tabloları, istatistikleri veya dinamik sunucu bilgilerini gösterin.

⌨️ Komutlar

Notlar: yukarıdaki komutlar proje tarafından belgelenmiştir. Burada kullanılan kaynaklarda belirli izin düğümleri listelenmemiştir; tam düğümler ve varsayılanlar için eklenti belgelerine bakılmalıdır.

⚙️ Kurulum

📥 Ayarlama

• Eklentinin JAR dosyasını projenin sürümünden veya eklenti kaynak sayfasından indirin.
• JAR dosyasını sunucunuzun plugins/ dizinine koyun.
• Sunucuyu yeniden başlatın.
• Title’ları, animasyonları ve oyuncu listesi ayarlarını düzenlemek için plugins/TitleManager/ altındaki oluşturulan yapılandırma dosyalarını düzenleyin.
• Yapılandırma değişikliklerini uygulamak için /tm reload kullanın; eklenti bozuk yapılandırmaların uygulanmasını önlemek için işlemsel yeniden yüklemeler yapar.

📦 Bağımlılıklar

• PlaceholderAPI (harici placeholder’lar için isteğe bağlı entegrasyon).
• Vault (isteğe bağlı, mevcut olduğunda placeholder değerleri için kullanılır).
• BungeeCord (proxy kurulumlarında kullanıldığında entegrasyon farkındalığı olan davranış).

Bu entegrasyonlar isteğe bağlıdır ve mevcut olduklarında kullanılır; eklenti onlar olmadan da çalışır, ancak kullanılabilir olduklarında verilerini kullanabilir.

🧠 Teknik Notlar

• Resmi çalışma zamanı hedefleri Minecraft 1.8 ile 1.21.x arasını kapsar (proje materyalleri 1.21.11’e kadar açık desteğe atıfta bulunur). Davranış sunucu sürümüne göre değişir: daha yeni Minecraft sürümleri modern Bukkit/Paper API’lerini kullanırken, eski sürümler sürüme özel uyumluluk modüllerine dayanır.
• TitleManager, isteğe bağlı entegrasyonlar için küçük bir Bukkit API’si yayınlar ve oluşturulmuş API belgeleri sağlar.
• Yapılandırma ve çalışma zamanı sorun gidermede yardımcı olmak için güvenli yeniden yükleme ve diagnostik komutları vardır.

🤝 Bu eklenti ne zaman kullanışlıdır

Özel kod yerine yapılandırmadan yönetilen, merkezileştirilmiş, animasyonlu ve placeholder tabanlı sunum kontrolleri (titles, actionbar’lar, tab-list ve sidebars) istiyorsanız, TitleManager bu UI öğelerini sunucu ortamınız genelinde tutarlı şekilde sunmak için belgeli bir eklenti ve API sağlar.