PlaceholderAPI: Minecraft Sunucularının Vazgeçilmez Entegrasyon Aracı
Minecraft sunucusundaki pluginlerin birbiriyle veri paylaşmasını sağlayan PlaceholderAPI (kısaca PAPI), modern sunucu yönetiminin temel taşlarından biridir. Oyuncunun para miktarını TAB listesinde göstermek, oyun içi unvanını sohbet mesajlarında kullanmak, öldürme sayısını scoreboard'da sergilemek, online oyuncu sayısını NPC diyaloğunda belirtmek — tüm bunlar PlaceholderAPI olmadan ya imkânsızdır ya da aşırı karmaşık hale gelir. Bu rehberde PAPI'yi nasıl kuracağınızı, genişleteceğinizi ve doğru kullanacağınızı anlatıyorum.
PlaceholderAPI Nasıl Çalışır?
PAPI bir "aracı" görevi görür. Ekonomi, yetki, istatistik gibi verilere sahip pluginler PlaceholderAPI'ye kendi verilerini sağlayan "expansion" (genişleme) kaydeder. Diğer pluginler ise bu verilere
%placeholder% formatında ulaşır. Örneğin:%vault_eco_balance%→ oyuncunun Vault ekonomisindeki bakiyesi
%luckperms_prefix%→ LuckPerms'teki unvan öneki
%player_ping%→ oyuncunun sunucuya olan ping değeri
%server_online%→ anlık online oyuncu sayısı
Bu veri akışı, pek çok plugin arasında karmaşık entegrasyonlar gerektirmeden sorunsuzca gerçekleşir. PAPI, pluginlerin ortak dilini konuştuğu standart bir arayüzdür.
Kurulum
SpigotMC veya Modrinth'ten PlaceholderAPI jar dosyasını indirin,
plugins/ klasörüne kopyalayın ve sunucuyu başlatın. Kurulum tamamlandığında plugins/PlaceholderAPI/ klasörü oluşur ve temel yapılandırma hazır olur.Sunucu başlatıldıktan sonra log'da şu satırı görmelisiniz:
[PlaceholderAPI] Successfully registered expansion: player
[PlaceholderAPI] PlaceholderAPI v2.x.x has been successfully loaded!
Expansion Yükleme — eCloud
PAPI bazı placeholder'ları varsayılan olarak içermez; bunları "expansion" olarak ayrı yüklemeniz gerekir. En pratik yol oyun içi komuttur:
/papi ecloud download Vault
/papi ecloud download LuckPerms
/papi ecloud download Player
/papi ecloud download Server
/papi reload
Mevcut tüm expansion'ları listelemek için:
/papi ecloud list all
İnternet erişimi olmayan sunucularda expansion jar dosyasını
plugins/PlaceholderAPI/expansions/ klasörüne manuel olarak kopyalayabilirsiniz.Placeholder Test Etme
Bir placeholder'ın çalışıp çalışmadığını test etmek için:
/papi parse KullanıcıAdı %vault_eco_balance%
/papi parse KullanıcıAdı %player_ping%
Bu komut, belirtilen oyuncunun bakiyesini veya ping değerini size gösterir. Eğer çıktı olarak yine
%vault_eco_balance% geliyorsa (işlenmemiş hâlde dönüyorsa), Vault expansion yüklenmemiş demektir.Hangi Pluginler PAPI Kullanır?
Neredeyse tüm popüler Minecraft pluginleri PlaceholderAPI desteği sunar:
- TAB: Oyuncu listesi ve isim üstü bilgiler; PAPI verisi ile oyuncu bilgisi gösterilir.
- EssentialsXChat: Sohbet formatı özelleştirme; önekleri ve bakiyeyi sohbette göstermek için kullanılır.
- FeatherBoard / FastBoard: Scoreboard gösterimi; her satır bir placeholder olabilir.
- DeluxeMenus: Oyun içi GUI menüleri; butonlarda dinamik veri gösterme.
- Citizens: NPC diyaloğu; oyuncuya özel bilgiler sunar.
Bu pluginlerin config dosyalarında
%placeholder% formatında yer tutucular kullanabilirsiniz.En Kullanışlı Yerleşik Placeholder'lar
%player_name%— Oyuncu adı
%player_health%— Anlık can miktarı
%player_level%— XP seviyesi
%player_world%— Bulunduğu dünya adı
%player_ping%— Ping değeri (ms)
%server_online%— Online oyuncu sayısı
%server_max_players%— Maksimum kapasite
Sık Yapılan Hatalar
- Expansion yüklemeden placeholder kullanmak:
%vault_eco_balance%görmek için Vault expansion ayrıca yüklenmelidir.
- /papi reload yapmayı unutmak: Yeni expansion yükledikten sonra mutlaka reload yapın.
- Büyük/küçük harf duyarlılığı: Placeholder adları genellikle küçük harftir;
%Vault_Eco_Balance%çalışmaz.
- Expansion sürümü eski: eCloud'dan expansion'ı güncel tutun; eski sürümler yeni placeholder eklentilerini desteklemeyebilir.
Sonuç
PlaceholderAPI, Minecraft sunucusundaki tüm pluginlerin aynı dili konuşmasını sağlayan güçlü bir altyapıdır. Kurulduktan sonra sunucunuzu özelleştirme olanakları inanılmaz ölçüde genişler. İlk adım olarak Vault, LuckPerms ve Player expansion'larını yükleyin; sonra hangi veriye nereden ulaşmak istediğinizi keşfetmeye başlayın.
💡 Etkileşim için giriş yap.