Minecraft 1.21 Sunucu Kurulumu

Minecraft 1.21 sunucu kurulumu üç şeye bağlıdır: Java 21, 1.21 hattına uygun bir sunucu jar’ı ve en az 8 GB RAM ayrılmış bir makine. Bunlar tamamsa kurulum yarım saatten kısa sürer. 1.21 hattı bugün Minecraft’ın en güncel sürümü değil — güncel kararlı sürüm 26.2 “Chaos Cubed” — ama mod ve eklenti ekosisteminin en olgunlaştığı hat olduğu için hâlâ binlerce sunucu bu sürümde çalışıyor.

Bu rehber 1.21’den 1.21.11’e kadar tüm alt sürümleri kapsıyor: hangi alt sürümü seçeceğinizi, hangi sunucu yazılımının 1.21 için hâlâ jar yayınladığını, doğru JVM bayraklarını, eklenti uyumluluk sınırlarını ve ileride 26.x’e geçmek isterseniz izlemeniz gereken yolu adım adım anlatıyor. İşletim sistemine özel ekran adımları için Windows kurulum rehberine veya Linux ve Ubuntu kurulum rehberine geçebilirsiniz.

1.21 Alt Sürümleri: Hangisini Kurmalısınız?#

“1.21 sunucusu” tek bir şey değil; hat içinde on bir ayrı yapı var ve bunlar protokol düzeyinde birbirine uyumlu değil. Yani 1.21.4 istemcisi, 1.21.11 sunucusuna doğrudan bağlanamaz. Kurulum yapmadan önce hangi alt sürümde kalacağınıza karar verin, çünkü dünya dosyası bir kez yeni sürümde açıldığında geriye dönmek kolay değildir.

Pratik karar kuralı: Sizi bir modpack ya da eklenti bağlamıyorsa 1.21.11 kurun. Bir modpack kuruyorsanız o modpackin yazdığı sürümü birebir kurun; “bir üst sürüm de çalışır” varsayımı Forge ve Fabric tarafında neredeyse hiç tutmaz.

Java 21 Gereksinimi ve Doğru Dağıtım Seçimi#

1.21 hattının tamamı Java 21 ister. Bu, 1.20.5 ile başlayan ve 1.21.11’de biten bir aralıktır. Java 17 ile 1.21 sunucusu başlatmaya çalışırsanız sunucu daha açılmadan UnsupportedClassVersionError ile düşer — bu hatanın ayrıntılı çözümü Java sürüm hatası sayfasında.

Dağıtım olarak Eclipse Temurin ilk tercihtir; Amazon Corretto ve Azul Zulu da sorunsuz çalışır. Oracle JDK’dan uzak durun, lisans onayı gerektirir ve sunucu tarafında hiçbir avantaj sağlamaz. Sürümler arası farkların tamamı için hangi Java sürümü gerekir sayfasına göz atın.

1.21 İçin Sunucu Yazılımı Seçimi#

1.21 hattının en büyük avantajı, neredeyse tüm sunucu yazılımlarının bu sürüm için jar yayınlamış olması. 26.x’e geçtiğinizde bu seçenek listesi ciddi biçimde daralıyor.

Kararsızsanız Paper kurun. Vanilla’ya kıyasla chunk yükleme, varlık (entity) işleme ve tick planlaması tarafında ciddi kazanç sağlar, üstelik eklenti kurabilmenizi mümkün kılar. Jar’ı indirdikten sonraki yapılandırma adımları için Paper sunucu kurulumu ve yapılandırma rehberi yol gösterir.

1.21 Sunucusu İçin Donanım#

Minecraft’ın ana tick döngüsü tek bir çekirdekte çalışır. Bu yüzden 32 çekirdekli düşük frekanslı bir sunucu işlemcisi, 8 çekirdekli yüksek saat hızlı bir Ryzen’in yanında lag yer. Donanım seçerken çekirdek sayısına değil, çekirdek başına performansa bakın.

Disk tarafında NVMe SSD şart. 1.21 ile gelen daha büyük chunk verisi, HDD veya SATA SSD üzerinde chunk okuma/yazma gecikmesini görünür hale getirir; oyuncular bunu “dünya geç yükleniyor” diye tarif eder. Türkiye lokasyonunda düşük pingli, ücretsiz DDoS korumalı Minecraft sunucu paketlerimiz 156 TL’den başlıyor; kendi makinenizi yönetmek isterseniz yüksek frekanslı Ryzen VDS tarafına bakabilirsiniz.

Adım Adım Minecraft 1.21 Sunucu Kurulumu#

1. Java 21’i kurun ve doğrulayın#

   Temurin JDK 21’i kurduktan sonra sürümü mutlaka doğrulayın. Makinede birden fazla Java varsa sistem yanlış olanı seçebilir.

   java -version
   # Beklenen çıktı:
   # openjdk version "21.0.12" 2025-...
   # OpenJDK Runtime Environment Temurin-21...

   Sürüm 21 dışında bir şey yazıyorsa Java yolunu düzeltin: Windows’ta JAVA_HOME ve PATH ortam değişkenleri, Linux’ta update-alternatives --config java komutu doğru sürümü seçmenizi sağlar.

2. Sunucu klasörünü oluşturun ve jar’ı indirin#

   Sunucu dosyalarını boş bir klasöre koyun; Minecraft başlatıldığı dizine onlarca dosya ve klasör açar. Paper indirme sayfasında önce sürüm seçicisinden 1.21.11 (veya kullanacağınız alt sürüm) seçilir, sonra en güncel build indirilir. Otomatik kurulum betiği yazıyorsanız sabit dosya adı yerine resmî API’yi kullanın:

   curl -s https://fill.papermc.io/v3/projects/paper/versions/1.21.11/builds/latest

3. Sunucuyu bir kez çalıştırıp EULA’yı kabul edin#

   İlk çalıştırmada sunucu eula.txt üretip kapanır. Bu normaldir. Dosyayı açıp eula=false satırını eula=true yapın ve kaydedin.

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

   Bu adımı atlarsanız sunucu her açılışta “You need to agree to the EULA” uyarısı basıp kapanır.

4. Başlatma komutunu doğru bayraklarla yazın#

   12 GB RAM’li bir paket için heap değerini 10 GB verin, kalanı işletim sistemine ve JVM’in heap dışı kullanımına bırakın. Xms ve Xmx daima eşit olmalıdır.

   java -Xms10G -Xmx10G --add-modules=jdk.incubator.vector \
     -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 \
     -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch \
     -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M \
     -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 \
     -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 \
     -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 \
     -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 \
     -Daikars.new.flags=true -jar paper.jar --nogui

   Windows’ta aynı komut tek satır hâlinde bir start.bat dosyasına, Linux’ta start.sh dosyasına yazılır. Bayrakların ne işe yaradığını RAM ayarları ve JVM flag’leri sayfasında tek tek açıkladık. 12 GB’ın üzerinde heap veriyorsanız Aikar’s Flags’te G1NewSizePercent=40, G1MaxNewSizePercent=50, G1HeapRegionSize=16M, G1ReservePercent=15 ve InitiatingHeapOccupancyPercent=20 değerlerini kullanın.

5. Portu açın ve bağlantıyı test edin#

   Java Edition varsayılan portu 25565/TCP’dir. Sunucu güvenlik duvarında bu portu açmadan dışarıdan bağlantı gelmez. Kendi bilgisayarınızdan test ederken localhost ile bağlanmak yeterli değildir; dış IP ile de deneyin. Evdeki bir modem arkasından yayın yapıyorsanız modem üzerinde de port yönlendirmesi gerekir.

6. server.properties dosyasını yapılandırın#

   Sunucu ilk açılışta varsayılan ayarlarla gelir. En az şu satırları elden geçirin: motd, max-players, view-distance, simulation-distance, online-mode, difficulty.

1.21 İçin server.properties Ayarları#

1.21 hattında performansı en çok etkileyen iki ayar view-distance ve simulation-distance. View distance oyuncunun gördüğü chunk yarıçapıdır, simulation distance ise sunucunun canavar, redstone ve büyüme hesabı yaptığı yarıçap. İkincisi CPU’ya çok daha pahalıya mal olur.

server-port=25565
motd=§bBatihost §fTest Sunucusu §8| §7 1.21.11
max-players=40
online-mode=true
view-distance=8
simulation-distance=6
difficulty=normal
spawn-protection=0
enable-command-block=false
network-compression-threshold=256
max-tick-time=60000
sync-chunk-writes=false

online-mode=true ayarını kapatmayın; kapattığınızda herkes istediği nickle girebilir ve OP hesabınız ele geçirilebilir. Kırık istemcilere açık bir sunucu işletiyorsanız AuthMe gibi bir giriş eklentisi zorunludur. Tüm satırların açıklaması için server.properties tam liste sayfasına bakın.

1.21’de Eklenti ve Mod Uyumluluğu#

1.21 hattı eklenti tarafında rahat bir hat; büyük projelerin hepsi bu sürümü destekliyor. Yine de sürüm sınırları var:

• WorldEdit: 7.4.x serisi 1.21.4 öncesiyle uyumsuzdur. 1.21, 1.21.1 veya 1.21.3 kullanıyorsanız 7.3.x hattını indirin.
• WorldGuard: WorldEdit’i ön koşul olarak ister; ikisinin sürümlerini birbiriyle uyumlu seçin.
• EssentialsX: 1.21 hattının tamamında sorunsuz çalışır.
• LuckPerms: Bukkit/Paper, Fabric, Forge, NeoForge ve Velocity için ayrı yapılar sunar; platformunuza uygun jar’ı indirin.
• CoreProtect: 1.16.5 ile 26.1.2 arasını destekler, 1.21 hattında sorun çıkarmaz.
• PlaceholderAPI: 1.21 için eski sürümler yeterlidir; 26.2’ye geçerseniz 2.12.3’e yükseltmek zorunludur.

Yeni İstemcilerin 1.21 Sunucusuna Bağlanması#

Oyuncularınız oyunu güncelledikçe 26.2 istemcisiyle sunucunuza girmeye çalışacak ve “Outdated server” uyarısı alacaklar. Bunu çözmenin iki yolu var: sunucuyu yükseltmek ya da sunucuya ViaVersion kurmak.

ViaVersion, sunucuya kurulan tek taraflı bir eklentidir; oyuncuların hiçbir şey yüklemesi gerekmez. Paper 1.8 ile 26.2 arasını destekler, yani 1.21.11 sunucunuza 26.2 istemcisiyle girilebilir hale gelir. Tersini isterseniz — yani 1.16 istemcisinin 1.21 sunucusuna girmesi — ViaBackwards, 1.8 ve öncesi için ViaRewind gerekir.

1.21 Kurulumunda Sık Karşılaşılan Hatalar#

UnsupportedClassVersionError#

Sunucu Java 17 veya daha eskisiyle başlatılıyor demektir. java -version çıktısını kontrol edin, birden fazla JDK kuruluysa başlatma betiğinde Java 21’in tam yolunu yazın.

Failed to bind to port#

25565 portu başka bir işlem tarafından kullanılıyor. Genellikle önceki sunucu süreci düzgün kapanmamıştır. Süreci sonlandırın veya server-port değerini değiştirin.

Can’t keep up! Is the server overloaded?#

Sunucu tick’leri 50 ms’de yetiştiremiyor. En yaygın nedenler: yetersiz heap, yüksek simulation distance, aşırı entity birikimi ve yavaş disk. Önce simulation-distance değerini 6’ya çekin, sonra spark profiler ile darboğazı ölçün.

OutOfMemoryError: Java heap space#

Heap dolmuş. 8 GB’ın altında heap verdiyseniz yükseltin; zaten yüksekse bellek sızdıran bir eklenti veya aşırı chunk yüklemesi söz konusudur. Heap değerini “ne kadar çok o kadar iyi” mantığıyla da vermeyin; makinenin toplam RAM’inin tamamını heap yapmak GC duraklamalarını uzatır.

1.21’den 26.x’e Yükseltme Yol Haritası#

Bir gün 26.2’ye geçmek isteyeceksiniz. Bu geçiş, 1.20’den 1.21’e geçmeye benzemez; arada bir ABI kırılması var.

26.1 ile birlikte Mojang obfuscated sunucu jar’ı yayınlamayı bıraktı. Paper dahili remapper’ını tamamen kaldırdı, Spigot desteğini düşürdü, Fabric ise Yarn’ı bırakıp Mojang Mappings’e geçti. Sonuç: 1.21.11 ve öncesinde derlenmiş hiçbir mod ve NMS kullanan hiçbir eklenti, yeniden derlenmeden 26.1 ve üstünde çalışmaz.

1. Eklenti ve mod envanteri çıkarın#

   plugins klasöründeki her jar için geliştiricinin 26.2 sürümü yayınlayıp yayınlamadığını kontrol edin. Bir tanesi bile yoksa geçiş planınız eksiktir.

2. Java 25’e geçin#

   26.1 ve sonrası Java 25 ister. Java 21 ile 26.2 sunucusu açılmaz. Java 26 çıktı ama LTS değil; sunucuda Java 25 LTS kullanın.

3. Dünyayı kopyalayıp test sunucusunda deneyin#

   Dünya klasörünü canlı sunucudan kopyalayıp ayrı bir 26.2 kurulumunda açın. Sürüm yükseltmesi dünya verisini dönüştürür ve bu işlem geri alınamaz.

4. Yedek alın, sonra canlıya geçin#

   Yükseltmeden önce dünya klasörünün, plugins dizininin ve tüm yapılandırma dosyalarının tam yedeğini alın. Sunucu kapalıyken alınan yedek, çalışırken alınandan güvenilirdir.

Sürüme özel kurulum adımları için 26.2 “Chaos Cubed” kurulum sayfasına geçebilirsiniz. Daha eski bir hatta ineceksiniz diyorsanız 1.20 sunucu kurulumu rehberi hazır.

Özetle#

Minecraft 1.21 sunucusu kurmak için Java 21, 1.21 hattına uygun bir Paper veya Purpur jar’ı ve en az 8 GB RAM’li Ryzen tabanlı bir makine yeterli. Yeni kurulumlarda 1.21.11 seçin, EULA’yı kabul edin, Aikar’s Flags ile başlatın, simulation-distance değerini 6 civarında tutun ve sunucuyu servis olarak çalıştırın. Yeni istemcilerin bağlanması için ViaVersion tek başına yeterli.

26.x’e geçmeyi planlıyorsanız asıl işi eklenti envanteri oluşturuyor: unobfuscation nedeniyle eski jar’lar yeniden derlenmeden çalışmaz. Kurulum sürecinin tamamına kuşbakışı bakmak isterseniz Minecraft sunucu kurulumu ana rehberi tüm adımları tek sayfada topluyor.