Windows’ta BuildTools ile Spigot Sunucu Kurulumu

Windows’ta Spigot sunucu kurulumu diğer sunucu yazılımlarından tek bir noktada ayrılır: hazır bir jar indiremezsiniz, BuildTools aracıyla Spigot’u kendi bilgisayarınızda derlemeniz gerekir. Derleme komutu tek satırdır, işlem 10-30 dakika sürer ve sonunda elinizde çalışmaya hazır bir spigot-26.2.jar dosyası olur.

Bu rehber baştan sona Windows üzerinden ilerler: Dosya Gezgini, Komut İstemi, Not Defteri ve Windows Defender Güvenlik Duvarı. Windows 10, Windows 11 ve Windows Server 2022/2025 için adımlar aynıdır. Spigot’un ne olduğu, Bukkit ile ilişkisi ve spigot.yml ayarlarının tam listesi için işletim sisteminden bağımsız Spigot sunucu kurulumu ve BuildTools kullanımı sayfamıza bakabilirsiniz.

Baştan bir uyarı: yeni bir sunucu açıyorsanız çoğu senaryoda doğru tercih Spigot değil Paper’dır. Paper aynı eklentileri çalıştırır, hazır jar olarak indirilir ve daha yüksek TPS verir. Yine de derleme sürecini bilmek gerekir; eklenti geliştiriyorsanız veya belirli bir uyumluluk nedeniyle saf Spigot istiyorsanız aşağıdaki adımlar tam olarak izlemeniz gerekenlerdir.

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

Spigot ve CraftBukkit, Mojang’ın sunucu kodunun üzerine yama uygulayarak üretilir. Bu kodu içeren bir derlemeyi paketleyip dağıtmak lisans açısından mümkün değildir. SpigotMC’nin çözümü şu oldu: sunucu jar’ını dağıtmak yerine, jar’ı sizin makinenizde üreten bir araç dağıtmak. BuildTools tam olarak bunu yapar.

BuildTools çalıştığında sırasıyla şunları yapar:

• Gerekirse taşınabilir bir Git sürümünü indirir ve Maven’i hazırlar.
• BuildData, Bukkit, CraftBukkit ve Spigot depolarını klonlar.
• Mojang’ın ilgili sürüm için sunucu jar’ını indirir.
• Yamaları uygular ve kaynak kodu derler.
• Çalışma klasörüne spigot-26.2.jar ve craftbukkit-26.2.jar dosyalarını bırakır.

Windows’ta BuildTools İçin Gerekenler#

Derleme, sunucu çalıştırmaktan farklı bir yük profiline sahiptir: kısa süreliğine tüm çekirdekleri kullanır ve çok sayıda küçük dosya yazar. Gereken üç şey şudur:

Java

Minecraft 26.2 derlemesi için JDK 25 (JRE değil, JDK). Eclipse Temurin JDK 25 önerilir.

Disk

Yaklaşık 3 GB boş alan. Depolar, Maven önbelleği ve ara derleme dosyaları bu alanı doldurur.

İnternet

Kesintisiz bağlantı. Derleme sırasında yüzlerce Maven bağımlılığı indirilir; kopma derlemeyi yarıda bırakır.

Git

Zorunlu değil. Sistemde Git yoksa BuildTools taşınabilir bir sürümü kendisi indirir.

Sunucunun kendisini çalıştıracağınız donanım tarafında ise şu tablo geçerlidir. Minecraft’ın ana tick döngüsü tek çekirdekte döndüğü için belirleyici olan çekirdek sayısı değil, saat hızıdır.

İndirmeniz Gereken Dosyalar#

BuildTools.jar dosyasını Jenkins sayfasındaki son başarılı yapının Artifacts bölümünden indirin. 19 Nisan 2026 tarihli build #200 güncel yapıdır; sayfa her zaman en yenisini gösterir.

Derleme Klasörünü Hazırlama#

BuildTools çalışırken bulunduğu klasöre onlarca dosya ve klasör açar. Bu yüzden onu boş, kısa yollu ve İngiliz alfabesi dışında karakter içermeyen bir dizine koyun. Dosya Gezgini ile C:\ kökünde şu klasörü oluşturun:

C:\buildtools\

İndirdiğiniz BuildTools.jar dosyasını bu klasöre taşıyın. Aşağıdaki yerlerde derleme yapmayın:

• Masaüstü veya Belgeler. Kullanıcı adınızda Türkçe karakter varsa (C:\Users\Ömer\Desktop) derleme yol hatasıyla düşer.
• OneDrive ile eşitlenen klasörler. OneDrive derleme sırasında dosyaları kilitler, yama uygulama adımı başarısız olur.
• Program Files. Yazma izni gerektirir ve yolda boşluk vardır.
• Ağ sürücüsü veya harici disk. Binlerce küçük dosya yazıldığı için derleme çok yavaşlar.

Spigot’u Derleme: Adım Adım#

1. Komut İstemi’ni doğru klasörde açın#

   Dosya Gezgini’nde C:\buildtools klasörünü açın, adres çubuğuna cmd yazıp Enter’a basın. Komut İstemi doğrudan o dizinde açılır. Alternatif olarak Başlat menüsünden cmd açıp şu komutu verin:

   cd /d C:\buildtools

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

   Sisteminizde Git kuruluysa bu komutu mutlaka çalıştırın. Windows’ta varsayılan olarak açık gelen otomatik satır sonu dönüşümü, yama uygulama adımını bozan bir numaralı sebeptir.

   git config --global core.autocrlf false

3. Derlemeyi başlatın#

   Güncel kararlı sürüm olan 26.2 için:

   java -jar BuildTools.jar --rev 26.2

   Konsolda uzun bir günlük akmaya başlar. Depolar klonlanır, Mojang sunucu jar’ı indirilir, yamalar uygulanır ve Maven derlemeyi yürütür. Pencereyi kapatmayın.

4. Başarı mesajını bekleyin#

   İşlem bittiğinde konsolun son satırlarında şuna benzer bir çıktı görürsünüz:

   [BuildTools] Success! Everything completed successfully. Copying final .jar files now.
   Copying spigot-26.2.jar to C:\buildtools\.
     - Saved as .\spigot-26.2.jar

5. Üretilen dosyaları kontrol edin#

   C:\buildtools klasöründe spigot-26.2.jar ve craftbukkit-26.2.jar dosyalarını göreceksiniz. Size gereken Spigot olanıdır; CraftBukkit yalnızca eklenti geliştirme ve geriye dönük test için vardır.

Sık kullanılan BuildTools parametreleri#

Parametreleri birleştirebilirsiniz. Derlemeyi doğrudan sunucu klasörüne çıkarmak en pratik kullanımdır:

java -jar BuildTools.jar --rev 26.2 --compile spigot --output-dir C:\minecraft\spigot

Sunucu Klasörünü Kurma ve start.bat#

Derleme klasörünü sunucu klasörü olarak kullanmayın; içinde gigabaytlarca ara dosya vardır. Ayrı bir dizin açın ve jar’ı oraya kopyalayıp adını sadeleştirin:

mkdir C:\minecraft\spigot
copy C:\buildtools\spigot-26.2.jar C:\minecraft\spigot\spigot.jar

Ardından aynı klasörde start.bat dosyasını oluşturun. Dosya Gezgini’nin Görünüm sekmesinden Dosya adı uzantıları kutusunu işaretlemeyi unutmayın; aksi hâlde dosya start.bat.txt olarak kaydedilir ve çift tıklayınca Not Defteri açılır.

@echo off
title Spigot 26.2 Sunucusu
cd /d C:\minecraft\spigot
java -Xms6G -Xmx6G -jar spigot.jar --nogui
pause

Buradaki -Xms6G -Xmx6G değerleri 8 GB’lık bir paket içindir; işletim sistemine pay bırakmak için heap’i paketin tamamı kadar vermeyin. 12 GB pakette -Xms10G -Xmx10G, 16 GB pakette -Xms14G -Xmx14G, 32 GB pakette -Xms28G -Xmx28G kullanın. Xms ve Xmx daima eşit olmalıdır. Betiğin otomatik yeniden başlatmalı ve çöp toplayıcı bayraklı sürümleri start.bat dosyası oluşturma ve RAM ayarları sayfasında.

İlk Çalıştırma, EULA ve Yapılandırma#

start.bat dosyasına çift tıklayın. İlk çalıştırmada sunucu açılmaz, “You need to agree to the EULA in order to run the server” mesajıyla kapanır. Klasörde oluşan eula.txt dosyasını Not Defteri ile açın ve son satırı değiştirin:

eula=true

Betiği ikinci kez çalıştırdığınızda Spigot dünyayı üretir. Konsolda Done (…)! For help, type "help" satırını gördüğünüzde sunucu ayaktadır. Kapatmak için pencereyi çarpıyla değil, konsola stop yazarak kapatın; aksi hâlde son kayıttan sonraki ilerleme kaybolur.

Bu aşamada klasör şöyle görünür:

C:\minecraft\spigot\
├── logs\
│   └── latest.log
├── plugins\
├── world\
├── world_nether\
├── world_the_end\
├── bukkit.yml
├── commands.yml
├── eula.txt
├── server.properties
├── spigot.jar
├── spigot.yml
└── start.bat

Sunucu kapalıyken server.properties dosyasını Notepad++ ile açıp temel ayarları yapın:

server-port=25565
server-ip=
motd=Batihost Spigot Sunucusu
max-players=40
online-mode=true
view-distance=8
simulation-distance=6
spawn-protection=0
enable-command-block=false

server-ip satırını boş bırakın; buraya bir adres yazmak sunucunun dışarıdan bağlantı kabul etmemesine yol açan klasik hatadır. Satırların tamamının anlamı server.properties ayarları tam listesi sayfasında.

Spigot’a özgü ayarlar ise spigot.yml dosyasındadır. Performans açısından en çok işe yarayan bölüm varlık aktivasyon menzilleridir:

world-settings:
  default:
    entity-activation-range:
      animals: 16
      monsters: 24
      misc: 8
    merge-radius:
      item: 3.5
      exp: 4.0
    mob-spawn-range: 6
    save-structure-info: true

Bu değerlerin ne işe yaradığını ve hangi sunucu tipinde nasıl ayarlanacağını paper.yml, spigot.yml ve bukkit.yml optimizasyon rehberi sayfasında ayrıntılı anlattık.

Güvenlik Duvarında 25565 Portunu Açma#

Sunucu çalışsa bile Windows dışarıdan gelen TCP bağlantılarını varsayılan olarak engeller. Yönetici yetkisiyle açılmış PowerShell’de tek komutla gelen kural oluşturun:

New-NetFirewallRule -DisplayName "Minecraft Spigot 25565 TCP" -Direction Inbound -Protocol TCP -LocalPort 25565 -Action Allow

Arayüzü tercih ediyorsanız Başlat menüsüne wf.msc yazıp Gelişmiş Güvenlik Özellikli Windows Defender Güvenlik Duvarı’nı açın ve Gelen Kuralları > Yeni Kural > Bağlantı Noktası > TCP > 25565 yolunu izleyin. Kuralı Etki Alanı, Özel ve Genel profillerinin üçünde de etkinleştirin. Ekran ekran anlatım Windows güvenlik duvarında Minecraft portu açma sayfasında.

BuildTools Derleme Hataları ve Çözümleri#

Derleme bir kez hata verdiyse en güvenli yol temiz başlangıçtır: C:\buildtools klasörünün içindeki her şeyi silin, yalnızca BuildTools.jar dosyasını bırakın ve komutu yeniden çalıştırın. Yarım kalmış bir depo klonu, sonraki denemeleri de bozar.

Sunucu tarafında karşılaşacağınız UnsupportedClassVersionError hatası ise derlemeyle değil çalıştırmayla ilgilidir; makinede yanlış Java sürümü aktif demektir. Çözümü Minecraft Java sürüm hatası sayfasında.

Eklenti Kurulumu ve Sunucuyu 7/24 Açık Tutma#

Eklentiler C:\minecraft\spigot\plugins klasörüne .jar olarak atılır ve sunucu yeniden başlatılır. Çalışan sunucuya eklenti atıp reload komutu vermeyin; bellek sızıntısı ve yarım yüklenmiş eklenti sorunları çıkarır. Bağımlılık sırası, sürüm uyumu ve konsolda hangi satırın aranacağı gibi ayrıntılar için Minecraft sunucusuna plugin kurulumu sayfasına bakın.

Konsol penceresi kapandığında sunucu da düşer. RDP oturumunuzu kapatsanız bile sunucunun ayakta kalması için start.bat dosyasını NSSM ile bir Windows servisine dönüştürün; services.msc üzerinden başlangıç türünü “Otomatik” yaptığınızda makine her açıldığında sunucu kendiliğinden kalkar. Kurulum adımları Minecraft sunucusunu Windows servisi olarak 7/24 çalıştırma sayfasında.

Spigot mu Paper mı? Windows’ta Hangisi#

Derleme sürecini tamamladıktan sonra dürüst bir karşılaştırma yapmakta fayda var. Paper, Spigot’un çatallamasıdır: aynı Bukkit/Spigot API’sini uygular, aynı eklentileri çalıştırır ama çekirdekte yüzlerce ek performans yaması taşır.

Spigot’tan Paper’a geçiş çok kolaydır: sunucuyu stop ile kapatın, spigot.jar dosyasını klasörden çıkarın, Paper jar’ını paper.jar adıyla koyun ve start.bat içindeki dosya adını güncelleyin. Dünya, eklentiler ve server.properties olduğu gibi kalır. Adım adım anlatım için Windows’ta Paper Minecraft sunucusu kurulumu sayfasına geçebilirsiniz.

Kendi bilgisayarınızda derleyip test ettiğiniz sunucuyu oyuncuya açacaksanız ev bağlantısı yerine kiralık bir sunucu kullanın. Panelli hazır bir Minecraft sunucu paketi derleme adımını tamamen ortadan kaldırır; Windows üzerinde tam kontrol istiyorsanız yüksek frekanslı bir Ryzen tabanlı VDS üzerinde bu rehberi RDP ile birebir uygulayabilirsiniz.

Özetle#

Windows’ta Spigot kurulumu şu zincirdir: Temurin JDK 25 kur, C:\buildtools klasörünü aç, BuildTools.jar dosyasını oraya koy, git config --global core.autocrlf false ayarını yap ve java -jar BuildTools.jar --rev 26.2 komutuyla derle. Çıkan spigot-26.2.jar dosyasını ayrı bir sunucu klasörüne spigot.jar adıyla kopyala, start.bat yaz, ilk çalıştırmadan sonra eula.txt dosyasını true yap ve güvenlik duvarında 25565/TCP portunu aç.

Derleme hatalarının büyük bölümü üç sebepten çıkar: yolda boşluk veya Türkçe karakter olması, Git’in satır sonu ayarı ve yanlış JDK sürümü. Bu üçünü baştan doğru yaparsanız derleme tek seferde biter. Windows tarafındaki tüm kurulum konularının toplandığı ana sayfa ise Windows’ta Minecraft sunucu kurulumu rehberidir.