EssentialsX Kurulum & Yapılandırma: Eksiksiz Rehber

Kurulum, config.yml detaylı ayarlar, home/warp/spawn, TPA, ekonomi, chat formatı, kit sistemi, modüller ve sorun giderme.

35 dk okuma

# EssentialsX Nedir?

EssentialsX, Minecraft sunucuları için en kapsamlı temel eklentidir. 130'dan fazla komut barındırır: teleport sistemi (home, warp, spawn, TPA), ekonomi, chat formatı, kit sistemi, nick, mesajlaşma ve çok daha fazlası. 2011'den beri geliştirilen Essentials'ın modern, aktif olarak güncellenen çatalıdır.

EssentialsX tek başına çalışır ancak Vault eklentisi ile birlikte kullanıldığında ekonomi ve prefix/suffix entegrasyonu sağlanır. Vault'u mutlaka kurun.

130+ yerleşik komut — ek eklentiye gerek yok
Modüler yapı — sadece ihtiyacınız olan parçaları kurun
Aktif geliştirme — Paper, Spigot, Purpur desteği
PlaceholderAPI, LuckPerms, Vault ile tam uyum
Detaylı config.yml — her özellik özelleştirilebilir

# Kurulum

EssentialsX'i resmi sitesinden veya doğrudan CI sunucusundan indirin. Ana jar ve ihtiyacınız olan modülleri plugins/ klasörüne koyun.

Sunucuyu stop komutu ile tamamen kapatıp açın. Asla /reload kullanmayın — EssentialsX config'i bozulabilir ve memory leak oluşur.

İlk başlatmadan sonra plugins/Essentials/ klasöründe config.yml oluşacaktır. Sunucuyu durdurun, config'i düzenleyin, tekrar başlatın.

# config.yml Detaylı Ayarlar

EssentialsX'in kalbi config.yml dosyasıdır. 800+ satır içerir. Aşağıda en kritik ayarları kategorilere ayırarak inceliyoruz.

# Teleport Ayarları

Ayar	Varsayılan	Önerilen	Açıklama
`teleport-cooldown`	0	3	Işınlanmalar arası bekleme süresi (saniye)
`teleport-delay`	0	3	Işınlanma öncesi geri sayım (saniye). Hareket ederse iptal olur
`teleport-invulnerability`	0	4	Işınlanma sonrası hasar almama süresi (saniye)
`teleport-back-when-freed-from-jail`	true	true	Hapisten çıkınca eski konuma dön
`teleport-to-center`	true	true	Bloğun merkezine ışınla (kenar yerine)

yaml

# config.yml — Teleport bölümü
teleport-cooldown: 3
teleport-delay: 3
teleport-invulnerability: 4
teleport-to-center: true

# Ekonomi Ayarları

Ayar	Varsayılan	Önerilen	Açıklama
`starting-balance`	0	1000	Yeni oyuncunun başlangıç parası
`max-money`	10000000000000	10000000	Maksimum bakiye (exploit önlemi)
`min-money`	-10000	0	Minimum bakiye (negatif = borçlanma izni)
`economy-log-enabled`	false	true	Tüm para transferlerini logla
`currency-symbol`	$	₺	Para birimi sembolü
`currency-symbol-suffix`	false	true	Sembolü sayının sonuna koy (100₺)

yaml

# config.yml — Ekonomi bölümü
starting-balance: 1000
max-money: 10000000
min-money: 0
economy-log-enabled: true
currency-symbol: '₺'
currency-symbol-suffix: true

# Home Ayarları

Ayar	Varsayılan	Önerilen	Açıklama
`max-homes`	—	3	Varsayılan home limiti (tüm oyuncular)
`sethome-multiple.default`	3	3	default grubu home sayısı
`sethome-multiple.vip`	—	5	VIP grubu home sayısı
`sethome-multiple.admin`	—	10	Admin grubu home sayısı
`world-home-permissions`	false	true	Dünya başına sethome yetkisi iste

yaml

# config.yml — Home bölümü
max-homes: 3
sethome-multiple:
  default: 3
  vip: 5
  admin: 10
world-home-permissions: false

# Spawn Ayarları

Ayar	Varsayılan	Önerilen	Açıklama
`spawn-on-join`	false	true	Oyuncu giriş yaptığında spawn'a ışınla
`spawn-on-join-groups`	—	—	Belirli grupları spawn'a ışınla (boş = herkesi)
`respawn-at-home`	false	false	Ölünce home'a mı spawn'a mı? (EssentialsXSpawn ile)
`newbies.announce-format`	—	&eHoş geldin {DISPLAYNAME}!	Yeni oyuncu duyurusu

# Diğer Önemli Ayarlar

Ayar	Varsayılan	Önerilen	Açıklama
`nick-prefix`	~	~	Takma ad öneki (boş bırakılabilir)
`change-displayname`	true	true	Oyuncu display name'ini nick ile değiştir
`add-prefix-suffix`	true	true	LuckPerms prefix/suffix'i display name'e ekle
`ops-name-color`	4	none	OP oyuncuların isim rengi (none = devre dışı)
`update-check`	true	true	Başlangıçta güncelleme kontrolü
`locale`	—	tr	Mesaj dili (messages_tr.properties)
`per-warp-permission`	false	true	Her warp için ayrı yetki iste

# Teleport Sistemi

EssentialsX'in en çok kullanılan özelliği teleport sistemidir. Dört ana bileşenden oluşur: Home, Warp, Spawn ve TPA.

# Home Komutları

Oyuncuların kişisel ışınlanma noktalarını yönetir. Grup bazlı home limiti config.yml'den ayarlanır.

Komut	Açıklama	Yetki
`/sethome`	Varsayılan evi kaydet	essentials.sethome
`/sethome maden`	İsimli ev kaydet	essentials.sethome.multiple
`/home`	Varsayılan eve ışınlan	essentials.home
`/home maden`	İsimli eve ışınlan	essentials.home
`/delhome maden`	İsimli evi sil	essentials.delhome
`/homes`	Tüm evleri listele	essentials.home.others (başkasınınki)

text

/sethome              # Varsayılan evi kaydet
/sethome maden         # İsimli ev kaydet
/home                  # Varsayılan eve ışınlan
/home maden            # İsimli eve ışınlan
/delhome maden         # Evi sil
/homes                 # Tüm evleri listele

# Warp Komutları

Sunucu genelinde herkesin (veya yetkisi olanların) kullanabileceği sabit ışınlanma noktaları. Market, arena, farm gibi önemli lokasyonlar için idealdir.

Komut	Açıklama	Yetki
`/setwarp market`	Warp noktası oluştur	essentials.setwarp
`/warp market`	Warp noktasına ışınlan	essentials.warp + essentials.warps.market
`/delwarp market`	Warp noktasını sil	essentials.delwarp
`/warps`	Tüm warp'ları listele	essentials.warp.list

per-warp-permission: true ayarı ile her warp için ayrı yetki isteyebilirsiniz. Örneğin essentials.warps.viparea yetkisi olmayan oyuncular o warp'a gidemez.

# Spawn Komutları

Komut	Açıklama	Yetki
`/setspawn`	Spawn noktasını ayarla	essentials.setspawn
`/setspawn vip`	Grup bazlı spawn ayarla	essentials.setspawn
`/spawn`	Spawn'a ışınlan	essentials.spawn

Grup bazlı spawn için EssentialsXSpawn modülü gereklidir. Farklı gruplar farklı spawn noktalarına ışınlanabilir.

# TPA (Oyuncuya Işınlanma)

Oyuncuların birbirlerine ışınlanma isteği göndermesini sağlar. Kabul/reddetme mekanizması ile güvenlidir.

Komut	Açıklama	Yetki
`/tpa Oyuncu`	Oyuncuya ışınlanma isteği gönder	essentials.tpa
`/tpahere Oyuncu`	Oyuncuyu yanına çağır	essentials.tpahere
`/tpaccept`	İsteği kabul et	—
`/tpdeny`	İsteği reddet	—
`/tpacancel`	Gönderilen isteği iptal et	—
`/tpaall`	Tüm oyunculara istek gönder	essentials.tpaall
`/back`	Son konuma geri dön (ölüm dahil)	essentials.back
`/tp Oyuncu`	Direkt ışınlan (admin)	essentials.tp

# Ekonomi Sistemi

EssentialsX yerleşik bir ekonomi motoru içerir. Vault eklentisi ile birlikte çalışarak ChestShop, ShopGUI+, Jobs gibi üçüncü parti eklentilerle tam entegrasyon sağlar.

Komut	Açıklama	Yetki
`/balance` (veya `/bal`)	Kendi bakiyeni gör	essentials.balance
`/balance Oyuncu`	Başkasının bakiyesini gör	essentials.balance.others
`/pay Oyuncu 500`	Oyuncuya para gönder	essentials.pay
`/baltop`	En zengin oyuncular listesi	essentials.baltop
`/eco give Oyuncu 1000`	Oyuncuya para ver	essentials.eco.give
`/eco take Oyuncu 500`	Oyuncudan para al	essentials.eco.take
`/eco set Oyuncu 0`	Bakiyeyi ayarla	essentials.eco.set
`/eco reset Oyuncu`	Başlangıç bakiyesine sıfırla	essentials.eco.set

max-money değerini çok yüksek tutmak ekonomi exploit'lerine yol açabilir. 10 milyon gibi makul bir üst sınır koyun.

# Chat Formatı (EssentialsX Chat)

EssentialsXChat modülü ile chat formatını tamamen özelleştirebilirsiniz. config.yml içindeki chat bölümünden ayarlanır.

yaml

# config.yml — Chat bölümü
chat:
  format: '{DISPLAYNAME}&7: &f{MESSAGE}'
  group-formats:
    default: '&7{PREFIX}{DISPLAYNAME}{SUFFIX}&7: &f{MESSAGE}'
    vip: '&a{PREFIX}{DISPLAYNAME}{SUFFIX}&7: &f{MESSAGE}'
    moderator: '&b{PREFIX}{DISPLAYNAME}{SUFFIX}&7: &f{MESSAGE}'
    admin: '&c{PREFIX}{DISPLAYNAME}{SUFFIX}&7: &f{MESSAGE}'

# Chat Değişkenleri

Değişken	Açıklama
`{DISPLAYNAME}`	Oyuncunun görünen adı (nick varsa nick)
`{PREFIX}`	LuckPerms/Vault üzerinden gelen prefix
`{SUFFIX}`	LuckPerms/Vault üzerinden gelen suffix
`{GROUP}`	Oyuncunun birincil grubu
`{MESSAGE}`	Chat mesajı
`{WORLD}`	Bulunduğu dünya adı
`{USERNAME}`	Gerçek kullanıcı adı (nick değil)

Chat'te prefix/suffix görmek için üç eklenti birlikte çalışmalıdır: LuckPerms (prefix tanımı) + Vault (köprü) + EssentialsX Chat (format). Birini bile atlarsanız prefix görünmez.

# Nick (Takma Ad) Sistemi

Oyuncuların görünen isimlerini değiştirmelerine olanak tanır. Renk kodu desteği ile renkli nick'ler oluşturulabilir.

Komut	Açıklama	Yetki
`/nick YeniIsim`	Takma ad ayarla	essentials.nick
`/nick &cYeniIsim`	Renkli takma ad ayarla	essentials.nick + essentials.nick.color
`/nick off`	Takma adı kaldır	essentials.nick
`/realname YeniIsim`	Nick'in arkasındaki gerçek ismi öğren	essentials.realname
`/nick Oyuncu YeniIsim`	Başkasının nick'ini değiştir	essentials.nick.others

yaml

# config.yml — Nick ayarları
nick-prefix: '~'              # Nick önüne eklenen karakter (boş bırakılabilir)
change-displayname: true      # Display name'i nick ile değiştir
nick-color: true              # Renk kodu kullanımına izin ver
max-nick-length: 20           # Maksimum nick uzunluğu

# Kit Sistemi

Hazır item setleri tanımlayarak oyunculara belirli aralıklarla dağıtabilirsiniz. Kit'ler config.yml içinde tanımlanır.

yaml

# config.yml — Kits bölümü
kits:
  baslangic:
    delay: 86400            # 24 saat cooldown
    items:
      - stone_sword 1
      - iron_pickaxe 1
      - bread 16
      - oak_log 32
  vipkit:
    delay: 43200            # 12 saat cooldown
    items:
      - diamond_sword 1 sharpness:2
      - diamond_pickaxe 1 efficiency:3
      - golden_apple 8
      - diamond 16
  madenci:
    delay: 3600             # 1 saat cooldown
    items:
      - iron_pickaxe 1 efficiency:4 unbreaking:3
      - torch 64
      - bread 16

Komut	Açıklama	Yetki
`/kit baslangic`	Kit al	essentials.kit.baslangic
`/kit vipkit`	VIP kit al	essentials.kit.vipkit
`/kits`	Kullanılabilir kitleri listele	essentials.kit.list
`/createkit isim saniye`	Envanterden kit oluştur	essentials.createkit
`/showkit isim`	Kit içeriğini göster	essentials.showkit

Kit cooldown'ları saniye cinsindendir. 86400 = 1 gün, 43200 = 12 saat, 3600 = 1 saat. delay: 0 sınırsız kullanım demektir.

# EssentialsX Modülleri

EssentialsX modüler yapıdadır. Ana jar dışında ihtiyacınız olan modülleri ayrı ayrı kurabilirsiniz:

Modül	İşlev	Bağımlılık	Zorunlu mu?
EssentialsX Chat	Chat formatı, grup bazlı renkler, PlaceholderAPI desteği	Vault (prefix/suffix için)	Önerilir
EssentialsX Spawn	Gelişmiş spawn yönetimi, ilk giriş spawn'ı, grup bazlı spawn, respawn ayarları	—	Önerilir
EssentialsX AntiBuild	Grup bazlı inşa/kırma engelleme, item kullanım kısıtlama	—	İsteğe bağlı
EssentialsX GeoIP	Oyuncuların ülke/şehir bilgisini gösterir, coğrafi kısıtlama	GeoIP veritabanı	İsteğe bağlı
EssentialsX Discord	Discord-Minecraft chat senkronizasyonu, webhook desteği, konsol kanalı	Discord bot token	İsteğe bağlı
EssentialsX Protect	Dünya koruması: creeper/TNT patlaması, fire spread, lava flow engelleme	—	İsteğe bağlı

# EssentialsX Discord Kurulumu

EssentialsX Discord modülü, Minecraft chat'ini Discord kanalına ve Discord mesajlarını oyun içine taşır.

Discord Developer Portal'dan yeni bir bot oluşturun
Bot token'ı alın ve plugins/Essentials/config.yml içine yapıştırın
Botu sunucunuza davet edin (MESSAGE_CONTENT intent'i açık olmalı)
discord bölümünü config'de düzenleyin: kanal ID'lerini girin

yaml

# config.yml — Discord bölümü (basitleştirilmiş)
discord:
  token: 'BOT_TOKEN_BURAYA'
  guild: '123456789012345678'
  channels:
    primary: '123456789012345678'
  staff:
    channel: '123456789012345679'
  console:
    channel: '123456789012345680'

# İzinler (Permissions) Tablosu

EssentialsX'in en sık kullanılan yetkileri. LuckPerms ile gruplara atayın:

Yetki	Açıklama	Önerilen Grup
`essentials.home`	Ev'e ışınlanma	default
`essentials.sethome`	Ev kaydetme	default
`essentials.sethome.multiple.3`	3 eve kadar kaydet	default
`essentials.warp`	Warp'a ışınlanma	default
`essentials.tpa`	TPA isteği gönderme	default
`essentials.back`	Son konuma dönme	default
`essentials.balance`	Bakiye görme	default
`essentials.pay`	Para gönderme	default
`essentials.kit`	Kit kullanma	default
`essentials.nick`	Nick değiştirme	vip
`essentials.nick.color`	Renkli nick	vip
`essentials.fly`	Uçma	vip
`essentials.tp`	Direkt ışınlanma	moderator
`essentials.kick`	Oyuncu atma	moderator
`essentials.mute`	Oyuncu susturma	moderator
`essentials.ban`	Oyuncu yasaklama	admin
`essentials.gamemode`	Oyun modu değiştirme	admin
`essentials.eco.give`	Para verme (admin)	admin
`essentials.setwarp`	Warp oluşturma	admin
`essentials.*`	Tüm EssentialsX yetkileri	owner

# Mesajları Türkçeleştirme

EssentialsX mesajları plugins/Essentials/messages.properties dosyasında saklar. Türkçe çeviri için:

yaml

# config.yml
locale: 'tr'

Bu ayar messages_tr.properties dosyasını otomatik oluşturur. İçinden istediğiniz mesajı düzenleyebilirsiniz. Topluluk çevirileri de mevcuttur.

# Sık Yapılan Hatalar ve Çözümleri

Sorun	Neden	Çözüm
Prefix chat'te görünmüyor	Vault veya EssentialsX Chat eksik	Vault + EssentialsXChat kur, `add-prefix-suffix: true` kontrol et
`/reload` sonrası config sıfırlandı	Reload EssentialsX'i bozar	Asla /reload kullanma, `stop` ile yeniden başlat
Ekonomi çalışmıyor	Vault kurulu değil veya provider yok	Vault kur, EssentialsX economy provider olarak yükleniyor mu kontrol et (`/vault-info`)
Home limiti çalışmıyor	Config'de `sethome-multiple` düzgün ayarlanmamış	Grup isimlerinin LuckPerms ile eşleştiğini kontrol et
TPA isteği gelmiyor	`teleport-cooldown` çok yüksek veya yetki eksik	`essentials.tpa` yetkisini kontrol et, cooldown'u düşür
Nick renk kodu çalışmıyor	`essentials.nick.color` yetkisi eksik	LuckPerms ile ilgili yetkiyi ver
Kit cooldown sıfırlanmıyor	Zamanlama doğru ama saniye cinsinden hesaplanıyor	86400 = 1 gün, 3600 = 1 saat — doğru değeri gir
Warp yetkisi çalışmıyor	`per-warp-permission: true` ama yetki verilmemiş	`essentials.warps.warp_adı` yetkisini ver

EssentialsX config.yml düzenlerken YAML syntax'ına dikkat edin. Yanlış girintileme (indentation) tüm config'i bozar. Her zaman 2 boşluk kullanın, TAB kullanmayın.

# Faydalı Kaynaklar

EssentialsX Wiki

Resmi EssentialsX dokümantasyonu — tüm komut ve ayarlar.

LuckPerms Yetki Rehberi

Yetki sistemi kurulumu ve EssentialsX entegrasyonu.

Minecraft Plugin Rehberi

Diğer temel eklentilerin kurulum ve yapılandırması.

Sunucu Optimizasyon Rehberi

Performans ayarları ve TPS iyileştirme.

EssentialsX kurulumunu bize bırakın

EssentialsX ve tüm modüllerinin profesyonel yapılandırması, Türkçe mesajlar, ekonomi entegrasyonu ve yetki sistemi kurulumu için KEYDAL ekibine ulaşın. Teklif alın →