Vault Plugin: Minecraft Ekonomi ve Yetki Sistemlerinin Köprüsü
Minecraft sunucunuza ekonomi sistemi kurmak istiyorsanız Vault'u atlayamazsınız. Vault, ekonomi pluginleri, yetki pluginleri ve bu sistemleri kullanan diğer pluginler arasında standart bir API köprüsü sağlar. Vault olmadan EssentialsX Economy'nin bakiyesi ChestShop tarafından okunamaz; Vault olmadan LuckPerms'in yetki verileri başka pluginlere aktarılamaz. Bu rehberde Vault'un ne olduğunu, nasıl kurulduğunu ve nasıl yapılandırıldığını adım adım anlatıyorum.
Vault Nedir?
Vault bir ekonomi ya da yetki plugini değildir; o bir API katmanıdır. Şöyle düşünün: her ülkenin kendi elektrik prizi standardı vardır. Vault, bu fişlerin hepsinin takılabileceği bir adaptör gibidir. Ekonomi plugini Vault API'sini kullanarak bakiye sağlar; dükkan, ödül sistemi veya diğer pluginler Vault API'sini kullanarak bu bakiyeyi okur ya da değiştirir.
Vault'un iki temel işlevi vardır:
- Economy API: Ekonomi pluginleri (EssentialsX, GemsEconomy, CMI vb.) ve bu ekonomiyi kullanan pluginler arasında standart arayüz.
- Permissions API: Yetki pluginleri (LuckPerms, PermissionsEx) ve bu yetkileri sorgulayan pluginler arasında standart arayüz.
Neden Vault Gereklidir?
- EssentialsX Economy, CMI Economy, GemsEconomy — hepsi farklı pluginler. Vault olmadan ChestShop veya ShopGUIPlus hangi ekonomiyi kullandığınızı bilemez.
- WorldGuard, CoreProtect gibi yetki kontrolü yapan pluginler Vault Permissions API'sine bağlanır; bu sayede hangi yetki sistemini kullandığınızdan bağımsız çalışır.
- PlaceholderAPI'nin
%vault_eco_balance%placeholder'ı da Vault üzerinden çalışır.
Kurulum
Vault'un kurulumu son derece basittir:
- SpigotMC Vault sayfasından en güncel jar dosyasını indirin
plugins/klasörüne kopyalayın
- Sunucuyu başlatın veya yeniden başlatın
Vault'un herhangi bir yapılandırma dosyası yoktur; kurulumdan sonra ek ayar gerektirmez. Yalnızca diğer pluginlerin kullanabileceği şekilde arka planda çalışır.
Ekonomi Entegrasyonu
Vault kurulduktan sonra bir ekonomi plugini yüklemeniz gerekir. En yaygın seçenekler:
- EssentialsX Economy: EssentialsX paketi kuruluysa otomatik aktif olur; ek ayar gerekmez.
- GemsEconomy: Çoklu para birimi desteği sunan hafif ekonomi plugini.
- CMI Economy: CMI plugin paketi kuruluysa dahili ekonomi kullanılabilir.
Sunucu başlatıldığında Vault, aktif ekonomi pluginini otomatik algılar:
[Vault] Hooking into EssentialsX for Economy
Bu mesajı görüyorsanız entegrasyon başarılıdır.
Yetki (Permissions) Entegrasyonu
Vault, yetki sistemleri için de köprü görevi görür. LuckPerms Vault API'sine kayıt olur; diğer pluginler Vault üzerinden yetki kontrolü yapar. Entegrasyonu doğrulamak için:
/vault-info
Bu komut, ekonomi ve yetki sistemlerinin hangi plugin tarafından sağlandığını listeler:
Economy: EssentialsX
Permission: LuckPerms
Chat: LuckPerms
Sık Yapılan Hatalar ve Çözümleri
- "No economy plugin found" hatası: EssentialsX veya başka bir ekonomi plugini kurulu değil ya da yüklenmedi.
/vault-infoile kontrol edin.
- Vault sürümü eski: Eski Vault sürümleri bazı pluginlerle çalışmaz. SpigotMC'deki en güncel sürümü kullanın.
- PlaceholderAPI Vault expansion çalışmıyor: Vault yüklü olsa da PAPI Vault expansion ayrıca yüklenmelidir:
/papi ecloud download Vault && /papi reload.
- İki ekonomi plugini aynı anda aktif: Vault yalnızca biriyle entegre olabilir. Log'da hangisine bağlandığını görün; istenileni aktif edin.
Vault ile Birlikte Çalışan Yaygın Pluginler
- ChestShop, ShopGUIPlus — oyuncu dükkanları
- EssentialsX — /pay, /balance, /baltop komutları
- CMI — kapsamlı sunucu yönetim paketi
- Auction House — açık artırma sistemi
- Jobs Reborn — iş/kazanç sistemi
- FeatherBoard, TAB — bakiye scoreboard'da gösterimi
Sonuç
Vault, Minecraft plugin ekosisteminin görünmez ama vazgeçilmez altyapısıdır. Ekonomi veya yetki sistemi kuracaksanız Vault'u her zaman ilk yükleyin. Üstüne EssentialsX Economy ve LuckPerms eklendiğinde güçlü ve esnek bir temel elde edersiniz. Vault olmadan büyük çoğunluğu güçlü economy ve permission bağımlı plugin hiçbir zaman doğru çalışmaz.
💡 Etkileşim için giriş yap.