Minecraft Sunucu Hataları ve Çözümleri

Minecraft sunucu hataları ilk bakışta sonsuz çeşitlilikte görünse de pratikte dört başlık altında toplanır: sunucu hiç açılmıyor, sunucu açık ama oyuncular bağlanamıyor, sunucu çalışırken çöküyor ve sunucu çalışıyor ama donuyor. Hatanızın hangi gruba girdiğine karar verdiğiniz an, olası neden sayısı yüzlerden birkaça iner. Bu rehber, o dört grubu tek tek açıyor ve her hata için doğrudan uygulanabilir bir çözüm zinciri veriyor.

İçerik 11 Ağustos 2026 tarihli sürüm gerçeklerine göre yazıldı. Güncel kararlı sürüm Minecraft 26.2 “Chaos Cubed” (16 Haziran 2026, protokol 776) ve Java 25 gerektiriyor. 26.1 ile gelen unobfuscation değişikliği eklenti ve mod ekosistemini kökten etkilediği için, 2024–2025 döneminden kalma rehberlerdeki pek çok çözüm artık yanlış sonuç veriyor. Aşağıdaki adımlar bu kırılma dikkate alınarak hazırlandı.

Hata Çözümünün Birinci Kuralı: Logu Okumak#

Minecraft sunucusu hiçbir zaman sessizce ölmez. Her hata için konsola ve logs/latest.log dosyasına bir kayıt düşer. Sorun şu ki çoğu kişi konsolun en son satırına bakar; oysa Java’da asıl neden yığın izinin en altındaki Caused by: bloğudur. Üstteki satırlar hatanın hangi katmanlardan geçtiğini anlatır, nedenini değil.

Sunucu klasöründe şu üç yer sizin teşhis kaynağınızdır:

logs/latest.log

Son çalışmanın tam günlüğü. Sunucu her başladığında sıfırlanır, bir öncekiler logs/2026-08-11-1.log.gz biçiminde arşivlenir.

crash-reports/

Yalnızca sunucu tamamen çöktüğünde dosya oluşur. Çökme anındaki iş parçacıkları, bellek durumu ve yüklü mod listesi buradadır.

Konsol çıktısı

Canlı akış. Sunucu başlatıldıktan sonraki ilk 30 saniyede basılan uyarılar en değerli olanlardır.

Tipik bir hata bloğu şöyle görünür ve okunacak satır kalın olarak işaretlediğimiz sondaki satırdır:

[12:04:31] [Server thread/ERROR]: Encountered an unexpected exception
net.minecraft.ReportedException: Ticking entity
    at net.minecraft.server.level.ServerLevel.tickNonPassenger(ServerLevel.java:812)
    at net.minecraft.server.MinecraftServer.tickChildren(MinecraftServer.java:1394)
Caused by: java.lang.NullPointerException: Cannot invoke "org.bukkit.entity.Player.getWorld()"
    at com.ornekeklenti.listener.JoinListener.onJoin(JoinListener.java:47)

Bu örnekte hata Minecraft’ın kendisinde değil, com.ornekeklenti paket adına sahip bir eklentidedir. Paket adı size doğrudan suçluyu verir. Yığın izinde org.bukkit, io.papermc, net.minecraft dışında bir paket adı görüyorsanız, o eklenti veya modla ilgilenin.

Hızlı Teşhis Tablosu: Hata Metninden Çözüme#

Konsolda gördüğünüz metni aşağıdaki tabloda arayın. Her satır, hatanın gerçek nedenini ve ayrıntılı çözüm sayfasını gösterir.

Sunucu Hiç Açılmıyor: Başlatma Hataları#

Sunucu birkaç saniye içinde kapanıyorsa, sorun oyun mantığında değil ortamdadır. Bu grup en kolay çözülen gruptur çünkü hatalar tek satırlıktır ve neredeyse hiç yoruma açık değildir.

Jar dosyası bulunamıyor#

Error: Unable to access jarfile server.jar mesajı, başlatma betiğinin işaret ettiği dosyanın orada olmadığını söyler. En sık sebep dosya adının farklı olmasıdır: indirdiğiniz dosya paper-26.2-112.jar iken betikte server.jar yazıyordur. İkinci sık sebep, betiğin farklı bir çalışma dizininden çalıştırılmasıdır. Betiği jar ile aynı klasöre koyun ve dosya adını birebir yazın.

EULA kabul edilmemiş#

İlk çalıştırmada sunucu eula.txt dosyasını oluşturur ve kapanır. Dosyayı açıp tek satırı değiştirmeniz gerekir:

# By changing the setting below to TRUE you are indicating your agreement to our EULA.
eula=true

Değeri TRUE veya true yazabilirsiniz, ikisi de kabul edilir. Satırın başına # koymayın; yorum satırı olur ve sunucu yine kapanır.

Java sürümü uyumsuz#

Şu hata mesajı doğrudan Java sürümünü gösterir:

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

Buradaki sayılar sürüm karşılığıdır: 69 = Java 25, 65 = Java 21, 61 = Java 17, 52 = Java 8. Yani sunucu Java 25 ile derlenmiş, sizde Java 21 kurulu. Doğru eşleşme tablosu şudur:

Kurulu sürümü doğrulamak için sunucuyu başlattığınız kabuğun kendisinde şu komutu çalıştırın:

java -version

Birden fazla Java kuruluysa, başlatma betiğinde java yerine tam yol yazmak en güvenli çözümdür. Kurulum ayrıntıları için hangi Java sürümü gerekir sayfamıza bakabilirsiniz.

Port zaten kullanımda#

**** FAILED TO BIND TO PORT! ve altındaki java.net.BindException: Address already in use satırı, 25565 portunu başka bir sürecin tuttuğunu söyler. Genellikle daha önce kapanmamış bir sunucu süreci vardır. Portu kimin tuttuğunu bulmak için:

netstat -ano | findstr :25565

sudo ss -tulpn | grep 25565

Çıktıdaki süreç kimliğini (PID) sonlandırın ya da server.properties içindeki server-port değerini boş bir porta çekin. Aynı makinede birden fazla sunucu çalıştırıyorsanız her birine ayrı port verin; ayrıntılar server.properties ayarları sayfasında.

Sunucu Açık Ama Oyuncular Bağlanamıyor#

Bu grubun ayırt edici testi tektir: sunucunun kendi üzerinden bağlanabiliyor musunuz? Sunucu makinesinde oyunu açıp localhost:25565 adresine bağlanabiliyorsanız Minecraft tarafı sağlamdır, sorun ağdadır. Bağlanamıyorsanız sunucu doğru arayüzü dinlemiyordur.

Connection refused#

io.netty.channel.AbstractChannel$AnnotatedConnectException: Connection refused: no further information mesajı, hedef adreste o portta dinleyen hiçbir şey olmadığını söyler. Paket hedefe ulaşmıştır ve açık bir reddediş almıştır. Kontrol sırası: sunucu gerçekten çalışıyor mu, doğru IP’yi mi yazdınız, server-port değeri girdiğiniz portla aynı mı, server-ip satırı boş mu.

server-ip=
server-port=25565
online-mode=true
enable-status=true

server-ip satırı boş bırakılmalıdır. Buraya bir değer yazarsanız sunucu yalnızca o arayüzü dinler ve dış bağlantılar reddedilir. En sık yapılan yapılandırma hatalarından biridir.

Connection timed out#

Bu hatada paket hedefe gidiyor ama geri hiçbir yanıt gelmiyordur. Reddediş bile yoktur; paket sessizce düşürülmüştür. Suçlu neredeyse her zaman bir güvenlik duvarı ya da eksik port yönlendirmedir. Ev bağlantısında modem üzerinden yönlendirme yapmanız, sunucuda ise 25565/TCP portunu açmanız gerekir. Adımlar port yönlendirme rehberinde anlatılıyor.

Sürüm uyuşmazlığı#

Oyuncu ekranında Outdated server! I’m still on 26.2 yazıyorsa oyuncunun istemcisi sunucudan yenidir. Outdated client! Please use 26.2 yazıyorsa tam tersidir. Protokol numaraları 2026 için şöyledir: 26.1 = 775, 26.2 = 776. Farklı sürümlerdeki oyuncuları aynı sunucuda toplamak istiyorsanız ViaVersion ailesini kurmanız gerekir; bu eklentiler protokol çevirisi yapar ama her özelliği garanti etmez.

Bağlantı Kopmaları: Internal Exception ve Netty Hataları#

Oyuncular giriyor ama bir süre sonra atılıyorsa, karşınızda kurulmuş bir bağlantının koptuğu durum vardır. Tipik mesajlar şunlardır:

Internal Exception: java.io.IOException: An existing connection was forcibly closed by the remote host
Internal Exception: io.netty.handler.timeout.ReadTimeoutException
Internal Exception: java.io.IOException: Connection reset by peer

Bu hataların ayırt edici sorusu şudur: kaç oyuncu etkileniyor? Tek bir oyuncu sürekli atılıyorsa neden o oyuncunun bağlantısı, MTU değeri, VPN’i veya istemci modlarıdır. Herkes aynı anda atılıyorsa sunucu tarafında bir tıkanma, bellek baskısı ya da ana iş parçacığının kilitlenmesi vardır. Sunucu tarafı nedenleri elemek için Internal Exception sayfamızdaki kontrol listesini uygulayın, ham netty istisnaları için io.netty hataları sayfasına geçin.

Sunucu Çalışırken Çöküyor: Bellek ve Watchdog#

Çalışan bir sunucunun aniden kapanmasının iki klasik nedeni vardır.

OutOfMemoryError#

java.lang.OutOfMemoryError: Java heap space satırı, JVM’in ayrılan heap’i doldurduğunu ve daha fazla nesne oluşturamadığını gösterir. Çözüm her zaman “daha fazla RAM” değildir; bazen bir eklenti sızıntı yapıyordur. Ama düşük heap ile çalışan bir sunucuda bu hatayı kovalamanın anlamı yok. Doğru heap değerleri paket boyutuna göre şöyle olmalıdır:

-Xms ve -Xmx daima eşit verilir; JVM’in heap’i sürekli büyütüp küçültmesi gereksiz duraklama üretir. İşletim sistemine ve JVM’in heap dışı belleğine (metaspace, netty doğrudan tamponları) pay bırakmak için toplam RAM’in yaklaşık dörtte birini boş bırakın.

Tipik bir 12 GB paket için başlatma satırı şöyledir:

java -Xms10G -Xmx10G -XX:+UseG1GC -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC \
  -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 \
  -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 \
  -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 \
  -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 \
  -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 \
  -jar paper-26.2-112.jar nogui

Watchdog kapatması#

Şu satırı görüyorsanız sunucu çökmemiş, donmuştur ve Paper’ın watchdog’u onu öldürmüştür:

[Server Watchdog/ERROR]: A single server tick took 60.00 seconds (should be max 0.05)
[Server Watchdog/ERROR]: Considering it to be crashed, server will forcibly shutdown.

Watchdog’un bastığı yığın izi, ana iş parçacığının o anda ne yaptığını gösterir; hatanın gerçek kaynağı orada yazar. Genelde sonsuz döngüye giren bir eklenti, senkron veritabanı sorgusu ya da devasa bir WorldEdit işlemi çıkar. Bu izi nasıl okuyacağınızı crash report okuma rehberimizde anlattık.

Eklenti ve Mod Kaynaklı Hatalar (26.1 Kırılması)#

2026’nın en sık karşılaşılan hata grubu budur. 26.1 ile Mojang obfuscated sunucu jar’ı yayınlamayı bıraktı; sınıf, metot ve alan adları artık gerçek adlarıyla dağıtılıyor. Bunun sonucunda Paper dahili 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 atlaması değil, ABI kırılmasıdır.

Pratik karşılığı şudur: 1.21.11 ve öncesi için derlenmiş hiçbir mod ve NMS kullanan hiçbir eklenti, yeniden derlenmeden 26.1 veya 26.2 üzerinde çalışmaz. Tipik hata mesajları:

[ERROR]: Could not load 'plugins/EskiEklenti.jar' in folder 'plugins'
java.lang.NoClassDefFoundError: net/minecraft/server/v1_21_R1/EntityPlayer
[ERROR]: Plugin EskiEklenti v2.1 has failed to register events
java.lang.NoSuchMethodError: 'void org.bukkit.entity.Player.sendMessage(...)'

Çözüm tek yönlüdür: eklentinin 26.2 için yayınlanmış sürümünü indirin. Geliştirici güncellemediyse alternatif aramanız gerekir. Hangi eklentilerin 26.2 uyumu olduğunu görmek için 2026 eklenti listemize bakın; kurulum ve sıralama mantığı için plugin kurulumu rehberi uygundur.

Yapılandırma Dosyası Hataları#

Sunucu açılıyor ama bir eklenti yüklenmiyorsa, çoğu zaman YAML sözdizimi bozulmuştur. Tipik hata:

while scanning a simple key
 in 'reader', line 14, column 3:
      spawn-protection: 16
      ^
could not find expected ':'

YAML dosyalarında üç kural hataların büyük çoğunluğunu önler: girintide TAB kullanmayın, yalnızca boşluk kullanın; iki nokta üst üsteden sonra bir boşluk bırakın; Türkçe karakter içeren değerleri tırnak içine alın. server.properties tarafında ise dikkat edilecek satırlar şunlardır:

view-distance=8
simulation-distance=6
max-players=40
network-compression-threshold=256
sync-chunk-writes=false
enable-command-block=false

view-distance değerini gerekmedikçe 10’un üzerine çıkarmayın; her artış chunk yükünü karesel biçimde büyütür. Bu değerlerin sunucu yüküne etkisini view distance ve simulation distance sayfasında ayrıntılı anlattık.

Dünya ve Chunk Bozulmaları#

Sunucu belirli bir bölgeye girildiğinde çöküyorsa, region klasöründeki bir .mca dosyası bozulmuş olabilir. Bu genellikle ani güç kesintisi, disk dolması veya sunucunun stop komutu yerine süreç öldürülerek kapatılması sonucu oluşur. Tipik hata satırı Chunk file at [12, -8] is missing block state ya da Failed to save chunk biçimindedir.

Bozuk chunk’ın çözümü basittir ama yedek ister: sorunlu r.X.Z.mca dosyasını sunucu kapalıyken silin, Minecraft o bölgeyi sıfırdan üretir. Oradaki yapılar kaybolur. Bu yüzden düzenli yedek almak bir tercih değil zorunluluktur; yedekleme rehberimizdeki otomatik yöntemleri kurun.

Donanım Kaynaklı Hatalar ve Kalıcı Çözüm#

Bazı hatalar yapılandırmayla çözülmez çünkü sorun kaynak yetersizliğidir. Sürekli Can’t keep up, sık OutOfMemoryError ve chunk yükleme gecikmeleri görüyorsanız altyapıya bakın.

Minecraft’ın ana tick döngüsü tek çekirdekte çalışır. Bu yüzden 32 çekirdekli düşük frekanslı bir sunucu işlemcisi, 8 çekirdekli yüksek saat hızlı bir işlemcinin gerisinde kalır. Doğru tercih her zaman yüksek frekanslı AMD Ryzen’dir: birinci tercih Ryzen 9 7900X veya 7950X, alt sınır Ryzen 9 3900X. Disk tarafında NVMe SSD zorunludur; chunk okuma/yazma I/O gecikmesi doğrudan TPS’e yansır, modlu sunucularda 100 GB ve üzeri alan gerekir.

Kendi donanımınızı yönetmek istemiyorsanız Batihost’un 156 TL’den başlayan Minecraft sunucu paketleri Ryzen tabanlı, NVMe diskli ve ücretsiz DDoS korumalıdır. Modlu sunucular için modlu Minecraft paketlerine, tam kontrol isteyenler için yüksek frekanslı Ryzen VDS seçeneğine bakabilirsiniz.

Hatayı Çözemediğinizde: Doğru Destek Talebi#

Bir noktada dışarıdan yardım istemek gerekir. Cevabın hızı, verdiğiniz bilginin kalitesiyle doğru orantılıdır. Aşağıdaki altı maddeyi tek mesajda gönderin:

1. Sunucu yazılımı ve tam sürüm#

   “Paper” demeyin, “Paper 26.2 build 112” deyin. Konsolun ilk satırlarında yazar.

2. Java sürümü#

   java -version çıktısını olduğu gibi ekleyin. Dağıtımı da (Temurin, Corretto, Zulu) belirtin.

3. Başlatma komutu#

   Kullandığınız tüm JVM bayraklarını içeren satırı paylaşın. Heap değerleri hatanın yarısını açıklar.

4. Log dosyası#

   logs/latest.log dosyasını bir log paylaşım servisine yükleyip bağlantısını verin. Ekran görüntüsü göndermeyin.

5. Ne zaman başladı#

   Hatadan hemen önce ne değişti? Eklenti eklendi mi, sürüm yükseltildi mi, yeni bir dünya mı yüklendi?

6. Denediğiniz adımlar#

   Zaten denediklerinizi yazın; aynı önerileri ikinci kez almazsınız.

Batihost müşterisiyseniz aynı bilgilerle destek talebi açabilir, sunucu tarafındaki port, güvenlik duvarı ve kaynak kontrollerini ekibimize yaptırabilirsiniz.

Hataları Baştan Önleyen Alışkanlıklar#

Çözdüğünüz her hatanın tekrar etmemesi için birkaç alışkanlık yeterlidir. Sürüm yükseltmelerini önce bir kopya sunucuda deneyin; eklenti güncellemelerini toplu değil teker teker yapın; her büyük değişiklikten önce dünya klasörünün yedeğini alın. Sunucunun sağlığını düzenli izlemek, hatayı oyuncular fark etmeden yakalamanızı sağlar.

Performans tarafındaki sorunları kalıcı olarak çözmek için sunucu optimizasyonu rehberimizi uygulayın; hangi eklentinin ne kadar tick harcadığını ölçmek için spark ile profil çıkarma sayfasına bakın. Bu iki adım, bu sayfadaki hataların önemli bir kısmının hiç ortaya çıkmamasını sağlar.

Özetle#

Minecraft sunucu hatalarını çözmenin yolu ezberden değil yöntemden geçer. Önce hatanın hangi grupta olduğunu belirleyin: açılmıyor mu, bağlanılmıyor mu, çöküyor mu, donuyor mu. Sonra logs/latest.log dosyasındaki ilk Caused by satırını okuyun. Yukarıdaki teşhis tablosundan hata metnini bulun ve ilgili ayrıntı sayfasına geçin.

2026’da özellikle iki noktaya dikkat edin: 26.1 ve sonrası Java 25 ister, ve unobfuscation nedeniyle eski eklenti/mod ikilileri yeniden derlenmeden çalışmaz. Bu iki gerçek, bugün açılan destek taleplerinin büyük kısmının arkasında duruyor. Donanım tarafında ise 8 GB RAM altına inmeyin, yüksek saat hızlı Ryzen ve NVMe disk tercih edin; hatanın kaynağı bazen kodda değil, doğrudan kaynak yetersizliğindedir.