EssentialsX Kurulumu ve Yapılandırması

EssentialsX kurulumu, Paper veya Spigot tabanlı bir Minecraft sunucusunda yapılan ilk işlerden biridir ve pratikte tek adımdan oluşur: EssentialsX.jar dosyasını sunucunun plugins klasörüne kopyalar, sunucuyu yeniden başlatır ve oluşan plugins/Essentials/config.yml dosyasını kendi sunucunuza göre düzenlersiniz. İlk başlatmadan sonra /spawn, /home, /warp, /tpa, /kit, /msg ve ekonomi komutları anında çalışır durumda olur.

EssentialsX, Minecraft sunucularının fiilî standart yönetim eklentisidir. Işınlanma, ev noktaları, kit dağıtımı, özel mesajlaşma, AFK takibi, ban/mute araçları ve dahili bir ekonomi sistemi tek pakette gelir. Bu yüzden 2026 sunucu eklenti listesinin en üstünde durur ve neredeyse her rehber onu ilk kurulacak eklenti olarak gösterir.

Buna karşılık EssentialsX’in yapmadığı iki iş vardır: grup/izin yönetimi ve bölge koruma. Rank sistemi, prefix ve izin dağıtımı için LuckPerms, arazi ve spawn koruması için WorldGuard kurmanız gerekir. Bu üçlü birlikte çalışacak şekilde tasarlanmıştır.

EssentialsX Modülleri: Hangi Jar Dosyası Ne İşe Yarar?#

EssentialsX tek bir dosya değil, bir modül ailesidir. İndirdiğiniz arşivin içinden çıkan jar dosyalarının hepsini yüklemek zorunda değilsiniz; ihtiyacınız olmayan modülü kurmazsanız RAM ve başlatma süresi de boşa harcanmaz.

Sürüm Uyumluluğu: 26.2 Sunucularında Dikkat Edilmesi Gerekenler#

Minecraft 26.1 “Tiny Takeover” ile birlikte Mojang obfuscated sunucu jar’ı yayınlamayı bıraktı. Bu, basit bir sürüm atlaması değil bir ABI kırılmasıdır: 1.21.11 ve öncesi için derlenmiş, NMS kullanan hiçbir eklenti yeniden derlenmeden 26.1 ve sonrasında çalışmaz. EssentialsX de bu geçişi yaptı, ama kararlı yapının desteklediği en yüksek sürüm hâlâ 26.1.2 görünüyor.

Hangi Java sürümünü kuracağınızdan emin değilseniz Minecraft sunucusu için hangi Java sürümü gerekir sayfasındaki tabloyu kullanın. 26.x sunucularında Java 25 LTS zorunludur; Java 26 çıkmış olsa da LTS olmadığı için üretim sunucusunda önerilmez.

İndirmeniz Gereken Dosyalar#

EssentialsX Kurulumu: Adım Adım#

1. Sunucu yazılımının eklenti destekli olduğundan emin olun#

   EssentialsX bir Bukkit API eklentisidir; yalnızca Paper, Purpur veya Spigot üzerinde çalışır. Mojang’ın resmî server.jar dosyasında ya da saf Forge/Fabric kurulumunda çalışmaz. Henüz eklenti destekli bir sunucunuz yoksa önce Paper sunucu kurulumu adımlarını tamamlayın.

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

   İndirdiğiniz arşivden çıkan EssentialsX.jar ve kullanacağınız modülleri sunucu kök dizinindeki plugins klasörüne kopyalayın. Panelli sunucularda dosya yöneticisini, kendi sunucunuzda SFTP istemcisini kullanabilirsiniz. Yükleme yöntemi için Minecraft sunucusuna plugin kurulumu rehberine bakın.

3. Vault ve LuckPerms’i aynı anda ekleyin#

   Vault’u sonradan eklerseniz ekonomi kaydı ilk açılışta boş oluşturulur ve bazı eklentiler bakiyeyi bulamaz. En temizi üç jar’ı birlikte yükleyip sunucuyu bir kez başlatmaktır.

4. Sunucuyu yeniden başlatın#

   Konsolda /reload kullanmayın; EssentialsX gibi çok modüllü eklentilerde bu komut bellek sızıntısına ve yarım yüklenmiş komut kayıtlarına yol açar. Doğru yöntem konsola stop yazıp süreci düzgün kapatmak ve başlatma betiğini yeniden çalıştırmaktır.

   stop

5. Yüklemeyi doğrulayın#

   Sunucu açıldıktan sonra konsolda plugins komutunu çalıştırın. EssentialsX ve modülleri yeşil renkte listeleniyorsa kurulum tamamdır. Kırmızı görünen bir modül varsa logs/latest.log dosyasının son 50 satırını okuyun; sebep neredeyse her zaman sürüm uyumsuzluğudur.

   plugins

config.yml İçinde İlk Ayarlanacak Satırlar#

Varsayılan yapılandırma çalışır durumdadır ama Türk sunucuları için birkaç satır neredeyse her zaman değiştirilir. Aşağıdaki blok, plugins/Essentials/config.yml içinde arayıp güncellemeniz gereken temel anahtarları gösterir.

# Dil ve isim ayarları
locale: tr
ops-name-color: 'c'
change-displayname: true
nickname-prefix: '~'
max-nick-length: 15

# Işınlanma davranışı
teleport-delay: 3
teleport-cooldown: 10
teleport-invulnerability: 4
teleport-safety: true

# Ev noktaları
spawn-if-no-home: true
sethome-multiple:
  default: 1
  vip: 3
  yetkili: 10

teleport-delay ışınlanma öncesi bekleme süresidir; PvP sunucularında kaçış suistimalini engellediği için 3-5 saniye arası verilir. sethome-multiple altındaki her satır bir izin adına karşılık gelir: vip: 3 yazdığınızda LuckPerms tarafında gruba essentials.sethome.multiple.vip iznini vermeniz gerekir, yoksa oyuncu default limitinde kalır.

Spawn ve ilk giriş davranışı#

EssentialsXSpawn kuruluysa oyun içinde durduğunuz noktada /setspawn yazarak spawn belirlersiniz. Yeni oyuncuların doğrudan spawn’a düşmesi için:

newbies:
  announce-format: '&6Sunucuya hoş geldin, {DISPLAYNAME}&6!'
  spawnpoint: newbies
  kit: baslangic

Bu blok yeni oyuncuya baslangic kitini otomatik verir ve newbies spawn noktasına ışınlar. Sunucunun genel karşılama metnini server.properties içindeki motd satırından ayarlarsınız; ayrıntısı server.properties ayarları sayfasında.

Ekonomi Sistemi ve Vault Entegrasyonu#

EssentialsX kendi ekonomi motorunu getirir; ayrı bir ekonomi eklentisi kurmanıza gerek yoktur. Ancak dükkân, iş, arazi satışı gibi eklentilerin bu bakiyeyi okuyabilmesi için araya Vault girer. Vault 1.7.3 sürümü 26.2 ile uyumludur ve Essentials ekonomi uygulamasındaki bir yarış durumunu da düzeltir.

currency-symbol: 'TL'
currency-symbol-suffix: true
starting-balance: 500
min-money: -5000
max-money: 10000000000000
economy-log-enabled: true

currency-symbol-suffix: true değeri para birimini rakamın sonuna koyar, yani 500 TL yazar. economy-log-enabled açıkken tüm para hareketleri plugins/Essentials/economy.txt dosyasına işlenir; şüpheli para transferlerini incelerken bu kayıt hayat kurtarır.

Yönetici olarak para dağıtmak için konsoldan veya oyun içinden şu komutları kullanırsınız:

/eco give Oyuncu 1000
/eco take Oyuncu 250
/eco set Oyuncu 0
/eco reset Oyuncu
/baltop

Kit Oluşturma ve Warp Yönetimi#

Kitler EssentialsX 2.16 sürümünden beri ayrı bir dosyada, plugins/Essentials/kits.yml içinde tutulur. Girinti YAML kurallarına uymak zorundadır; sekme karakteri değil boşluk kullanın.

kits:
  baslangic:
    delay: 86400
    items:
      - stone_sword 1
      - stone_pickaxe 1
      - cooked_beef 16
      - oak_log 32
  vip:
    delay: 43200
    items:
      - diamond_sword 1 unbreaking:3
      - golden_apple 4
      - ender_pearl 8

delay saniye cinsinden bekleme süresidir; 86400 günde bir kit anlamına gelir. Bir kitin kullanılabilmesi için oyuncunun essentials.kits.baslangic iznine sahip olması gerekir. Kit adları küçük harf ve Türkçe karaktersiz olmalıdır, aksi hâlde komut satırında eşleşme sorunu çıkar.

Warp noktaları ise oyun içinden yönetilir. Gitmek istediğiniz yerde durup /setwarp maden yazarsınız; nokta plugins/Essentials/warps/maden.yml dosyasına kaydedilir. Her warp kendi iznini ister: essentials.warp.maden. Tüm warp’lara toplu erişim için essentials.warps.* verilebilir ama bu, gizli yönetici warp’larını da açar; dikkatli kullanın.

Türkçe Mesaj Dosyası Nasıl Düzenlenir?#

config.yml içinde locale: tr yazmak arayüz mesajlarının çoğunu Türkçeye çevirir. Metinleri kendi sunucunuzun tonuna göre değiştirmek isterseniz plugins/Essentials klasöründe messages_tr.properties adında bir dosya oluşturun ve yalnızca değiştireceğiniz satırları yazın. Dosyada bulunmayan satırlar varsayılan çeviriden okunur.

homeSet=§6Ev noktanız kaydedildi.
teleporting=§6Işınlanılıyor...
noPerm=§4Bunun için §c{0}§4 iznine sahip değilsin.
kitReceive=§6{0} §6kitini aldın.

İzinler ve LuckPerms ile Birlikte Kullanım#

EssentialsX kurulduğunda komutların büyük kısmı yalnızca OP oyunculara açıktır. Normal oyuncuların /home veya /tpa kullanabilmesi için izin vermeniz gerekir. Bu iş bir izin eklentisi olmadan yapılamaz.

İzinleri LuckPerms üzerinden vermek için konsolda şu komutları çalıştırabilirsiniz:

/lp group default permission set essentials.home true
/lp group default permission set essentials.tpa true
/lp group vip permission set essentials.sethome.multiple.vip true
/lp group yetkili permission set essentials.ban true

Yalnızca birkaç kişiye tam yetki vermek istiyorsanız OP kullanımı da bir seçenektir, ama grup mantığı kurmak her zaman daha güvenlidir. İki yaklaşımın farkı OP verme ve yetki yönetimi sayfasında karşılaştırılıyor.

Sohbet biçimi ve prefix#

Prefix EssentialsX’ten değil izin eklentisinden gelir. EssentialsXChat ve Vault kuruluyken config.yml içindeki chat bölümüne yer tutucuları eklemeniz yeterlidir:

chat:
  radius: 0
  format: '{PREFIX}&f{DISPLAYNAME}{SUFFIX}&7: &f{MESSAGE}'
  group-formats:
    yetkili: '&4[Yetkili] &c{DISPLAYNAME}&7: &f{MESSAGE}'

radius: 0 tüm sunucuda global sohbet demektir; rol yapma sunucularında 100 gibi bir değer verip yerel sohbet kurabilirsiniz.

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

“Essentials found a problem: Vault”#

Vault kurulu değil ya da eski bir sürümü yüklü. Vault 1.7.3’ü plugins klasörüne atıp sunucuyu yeniden başlatın. Vault tek başına hiçbir şey yapmaz, yalnızca köprü görevi görür.

Komutlar başka bir eklentiyle çakışıyor#

İki eklenti aynı komutu kaydettiğinde Bukkit birine öncelik verir. Sorunu kesin çözmek için komutu tam adıyla çağırın: /essentials:home. Kalıcı çözüm sunucu kök dizinindeki commands.yml dosyasına takma ad tanımlamaktır.

Konsolda “Unsupported API version” yazıyor#

Eklenti sunucu sürümünden eski. 26.x sunucularında bu hata neredeyse her zaman 1.21.x için derlenmiş bir jar’dan kaynaklanır. Doğru yapıyı indirin; ayrıntılı tanı için Minecraft sunucu hataları ve çözümleri sayfasına bakın.

Ayar değişikliği uygulanmıyor#

YAML girintisi bozulduğunda EssentialsX dosyayı sessizce yok sayıp varsayılanlara döner. Kaydetmeden önce dosyayı bir YAML doğrulayıcıdan geçirin ve sekme karakteri kullanmadığınızdan emin olun. Değişiklikten sonra /essentials reload yazın.

Donanım Notu: EssentialsX’li Bir Sunucu Ne Kadar RAM İster?#

EssentialsX’in kendisi hafiftir, ancak yanına LuckPerms, WorldGuard, Vault ve PlaceholderAPI eklendiğinde eklenti yükü hissedilir hâle gelir. Eklentili bir Paper sunucusunda 2-10 oyuncu için 8 GB, 10-30 oyuncu için 10-12 GB, 30-60 oyuncu için 16 GB RAM ayırın. İşlemcide çekirdek sayısı değil saat hızı belirleyicidir; Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için AMD Ryzen 9 7900X sınıfı bir işlemci, çok çekirdekli ama düşük frekanslı sunucu işlemcilerinden belirgin şekilde iyi sonuç verir. Disk tarafında chunk okuma/yazma gecikmesi yüzünden NVMe SSD şarttır; en az 50 GB alan planlayın.

Ayrıntılı hesaplama için oyuncu sayısına göre RAM tablosuna göz atabilir, hazır kurulu Paper ve eklenti paketleriyle gelen Batihost Minecraft sunucu paketlerini inceleyebilirsiniz.

Özetle#

EssentialsX kurulumu jar dosyasını plugins klasörüne atmak kadar basit, ama işin asıl kısmı config.yml ayarlarında ve izin planlamasında. Sırayı şöyle kurun: doğru yapıyı indirin (26.2 kullanıyorsanız dev yapıyı), Vault ve LuckPerms ile birlikte yükleyin, sunucuyu düzgün kapatıp açın, ardından dil, ışınlanma, ev limiti ve ekonomi satırlarını düzenleyin. İzinleri joker düğüm yerine tek tek verin, kitleri kits.yml üzerinden yönetin ve her ayar değişikliğinden sonra /essentials reload çalıştırın.

Bir sonraki adım grup ve rank yapısını kurmaktır. LuckPerms ile yetki sistemi kurma rehberi, buradaki izin düğümlerini gerçek bir rank hiyerarşisine dönüştürmenizi anlatıyor.