Web Panelden Sunucu Sürümü Nasıl Değiştirilir?

Web panelden sunucu sürümü değiştirmek, “Başlangıç (Startup)” sekmesindeki sürüm alanını güncelleyip “Yeniden Kur (Reinstall)” düğmesine basmaktan ibarettir. Panel eski jar dosyasını yenisiyle değiştirir, kurulum betiğini çalıştırır ve sunucu yeni sürümle açılmaya hazır hâle gelir. Toplam işlem 1-3 dakika sürer.

Ama işin kolay kısmı burası. Asıl dikkat edilmesi gereken şey sürüm değişiminin yan etkileri: eklentilerin uyumu, Java sürümünün eşleşmesi, dünya dosyasının dönüştürülmesi ve oyuncuların bağlanabilmesi. Bu sayfada hem düğmeye basma adımlarını hem de basmadan önce yapmanız gerekenleri sırayla göreceksiniz.

Paneli ilk kez kullanıyorsanız önce web panel ile Minecraft sunucusu kurma rehberini okuyun; oradaki sekme isimleri bu sayfada da geçiyor.

Panelde Sürüm Değiştirmek Aslında Ne Yapar?#

Panelde gördüğünüz “sürüm” alanı, sunucunun çalıştırdığı .jar dosyasını belirler. Sürümü değiştirdiğinizde panel arka planda şunları yapar:

1. Seçtiğiniz yazılımın (Paper, Purpur, vanilla, Forge, Fabric) resmî indirme kaynağına bağlanır.
2. Yazdığınız Minecraft sürümü için en güncel yapıyı indirir.
3. Eski jar dosyasının üzerine yazar.
4. Gerekirse kütüphaneleri (libraries klasörü) yeniler.

Dikkat edin: bu işlem yalnızca sunucu yazılımını değiştirir. Dünyanız, eklentileriniz, server.properties dosyanız ve yapılandırmalarınız yerinde kalır. Sorunlar da tam olarak buradan çıkar — eski eklentiler yeni jar ile karşılaştığında yüklenmeyi reddedebilir.

Sürüm Değiştirmeden Önce Yapılacak 4 Kontrol#

Aşağıdaki dört maddeyi atlamadan uygulayın. Her biri, sonradan saatlerinizi alacak bir sorunu baştan engelliyor.

1. Yedek alın#

Panelin “Yedekler (Backups)” sekmesine girip Yedek Oluştur düğmesine basın. Yedek tamamlanmadan sürüm değiştirmeye başlamayın. Bu, geri dönüşü olan tek adımdır; sürüm değişimi sonrası dünya açılmazsa yapabileceğiniz tek şey yedeği geri yüklemektir. Ayrıntı: panelden yedek alma ve geri yükleme.

2. Mevcut sürümünüzü not edin#

Konsolda sunucu açılırken yazan satır size hem yazılımı hem sürümü söyler. Bir yere kopyalayın; geri dönmeniz gerekirse bu bilgi lazım olacak.

[Server thread/INFO]: Starting minecraft server version 26.2
[Server thread/INFO]: This server is running Paper version 26.2-112
[Server thread/INFO]: Loading properties
[Server thread/INFO]: Default game type: SURVIVAL

3. Eklenti listenizi çıkarın#

Sunucu açıkken konsola plugins yazın. Yeşil renkte görünenler çalışıyor, kırmızı görünenler zaten yüklenememiş demektir. Bu listeyi bir kenara kaydedin; sürüm değişiminden sonra hangi eklentinin düştüğünü karşılaştırarak bulacaksınız.

4. Hedef sürümün Java karşılığını öğrenin#

Sürüm değişimiyle birlikte Java sürümünü de değiştirmeniz gerekebilir. Aşağıdaki tablo hangi Minecraft sürümünün hangi Java’yı istediğini gösteriyor.

Java sürümü konusunda kafanız karışırsa Minecraft sunucusu için hangi Java sürümü gerekir sayfası tüm ayrıntıyı veriyor.

Adım Adım: Panelden Sürüm Yükseltme#

Yedeğiniz hazırsa başlayalım. Aşağıdaki altı adım Pterodactyl, Pelican ve bunlara benzeyen tüm panellerde aynı şekilde işler.

1. Oyuncuları uyarın ve sunucuyu durdurun#

   Konsola say Sunucu bakima aliniyor, 2 dakika icinde kapanacak yazıp oyunculara haber verin. Sonra save-all komutunu çalıştırıp dünyanın diske yazılmasını bekleyin. Ardından Durdur (Stop) düğmesine basın. “Öldür (Kill)” düğmesini kullanmayın.

2. Başlangıç sekmesinde sürümü değiştirin#

   Başlangıç (Startup) sekmesine geçin. “Minecraft Version”, “VERSION” ya da “Sürüm” adlı alana yeni sürümü yazın. Build numarası soran bir alan varsa latest bırakabilirsiniz; panel o sürümün en güncel yapısını indirir.

   MINECRAFT_VERSION = 26.2
   BUILD_NUMBER      = latest
   SERVER_JARFILE    = server.jar

3. Java sürümünü (Docker Image) güncelleyin#

   Aynı sekmedeki “Docker Image” listesinden hedef sürümün istediği Java’yı seçin. 26.1 ve 26.2 için Java 25. Bu adımı atlarsanız sunucu açılışta hemen kapanır ve konsolda sınıf sürümü hatası 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

4. Değişiklikleri kaydedin#

   Alanları doldurduktan sonra sayfadan ayrılmadan kaydedin. Bazı paneller alan dışına tıkladığınızda otomatik kaydeder, bazılarında ayrı bir Kaydet düğmesi vardır. Kaydetmeden yeniden kurulum başlatırsanız panel eski sürümü indirir.

5. Yeniden kurulumu başlatın#

   Ayarlar (Settings) sekmesine geçip Yeniden Kur (Reinstall Server) düğmesine basın. Panel sizden onay ister. İşlem sırasında konsolda indirme çıktısı akar; “Installation completed” benzeri bir satır gördüğünüzde kurulum bitmiştir.

6. Sunucuyu başlatıp konsolu okuyun#

   Başlat deyin ve konsolu satır satır izleyin. İlk açılış, dünya verisi yeni biçime dönüştürüleceği için normalden uzun sürer. Done satırını gördüğünüzde sürüm değişimi tamamlanmıştır. Sonra version komutuyla doğrulayın.

   version

Sunucu Yazılımını Değiştirme (Paper, Purpur, Forge Arası Geçiş)#

Bazen amaç sürüm yükseltmek değil, yazılım değiştirmektir: vanilla’dan Paper’a geçmek, Paper’dan Purpur’a geçmek gibi. Bu işlem de aynı sekmeden yapılır ama sonuçları farklıdır.

En sık yapılan geçiş vanilla’dan Paper’adır ve neredeyse hiç sorun çıkarmaz. En riskli geçiş ise eklentili bir sunucudan modlu bir sunucuya geçiştir: eklenti ve mod ekosistemleri birbiriyle uyumlu değildir. Modlu tarafa geçecekseniz web panel üzerinden modlu sunucu kurma sayfasındaki yolu izleyin.

Hangi yazılımın size uyduğuna karar veremediyseniz sunucu yazılımları karşılaştırması sayfasındaki tablo yardımcı olur.

26.2’ye Geçerken Eklenti Uyumu#

Bu bölüm 26.2’ye yükselenler için kritik. Minecraft 26.1 ile Mojang obfuscated (karartılmış) sunucu jar’ı yayınlamayı bıraktı. Bu, sadece sürüm değişimi değil, bir ABI kırılmasıdır: sunucunun iç sınıflarını (NMS) doğrudan kullanan eklentiler ve tüm modlar, yeniden derlenmeden 26.1 ve 26.2’de çalışmaz.

Sık kullanılan eklentilerin 11 Ağustos 2026 itibarıyla durumu:

Eklentileri güncelledikten sonra jar dosyalarını yüklemek için panelden plugin yükleme sayfasındaki adımları izleyin. Eski jar’ları plugins klasöründen silmeyi unutmayın; aynı eklentinin iki sürümü bir arada durursa sunucu hata verir.

Sürüm Düşürme (Downgrade) Yapılabilir mi?#

Kısa cevap: sunucu yazılımını düşürebilirsiniz, dünyanızı düşüremezsiniz. Minecraft, bir dünya klasörünü yeni sürümde açtığı anda veri biçimini (data version) yükseltir ve bu işlem geri alınamaz.

Elinizde iki senaryo var:

Yedeğiniz varsa

Panelde sürümü eski değere çevirin, Java sürümünü de geri alın, yeniden kurun ve yükseltmeden önceki yedeği geri yükleyin. Yükseltmeden sonra oynanan süre kaybolur ama dünya sağlam açılır.

Yedeğiniz yoksa

Eski sürüm dünyayı büyük ihtimalle açmaz veya chunk’ları bozuk yükler. Yeni bir dünya ile devam etmek zorunda kalabilirsiniz. Bu, yedek almanın neden ilk adım olduğunun en net kanıtıdır.

Oyuncuların Sürümüyle Sunucunun Sürümü Uyuşmazsa#

Sürüm değiştirdiğinizde oyuncular bağlanamaz hâle gelir; çünkü Minecraft protokolü sürüme bağlıdır. 26.1 protokol 775, 26.2 protokol 776 kullanır. Oyuncular launcher’dan sunucununkiyle aynı sürümü seçmelidir.

İki hata mesajının anlamı farklıdır:

• Outdated server: Oyuncu yeni, sunucu eski. Sunucuyu yükseltmeniz gerekir.
• Outdated client: Sunucu yeni, oyuncu eski. Oyuncunun launcher’dan sürüm değiştirmesi gerekir.

Ayrıntılı çözüm için Outdated Server ve Outdated Client hatası sayfasına bakın.

Oyuncularınızın farklı sürümlerden bağlanabilmesini istiyorsanız ViaVersion ailesi işinizi görür. ViaVersion yeni istemcilerin eski sunucuya, ViaBackwards eski istemcilerin yeni sunucuya bağlanmasını sağlar. ViaRewind ise 1.7 ve 1.8 gibi çok eski istemcileri kapsar.

Sürüm Değişiminden Sonra Karşılaşılan 5 Sorun#

1. Sunucu açılmıyor, konsol hemen kapanıyor#

Java sürümünü kontrol edin. 26.1 ve sonrası Java 25 ister; panelde Docker Image hâlâ Java 21’de kalmışsa sunucu açılmaz. Hata mesajı UnsupportedClassVersionError içeriyorsa sorun kesinlikle budur. Ayrıntı: Java sürüm hatası çözümü.

2. Eklentilerin yarısı yüklenmedi#

Konsolda plugins komutunu çalıştırın; kırmızı görünenler yüklenmemiş demektir. Konsolda o eklentinin adının geçtiği hata satırını arayın. Genelde iki sebebi olur: eklenti sürümü sunucu sürümünü desteklemiyor ya da bir bağımlılık eklentisi (örneğin Vault veya WorldEdit) eksik.

3. Dünya açılıyor ama chunk’lar bozuk görünüyor#

Büyük sürüm atlamalarında olabilir. Sunucuyu hemen durdurun ve yedeği geri yükleyin. Kademeli yükseltme (önce ara sürüme, sonra hedefe) bazı durumlarda daha temiz sonuç verir.

4. Yapılandırma dosyaları eskisi gibi çalışmıyor#

Yeni sürümlerde paper-global.yml ve benzeri dosyalara yeni anahtarlar eklenir, bazıları kaldırılır. Sunucu ilk açılışta eksik anahtarları kendi ekler. Elle yaptığınız optimizasyonları gözden geçirin; kaldırılmış bir ayarı zorlamak sunucunun uyarı basmasına yol açar.

5. TPS düştü#

Yeni sürüm yeni mekanikler getirir ve bunların bir CPU maliyeti vardır. Önce view-distance ve simulation-distance değerlerini gözden geçirin. Sorun sürerse spark profiler ile hangi eklentinin yük oluşturduğunu ölçün.

Sürüm Yükseltme Ne Zaman Yapılmalı?#

Minecraft’ın yeni sürümü çıktığı gün sunucunuzu yükseltmek zorunda değilsiniz. Sağlıklı bir sıra şudur:

1. Yeni sürüm çıkar, oyuncular sizden ister.
2. Sunucu yazılımınızın (Paper, Purpur) o sürüm için kararlı yapısı yayınlanır.
3. Kullandığınız eklentilerin hepsi yeni sürümü destekleyen sürüm çıkarır.
4. Yedek alıp yükseltirsiniz.

Üçüncü madde tamamlanmadan yükselten sunucular genelde birkaç gün içinde eski sürüme dönmek zorunda kalır. Bu arada oyuncularınızı beklemede tutmak istemiyorsanız ViaVersion ile yeni istemcilerin eski sunucuya bağlanmasına izin verebilirsiniz.

26.2’ye geçişin sunucu tarafındaki tüm ayrıntıları için Minecraft 26.2 sunucu kurulumu ve güncelleme sayfasına da göz atın.

Özetle#

Panelden sürüm değiştirme dört adımdan oluşur: yedek al, “Başlangıç” sekmesinde sürümü ve Java’yı güncelle, “Yeniden Kur” de, konsolu izleyerek başlat. Teknik iş bu kadar; geri kalan her şey uyum kontrolüdür.

Aklınızda kalması gerekenler: 26.1 ve sonrası Java 25 ister; 26.1 ile gelen unobfuscation eski eklentileri kırar; CoreProtect gibi bazı eklentiler henüz 26.2’yi desteklemiyor; dünya sürümü geri alınamaz, tek çözüm yedektir.

Yükseltmeden sonraki iş listeniz için panelden plugin yükleme ve panel dosya yöneticisi kullanımı sayfalarına geçin. Sürüm geçişinde takılırsanız destek talebi açın.