Minecraft Sunucusuna Eklenti Kurma: LuckPerms, EssentialsX ve Geyser Rehberi

Kısa cevap: Paper (veya Spigot) sunucusuna eklenti kurmak için eklentinin .jar dosyasını sunucunun plugins/ klasörüne koyup sunucuyu yeniden başlatırsın. Neredeyse her sunucunun ilk kurduğu üç eklenti şunlardır: LuckPerms (yetki ve rütbeler), EssentialsX (home, spawn, warp, tpa, ekonomi gibi temel komutlar) ve Geyser + Floodgate (telefon/konsoldaki Bedrock oyuncularının Java sunucuna girebilmesi). Bu rehberde üçünü de Türkçe komut örnekleriyle kuruyoruz.

Bu rehber, sunucunun Paper ile kurulu olduğunu varsayar. Henüz sunucun yoksa önce Minecraft sunucu kurma rehberine bak.

Eklenti Nasıl Kurulur? (Genel Adımlar)

1. Eklentiyi resmi kaynağından indir (eklentinin kendi sitesi, Modrinth, Hangar veya SpigotMC). Tanımadığın sitelerdeki "crackli" ya da yeniden paketlenmiş .jar dosyaları sunucuna zararlı kod sokabilir.
2. Eklentinin, sunucunun Minecraft sürümünü desteklediğini kontrol et (indirme sayfasında yazar).
3. .jar dosyasını sunucudaki plugins/ klasörüne yükle (SFTP ile ya da sunucuda wget ile).
4. Sunucuyu yeniden başlat. /reload komutunu kullanma; birçok eklentide bellek sızıntısı ve hatalara yol açar.
5. Eklenti ilk açılışta plugins/EklentiAdı/ altında ayar dosyalarını (config.yml) oluşturur. Ayarları değiştirdikten sonra yine yeniden başlat ya da eklentinin kendi reload komutunu kullan.

Kurulu eklentileri oyunda /plugins komutuyla görebilirsin; yeşil olanlar çalışıyor, kırmızı olanlar hata vermiş demektir (nedeni sunucu konsolunda yazar).

LuckPerms: Yetki ve Rütbe Sistemi

LuckPerms, hangi oyuncunun hangi komutu kullanabileceğini belirleyen yetki (permission) eklentisidir. Rütbeler (oyuncu, VIP, moderatör, admin) LuckPerms'te grup olarak tanımlanır; her gruba yetkiler verilir ve oyuncular gruplara eklenir.

İndirme: luckperms.net (Bukkit/Paper sürümünü seç). Kurulumdan sonra varsayılan olarak bir default grubu oluşur; sunucuya giren herkes bu gruptadır.

Temel komutlar

Ne yapmak istiyorsun?	Komut
Yeni grup (rütbe) oluştur	/lp creategroup vip
Gruba yetki ver	/lp group vip permission set essentials.fly true
Gruptan yetki kaldır	/lp group vip permission unset essentials.fly
VIP, default grubun yetkilerini de alsın	/lp group vip parent add default
Oyuncuyu gruba ekle	/lp user Ali parent add vip
Oyuncunun grubunu değiştir (tek grup)	/lp user Ali parent set vip
Sohbette rütbe ön eki	/lp group vip meta setprefix 100 "&6[VIP] "
Oyuncunun yetkilerini kontrol et	/lp user Ali permission check essentials.fly
Web editörünü aç	/lp editor

/lp editor komutu bir bağlantı verir; tarayıcıda açtığında tüm grupları ve yetkileri görsel olarak düzenleyip tek tıkla kaydedebilirsin. Yeni başlayanlar için en kolay yol budur.

İpucu: Kendine tüm yetkileri vermek için /op yerine sunucu konsolundan lp user SeninAdın permission set * true kullanabilirsin; ama bunu yalnızca kendi hesabına yap. Yetkili ekibe * vermek, bir hesap çalındığında tüm sunucuyu riske atar.

Sohbette rütbe ön ekinin görünmesi

LuckPerms ön eki tanımlar ama sohbet biçimini değiştirmez. Ön ekin sohbette görünmesi için bir sohbet eklentisi gerekir: aşağıdaki EssentialsXChat + Vault ikilisi bunu yapar.

EssentialsX: Home, Spawn, Warp, TPA ve Ekonomi

EssentialsX, sunucuların temel komut setidir: /sethome ve /home, /spawn, /warp, /tpa, /msg, /kit, ekonomi (/balance, /pay) ve daha fazlası. Modüller hâlinde gelir:

Modül	Ne işe yarar?
EssentialsX (çekirdek)	Temel komutlar — zorunlu
EssentialsX Chat	Sohbet biçimi ve rütbe ön ekleri
EssentialsX Spawn	/spawn, /setspawn, ilk girişte spawn'a ışınlama
EssentialsX AntiBuild, Protect, GeoIP…	İsteğe bağlı

İndirme: essentialsx.net. Sohbet ön ekleri ve ekonominin diğer eklentilerle konuşabilmesi için Vault eklentisini de kur (Vault tek başına bir şey yapmaz; eklentiler arası köprüdür).

Kurulumdan sonra ilk ayarlar

• Türkçe mesajlar: plugins/Essentials/config.yml dosyasında locale: tr yap ve yeniden başlat.
• Spawn noktası: Oyunda istediğin yerde dur ve /setspawn yaz.
• Warp: /setwarp market ile bir nokta kaydet, oyuncular /warp market ile gider.
• Kit: Envanterine başlangıç eşyalarını koyup /createkit baslangic 86400 yaz (86400 saniye = günde bir kez alınabilir).

Oyunculara temel komut yetkileri (LuckPerms ile)

Varsayılan grupta oyuncuların komutları kullanabilmesi için yetki vermen gerekir:

/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.spawn true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.warp true
/lp group default permission set essentials.msg true
/lp group default permission set essentials.balance true
/lp group default permission set essentials.pay true
/lp group default permission set essentials.kit true
/lp group default permission set essentials.kits.baslangic true

Birden fazla home hakkı vermek için config.yml içindeki sethome-multiple bölümünde grup limitleri tanımlanır (ör. vip: 5), ardından VIP grubuna essentials.sethome.multiple.vip yetkisi verilir.

Geyser + Floodgate: Telefon ve Konsol Oyuncuları

Minecraft'ın iki sürümü vardır: bilgisayardaki Java Edition ve telefon, tablet, konsol ve Windows mağazasındaki Bedrock Edition. Normalde birbirine bağlanamazlar. Geyser, Java sunucuna Bedrock oyuncularının da girebilmesini sağlayan bir çeviri katmanıdır.

• Geyser: Bedrock bağlantılarını Java sunucusuna çevirir. Bedrock oyuncuları varsayılan olarak 19132/UDP portundan bağlanır.
• Floodgate: Bedrock oyuncularının ayrıca bir Java hesabına sahip olmadan girebilmesini sağlar (Microsoft hesabıyla doğrulanırlar). Floodgate'li oyuncuların adının başına varsayılan olarak nokta eklenir (ör. .Ali); böylece aynı isimli bir Java oyuncusuyla karışmaz.

Kurulum

1. geysermc.org/download adresinden Geyser (Spigot/Paper) ve Floodgate (Spigot/Paper) .jar dosyalarını indirip plugins/ klasörüne koy.
2. Sunucuyu yeniden başlat. Geyser, aynı sunucuda Floodgate'i bulduğunda doğrulamayı ona bırakır; emin olmak için plugins/Geyser-Spigot/config.yml dosyasında auth-type: floodgate yazdığını kontrol et.
3. Sunucunun güvenlik duvarında 19132/UDP portunu aç (Linux'ta: ufw allow 19132/udp).
4. Bedrock oyuncuları Sunucular → Sunucu Ekle bölümünde sunucunun adresini ve 19132 portunu girer.

Bağlantıyı test etmek için Minecraft sunucu sorgulama aracında "Bedrock" seçip adresini sorgulayabilirsin; "Sunucu açık" görünüyorsa Bedrock oyuncuları da girebilir.

Not: Geyser, Java sürümünün en güncel hâlini destekler. Sunucun eski bir sürümdeyse ViaVersion eklentisi gerekebilir; Geyser'in indirme sayfasında güncel uyumluluk notları yazar.

Sık Karşılaşılan Sorunlar

• Eklenti /plugins listesinde kırmızı: Konsolda eklentinin adını ara. Çoğunlukla sürüm uyumsuzluğu veya eksik bağımlılıktır (ör. Vault'a ihtiyaç duyan bir eklenti).
• Oyuncular "You do not have permission" alıyor: O komutun yetkisi oyuncunun grubunda yok. /lp user Ad permission check yetki.adı ile kontrol et.
• Ön ek sohbette görünmüyor: EssentialsXChat ve Vault kurulu mu? İkisi de gerekir.
• Bedrock oyuncuları bağlanamıyor: 19132/UDP açık mı, Floodgate kurulu mu, oyuncu doğru portu mu yazıyor? Sunucu sağlayıcın UDP'yi engelliyor olabilir.
• Sunucu eklentilerden sonra kasıyor: Spark eklentisini kurup /spark profiler start ile ölçümü başlat, birkaç dakika sonra /spark profiler stop ile verdiği raporda hangi eklentinin işlemciyi tükettiğini gör. Eklenti sayısı arttıkça RAM ve özellikle tek çekirdek hızı önem kazanır.

Sonraki adım: yapı ve harita

Spawn, lobi ve harita yapımı için en çok kullanılan eklenti WorldEdit'tir: WorldEdit komutları ve kurulumu.

Kendi sunucunda mı, paylaşımlı hostingde mi?

Paylaşımlı oyun hostlarında eklentiler genelde paneldeki listeden kurulur ve dosya erişimi sınırlı olabilir. Kendi sunucunda (VPS/VDS) plugins/ klasörü tamamen senindir: istediğin eklentiyi, istediğin sürümde kurarsın. İstersen bu kurulumları sunucunu açarken biz de yapabiliriz.