Spigot Minecraft Sunucu Kurulumu

Spigot sunucu kurulumu diğer sunucu yazılımlarından bir noktada ayrılır: Spigot’un hazır bir .jar indirmesi yoktur, jar dosyasını BuildTools aracıyla kendi makinenizde derlersiniz. Kurulum sırası şudur: JDK 25 ve Git kurun, BuildTools.jar indirin, java -jar BuildTools.jar --rev 26.2 komutunu çalıştırın, oluşan spigot-26.2.jar dosyasını sunucu klasörünüze taşıyın.

Spigot, Bukkit eklenti ekosisteminin uzun yıllar boyunca omurgası olmuş sunucu yazılımıdır. 2026’da yeni kurulan sunucuların çoğu Paper’a yöneliyor olsa da Spigot hâlâ aktif geliştiriliyor ve BuildTools 26.2’yi sorunsuz derliyor. Bu rehber işletim sisteminden bağımsızdır; Windows’a özgü ekran adımları için Windows’ta BuildTools ile Spigot kurulumu sayfasına, genel kurulum akışı için Minecraft sunucu kurulumu ana rehberine geçebilirsiniz.

Spigot Nedir? Bukkit ve CraftBukkit ile İlişkisi#

Minecraft sunucu yazılımlarının katmanlarını bilmeden Spigot’un ne olduğunu anlamak zordur:

Vanilla server.jar

Mojang’ın resmî sunucusu. Eklenti desteği yoktur.

Bukkit

Bir API tanımıdır, tek başına çalışmaz. Eklentilerin konuştuğu arayüz.

CraftBukkit

Bukkit API’sini Minecraft sunucusuna bağlayan uygulama. Eklentileri çalıştırabilen ilk katman.

Spigot

CraftBukkit üzerine performans yamaları, ek ayarlar ve spigot.yml ekleyen sürüm.

Paper

Spigot’un çatallaması. Çok daha agresif optimizasyon ve genişletilmiş API.

Bir eklenti "Bukkit eklentisi", "Spigot eklentisi" veya "Paper eklentisi" olarak tanımlanır ve bu zincirde yukarı doğru çalışır: Bukkit eklentisi Spigot’ta da Paper’da da açılır, Paper eklentisi ise yalnızca Paper’da açılır.

Spigot Neden Hazır Jar Olarak Dağıtılmaz?#

Sebep teknik değil hukuki. Mojang’ın Son Kullanıcı Lisans Sözleşmesi, Minecraft sunucu kodunun değiştirilmiş halinin yeniden dağıtılmasına izin vermez. 2014’teki DMCA süreçlerinden sonra SpigotMC, derlenmiş jar’ları barındırmayı bıraktı ve yerine BuildTools adlı aracı yayımladı.

BuildTools şunları yapar:

• Mojang’ın resmî sunucu jar’ını indirir.
• BuildData deposundaki eşleştirme (mapping) ve yama dosyalarını çeker.
• Bukkit, CraftBukkit ve Spigot kaynak depolarını klonlar.
• Yamaları uygular ve Maven ile kaynağı derler.
• Sonuçta spigot-<sürüm>.jar ve craftbukkit-<sürüm>.jar dosyalarını üretir.

Kurulum Öncesi Gereksinimler#

JDK sürümü (JRE değil)#

BuildTools kaynak kodu derlediği için tam bir JDK ister; yalnızca JRE kuruluysa çalışmaz. Derleyeceğiniz Minecraft sürümüne göre doğru JDK’yı seçin:

Aynı makinede birden fazla JDK bulundurabilirsiniz; BuildTools’u çalıştırırken hangi java çalıştırılabilirini kullandığınıza dikkat edin. Sürüm eşleşmesinin ayrıntısı için hangi Java sürümü gerekir sayfasına bakın.

Git#

BuildTools depoları Git ile klonlar; Git kurulu değilse süreç en başta durur. Kurulumdan sonra terminali kapatıp açın ve şu komutun çıktı verdiğini doğrulayın:

git --version
java -version

İkinci komutun çıktısında openjdk version "25" ile başlayan bir satır görmelisiniz.

Donanım#

Minecraft’ın ana tick döngüsü tek çekirdekte çalışır; bu yüzden çekirdek sayısı değil saat hızı belirleyicidir. Spigot, Paper’a göre daha az optimize olduğu için aynı oyuncu sayısında bir tık daha fazla kaynak ister.

Disk mutlaka NVMe SSD olmalı: chunk okuma/yazma küçük bloklu ve yoğun I/O üretir, SATA disklerde autosave anında TPS gözle görülür şekilde düşer. Türkiye lokasyonlu Ryzen tabanlı hazır paketler için Minecraft sunucu paketlerine bakabilirsiniz.

İndirmeniz Gerekenler#

BuildTools ile Spigot Derleme#

1. Ayrı bir derleme klasörü açın#

   BuildTools çalıştığı dizine birkaç depo ve büyük bir Maven önbelleği yazar. Bunu sunucu klasörünüzün içinde değil, ayrı bir yerde yapın. Yol adında boşluk ve Türkçe karakter bulunmasın; bazı Windows kurulumlarında Git bu yolları işleyemez.

2. Git satır sonu ayarını düzeltin#

   Windows’ta Git varsayılan olarak satır sonlarını dönüştürür ve yamalar bozulur. Derlemeden önce mutlaka şu ayarı yapın:

   git config --global core.autocrlf false

3. BuildTools.jar dosyasını klasöre koyun#

   Jenkins sayfasındaki son başarılı yapının (Build #200, 19 Nisan 2026) artifact bölümünden BuildTools.jar dosyasını indirip derleme klasörüne yerleştirin.

4. Derleme komutunu çalıştırın#

   Hedef sürümü --rev ile belirtin. Sürüm belirtmezseniz BuildTools en son kararlı sürümü derler.

   # Minecraft 26.2 için Spigot derle
   java -jar BuildTools.jar --rev 26.2
   
   # Grafik penceresi olmadan, yalnızca Spigot üret
   java -jar BuildTools.jar --rev 26.2 --compile spigot --nogui
   
   # Eski bir sürüm derlemek isterseniz (JDK 8 ile çalıştırın)
   java -jar BuildTools.jar --rev 1.8.8

5. Çıktıyı kontrol edin#

   İşlem bittiğinde konsolun son satırında Success! Everything completed successfully. yazar ve klasörde spigot-26.2.jar ile craftbukkit-26.2.jar dosyaları oluşur. Sunucu için ihtiyacınız olan dosya Spigot olanıdır.

Sunucuyu İlk Kez Çalıştırma#

Derlenen jar’ı boş bir sunucu klasörüne kopyalayın ve adını kısaltın (örneğin spigot.jar). Sonrasında akış her sunucu yazılımıyla aynıdır.

# 1. İlk çalıştırma - EULA kabul edilmediği için hemen kapanır
java -Xms6G -Xmx6G -jar spigot.jar --nogui

# 2. eula.txt içinde eula=true yapın, sonra tekrar başlatın
java -Xms6G -Xmx6G -jar spigot.jar --nogui

İlk çalıştırmada oluşan eula.txt dosyasındaki son satırı değiştirmeniz gerekir:

#By changing the setting below to TRUE you are indicating your agreement to our EULA.
eula=true

İkinci başlatmada dünya üretilir ve konsolda Done (18.740s)! For help, type "help" satırını gördüğünüzde sunucu 25565/TCP portunu dinlemeye başlar. Ardından stop yazıp kapatın ve temel ayarları girin:

server-port=25565
motd=Batihost Spigot Sunucusu
max-players=40
online-mode=true
view-distance=8
simulation-distance=6
difficulty=normal
spawn-protection=0
network-compression-threshold=256

Her satırın anlamı ve önerilen değerler için server.properties ayarlarının tam listesi sayfasını kullanın. Java heap ve JVM bayrağı seçimi içinse RAM ayarları ve JVM flag’leri rehberi doğru adres. Kısaca: 8 GB pakette -Xms6G -Xmx6G, 12 GB pakette -Xms10G -Xmx10G, 16 GB pakette -Xms14G -Xmx14G verin, -Xms ile -Xmx daima eşit olsun.

spigot.yml ve bukkit.yml Ayarları#

Spigot’un vanilla’ya göre asıl kazancı bu iki dosyadan gelir. İlk çalıştırmadan sonra sunucu klasöründe oluşurlar.

spigot.yml — varlık ve item yönetimi#

world-settings:
  default:
    mob-spawn-range: 4
    entity-activation-range:
      animals: 16
      monsters: 24
      raiders: 48
      misc: 8
      water: 8
      villagers: 16
      flying-monsters: 48
    merge-radius:
      item: 3.5
      exp: 4.0
    item-despawn-rate: 4000
    arrow-despawn-rate: 300
    nerf-spawner-mobs: true
    max-tick-time:
      tile: 1000
      entity: 1000

entity-activation-range en kritik ayardır: bu menzilin dışındaki varlıklar tick harcamaz. Değerleri düşürmek TPS’i yükseltir ama mob davranışlarını fark edilir biçimde değiştirir; monsters için 24’ün altına inmeyin. nerf-spawner-mobs: true spawner’dan çıkan mob’ların yapay zekâsını kısar ve mob farm ağırlıklı sunucularda ciddi kazanç sağlar.

bukkit.yml — spawn limitleri ve tick oranları#

spawn-limits:
  monsters: 50
  animals: 8
  water-animals: 4
  water-ambient: 4
  ambient: 1
ticks-per:
  animal-spawns: 400
  monster-spawns: 4
  autosave: 6000
settings:
  allow-end: true
  warn-on-overload: true

autosave: 6000 değeri 5 dakikada bir kayıt anlamına gelir; daha sık kayıt periyodik takılmalara yol açar. Bu iki dosyanın satır satır açıklaması ve sunucu tipine göre önerilen değerler için paper.yml, spigot.yml ve bukkit.yml optimizasyon rehberine bakın.

Eklenti Kurulumu ve 26.1 Unobfuscation Kırılması#

Eklentiler sunucu klasöründeki plugins dizinine .jar olarak atılır ve sunucu yeniden başlatılır. İlk açılışta her eklenti kendi ayar klasörünü üretir. Süreç ve dikkat edilecekler için plugin kurulumu rehberini okuyun.

26.x’e geçerken bilmeniz gereken kritik konu şudur: Minecraft 26.1 ile Mojang obfuscated sunucu jar’ı yayımlamayı bıraktı. Bu sıradan bir sürüm atlaması değil, bir ABI kırılmasıdır. Paper dahili remapper’ını tamamen kaldırdı, Spigot da remapper desteğini düşürdü. Sonuç: 1.21.11 ve öncesi için derlenmiş, NMS (net.minecraft.server) sınıflarına doğrudan erişen hiçbir eklenti yeniden derlenmeden 26.1 ve sonrasında çalışmaz.

BuildTools Derleme Hataları ve Çözümleri#

Could not find git / git is not recognized#

Git kurulu değil ya da PATH’te değil. Kurulumdan sonra terminali kapatıp yeniden açmayı unutmayın. Windows’ta Git kurulum sihirbazında "Git from the command line and also from 3rd-party software" seçeneği işaretli olmalıdır.

error: patch failed / Applying patches failed#

Neredeyse her zaman satır sonu dönüşümünden kaynaklanır. git config --global core.autocrlf false komutunu çalıştırın, derleme klasöründeki BuildData, Bukkit, CraftBukkit, Spigot ve work klasörlerini silin, derlemeyi baştan başlatın.

UnsupportedClassVersionError veya "requires Java X"#

Yanlış JDK ile derliyorsunuz. 26.2 için JDK 25, 1.8.8 için JDK 8 gerekir. Aynı makinede birden çok JDK varsa BuildTools’u istediğiniz sürümün tam yoluyla çalıştırın. Sunucu tarafında aynı hatayı alıyorsanız Java sürüm hatası sayfasına bakın.

Derleme yarıda kalıyor veya çok yavaş#

BuildTools onlarca megabaytlık depo indirir; kararsız bağlantıda süreç yarıda kesilir. Sunucu üzerinde derliyorsanız bağlantı kopmalarına karşı işlemi screen veya tmux içinde başlatın. Ayrıca antivirüs yazılımları Windows’ta Maven önbelleğini tarayarak derlemeyi çok yavaşlatabilir; derleme klasörünü taramadan hariç tutun.

Sunucu açılıyor ama eklentiler yüklenmiyor#

Konsolda her eklenti için tek tek log satırı gelir. Bir eklenti "Could not load 'plugins/X.jar'" hatası veriyorsa ya jar bozuktur ya da API sürümü uyumsuzdur. Eklentiyi tek başına test sunucusunda deneyin.

Spigot mu Paper mı? Geçiş Kararı#

Yeni bir sunucu kuruyorsanız dürüst cevap Paper’dır. Paper, Spigot’un çatallamasıdır; tüm Spigot ve Bukkit eklentilerini çalıştırır, hazır jar olarak dağıtıldığı için derleme derdi yoktur ve chunk sistemi, varlık takibi, hopper ile ağ katmanında Spigot’ta olmayan yüzlerce optimizasyon içerir.

Geçiş de basittir: sunucuyu stop ile kapatın, tam yedek alın, yalnızca .jar dosyasını Paper jar’ıyla değiştirin. world, plugins, server.properties, ops.json ve whitelist.json dosyalarına dokunmanız gerekmez; Paper aynı biçimleri okur ve spigot.yml ile bukkit.yml ayarlarınızı kullanmaya devam eder. Adımların tamamı için Paper sunucu kurulumu ve yapılandırma rehberine bakın.

Spigot’u tercih etmenin mantıklı olduğu tek senaryo, çok eski bir sürümde (örneğin 1.8.9 PvP sunucularında) belirli bir eklenti davranışına bağımlı olmanızdır.

Özetle#

Spigot sunucu kurulumu için JDK 25 ve Git kurun, BuildTools.jar’ı boşluksuz bir klasöre indirin, git config --global core.autocrlf false ayarını yapın ve java -jar BuildTools.jar --rev 26.2 komutunu çalıştırın. Oluşan spigot-26.2.jar dosyasını boş bir sunucu klasörüne taşıyın, bir kez çalıştırıp eula.txt içinde eula=true yapın, ardından heap değerlerini verdiğiniz başlatma komutuyla tekrar açın.

Performansın büyük kısmı spigot.yml içindeki entity-activation-range ve bukkit.yml içindeki spawn limitlerinden gelir. Donanımda kısmayın: 8 GB’ın altında RAM, düşük frekanslı işlemci veya SATA disk, yaptığınız bütün ayarı boşa çıkarır.

Uzun vadede yeni kurulumlarda Paper daha doğru bir tercihtir; Spigot’tan geçiş yalnızca jar değişimidir ve mevcut eklentileriniz olduğu gibi çalışmaya devam eder. Hazır, Ryzen tabanlı ve DDoS korumalı bir sunucuyla başlamak isterseniz Batihost Minecraft paketlerini inceleyebilir, takıldığınız noktada destek talebi açabilirsiniz.