Minecraft eklentisi ajLeaderboards

🔌 ajLeaderboards hakkında

ajLeaderboards, sayısal bir değer döndüren herhangi bir PlaceholderAPI placeholder'ından sıralama tabloları oluşturmak için kullanılan bir Minecraft eklentisidir. Placeholder'ların bildirdiği değerleri toplar ve sıralar; sonuçları hologramlar, yerleşik tabelalar, NPC'ler, zırh standları ve oyuncu kafaları ile gösterebilir.

🎯 Amaç

Bu eklenti, özel entegrasyon gerektirmeden esnek ve eklentiler arası sıralama tabloları oluşturma sorununu çözer: sayısal bir PlaceholderAPI placeholder'ı sunan herhangi bir eklenti izlenebilir ve oyun içi gösterimlerde sunulabilir ya da diğer gösterim eklentileri için placeholder olarak kullanılabilir.

⚙️ Özellikler

• Herhangi bir sayısal PlaceholderAPI placeholder'ını sıralama girdisi olarak takip eder.
• Birden fazla gösterim seçeneği: hologramlar, yerleşik tabelalar, NPC'ler, zırh standları ve oyuncu kafaları.
• Otomatik sıfırlamalı zamanlı sıralamalar (saatlik, günlük, aylık vb.) ve tüm zamanlar istatistiklerini koruma.
• Takip edilen placeholder'ın da senkronize olması gereken sunucular arası sıralama senkronizasyonu için MySQL desteği.
• Vault entegrasyonu üzerinden oyuncu prefix/suffix bilgisini isteğe bağlı olarak gösterme.
• Sıralama girdileriyle birlikte ek placeholder metni göstermek için "Extra" placeholder'lar.
• Folia desteği ve yaygın gösterim eklentileriyle (ör. hologram ve NPC sistemleri) uyumluluk.
• bStats üzerinden anonim kullanım istatistikleri toplama (bStats ayarlarından devre dışı bırakılabilir).

🧩 Kimler İçin

• Bakiyeler, istatistikler veya özel metrikler için dinamik sıralamalar isteyen Survival ve SMP sunucuları.
• Zaten PlaceholderAPI kullanan ve oyun içinde sıralama göstermek isteyen sunucular (hologramlar, tabelalar, NPC'ler).
• Zamanlı sıralamalara (günlük/saatlik/aylık) ve isteğe bağlı MySQL senkronizasyonuna ihtiyaç duyan yöneticiler.

🏗️ Örnek Kullanım Alanları

• Bir ekonomi eklentisi placeholder'ı ve bir hologram eklentisi kullanarak en yüksek ekonomi bakiyelerini göstermek.
• En yüksek kill sayılarını veya özel mini oyun skorlarını NPC'lerde ya da tabelalarda göstermek.
• Etkinlik kazananları için saatlik veya günlük sıralamalar çalıştırırken tüm zamanlar kayıtlarını korumak.

⌨️ Komutlar

(Not: komut adları eklenti tarafından belgelenmiştir; sunucu operatörleri tam komut listesi ve sözdizimi için eklentinin wiki'sine bakmalıdır.)

🔐 İzinler

⚙️ Kurulum

📥 Ayarlama

• Resmi eklenti JAR dosyasını indirin ve sunucunuzun plugins/ klasörüne yerleştirin.
• Sunucuyu başlatmadan önce PlaceholderAPI'nin kurulu olduğundan emin olun; eklenti, izlenen değerleri okumak için PlaceholderAPI'ye ihtiyaç duyar.
• Sunucuyu başlatın veya yeniden başlatın ve eklentinin yüklendiğini doğrulamak için sunucu konsolunu kontrol edin.

📦 Bağımlılıklar

• PlaceholderAPI (gerekli)
• Vault (isteğe bağlı; prefix/suffix göstermek için kullanılır)
• Citizens (isteğe bağlı; NPC tabanlı sıralama gösterimleri için)
• DecentHolograms veya diğer hologram eklentileri (isteğe bağlı; hologram gösterimleri için)

🧠 Teknik Notlar

• Eklenti zamanlı sıralamaları (saatlik/günlük/aylık) destekler ve takip edilen placeholder değeri de senkronize edildiğinde sıralamaları senkronize etmek için MySQL kullanabilir.
• Folia desteği sunulur.
• Eklenti anonim ölçümleri bStats'a gönderir; bu, bStats yapılandırmasından devre dışı bırakılabilir.

🤝 Bu Eklenti Ne Zaman Faydalıdır

Zaten PlaceholderAPI kullanıyor ve sıralanmış sayısal verileri (ekonomi, istatistikler, özel metrikler) oyun içinde veya placeholder olarak kolayca, gösterimden bağımsız bir şekilde sunmak istiyorsanız, ajLeaderboards zamanlı sıralamalar, birden fazla gösterim seçeneği ve isteğe bağlı MySQL senkronizasyonu sağlar; eklenti başına özel entegrasyon gerektirmez.