PlaceholderAPI — Minecraft'ta dinamik veri yerleştirme eklentisi

PlaceholderAPI — Minecraft'ta dinamik veri yerleştirme eklentisi

• Makalenin test edildiği ve yazıldığı Minecraft sürümü: 26.1.2

• Desteklenen sürüm aralığı: 1.8.x – 26.1.x

PlaceholderAPI (kısaca PAPI), metindeki özel işaretleri dinamik değerlerle değiştiren bir Minecraft sunucu eklentisidir. Kendi başına hiçbir şey üretmez: bu, bir dizede %player_name% biçimindeki işareti bulup onu gerçek bir değerle — oyuncu adı, bakiye, rütbe, sunucudaki çevrimiçi sayısı gibi — değiştiren bir motordur. Verilerin kendisini ayrı modüller — eklentiler (expansion) — sağlar, PAPI ise yalnızca değiştirmeyi yapar. Bu sayede sohbet, skor tahtası, tab listesi ve menü eklentileri kendi söz dizimlerine gerek kalmadan değerleri aynı biçimde okuyabilir.

Placeholder biçimi

Placeholder, iki yüzde işareti arasına yazılır: %<розширення>_<параметр>%. Alt çizgiden önceki ilk kısım eklentinin adı, sonrası ise belirli parametredir. Örneğin, %player_name% oyuncu adını döndürür, %server_online% ise çevrimiçi oyuncu sayısını döndürür.

Değiştirme yalnızca bunu çağıran alıcı eklenti olduğunda çalışır. Bir eklenti PAPI'yi desteklemiyorsa, onun mesajlarındaki işaretler düz metin olarak kalır. Tek bir placeholder'ı ayrıştırma komutuyla kontrol edebilirsiniz:

/papi parse me %player_name%

Yanıt olarak değer yerine işaretin metni geri dönüyorsa, gereken eklenti mevcut değildir ya da kaynak eklenti devre dışı bırakılmıştır.

Eklentiler ve eCloud

PlaceholderAPI kutudan çıktığı haliyle hiçbir placeholder içermez — hepsi eklentilerden (expansion) gelir. Bazıları kaynak eklentinin içine gömülüdür ve sunucu başlatıldığında kendiliğinden kaydolur; diğerleri ise eklenti bulutunda (eCloud) ayrı jar dosyaları olarak bulunur ve /plugins/PlaceholderAPI/expansions/ klasörüne kurulur.

İhtiyaç duyulan eklenti doğrudan oyun içinden indirilebilir:

/papi ecloud download <розширення>

/papi reload

Bu komutla yalnızca doğrulanmış eklentiler indirilebilir — bu, zararlı koda karşı bir korumadır. Doğrulanmamış eklentiler elle kurulur: jar dosyası siteden indirilip eklenti klasörüne konur.

Komutlar

Tüm komutlar /papi ile başlar. Varsayılan olarak yalnızca operatörler kullanabilir; ayrı izinler placeholderapi.* düğümleri üzerinden verilir.

Yapılandırma

config.yml içinde düzenlemeye değer yalnızca birkaç parametre vardır:

Dosyadaki geri kalan değerler dahili amaçlıdır (eklenti koruması, Adventure bileşenlerinde değiştirme modu, hata ayıklama) ve varsayılan olarak dokunulmaz.

Sonuç

PlaceholderAPI, yüzlerce eklentinin anladığı tek bir veri değiştirme biçimi sunar: her eklenti için ayrı bir entegrasyon yerine, placeholder içeren tek bir satır yeterlidir. Sohbeti, tab listesini, skor tahtasını veya menüyü dinamik verilerle çalıştıran Minecraft sunucu yöneticileri için gereklidir; tek kişilik oyunda kullanım alanı yoktur.