Minecraft eklentisi PlaceholderAPI

🔌 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

(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.