Minecraft Servers HQ

Minecraft eklentisi PlaceholderAPI

PlaceholderAPI ve bulunduğu sunucular hakkında bilgi

SpigotPaperAPIAdmin ToolsPermissionsUtilityChatIntegrationDeveloper API

🔌 PlaceholderAPI hakkında

PlaceholderAPI, merkezi bir placeholder sistemi ve bir genişletme ekosistemi (eCloud) sunan bir Minecraft eklentisidir. Diğer eklentilerin, doğrudan entegrasyon veya sıkı bağımlılıklar gerektirmeden binlerce dinamik placeholder’ı (oyuncu verileri, ekonomi değerleri, eklentiye özel değerler vb.) okumasına ve yerine koymasına olanak tanır.

🎯 Amaç

Bu eklenti, tek ve genişletilebilir bir placeholder API’si sunarak eklentiler arasındaki entegrasyon zorluklarını çözer. Eklenti yazarları, adlandırılmış placeholder’lar sağlayan genişletmeler yayınlar; sunucu yöneticileri bu genişletmeleri kurar, böylece sunucuya yönelik eklentiler (scoreboards, chat, holograms, GUIs) tutarlı bir sözdizimi kullanarak canlı verileri gösterebilir.

⚙️ Özellikler

  • Diğer eklentilerin bağlanabildiği temel placeholder ayrıştırma API’si.
  • Genişletme sistemi: tek başına paketlenmiş genişletmeler veya eklenti içinde paketlenen genişletmeler.
  • eCloud (genişletme bulutu), doğrulanmış genişletmeleri oyun içinde bulup indirmek için.
  • Genişletmeleri listelemek, kaydetmek, kaydını silmek ve yeniden yüklemek için çalışma zamanı yönetim komutları.
  • Bir oyuncu için placeholder’ları değerlendiren veya sonucu duyuran debug/parse komutları; sorun gidermede kullanışlıdır.
  • Destek isterken kurulu genişletmeleri ve eklenti durumunu paylaşmak için dump komutu gibi yardımcı araçlar.

🧩 Kimler için

  • Birden fazla eklenti arasında birleşik dinamik metne ihtiyaç duyan sunucu yöneticileri (scoreboards, tablists, holograms, GUIs).
  • Placeholder’ları sıkı bağımlılık zorlamadan sunmak veya kullanmak isteyen eklenti geliştiricileri.
  • Çok sayıda eklentiyi birleştiren ve tutarlı bir placeholder sözdizimine ihtiyaç duyan Survival, minigame ve network sunucuları.

🏗️ Örnek kullanım senaryoları

  • Bir sunucu, oyuncu bakiyesi gibi ekonomi placeholder’larının scoreboard ve chat eklentilerinde kullanılabilmesi için bir Vault genişletmesi kurar.
  • Bir yönetici, hologram eklentisinin canlı hedef verilerini gösterebilmesi için eCloud’dan eklentiye özel bir genişletme indirir.
  • Bir geliştirici, diğer sunucuların bu verileri eklentiye doğrudan bağımlı olmadan gösterebilmesi için plugin verilerini bir PlaceholderExpansion aracılığıyla sunar.

⌨️ Komutlar

KomutAçıklamaİzinErişim
`/papi parse <playerme> `Bir metin içindeki placeholder’ları ayrıştırır ve sonucu hata ayıklama için gösterir.belirtilmemiş
`/papi bcparse <playerme> `Placeholder’ları ayrıştırır ve sonucu tüm oyunculara duyurur.belirtilmemiş
`/papi cmdparse <playerme> `Placeholder’ları ayrıştırır ve ortaya çıkan komutu çalıştırır.belirtilmemiş
/papi parserel <player1> <player2> <text>İki oyuncuyu karşılaştıran ilişkisel placeholder’ları ayrıştırır.belirtilmemişYönetici
/papi listEtkin/kayıtlı genişletmeleri listeler.belirtilmemişYönetici
/papi info <expansion>Kayıtlı bir genişletme hakkında bilgi gösterir.belirtilmemişYönetici
/papi register <filename>Yeniden başlatmadan expansions klasöründeki bir genişletme jar dosyasını kaydeder.belirtilmemişYönetici
/papi unregister <filename>Kayıtlı bir genişletmenin kaydını siler/kaldırır.belirtilmemişYönetici
/papi reloadPlaceholderAPI yapılandırmasını yeniden yükler ve yeni indirilen genişletmeleri kaydeder.belirtilmemişYönetici
/papi versionEklenti sürümünü ve yazarları gösterir.belirtilmemişYönetici
/papi dumpDestek için eklenti/sürüm/genişletme bilgisi çıktılar (paste servisi).belirtilmemişYönetici
/papi ecloud download <expansion> [version]eCloud’dan doğrulanmış bir genişletmeyi sunucuya indirir.belirtilmemişYönetici
`/papi ecloud list [allinstalled]`eCloud’da bulunan genişletmeleri veya kurulu genişletmeleri listeler.
/papi ecloud placeholders <expansion>Bir eCloud genişletmesinin sağladığı placeholder’ları listeler.belirtilmemişYönetici
/papi ecloud statuseCloud hizmetinin bağlantı/durum bilgisini gösterir.belirtilmemişYönetici

(Not: Yukarıdaki komutlar resmi PlaceholderAPI komut referansında belgelenmiştir. Tek tek komutlar için izin düğümleri, referans verilen komut dokümantasyonunda listelenmemiştir.)

⚙️ Kurulum

📥 Kurulum

  • Resmi PlaceholderAPI jar dosyasını indirin ve sunucunuzun plugins/ dizinine yerleştirin.
  • Sunucuyu başlatın veya yeniden başlatın ve PlaceholderAPI’nin konsolda yüklendiğini doğrulayın.
  • Genişletmeleri, genişletme jar dosyalarını plugins/PlaceholderAPI/expansions/ içine bırakarak veya oyun içi eCloud komutlarını kullanarak kurun (doğrulanmış genişletmeler için).

📦 Bağımlılıklar

  • PlaceholderAPI’nin çalışması için genel bir eklenti bağımlılığı gerekmez. Genişletmelerin sağladığı bazı placeholder’lar başka eklentilere bağlıdır (örneğin, ekonomi değerlerini gösteren bir genişletme, ilgili ekonomi eklentisini gerektirir). Bu gereksinimler ilgili genişletmeye bağlıdır.

🧠 Teknik notlar

  • PlaceholderAPI, Spigot tabanlı sunucular için sağlanır ve Paper üzerinde de yaygın olarak kullanılır. Eklenti geliştiricilerinin PlaceholderExpansions kaydetmesi için bir API sunar.
  • Genişletmeler tek başına jar dosyaları olarak dağıtılabilir veya diğer eklentilerin içine dahil edilebilir; bağımsız genişletmeler genellikle plugins/PlaceholderAPI/expansions/ içine kurulur.
  • eCloud özelliği, doğrulanmış genişletmelerin oyun içinde keşfedilmesini ve indirilmesini sağlar; eCloud indirmelerinin çalışması için sunucuların çıkış HTTPS bağlantılarına izin vermesi gerekir.
  • Eklenti, yöneticilerin placeholder’ların doğru şekilde çözümlendiğini doğrulamasına yardımcı olan debug ve parsing komutları içerir.

🤝 Bu eklenti ne zaman faydalıdır

Sunucunuz dinamik, eklentiler arası veri göstermesi gereken birden fazla eklenti (chat, tab, holograms, scoreboards veya GUIs) kullanıyorsa, PlaceholderAPI faydalıdır; çünkü placeholder çözümlemesini merkezileştirir ve her tüketici eklentiyi değiştirmeden modüler genişletmeler aracılığıyla ek eklenti desteği eklemenize izin verir.

PlaceholderAPI eklentisine sahip sunucular

PlaceholderAPI eklenti sayfası, izleme sisteminin bu eklentiyi hangi sunucularda bulduğunu, hangi platformlar ve sürümlerle görüldüğünü gösterir.

Eklentiler komutlar, ekonomi, koruma, izinler, mini oyunlar, entegrasyonlar veya başka mekanikler ekleyebilir. PlaceholderAPI eklentisinin gerçek rolü belirli sunucunun yapılandırmasına bağlıdır.

Veriler sunucuların teknik yanıtlarından otomatik oluşturulur. Bir sunucu eklenti listesini gizliyorsa PlaceholderAPI kullansa bile bu bölümde görünmeyebilir.

Projeleri karşılaştırmak, uyumlu sürümleri kontrol etmek veya eklentinin herkese açık sunucularda nasıl kullanıldığına dair örnekler bulmak için PlaceholderAPI bulunan sunucu listesini kullanın.