Minecraft Sunucusu Yeni Sürüme Nasıl Yükseltilir?

Minecraft sunucusunu yeni sürüme yükseltmek, jar dosyasını değiştirip sunucuyu başlatmaktan ibaret değildir. Doğru sıra şudur: önce tam yedek, sonra Java kontrolü, sonra eklenti uyum listesi, en son jar değişimi ve ilk açılış logunun okunması. Bu sırayı bozan sunucular genellikle yükseltmeden sonra değil, birkaç gün sonra sorun yaşar; çünkü bozulma anında değil, oyuncular yeni bölgelere gittikçe ortaya çıkar.

2026 sürümleriyle birlikte yükseltme eskisinden daha riskli hâle geldi. Minecraft 26.1 “Tiny Takeover” (24 Mart 2026, protokol 775) hem Java 25 zorunluluğu getirdi hem de sunucu jar’ının obfuscation katmanını tamamen kaldırdı. Güncel kararlı sürüm olan 26.2 “Chaos Cubed” (16 Haziran 2026, protokol 776) da aynı temeli kullanıyor. Bu iki değişiklik birleşince, 1.21.11 döneminden gelen eklenti ve modların önemli bir kısmı yeniden derlenmeden çalışmaz hâle geldi.

Bu rehberde yükseltmeyi baştan sona, atlanan adım bırakmadan anlatıyoruz: neyin yedekleneceğinden dünya dönüşümüne, eklenti uyum tablosundan işler ters giderse uygulayacağınız geri dönüş planına kadar.

Yükseltmeye Başlamadan Önce: Kontrol Listesi#

Aşağıdaki altı maddeyi tamamlamadan jar dosyasına dokunmayın. Her biri birkaç dakika sürer ve saatlerce süren kurtarma çalışmasını önler.

Hedef sürümü netleştirin

26.2 mi, 26.1.2 mi? Ara sürüm atlamak Minecraft’ta sorun değildir; dünya dönüştürücü aradaki adımları kendisi uygular.

Java sürümünü doğrulayın

26.1 ve sonrası Java 25 ister. Yükseltmeden önce java -version çıktısını görün.

Eklenti listesini çıkarın

plugins/ klasöründeki her jar’ın adını ve sürümünü bir yere yazın. Kontrol edilmemiş tek eklenti bile sunucuyu kilitleyebilir.

Bakım penceresi ilan edin

Oyunculara en az 24 saat önceden duyurun. Yükseltme sırasında sunucu kapalı olmalıdır.

Tam yedek alın

Sunucu /stop ile kapalıyken. Çalışan sunucudan kopyalanan dünya bozuk çıkabilir.

Geri dönüş kararını verin

Yükseltme başarısız olursa yedekten dönmeye ne kadar süre ayırabilirsiniz? Bu süreyi baştan belirleyin.

Sürüm numaralandırmasının neden 1.21’den 26.1’e atladığını merak ediyorsanız Minecraft’ın yeni sürüm numaralandırma şemasını anlatan sayfamıza göz atın; yükseltme planı yaparken hangi sürümün hangisinden yeni olduğunu bilmek işinizi kolaylaştırır.

Hangi Sürüme Yükselteceğinize Karar Verin#

Yükseltme kararı “en yeniye geç” kadar basit değildir. Sunucunuzun ayakta kalması, eklentilerinizin desteklediği en yüksek sürüme bağlıdır. Üç seçeneğiniz var:

Ara sürüm atlamak sorun değildir: 1.21.11’den doğrudan 26.2’ye geçebilirsiniz, dünya dönüştürücüsü aradaki adımları kendisi uygular. Ancak 26.1 ve 26.2 arasında bir tercih yapıyorsanız, karar verici etken eklenti listenizdir; sürümün yeniliği değil.

Oyuncular Eski Sürümdeyse#

Yükseltmenin en görünür sonucu, güncellemeyi kaçıran oyuncuların “Outdated client” uyarısıyla giremez hâle gelmesidir. ViaVersion ve ViaBackwards ikilisi bu boşluğu kapatır: sunucunuz 26.2 çalışırken 1.8’e kadar geriye giden istemcilerin bağlanmasına izin verirler. ViaVersion 5.11.0 doğrulanmış olarak Paper 1.8–26.2 aralığını destekliyor.

Bu bir uyumluluk katmanıdır, sihir değildir: eski istemciler yeni blokları ve eşyaları göremez, bazı arayüz öğeleri bozuk görünebilir. Kalıcı çözüm oyuncuların launcher’dan sürüm değiştirmesidir. Bağlanamayan oyunculara ne söyleyeceğinizi “Outdated Server” ve “Outdated Client” hatası sayfasından hazır olarak alabilirsiniz.

Adım 1 — Tam Yedek Alın#

PaperMC’nin resmî yükseltme dokümanı yedeklenmesi gerekenleri dört başlıkta topluyor: dünya klasörleri, sunucu yapılandırma dosyaları, eklenti yapılandırma dosyaları ve eklenti JAR’ları. Pratikte en kolayı sunucu klasörünün tamamını arşivlemektir.

# Sunucuyu once duzgun kapatin (konsolda):  stop
# Ardindan tarihli tam arsiv:
tar -czf yedek-$(date +%F-%H%M).tar.gz world plugins server.properties *.yml config/

# Sadece dunya klasorleri (hizli yedek):
tar -czf dunya-$(date +%F).tar.gz world

# Windows sunucularda, sunucu KAPALIYKEN:
$tarih = Get-Date -Format "yyyy-MM-dd-HHmm"
Compress-Archive -Path C:\minecraft\server\* -DestinationPath C:\yedek\mc-$tarih.zip

Yedeği aldıktan sonra arşivi açıp içinde world/level.dat dosyasının bulunduğunu doğrulayın. Açılmayan bir arşiv yedek değildir.

Adım 2 — Java Sürümünü Doğrulayın#

Yükseltmede en sık takılınan yer burasıdır. 26.1 ve sonrası Java 25 ister; Java 21 kurulu bir makinede 26.2 jar’ı hiç açılmaz ve oyuncular sunucuyu çevrimdışı görür.

java -version
# 26.1+ icin ciktida "25" gormeniz gerekir, ornek:
# openjdk version "25.0.4" 2026-07-15

Yanlış Java ile açmayı denerseniz konsolun ilk satırlarında şu hatayı görürsünüz:

java.lang.UnsupportedClassVersionError: net/minecraft/bundler/Main has been compiled by a
more recent version of the Java Runtime (class file version 69.0), this version of the
Java Runtime only recognizes class file versions up to 65.0

Buradaki sayılar doğrudan Java sürümüne karşılık gelir. 69.0 Java 25, 65.0 Java 21 demektir; yani mesaj “jar Java 25 ile derlenmiş ama sen Java 21 çalıştırıyorsun” diyor. Aynı hata bir eklenti için de çıkabilir: Java 25 ile derlenmiş bir eklenti, Java 21 üzerindeki sunucuda “Could not load” ile değil UnsupportedClassVersionError ile düşer.

Java 26 çıktı ancak LTS değil; sunucu tarafında Java 25 LTS’te kalın. Hangi dağıtımı seçeceğinize karar veremiyorsanız Minecraft sunucusu için hangi Java sürümü gerekir sayfası konuyu ayrıntılı anlatıyor. Hata metnini birebir arayarak buraya geldiyseniz UnsupportedClassVersionError çözüm sayfası daha hedefli.

Adım 3 — Eklenti Uyumluluğunu Önceden Kontrol Edin#

Yükseltmenin gerçek zorluğu burada. 26.1 ile Mojang obfuscated sunucu jar’ı yayınlamayı bıraktı; Paper dahilî remapper’ı tamamen kaldırdı, Spigot desteği düşürdü, Fabric ise Yarn’ı bırakıp Mojang Mappings’e geçti. Bu bir sürüm değişimi değil, bir ABI kırılmasıdır: 1.21.11 ve öncesi için derlenmiş, NMS (net.minecraft.server) katmanına dokunan hiçbir eklenti yeniden derlenmeden 26.1+ üzerinde çalışmaz.

java.lang.NoSuchMethodError: 'org.bukkit.attribute.Attribute
org.bukkit.craftbukkit.attribute.CraftAttribute.minecraftToBukkit(...)'

java.lang.NoClassDefFoundError: net/minecraft/server/v1_XX_RX/...

Hâlâ 1.21.11 üzerindeyseniz, yükseltmeden önce hangi eklentilerin kırılacağını şu bayrakla test edebilirsiniz. Bayrak Paper’ın remapper’ını kapatır ve 26.x koşullarını taklit eder:

java -Dpaper.disablePluginRemapping=true -jar paper-1.21.11.jar nogui

Aşağıdaki tablo, 26.x’e geçen sunucularda en sık kullanılan eklentilerin doğrulanmış durumunu gösteriyor. Kendi listenizi yaparken her eklentinin indirme sayfasındaki “supported versions” etiketine bakın; forum başlığındaki iddiaya değil.

Uyumsuz eklentiyle karşılaştığınızda okumanız gereken satır konsolun ikinci satırıdır; ilk satır sadece “yüklenemedi” der, nedeni bir alttaki satır söyler. Bu ayrımın örnekleri “Could not load plugin” hatası çözüm sayfasında tek tek gösteriliyor.

Adım 4 — Sunucu Jar’ını Değiştirin#

1. Sunucuyu düzgün durdurun#

   Konsola stop yazın. Süreci kill -9 ile ya da Görev Yöneticisi’nden sonlandırmayın; yarıda kalan chunk yazımı bozuk region dosyası üretir.

2. Yeni jar’ı indirin ve klasöre koyun#

   Eski jar’ı silmeyin, adını değiştirip saklayın. Paper build numarası her yamada artar, bu yüzden sabit dosya adına güvenmeyin.

   mv paper-1.21.11-238.jar paper-eski.jar
   wget -O paper-26.2-112.jar "https://fill.papermc.io/v3/projects/paper/versions/26.2/builds/latest"

3. Başlatma komutundaki jar adını güncelleyin#

   start.sh ya da start.bat dosyasında eski jar adı kalırsa sunucu eski sürümle açılır ve yükselttiğinizi sanırsınız.

   java -Xms14G -Xmx14G -jar paper-26.2-112.jar nogui

4. JVM bayraklarını olduğu gibi bırakın#

   Yükseltme sırasında çöp toplayıcıyı değiştirmeyin. Tek seferde tek değişken oynatın; bir sorun çıkarsa nedenin jar mı bayrak mı olduğunu bilemezsiniz.

Adım 5 — Eklentileri update Klasörüyle Güncelleyin#

Eklenti jar’larını doğrudan plugins/ içinde değiştirmek yerine Bukkit’in yerleşik plugins/update/ mekanizmasını kullanın. Sunucu açılışta buradaki jar’ları eskilerinin üzerine taşır; bu, dosya kilidi ve yarım kopyalama sorunlarını ortadan kaldırır.

mkdir -p plugins/update
cp ~/indirilenler/LuckPerms-Bukkit-5.5.57.jar plugins/update/
cp ~/indirilenler/PlaceholderAPI-2.12.3.jar   plugins/update/
# sunucuyu baslatin; Paper guncellemeleri otomatik uygular

Eklenti yapılandırma dosyalarını silmeyin. Çoğu eklenti yeni sürümde eksik anahtarları kendisi ekler; sıfırdan config üretmek yetki gruplarınızı ve bölge ayarlarınızı kaybettirir. Bir kurala dikkat edin: jar dosyası plugins/ klasörünün kökünde olmalıdır, alt klasörler taranmaz.

Adım 6 — İlk Açılış ve Dünya Dönüşümü#

İlk açılışı mutlaka konsolu izleyerek yapın. Sunucuyu arka plana atıp gitmeyin; kritik uyarılar ilk 30 saniyede basılır. Dünya dönüşümü varsayılan olarak kademelidir: Paper chunk’ları oyuncular o bölgeye gittikçe yeni formata çevirir. Bu, tek seferde tüm dünyayı taramaktan çok daha hızlıdır.

Tüm dünyayı bir kerede dönüştürmek isterseniz iki CLI bayrağı var:

# Tum dunyayi tek seferde donustur (uzun surer):
java -Xms14G -Xmx14G -jar paper-26.2-112.jar --nogui --forceUpgrade

# Heightmap ve isik verisini de sifirla (yeniden hesaplanir):
java -Xms14G -Xmx14G -jar paper-26.2-112.jar --nogui --forceUpgrade --eraseCache

26.1 ile Değişen Dünya Klasör Yapısı#

Yükseltmeden sonra dünya klasörünüzün içi tanıdık gelmeyecek. 26.1 ile boyutlar (dimension) world/dimensions/ altında ayrı klasörlere taşındı. İnternetteki eski kurtarma ve düzenleme tarifleri artık yanlış yol veriyor:

# 26.1 ve sonrasi (GECERLI):
world/dimensions/minecraft/overworld/region/r.0.0.mca
world/dimensions/minecraft/the_nether/region/
world/dimensions/minecraft/the_end/region/
world/dimensions/minecraft/<boyut>/{data,entities,poi,region}/
world/data/minecraft/

# 26.1 oncesi (ARTIK GECERSIZ):
world/region/
world_nether/DIM-1/region/
world_the_end/DIM1/region/

Bu değişiklik yedekleme betiklerinizi de etkiler. world_nether ve world_the_end klasörlerini tek tek arşivleyen eski bir betiğiniz varsa artık boş klasör arıyor olabilir; yedeğinizde Nether ve End verisi hiç bulunmayabilir. Betiğinizi world/ klasörünün tamamını alacak şekilde güncelleyin. Bozuk bir region dosyasıyla karşılaşırsanız doğru yolları bozuk dünya kurtarma sayfasında bulabilirsiniz.

Yükseltme Sonrası Doğrulama#

Sunucu açıldı diye iş bitmedi. Oyunculara kapıyı açmadan önce şu altı kontrolü yapın:

1. Açılış logunu baştan sona okuyun#

   WARN ve ERROR satırlarını süzün. Hangi satırın önemli olduğunu ayırt etmek için sunucu logu okuma rehberimize bakın.

   grep -E '/(WARN|ERROR|FATAL)\]' logs/latest.log | head -40

2. Sürümü konsoldan teyit edin#

   Konsola version yazın. Çıktıda beklediğiniz Minecraft sürümü ve build numarası görünmeli.

3. Her eklentinin etkin olduğunu görün#

   plugins komutunda kırmızı görünen eklenti yüklenememiş demektir. Yeşil görünmesi çalıştığını garanti etmez; asıl test bir sonraki adımdır.

4. Kritik özellikleri elle deneyin#

   Ekonomi, ev sistemi, bölge koruma, arazi satın alma, kit verme — hepsini tek tek çalıştırın. NMS kaynaklı hatalar sadece burada ortaya çıkar.

5. Üç boyuta da girin#

   Overworld, Nether ve End’e teker teker gidin. Dönüşüm hataları çoğu zaman yalnızca bir boyutta görülür.

6. TPS ve bellek durumuna bakın#

   Birkaç oyuncuyla 15–20 dakika test edin. Dönüşüm sırasında disk yükü artacağı için ilk saatlerde TPS dalgalanması normaldir.

Sorun Çıkarsa: Geri Dönüş Planı#

Yükseltme sonrası ciddi bir sorun yaşarsanız aklınızdaki ilk soru “eski sürüme dönebilir miyim” olacak. Cevap net: sürüm düşürme mümkün değildir. Minecraft dünya verisini DataFixerUpper ile ileri taşır ve bu dönüşümün tersi yoktur. Yeni sürümde bir kez yüklenen chunk kalıcı olarak yeni formata geçmiştir.

Somut kırılmalar şunlardır: yeni sürümde eklenen bloklar eski sürümün blok kayıt defterinde bulunmadığı için hava (air) olur ya da chunk hatası verir; yeni NBT verisi taşıyan eşyalar envanterden düşer; ilerlemeler ve harita verileri okunamayabilir.

Dolayısıyla tek geri dönüş yolunuz Adım 1’de aldığınız yedektir:

# Sunucuyu durdurun, bozuk dunyayi kenara alin (SILMEYIN):
mv world world-26x-bozuk

# Yedegi geri acin:
tar -xzf yedek-2026-08-12-0300.tar.gz

# Eski jar ile baslatin:
java -Xms14G -Xmx14G -jar paper-eski.jar nogui

Test Sunucusuyla Risksiz Yükseltme#

Oyuncu sayısı arttıkça “dener bakarız” yaklaşımının maliyeti büyür. Profesyonel yöntem, canlı sunucuya dokunmadan önce yükseltmeyi bir kopya üzerinde provasını yapmaktır:

1. Dünyanın kopyasını ayrı bir klasöre açın#

   Yedek arşivinizi /opt/minecraft/test gibi ikinci bir dizine çıkarın ve server.properties içindeki server-port değerini 25566 gibi farklı bir porta alın.

2. Yükseltmeyi orada uygulayın#

   Yeni jar, yeni eklenti sürümleri, aynı yapılandırma. Kaç eklentinin kırıldığını burada görürsünüz.

3. Kırılan eklentiler için karar verin#

   Alternatif eklenti mi, güncellemeyi beklemek mi, o özelliği kapatmak mı? Kararı canlı sunucu kapalıyken değil, şimdi verin.

4. Canlıya sadece çalıştığını gördüğünüz şeyi taşıyın#

   Bakım penceresini test aşamasında değil, uygulama aşamasında kullanın. Prova yapılmış bir yükseltme 15 dakikada biter.

Test için ikinci bir makineye ihtiyacınız varsa aynı fiziksel sunucuda farklı port kullanmak çoğu durumda yeterlidir; ama dönüşüm sırasında disk ve CPU yükü artacağı için canlı sunucunun yoğun saatlerinde yapmayın. Ayrı bir test ortamını uzun süre tutacaksanız Batihost Minecraft sunucu paketlerinden küçük bir test paketi açmak en temiz yöntemdir; canlı sunucunuzun kaynaklarına hiç dokunmazsınız.

Sık Yapılan Yükseltme Hataları#

Yedek almadan başlamak

Listenin bir numarası. Geri dönüşü olmayan tek adım budur.

Java’yı unutmak

Jar değişti ama Java 21 kaldı. Sunucu hiç açılmaz, oyuncular çevrimdışı görür.

“Sunucu açıldı, tamamdır” demek

NMS kırılmaları açılışta değil, özellik ilk kullanıldığında ortaya çıkar.

Tüm eklentileri aynı anda güncellemek

Bir sorun çıkınca hangisinin sebep olduğunu bulamazsınız. Kritik eklentileri gruplar hâlinde güncelleyin.

Başlatma dosyasındaki jar adını değiştirmemek

Sunucu eski sürümle açılır; saatlerce “neden hâlâ eski sürüm” diye aranırsınız.

Yükseltmeyle birlikte JVM bayraklarını da değiştirmek

İki değişkeni aynı anda oynatmak teşhisi imkânsızlaştırır.

--forceUpgrade bayrağını unutmak

Her yeniden başlatmada tüm dünya yeniden taranır.

Oyunculara haber vermemek

Beklenmeyen kapanma, aktif oyuncu kaybının en hızlı yoludur.

Panelden Yükseltme Yapanlar İçin#

Pterodactyl, Pelican ya da Batihost web paneli kullanıyorsanız adımların mantığı aynıdır, yalnızca arayüz değişir. Sırayla: panel üzerinden yedek oluşturun, sunucuyu durdurun, sürüm seçicisinden hedef sürümü seçin, Java imajını 25’e alın, eklenti jar’larını dosya yöneticisiyle güncelleyin, konsolu izleyerek başlatın.

Paneldeki en sık atlanan ayrıntı Java imajıdır: panel sunucu jar’ını 26.2 yapar ama Java 21 imajında bırakırsanız konsolda yine class file version 69.0 hatasını görürsünüz. Panel adımlarının ekran ekran anlatımı için web panelden sunucu sürümü değiştirme sayfasına bakın; yedek alma ve geri yükleme düğmeleri de aynı panelin içindedir.

Özetle#

Minecraft sunucusu yükseltmek, disiplinli bir sırayla yapıldığında yarım saatlik rutin bir bakım işidir; sıra bozulduğunda ise günlerce süren bir kurtarma operasyonuna dönüşür. Aklınızda kalması gereken dört şey var: yükseltmeden önce mutlaka tam yedek alın, 26.1+ için Java 25 kurun, eklentilerinizin 26.2 sürümlerini önceden kontrol edin ve ilk açılış logunu satır satır okuyun.

26.1 ile gelen unobfuscation ve dünya klasörü değişikliği, bu yükseltmeyi önceki yıllarınkinden farklı kılıyor. Eski eklentileriniz sessizce yüklenip çalışma anında patlayabilir; eski yedekleme betikleriniz yanlış klasöre bakıyor olabilir. İkisini de yükseltmeden önce gözden geçirin.

Yükseltme sırasında takıldığınız bir nokta olursa 26.2 sunucu kurulumu ve güncelleme sayfası hedef sürüme özel ayrıntıları veriyor; çözemediğiniz bir hata kalırsa destek talebi açarak konsol çıktısını iletebilirsiniz.