EssentialsX Kurulum & Yapılandırma: Eksiksiz Rehber

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.

• 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.

cd ~/server/plugins

# Ana eklenti (zorunlu)
wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsX.jar

# Vault (ekonomi ve yetki köprüsü — şiddetle önerilir)
wget https://github.com/MilkBowl/Vault/releases/latest/download/Vault.jar

# Modüller (isteğe bağlı)
wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsXChat.jar
wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsXSpawn.jar
wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsXAntiBuild.jar
wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsXGeoIP.jar
wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsXDiscord.jar
wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsXProtect.jar

İ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ı

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

Ekonomi Ayarları

# 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ı

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

Spawn Ayarları

Diğer Önemli Ayarlar

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.

/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.

Spawn Komutları

TPA (Oyuncuya Işınlanma)

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

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.

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.

# 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

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.

# 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.

# 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

EssentialsX Modülleri

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

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

# 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:

Mesajları Türkçeleştirme

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

# 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

Faydalı Kaynaklar