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

Yukarıdaki satır kısaltılmış bir örnek; Wispdock’taki bir sunucunun günlüğünden alınmadı. İ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. Bu durumda sunucunun Java’sını hemen yükseltme; o eklentinin ya da modun senin sürümüne uyan bir sürümünü bul.

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

Tablo yalnızca bu sürüm ailelerini kapsıyor; bundan sonraki her Minecraft sürümünün Java 21 isteyeceği anlamına gelmez. Yeni sürümlerde ya da uyumluluk yaması içeren eski paketlerde dağıtımın ve yükleyicinin ne istediğine ayrıca bak. 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 Launcher’ın içindeki Java da ayrı; sunucunun hangi Java ile açılacağına karışmaz.

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ü ve seçili Java’yı gönder. Wispdock paneli henüz hazır değil; bu ayarların adı sağlayıcıdan sağlayıcıya 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, sınıf sürümü hatasından farklı bir sorun: yeni Java eski bir sınıfı sırf 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 çalıştırıp sürümüne bak, sonra panelde ya da sunucunun açılış çıktısında hangi Java’nın kullanıldığını kontrol et. 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ç. Oyuncunun Minecraft sürümü ayrı bir konu, sunucunun Java’sıyla ilgisi yok.

Hata sadece bir eklentiyi gösteriyorsa

İlk exception’daki sınıf adına bak. Daha yeni Java hedefiyle derlenen eklentinin eski ve uyumlu bir sürümü olabilir. Sunucunun Java’sını körlemesine değiştirme, geliştiricinin senin Minecraft sürümün için verdiği build’i kur. Java’yı değiştirdiysen kontrolü sunucuyu başlatan betik, servis ya da container üzerinden yap; masaüstündeki terminalin bambaşka bir Java bulabilir.

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.