Selam, Şöyle bir durumla kesin karşılaşmışsınızdır: Scoreboard eklentisi kurdunuz, config'e %player_name% yazdınız, sunucuya girdiniz ve ekranda dümdüz "%player_name%" yazıyor. Ya da chat eklentisinde rütbe göstermek istiyorsunuz ama chatte kocaman bir %rank% yazısı duruyor.
Çoğu kişi "bu eklenti bozuk" deyip siler. Aslında sorun eklentide değil, eklentilerin birbiriyle konuşmasını sağlayan ortak dilde. O dilin adı PlaceholderAPI (PAPI).
Ne İş Yapar?
Sunucudaki her eklenti kendi başına çalışır. Ekonomi eklentisi oyuncunun parasını bilir ama bunu scoreboard'a söylemez. PlaceholderAPI bu eklentiler arasındaki çevirmendir.
%vault_eco_balance% yazdığınızda PAPI gidip ekonomi eklentisine "Bu oyuncunun kaç parası var?" diye sorar, cevabı alır ve yazdığınız yere yapıştırır. Tek bir formatla yüzlerce eklentiden veri çekip chat'e, menüye, hologram'a, tab listesine yazdırabilirsiniz.
Herkesin Düştüğü O Tuzak
PAPI'yi kurmak yetmiyor. Eklenti boş bir iskelet olarak gelir. Hangi eklentilerden veri çekeceğini Expansion yükleyerek öğretmeniz lazım.
Oyuncunun adını gösterecekseniz "Player" expansion'ını indirmeniz gerekir:
/papi ecloud download PlayerAma bitmedi. İndirmek yetmez, aktif etmeniz lazım:
/papi reloadBu adımı atlayan çok kişi var. Saatlerce "neden çalışmıyor" diye uğraşıyorlar, cevap bu kadar basit.
En Çok Kullanılan Kodlar
Player:
%player_name%oyuncunun adı%player_ping%anlık ping
Vault:
%vault_eco_balance_formatted%oyuncunun parası%vault_prefix%rütbe prefixi
Server:
%server_online%aktif oyuncu sayısı%server_tps_1%son 1 dakikalık TPS
LuckPerms:
Eğer yetki yönetimi için LuckPerms kullanıyorsanız, rütbe bilgisini çekmek için LuckPerms expansion'ını indirmelisiniz.
%luckperms_prefix%oyuncunun prefixi%luckperms_primary_group_name%ana grup adı
Sık Yapılan Hatalar
Ekranda boşluk çıkıyor: Vault veya ekonomi eklentiniz düzgün yüklenmemiş demektir. Eklentilerin sırayla yüklenip yüklenmediğini kontrol edin.
Kod düz metin olarak görünüyor: Ya expansion indirmediniz, ya reload atmadınız, ya da büyük/küçük harf hatası var. %Player_Name% çalışmaz, %player_name% olmalı.
Eklenti PAPI desteklemiyor: Bazı eski eklentiler PAPI'yi tanımaz. Config'de "PlaceholderAPI desteğini aç" ayarı varsa açın, yoksa PAPI destekleyen modern bir alternatife geçin.
Kısaca
Sunucu kuruyorsanız PlaceholderAPI ilk 3 eklentinizden biri olmalı. Menüleriniz, scoreboard'larınız, chat düzeniniz ve hologramlarınızın kalbi burada atıyor. Kurun, expansion'ları indirin, reload atın. Bu kadar basit ama bu kadar kritik.
PAPI kurarken sizi çileden çıkaran bir hata oldu mu? Yazın dertleşelim.