Minecraft UnsupportedClassVersionError çözümü

Wispdock kontrol paneli henüz hazır değil. Bir adımda “kontrol panelinde” yazıyorsa, sağlayıcının dosyalar, konsol ve başlat/durdur için sunduğu araçları kullan. Minecraft tarafı her yerde aynı çalışır.

Hata mesajındaki iki sayıyı ayır

java.lang.UnsupportedClassVersionError: ...
class file version 65.0, this version of the Java Runtime only recognizes class file versions up to 61.0

Bu, hatayı göstermek için kısaltılmış bir örnektir; Wispdock’tan alınmış sunucu günlüğü değildir. İlk sayı derlenmiş sınıfın sürümünü, ikinci sayı onu yüklemeye çalışan Java’nın sınırını gösterir:

Mesajdaki sınıf bir eklentiye veya moda aitse daha yeni Java isteyen yalnızca o bileşen olabilir. Adını bulmak için günlük okuma rehberini kullan. Eski sunucunun Java’sını düşünmeden yükseltmek yerine bileşenin uyumlu sürümünü seç.

Minecraft sürümüne uygun Java’yı seç

Tablo bu eski sürüm ailelerini kapsar; bundan sonraki her Minecraft sürümünün Java 21 kullanacağı anlamına gelmez. Özellikle daha yeni sürümlerde veya özel uyumluluk yamaları içeren eski paketlerde dağıtımın ve yükleyicinin gereksinimini kontrol et. Java 21 geçişi Minecraft 1.20.5 sürüm notlarında açıklanır. Paper’ın desteklediği sürümler için kendi kurulum belgesine bak.

Gerçekte çalışan Java yolunu doğrula

Sunucuyu başlatan hesap ve ortamda şu komutları çalıştır:

java -version
which java

Windows Komut İstemi’nde:

java -version
where java

Windows birden fazla yol gösterebilir; normalde ilk eşleşen çalıştırılabilir dosya kullanılır. Servis, betik veya konteyner farklı PATH ya da doğrudan Java yolu kullanabilir. Java 21 kurmak, Java 17 ile açılan komutu kendiliğinden değiştirmez. Minecraft istemci başlatıcısının kendi Java’sı da bağımsız sunucunun Java’sını seçmez.

Debian veya Ubuntu’da gerekli Java zaten kuruluysa sistem varsayılanını seçebilirsin:

sudo update-alternatives --config java

Bu seçim, aynı sistem bağlantısını kullanan diğer komutları da etkiler. Yalnızca bu sunucuyu değiştirmek için başlangıç betiğine Java’nın tam yolunu yaz. amd64 Debian tarzı kurulumda örnek:

/usr/lib/jvm/java-21-openjdk-amd64/bin/java -version
/usr/lib/jvm/java-21-openjdk-amd64/bin/java -Xms4G -Xmx4G -jar server.jar nogui

Kendi makinendeki yolu kullan; dağıtım ve işlemci mimarisine göre değişir. Komutu sunucu klasöründe çalıştır, örnekteki 4G belleği kendi sınırına göre ayarla. Üretilmiş başlatma betiği kullanan yükleyicilerde kütüphane argümanlarını silmek yerine betiğin Java seçimini düzelt.

Panelde Java veya Docker imajını değiştir

Sunucuyu durdur. Paneldeki Java sürümü veya Docker imajı alanından Minecraft ve yükleyicinin istediği çalışma ortamını seç, kaydet ve bir kez başlat. Ana makinenin terminali Java 21 gösterirken sunucu konteyneri hâlâ Java 17 kullanabilir. İmaj alanı kilitliyse sağlayıcıdan değiştirmesini iste.

Minecraft Java sunucusu için yardım isterken sınıf sürümü hatasını, Minecraft ve yükleyici sürümünü, seçili Java’yı birlikte gönder. Wispdock paneli henüz hazırlık aşamasında; alan adları sağlayıcıya göre değişir. Vanilla, Paper ve mod yükleyicilerini ayırmak için sunucu yazılımı rehberine bak.

Ters durum: Eski Forge için Java fazla yeni

Standart Forge 1.12–1.16 paketleri çoğunlukla Java 8 bekler. Daha yeni Java, başlatma katmanını, reflection erişimini veya eski kütüphaneleri bozabilir; ClassCastException ya da InaccessibleObjectException görülebilir. Bu ayrı bir uyumluluk sorunudur. Yeni Java normalde eski sınıfı yalnızca sınıf sürüm numarası küçük diye reddetmez.

Eski sunucu için paketin önerdiği Java 8’i kullan. Modern sunucular için Java 21 ayrı kurulu kalabilir. Paketin talimatlarını kontrol etmeden modları silme veya rastgele JVM bayrakları ekleme. Java seçimini değiştirmeden önce dünyayı ve başlangıç betiğini yedekle; gerekirse önceki kuruluma dönebilirsin.

Java seçimini ve açılışı doğrula

Tam yolunu yazdığın Java’yı -version ile denetle; ardından panel veya sunucu başlangıç çıktısından kullanılan sürüme bak. Sınıf sürümü hatası kaybolmalı ve günlükte Done görünmeli. Yalnızca bir eklenti hata veriyorsa uyumlu derlemesini kur. Sunucu açılıyor ama bağlanamıyorsan bağlantı rehberine ve server.properties ayarlarına geç. İstemcinin Minecraft sürümüyle sunucunun Java sürümü ayrı kontrollerdir.

Read this guide in English

Wispdock’un taslak paketlerinde vanilla ve eklentiler için 4 GB, mod paketleri için 8 GB seçeneği var. Ayrıntılar fiyatlar sayfasında; fiyatlar henüz taslak ve sipariş almıyoruz.

Hâlâ çözemedin mi? Ayrıntıları ve latest.log dosyanı bize gönder.