Minecraft Sunucusu İçin Hangi Java Sürümü Gerekir?

Minecraft sunucusu için hangi Java sürümü gerekir sorusunun cevabı, çalıştırdığınız Minecraft sürümüne bağlıdır. Güncel kararlı sürüm olan 26.2 “Chaos Cubed” ve 26.1 için Java 25 zorunludur. 1.20.5-1.21.11 aralığı Java 21, 1.17-1.20.4 aralığı Java 17, 1.16.5 ve öncesi ise Java 8 ister.

Aşağıdaki tabloyu doğrudan kullanabilirsiniz. Ardından hangi dağıtımı seçeceğinizi, kurulumu nasıl doğrulayacağınızı ve yanlış sürümle karşılaşacağınız hataları açıklıyoruz.

Sürüm Eşleştirme Tablosu#

Java 25 Neden Zorunlu Oldu?#

Mojang, 26.1 “Tiny Takeover” sürümüyle birlikte minimum Java gereksinimini 25’e yükseltti. Bu, yalnızca bir sürüm numarası değişikliği değildi; 26.1 aynı zamanda Minecraft’ın unobfuscated hâle geldiği ilk sürümdür.

Unobfuscation şu anlama gelir: Mojang artık obfuscated (karmaşıklaştırılmış) sunucu jar’ı yayınlamıyor, kod gerçek sınıf ve metot adlarıyla dağıtılıyor. Mod ve eklenti ekosistemi açısından bu bir ABI kırılmasıdır. Paper dahili remapper’ını tamamen kaldırdı, Spigot da düşürdü, Fabric ise Yarn’ı bırakıp Mojang Mappings’e geçti.

Sürüm numaralandırması da 2026’da değişti. Yeni biçim YY.D.H yani yıl, o yılın kaçıncı içerik güncellemesi ve hotfix sayacı şeklindedir. Bu değişikliğin ayrıntıları yeni sürüm numaralandırması sayfamızda.

Hangi Java Dağıtımını Seçmeli?#

Java’nın birden fazla dağıtımı vardır ve hepsi aynı OpenJDK kaynağından derlenir. Aralarındaki fark destek süresi, paketleme ve ek araçlardır.

Kurulu Sürümü Doğrulama#

Kurulumdan sonra ilk iş, sunucunun gerçekten doğru Java’yı kullandığını doğrulamaktır.

java -version
which java
readlink -f $(which java)

java -version
where.exe java
echo $env:JAVA_HOME

Çıktının ilk satırında 26.x sunucusu için openjdk version "25... ile başlayan bir değer görmelisiniz. Görmüyorsanız birden fazla Java kurulu olabilir ve PATH yanlış sürümü işaret ediyordur.

İşletim Sistemine Göre Kurulum#

Bu sayfa işletim sisteminden bağımsızdır; her iki platform için kısa özet aşağıda, ayrıntılı adımlar ayrı rehberlerde.

Linux (Ubuntu / Debian)#

sudo apt update
sudo apt install -y wget apt-transport-https gpg
java -version

Ubuntu, Debian ve AlmaLinux için depo ekleme, paket kurulumu ve update-alternatives ile varsayılan sürüm seçimi dahil tüm adımlar Linux’a Java 25 kurulumu rehberinde.

Windows#

java -version
[Environment]::GetEnvironmentVariable("JAVA_HOME","Machine")

MSI kurulumu, JAVA_HOME ortam değişkeni ayarı ve PATH düzenlemesi için Windows’a Java 25 kurulumu rehberine bakın.

Yanlış Java Sürümüyle Karşılaşacağınız Hatalar#

Java sürümü uyuşmazlığı belirgin ve tanınabilir hatalar üretir.

UnsupportedClassVersionError#

Error: LinkageError occurred while loading main class net.minecraft.server.Main
java.lang.UnsupportedClassVersionError: net/minecraft/server/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

Bu hata net bir mesaj verir: sunucu jar’ı sizin Java sürümünüzden daha yenisiyle derlenmiş. Class file sürümleri Java sürümlerine karşılık gelir; 65.0 Java 21’i, 69.0 Java 25’i işaret eder. Çözüm Java 25 kurmaktır. Ayrıntılı çözüm için Java sürüm hatası sayfamıza bakın.

Eski jar, yeni Java#

Exception in thread "main" java.lang.NoSuchMethodError
Unrecognized VM option 'UseConcMarkSweepGC'

1.12.2 gibi eski bir sunucuyu Java 25 ile başlatmaya çalıştığınızda kaldırılmış JVM bayrakları veya API’ler yüzünden hata alırsınız. Çözüm, o sunucu için Java 8 kurup başlatma betiğinde onu kullanmaktır.

Obsolete bayrak uyarısı#

OpenJDK 64-Bit Server VM warning: Option ZGenerational was deprecated in
version 25 and will likely be removed in a future release.

JEP 490 ile ZGC’nin non-generational modu kaldırıldığı için -XX:+ZGenerational bayrağı Java 25’te obsolete’tir. Doğru kullanım yalnızca -XX:+UseZGC şeklindedir; bayrağı başlatma satırınızdan silin.

Java 25 ile Çöp Toplayıcı Gerçekleri#

Java 25’e geçerken en sık karşılaşılan yanlış bilgiyi düzeltelim. Minecraft 26.1 changelog’undaki “garbage collection has been changed from G1GC to ZGC” satırı oyun istemcisini ilgilendirir; bu, Minecraft Launcher’ın istemci JVM varsayılanıdır. Sunucu jar’ının launcher’ı yoktur, sunucunun çöp toplayıcısını tamamen sizin verdiğiniz bayraklar belirler.

Aikar’s Flags 26.x sunucularında hâlâ geçerlidir; PaperMC’nin resmî dokümanı geri çekilmemiştir. Pratik öneri: 8-12 GB heap için G1GC + Aikar’s Flags, 16 GB ve üzeri heap veya ağır modlu sunucu için ZGC değerlendirilebilir.

# 12 GB paket, Java 25, G1GC
/usr/lib/jvm/temurin-25-jdk/bin/java \
  -Xms10G -Xmx10G \
  -XX:+UseG1GC -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions \
  -XX:+DisableExplicitGC -XX:+AlwaysPreTouch \
  -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 \
  -XX:InitiatingHeapOccupancyPercent=15 \
  -jar paper-26.2.jar nogui

Bayrakların tamamı ve heap planlaması için RAM ayarları ve JVM flag rehberine, pakete göre RAM seçimi için RAM ihtiyacı tablosuna bakın.

Aynı Makinede Birden Fazla Java#

Eski bir 1.12.2 modpacki ve güncel bir 26.2 sunucusunu aynı makinede çalıştırmak çok yaygındır. Çözüm basittir: her sunucunun başlatma betiğinde java’nın tam yolunu belirtin.

#!/bin/bash
# 26.2 sunucusu - Java 25
JAVA=/usr/lib/jvm/temurin-25-jdk/bin/java
$JAVA -Xms14G -Xmx14G -jar paper-26.2.jar nogui

@echo off
REM 1.12.2 modpack - Java 8
set JAVA="C:\Program Files\Eclipse Adoptium\jdk-8\bin\java.exe"
%JAVA% -Xms14G -Xmx14G -jar forge-1.12.2.jar nogui
pause

Windows’ta başlatma dosyası hazırlama için start.bat rehberimize, Linux’ta servis hâline getirmek için systemd rehberine bakabilirsiniz.

Sürüm Yükseltmesi Planlaması#

Eski bir sunucudan 26.2’ye geçecekseniz Java tek başına yeterli değildir. Sırayla kontrol edin:

1. Tam yedek alın#

   Dünya, eklentiler, config dosyaları ve veritabanı. Yedekleme rehberi güvenli yöntemi anlatıyor.

2. Eklenti ve mod uyumunu doğrulayın#

   Her eklentinin 26.2 sürümünün yayınlandığını tek tek kontrol edin. Yayınlanmamış bir eklenti varsa yükseltmeyi erteleyin.

3. Java 25’i kurun ve doğrulayın#

   java -version

4. Test sunucusunda deneyin#

   Üretim sunucusunu doğrudan yükseltmeyin. Kopya bir dizinde 26.2 ile açıp konsol loglarını inceleyin.

5. Yükseltmeyi uygulayın#

   Sorun çıkmazsa üretim sunucusunda aynı adımları tekrarlayın. Kurulum ayrıntıları 26.2 kurulum rehberinde.

Tüm sunucu dosyalarının indirme adreslerini tek sayfada toplayan indirme merkezimiz yükseltme sırasında işinizi kolaylaştırır. Sunucu paketinizde Java’nın hazır kurulu gelmesini isterseniz Minecraft sunucu paketlerimiz Java 25 ile birlikte teslim edilir.

Özetle#

Kural basittir: Minecraft 26.1 ve sonrası Java 25, 1.20.5-1.21.11 Java 21, 1.17-1.20.4 Java 17, 1.16.5 ve öncesi Java 8. Java 26 çıkmış olsa da LTS olmadığı için sunucularda kullanılmamalı.

Dağıtım olarak Eclipse Temurin’i tercih edin; Corretto ve Zulu da güvenilir alternatiflerdir. Kurulumdan sonra java -version ile doğrulayın, birden fazla sürüm varsa başlatma betiğinde tam yol yazın. Son olarak: Java 25’e geçmek 26.x’e geçmek demek değildir. Unobfuscation nedeniyle eski eklenti ve modlarınızın 26.x yapılarını da temin etmeniz gerekir.