Minecraft eklentisi DeluxeTags

🔌 DeluxeTags hakkında

DeluxeTags, Spigot için bir Minecraft eklentisidir ve oyuncuların oyun içi bir GUI veya komutlar kullanarak açıp değiştirebileceği izin tabanlı ek etiketler (prefixler) sağlar. Etiketler bir "ek prefix" olarak değerlendirilir ve placeholder'lar aracılığıyla sohbet, tab ve diğer sohbet entegrasyonlarında gösterilebilir.

🎯 Amaç

DeluxeTags, oyunculara rank/grup prefixlerinden ayrı, isteğe bağlı ve açılabilir kozmetik etiketler vermek sorununu çözer. Ana grup veya rank değiştirmeden oyuncuların etkinleştirebileceği ya da devre dışı bırakabileceği, satın alınabilir/açılabilir veya ödül olarak verilebilir etiketler isteyen sunucular için kullanışlıdır.

⚙️ Özellikler

• İzin tabanlı etiketler: deluxetags.tag.<identifier> ile erişim verin (yapılandırmada örnek: deluxetags.tag.example).
• Oyuncuların mevcut etiketleri gezip seçebilmesi için GUI.
• Etiketleri listeleme, seçme ve yönetme komutları (oyuncu ve admin komutları proje tarafından belgelenmiştir).
• PlaceholderAPI desteği ve aktif etiket, tanımlayıcı, açıklama ve sayıyı sohbet formatlarına eklemek için placeholder'lar.
• Eklenti yapılandırma örneğinde görülen, özelleştirilebilir GUI öğeleri, adlar ve sayfalama ayarları.
• Oyuncunun etiketini girişte yükleme, sohbet biçimlendirme entegrasyonu ve güncelleme kontrolü seçenekleri.

🧩 Kimler için

• Rank prefixlerinden ayrı, kozmetik ve açılabilir sohbet etiketleri isteyen Survival / SMP sunucuları.
• Kozmetik ödüller vermek için izin eklentileri kullanan sunucular (örneğin LuckPerms üzerinden).
• Oyuncular için basit, GUI tabanlı bir etiket seçici isteyen yöneticiler.

🏗️ Örnek kullanım senaryoları

• Bir oyuncuya VIP etiketi iznini satın alınabilir bir kozmetik olarak vermek ve bunu etiket GUI'si üzerinden açıp kapatmasına izin vermek.
• Bir etkinlik ödülü, belirli bir etiket izni vererek kazananların mevcut etiketlerinden yeni etiketi seçmesini sağlar.
• Yöneticiler komutlarla özel etiketler oluşturur ve hangi oyuncuların bunları kullanabileceğini izinlerle belirler.

⌨️ Komutlar

Not: Proje dokümantasyonu bu komutları doğrular; komutlara özel izin düğümleri (etiket başına düğüm kalıbı dışında) ana kaynakta listelenmemiştir.

🔐 İzinler

Eklenti, etiket başına izin düğümleri kullanır; diğer komutlara özgü düğümler mevcut ana proje dosyalarında açıkça belgelenmemiştir.

⚙️ Kurulum

📥 Kurulum

• Eklentinin JAR dosyasını projenin Spigot kaynağından veya resmi build çıktılarından indirin.
• JAR dosyasını sunucunuzun plugins/ klasörüne koyun.
• Sunucuyu başlatın veya yeniden başlatın ve eklentinin yüklendiğini doğrulamak için konsolu kontrol edin.

📦 Bağımlılıklar

• PlaceholderAPI — desteklenir (eklenti placeholder'lar ve bir papi_chat seçeneği içerir), yapılandırmada ve placeholder örneklerinde listelenmiştir.

🧾 Yapılandırma

• DeluxeTags, etiketleri, GUI ayarlarını ve mesajları tanımlayan bir YAML yapılandırması kullanır. Yapılandırma; etiket girdileri, GUI öğe ayarları, placeholder'lar ve sohbet biçimi seçenekleri için örnekler içerir. Yapılandırmada sık görülen anahtarlar: deluxetags:, gui:, format_chat, papi_chat, load_tag_on_join.

🧠 Teknik Notlar

• Projenin kaynak kodu herkese açık bir GitHub deposunda mevcuttur.
• Spigot projesi, 1.8 ile 1.21 arasındaki test edilmiş Minecraft sürümlerini listeler ve test edilen sürümler listesinde özel bir 1.20.6 girdisi içerir.
• Geliştirme buildleri ve CI çıktıları projenin CI sunucusu tarafından sağlanır.
• Depoda kaynak host üzerinde yayımlanmış sürümler görünmez; CI çıktıları ayrı olarak kullanılabilir.

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

Oyuncuların rank gruplarını değiştirmeden GUI veya komutlarla etkinleştirebilecekleri, isteğe bağlı ve izin tabanlı kozmetik etiketlere sahip olmasını istiyorsanız DeluxeTags, sohbet gösterimi için PlaceholderAPI entegrasyonuna sahip, basit ve yapılandırılabilir bir çözüm sunar.