🌐 PlaceholderAPI Nedir? Kurulum, Komutlar, Yetkiler ve Placeholder Detaylı Kullanımı

PlaceholderAPI Nedir?

PlaceholderAPI, Minecraft sunucularında farklı eklentilerden alınan oyuncu ve sunucu verilerini ortak bir placeholder sistemi üzerinden kullanmanızı sağlayan ücretsiz bir eklentidir.

Oyuncu adı, bakiye, rütbe, ping, dünya bilgisi, TPS, çevrim içi oyuncu sayısı gibi verileri TAB, Scoreboard, Hologram, DeluxeMenus, Sohbet ve birçok farklı eklenti içerisinde dinamik olarak gösterebilirsiniz.

PlaceholderAPI tek başına bir scoreboard veya TAB oluşturmaz. Görevi, diğer eklentilerden aldığı verileri %placeholder% formatına dönüştürerek destekleyen eklentilerde kullanılmasını sağlamaktır.

Örneğin;
<span>%player_name%</span>
placeholderı oyuncunun gerçek kullanıcı adını gösterir.

---

PlaceholderAPI Ne İşe Yarar?​

PlaceholderAPI sayesinde;

• Oyuncu adı, ping ve dünya bilgisi gösterilebilir.
• Oyuncuların bakiye ve rütbeleri görüntülenebilir.
• Scoreboard ve TAB listeleri dinamik hale getirilebilir.
• Hologramlarda canlı sunucu bilgileri gösterilebilir.
• Menü sistemlerinde oyuncuya özel bilgiler kullanılabilir.
• Sohbet mesajlarına prefix ve suffix eklenebilir.
• TPS, RAM ve oyuncu sayısı gibi sunucu verileri görüntülenebilir.

Kurulumu​

Kurulum işlemi oldukça basittir.

1. PlaceholderAPI'nin güncel sürümünü indirin.
2. Dosyayı plugins klasörüne yükleyin.
3. Sunucunuzu yeniden başlatın.
4. Gerekli Expansion paketlerini yükleyin.
5. Son olarak aşağıdaki komutu çalıştırın.

/papi reload

PlaceholderAPI varsayılan olarak tüm placeholderları içermez. Kullanacağınız verilere göre gerekli Expansion paketlerini ayrıca yüklemeniz gerekir.

Genişletmek için tıklayın...

---

Expansion Nedir?​

Expansion, PlaceholderAPI'ye yeni placeholderlar ekleyen küçük modüllerdir.

En çok kullanılan Expansionlar:

• Player
• Server
• Vault
• LuckPerms

Kurulum örneği:

/papi ecloud download Player
/papi ecloud download Server
/papi ecloud download Vault
/papi ecloud download LuckPerms

Kurulum tamamlandıktan sonra:

/papi reload

Kurulu Expansionları görmek için:

/papi list

---

En Çok Kullanılan Placeholderlar​

​

Oyuncu Bilgileri​

%player_name%
%player_uuid%
%player_ping%
%player_world%
%player_level%
%player_health%

Sunucu Bilgileri​

%server_online%
%server_max_players%
%server_tps%
%server_ram_used%
%server_version%

Vault Bilgileri​

%vault_eco_balance%
%vault_eco_balance_formatted%
%vault_group%<br>%vault_prefix%
%vault_suffix%

---

PlaceholderAPI Komutları​

Temel Komutlar​

/papi help
/papi version
/papi reload
/papi list
/papi info

Placeholder Testi
​

Bir placeholderın çalışıp çalışmadığını test etmek için:

/papi parse me %player_name%

Bakiye bilgisini test etmek için:

/papi parse me %vault_eco_balance_formatted%

Sunucudaki oyuncu sayısını test etmek için:

/papi parse me %server_online%

---

eCloud Komutları​

/papi ecloud list all
/papi ecloud list installed
/papi ecloud download
/papi ecloud info
/papi ecloud placeholders
/papi ecloud refresh

---

Yetkiler​

En çok kullanılan izinler şunlardır:

placeholderapi.*
placeholderapi.admin
placeholderapi.reload
placeholderapi.parse
placeholderapi.list
placeholderapi.version
placeholderapi.ecloud.*

---

Desteklediği Eklentiler​

PlaceholderAPI birçok popüler Minecraft eklentisi ile uyumludur.

• LuckPerms
• Vault
• EssentialsX
• TAB
• DeluxeMenus
• DecentHolograms
• HolographicDisplays
• Citizens
• VotingPlugin
• Towny
• Factions
• SkyBlock eklentileri

---

Placeholder Çalışmıyorsa​

Sorunu çözmek için aşağıdaki adımları kontrol edin.

• Gerekli Expansion kurulu mu?
• Placeholder doğru yazılmış mı?
• Kullandığınız eklenti PlaceholderAPI desteğine sahip mi?
• Placeholder aşağıdaki komutla test edildi mi?

/papi parse me %player_name%

Ardından:

/papi reload

komutunu çalıştırın.

---

Performans​

PlaceholderAPI tek başına sunucuya ciddi bir yük oluşturmaz.

Ancak;

• Sürekli güncellenen liderlik tabloları
• Veritabanından veri çeken Expansionlar
• Her tick yenilenen placeholderlar

gereksiz yere sık yenilenirse performansı olumsuz etkileyebilir.

Önerilen yenileme süreleri:

• Ping: 1-2 saniye
• Bakiye: 2-5 saniye
• Liderlik tabloları: 30-300 saniye
• Az değişen bilgiler: 60 saniye ve üzeri

---

Sık Sorulan Sorular​

PlaceholderAPI ücretsiz mi?​

Evet. Tamamen ücretsiz olarak kullanılabilir.

Tek başına çalışır mı?​

Çalışır ancak ekonomi, yetki veya sunucu bilgileri gibi veriler için gerekli Expansion paketlerinin kurulması gerekir.

Hangi sunucu yazılımlarını destekler?​

• Paper
• Spigot
• Purpur
• Bukkit tabanlı diğer sunucular

Placeholder nasıl test edilir?​

/papi parse me %placeholder%

Örneğin:

/papi parse me %server_online%

Sonuç​

PlaceholderAPI, Minecraft sunucularında en yaygın kullanılan altyapı eklentilerinden biridir. Farklı eklentilerden aldığı oyuncu ve sunucu verilerini ortak bir placeholder sistemi üzerinden kullanmanıza olanak tanır. TAB, Scoreboard, Hologram, Sohbet ve Menü sistemlerinde dinamik bilgiler göstermek isteyen sunucular için vazgeçilmez bir çözümdür. Kurulum sonrasında yalnızca ihtiyaç duyduğunuz Expansion paketlerini yükleyerek yüzlerce farklı placeholderı kolayca kullanabilirsiniz.

Döktürmüşsün