Vault ve PlaceholderAPI Nedir, Nasıl Kurulur?

Vault ve PlaceholderAPI, bir Minecraft sunucusunda tek başlarına hiçbir görünür iş yapmayan ama neredeyse her ciddi eklentinin çalışması için zorunlu olan iki köprü eklentisidir. Kısa cevap şu: Vault ekonomi, izin ve sohbet verisini eklentiler arasında ortak bir dile çevirir; PlaceholderAPI (kısaca PAPI) ise bir eklentinin ürettiği bilgiyi %player_name%, %vault_eco_balance% gibi yer tutucular (placeholder) hâlinde başka bir eklentinin metin alanında kullanılabilir yapar.

Bu ikiliyi kurmadan mağaza eklentisi, iş (jobs) sistemi, TAB düzenleyici, hologram veya çoğu GUI menüsü çalışmaz — konsolda bağımlılık hatası verip hiç yüklenmezler. Bu sayfada 26.2 “Chaos Cubed” sunucularında hangi sürümü kurmanız gerektiğini, kurulumun adımlarını, yer tutucu listesini ve en sık karşılaşılan hataların birebir metinlerini bulacaksınız.

Eğer eklenti kurmanın temel mantığına henüz hâkim değilseniz önce Minecraft sunucusuna plugin kurulumu rehberini okuyun; buradaki adımlar jar dosyasını plugins klasörüne koyabildiğinizi varsayar.

Vault Ne İşe Yarar? Köprü Eklentisi Mantığı#

Bir mağaza eklentisi oyuncunun parasını okumak istediğinde iki yol vardır. Birincisi EssentialsX, CMI, XConomy gibi her ekonomi eklentisini tek tek desteklemek — bu, geliştirici için kâbustur. İkincisi tek bir ortak arayüzü çağırmaktır. İşte Vault bu ortak arayüzdür: bir soyutlama köprüsü.

Vault üç ayrı alanda köprü kurar:

Economy (ekonomi)

Bakiye okuma, para ekleme ve çıkarma. Sağlayıcı genellikle EssentialsX’tir.

Permission (izin)

Oyuncunun bir izne sahip olup olmadığını sorma. Sağlayıcı genellikle LuckPerms’tir.

Chat (sohbet)

Prefix ve suffix okuma. Yine izin eklentisinden gelir.

Bu yüzden Vault’un kendi komutu, kendi ayar dosyası veya kendi verisi neredeyse yoktur. Kurduğunuzda plugins/Vault klasörü oluşur ama içi büyük ölçüde boştur. Vault bir sonuç değil, altyapıdır.

2026’da Vault mı, VaultUnlocked mı Kurmalı?#

Bu, 26.x sunucularının en sık takıldığı noktadır. Orijinal Vault (MilkBowl) hâlâ ayakta ama gelişimi durmuş durumda: GitHub’daki son yayını 1.7.3 ve 17 Temmuz 2020 tarihli. SpigotMC kaynağında da aynı sürüm numarası duruyor. Vault saf API eklentisi olduğu ve NMS’e (sunucunun iç sınıflarına) hiç dokunmadığı için 26.2’de teknik olarak yüklenir — ama resmî destek listesinde 26.x yoktur.

Bunun yerine önerilen çözüm VaultUnlocked’dır. Modrinth’te “modern drop-in Vault fork” olarak tanımlanan bu çatallama, Vault’un API’sini birebir sağladığı için mevcut eklentileriniz hiçbir değişiklik yapmadan çalışmaya devam eder.

İndirmeniz Gereken Dosyalar#

Kurulum: Adım Adım#

1. Sunucuyu düzgün durdurun#

   Konsola stop yazın. Süreç bittikten sonra dosya işlemine geçin; sunucu açıkken jar kopyalamak yarım yüklenmiş eklenti hatalarına yol açar.

2. Jar dosyalarını plugins klasörüne kopyalayın#

   İki dosya da doğrudan plugins klasörünün içine gider, alt klasör açmayın. Web paneli kullanıyorsanız panelden plugin yükleme adımlarını izleyebilirsiniz.

   plugins/
   ├── VaultUnlocked-2.20.2.jar
   ├── PlaceholderAPI-2.12.3.jar
   ├── LuckPerms-Bukkit-5.5.71.jar
   └── EssentialsX.jar

3. Sunucuyu başlatın ve konsolu izleyin#

   Açılış sırasında her iki eklentinin de “Enabling” satırını görmelisiniz. Hata varsa satırı not alın; log okuma pratiği için sunucu loglarını okuma rehberi işinizi kolaylaştırır.

4. Yüklendiğini doğrulayın#

   Oyun içinde veya konsolda eklenti listesini çekin. Her iki isim de yeşil görünmelidir.

   /plugins
   # kısa hâli:
   /pl

5. Ekonomi sağlayıcısını doğrulayın#

   EssentialsX kuruluysa kendini otomatik olarak Vault’a kaydeder, ek ayar gerekmez. Bakiye komutunun çalıştığını görün.

   /balance
   /eco give Notch 500

PlaceholderAPI Nasıl Çalışır? eCloud ve Expansion Mantığı#

PlaceholderAPI’yi kurduğunuzda elinizde yalnızca motor olur; yer tutucuların çoğu henüz yoktur. Her veri kaynağı için ayrı bir expansion (genişletme) indirilir. Bunlar ayrı eklenti değildir; plugins/PlaceholderAPI/expansions/ klasörüne düşen küçük jar dosyalarıdır.

Expansion indirme işi eCloud üzerinden yapılır ve komutları şunlardır:

/papi ecloud download <expansion> [version]
/papi ecloud list <all|<author>|installed>
/papi ecloud info <expansion> [version]
/papi ecloud placeholders <expansion>
/papi ecloud refresh
/papi ecloud status
/papi ecloud clear
/papi ecloud enable
/papi ecloud disable
/papi reload
/papi list
/papi info <expansion>
/papi register <filename>
/papi unregister <filename>
/papi parse <player|me|--null> <text>

Pratikte tipik bir kurulum şöyle ilerler: önce /papi ecloud download Vault ile ekonomi genişletmesini indirir, sonra /papi reload ile devreye alırsınız. LuckPerms kendi yer tutucularını doğrudan kaydettiği için onun için ayrıca expansion indirmeniz gerekmez.

Yer Tutucuları Nerede Kullanabilirsiniz?#

PlaceholderAPI kurduktan sonra yer tutucular kendiliğinden hiçbir yerde belirmez; onları destekleyen bir eklentinin metin alanına elinizle yazmanız gerekir. Tipik kullanım yerleri şunlardır:

Örneğin bir sohbet eklentisinin biçim satırında şöyle bir kullanım görürsünüz. Buradaki her yüzde işaretli ifade, mesaj gönderildiği anda gerçek değeriyle değiştirilir:

format: '%luckperms_prefix%%player_name% &7» &f{message}'
tablist-suffix: ' &a$%vault_eco_balance_formatted%'

Bir yer tutucunun hangi eklentiden geldiğini bilmiyorsanız /papi list komutu kurulu tüm expansion’ları, /papi ecloud placeholders <expansion> ise o genişletmenin sağladığı yer tutucuların tam listesini basar. Yeni bir eklenti kurduğunuzda ilk yapacağınız iş bu iki komutla envanter çıkarmaktır.

En Çok Kullanılan Yer Tutucular#

Aşağıdaki liste, Vault expansion’ının sağladığı ekonomi yer tutucularıdır. Bunları TAB listesinde, scoreboard’da, hologramlarda ve sohbet biçiminde kullanabilirsiniz.

Bu yer tutucuların en yaygın kullanım yeri oyuncu listesi ve yan paneldir. TAB eklentisinin config dosyasında nasıl kullanıldığını TAB ve scoreboard düzenleme sayfasında adım adım bulabilirsiniz. Hologramlarda kullanmak isterseniz hologram ekleme rehberi aynı sözdizimini anlatır.

Sık Karşılaşılan Hatalar ve Birebir Çözümleri#

Unknown/missing dependency plugins#

Bir eklenti kendi plugin.yml dosyasında depend: [Vault] yazıyorsa ve Vault sunucuda yoksa Bukkit eklentiyi hiç yüklemez, şu istisnayı fırlatır:

org.bukkit.plugin.UnknownDependencyException
Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'AnnouncerPlus'

Aynı kalıp PlaceholderAPI, spark ve ProtocolLib gibi bağımlılıklar için de geçerlidir; köşeli parantez içindeki isim eksik olan eklentidir. Çözüm eksik jar’ı plugins klasörüne koyup tam yeniden başlatma yapmaktır — /reload bu durumu düzeltmez. Diğer yükleme hataları için “Could Not Load Plugin” hatası çözümü sayfasına bakın.

Failed to load expansion class#

Failed to load expansion class <expansion> ...

Bu satır iki şeyden birini söyler: ya expansion’ın getAuthor(), getIdentifier() veya getVersion() metotlarından biri null dönüyordur, ya da expansion’ın bağlı olduğu ana eklenti sunucuda kurulu değildir. Örneğin Vault expansion’ını indirdiniz ama Vault/VaultUnlocked yoksa bu hatayı alırsınız.

NoClassDefFoundError: com/google/gson/Gson#

java.lang.NoClassDefFoundError: com/google/gson/Gson

Sunucu sürümü PlaceholderAPI için fazla eski demektir; PAPI en az 1.8.8 ister. Bu hatayı 26.2 sunucusunda görmeniz beklenmez.

26.1 sonrası NMS kaynaklı çökmeler#

Vault ve PlaceholderAPI saf API eklentileri olduğu için bu riskin dışındadır. Buna karşılık Paper 26.2’nin Adventure 5 ile birlikte gelip eskiden kullanımdan kaldırılmış API’leri tamamen silmesi, güncellenmemiş üçüncü taraf eklentilerde aynı istisnaları tetikleyebilir. Sürüm geçişini planlarken sunucuyu yeni sürüme yükseltme rehberindeki test adımlarını uygulayın.

Hangi Eklentiler Bu İkiliyi İster?#

Aşağıdaki tablo, tipik bir survival veya skyblock sunucusunda kurulan eklentilerin hangi köprüye ihtiyaç duyduğunu gösterir.

Ekonomi tarafını sıfırdan kuracaksanız ekonomi sistemi kurma ve mağaza eklentisi kurma sayfaları bu köprüleri hazır kabul ederek devam eder. İzin tarafı için LuckPerms ile yetki sistemi kurma rehberi doğru sıralamayı gösterir: önce LuckPerms, sonra Vault, en son ekonomi eklentisi.

Donanım ve Barındırma Tarafı#

Vault ve PlaceholderAPI ölçülebilir bir RAM veya CPU yükü getirmez; asıl yük bu köprüleri kullanan eklentilerden gelir. Eklenti sayısı arttıkça açılış süresi ve heap tüketimi büyür, bu yüzden eklentili bir Paper sunucusunda alt sınırı 8 GB RAM olarak tutun ve heap’i şu şekilde ayarlayın:

java -Xms6G -Xmx6G -XX:+UseG1GC -jar paper.jar nogui

Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için çekirdek sayısı değil saat hızı belirleyicidir; bu yüzden Ryzen 9 7900X / 7950X sınıfı işlemciler ve NVMe SSD disk tercih edin. Batihost’un Minecraft sunucu paketleri 156 TL’den başlar ve tamamı Ryzen tabanlı NVMe diskli donanımda çalışır. Kaç GB ile başlamanız gerektiğini oyuncu sayısına göre RAM tablosundan hesaplayabilirsiniz.

Özetle#

Vault ve PlaceholderAPI, sunucunuzda görünmeyen ama her şeyi birbirine bağlayan iki parçadır. 26.2 sunucusunda kurmanız gereken sürümler nettir: VaultUnlocked 2.20.2 ve PlaceholderAPI 2.12.3. Kurulum sırası da bellidir — önce izin eklentisi, sonra köprüler, en son ekonomi ve mağaza eklentileri.

Yer tutucu ham metin olarak görünüyorsa ilk bakacağınız yer eksik expansion, eklenti hiç yüklenmiyorsa ilk bakacağınız yer Unknown/missing dependency plugins satırıdır. Bu iki refleksi edindiğinizde eklenti kurulumlarının büyük bölümünü kendiniz çözersiniz. Takıldığınız bir nokta olursa destek talebi açarak konsol çıktısını paylaşabilirsiniz.