Sunucu günlüklerini ve çökme raporlarını oku

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.

Java sunucusu için yardım isterken Minecraft ve Java sürümünü yaz; mod paketi kurulumlarında tam paket sürümünü de ekle.

Günlükler nerede?

• logs/latest.log, son açılıştan şu ana kadarki oturumu içerir. Önce buna bak.
• Önceki oturumlar aynı klasörde, 2026-11-01-1.log.gz gibi tarihli ve gzip ile sıkıştırılmış dosyalarda durur. Sunucu aynı gün birden fazla kez açılırsa sondaki sayı artar.
• Sunucu her çöktüğünde crash-reports klasörüne crash-2026-11-01_18.42.10-server.txt gibi yeni bir dosya eklenir. Kendiliğinden kapandıysa buraya bak.
• Kontrol panelindeki konsol, latest.log satırlarını yazıldıkları anda gösterir; genellikle yalnızca son satırları tutar.

Dosyaları kontrol panelindeki dosya yöneticisinden açabilir veya indirebilirsin. .gz dosyasını önce açman gerekir: Windows’ta 7-Zip kullan, macOS’te çift tıkla. Linux’ta zcat 2026-11-01-1.log.gz içeriği ekrana yazdırır.

Yeniden başlatınca dosyalar yer değiştirir. Sunucu açılırken önceki latest.log tarihli dosyalardan birine sıkıştırılır. Sorun yeniden başlatmadan önce olduysa adında tarih olan dosyayı arıyorsun.

Tek bir oyuncunun oyunu çöküyorsa veya oyuncu bağlanamıyorsa ve sunucu günlüğünde hata yoksa kendi bilgisayarındaki .minecraft/logs/latest.log ve .minecraft/crash-reports dosyalarına da bak.

Bir günlük satırını okumak

[18:42:10] [Server thread/INFO]: Starting minecraft server version 1.21.4
[18:42:12] [Server thread/ERROR]: Error occurred while enabling ExampleHomes v2.4.0 (Is it up to date?)
[18:43:05] [Server thread/WARN]: Can't keep up! Is the server overloaded? Running 2043ms or 40 ticks behind

Her satırda saat, köşeli parantez içinde iş parçacığı ve kayıt seviyesi bulunur. Satırların çoğu INFO seviyesindedir ve sorun göstermez. WARN satırlarına göz at; asıl aradıkların ERROR ve FATAL. Eklentiler ve modlar genellikle mesajın başına [LuckPerms] gibi kendi adını koyar. Böylece mesajın nereden geldiğini anlarsın. Konsol aynı satırı kısaltarak gösterebilir.

Done (6.912s)! For help, type "help" yazdığında sunucu açılmıştır. Açılışı engelleyen hatalar bu satırdan önce görünür.

ERROR, WARN ve Exception ifadelerini ara. Açılıştan sonraki ilk hatadan başla. Sonraki hatalar genellikle onun sonucudur: yüklenemeyen bir eklenti, ona bağımlı bütün eklentilerde hata çıkarabilir. Terminal erişimin varsa grep -n ERROR logs/latest.log hataları satır numaralarıyla listeler. Sıkıştırılmış dosyalarda aynısını zgrep yapar.

Stack trace okumak

Hatanın altında genellikle bir stack trace bulunur: exception satırı, at ile başlayan satırlar ve bazen altında başka bir blokla birlikte Caused by:. Hayali ExampleHomes eklentisinden kısaltılmış bir örnek:

[18:42:12] [Server thread/ERROR]: Error occurred while enabling ExampleHomes v2.4.0 (Is it up to date?)
java.lang.IllegalStateException: Could not load homes.yml
	at com.example.homes.storage.YamlStorage.load(YamlStorage.java:88)
	at com.example.homes.ExampleHomes.onEnable(ExampleHomes.java:31)
	at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:281)
	...
Caused by: org.yaml.snakeyaml.scanner.ScannerException: mapping values are not allowed here
 in 'reader', line 12, column 9:
	at org.yaml.snakeyaml.scanner.ScannerImpl.fetchValue(ScannerImpl.java:902)
	... 12 more

Şu sırayla oku:

1. Exception satırı, neyin ters gittiğini Java’nın diliyle söyler. Burada bir dosya yüklenememiş.

2. at satırları hatanın nerede olduğunu, en son çağrıdan başlayarak gösterir. java., net.minecraft, org.bukkit, io.papermc veya net.fabricmc, net.neoforged gibi yükleyici paketlerini geç. Geriye kalan ilk paket, ilgili eklenti veya moda aittir. Buradaki com.example.homes, ExampleHomes’tur.

3. Caused by: alttaki asıl hatayı gösterir. Birden fazlaysa kök neden genellikle en sondakidir. Burada ayar dosyasının 12. satırında YAML sözdizimi hatası var; yani kod hatasından önce dosyadaki yazımı kontrol et.

Paket adı her zaman eklentinin adıyla aynı olmaz. Örneğin EssentialsX, com.earth2me.essentials paketini kullanır. Yine de bu adla arama yapabilirsin. Bazı sunucular her at satırının sonunda jar dosyasının adını da yazar.

Çökme raporunu okumak

Çökme raporu ---- Minecraft Crash Report ----, tek satırlık bir espri, saat ve Description: satırıyla başlar. Altında stack trace bulunur. Sona yakın -- System Details -- bölümünde Minecraft sürümü, Java sürümü, bellek ve modlu sunucularda mod listesi yer alır.

• Description: satırını, altındaki exception’ı ve en sondaki Caused by: satırını oku. Genellikle sorunu birlikte açıklarlar.
• System Details bölümündeki Java sürümünü ve belleği kontrol et. Yanlış Java sürümü veya çok düşük bir -Xmx değeri burada açıkça görünür.
• Forge ve NeoForge raporları çoğu zaman şüpheli modları listeler. Bunu kesin sonuç olarak alma; araştırmaya oradan başla.
• A single server tick took 60.00 seconds (should be max 0.05), sunucunun donduğunu ve max-tick-time süresi dolunca watchdog tarafından durdurulduğunu gösterir. Lagın nedenini bulmak için spark ile profil al. Paper, sunucu yanıt vermediğinde ana iş parçacığının stack trace’ini latest.log içine de yazar. Oradan neyle meşgul olduğunu görebilirsin.

Başlangıç hatası belirginse doğrudan ilgili adımlara geç: Unable to access jarfile, FAILED TO BIND TO PORT, UnsupportedClassVersionError.

Yaygın hatalar ve anlamları

Can't keep up! Is the server overloaded?

Sunucu belirtilen süre kadar geride kalmış. Açılışta veya biri uçarak yeni araziye giderken bir iki kez görülmesi normal. Sürekli geliyorsa sunucuda lag var. Nedenini bulmak için lag azaltma rehberine bak.

**** FAILED TO BIND TO PORT!

Ardından java.net.BindException: Address already in use gelir. O portu başka bir işlem kullanıyor; çoğu zaman kapanmamış ikinci bir sunucu kopyasıdır. Hepsini durdur, sonra bir kez başlat. Hosting kullanıyorsan server-port sana ayrılan port olmalı. Sunucu açılıyor ama kimse bağlanamıyorsa bağlantı sorunları rehberine bak.

java.lang.UnsupportedClassVersionError

Sunucu jar’ı veya bir eklenti, çalıştırdığın Java’dan daha yeni bir sürüm için derlenmiş. Mesaj gereken sınıf dosyası sürümünü de söyler: class file version 65.0, this version of the Java Runtime only recognizes class file versions up to 61.0 gibi.

Minecraft 1.20.5 ve sonrası Java 21, 1.18 ile 1.20.4 arası Java 17 ister. Kontrol panelinin başlangıç ayarlarından Java sürümünü değiştir. Yalnızca tek bir eklenti daha yeni Java istiyorsa eklentinin Minecraft sürümünle uyumlu derlemesini bul.

Eklenti veya mod sürümü uyuşmazlıkları

Paper’da Could not load 'plugins/Example.jar' ile birlikte Unsupported API version görüyorsan eklenti daha yeni bir Minecraft sürümü için derlenmiş. UnknownDependencyException, kurulu olmayan başka bir eklentiye ihtiyaç olduğunu gösterir; mesajda adı yazar. Doğru dosyayı seçmek için eklenti kurulum rehberine bak.

Fabric, Forge ve NeoForge dünya yüklenmeden önce sürümleri kontrol eder; hangi modun hangi Minecraft, yükleyici veya mod sürümünü istediğini listeler. İlk sorunu düzeltip tekrar başlat. Forge ve NeoForge’da Attempted to load class net/minecraft/client/… for invalid dist DEDICATED_SERVER, yalnızca istemcide çalışan bir modun sunucunun mods klasörüne konduğunu gösterir. O modu çıkar.

java.lang.OutOfMemoryError: Java heap space

Sunucu -Xmx ile ayrılan belleğin tamamını kullanmış. Ya sınır çalıştırdığın içerik için düşük ya da devasa bir farm veya bellek sızdıran bir mod belleği dolduruyor. Uygun miktarı seçmek için RAM rehberine bak.

You need to agree to the EULA in order to run the server

Yeni sunucunun ilk açılışında görülür. Mojang’ın EULA’sını kabul ediyorsan eula.txt dosyasını aç, eula=false değerini eula=true yap ve tekrar başlat.

moved too quickly!

Oyuncunun tek tick içinde izin verilenden fazla hareket ettiğini söyler. Ani lag veya bazı hareket hileleri buna neden olabilir. Tek başına zarar veren bir hata değildir.

Günlük paylaşmak

Dosyayı mclo.gs’a yükleyip bağlantısını gönder. Minecraft günlükleri için hazırlanmıştır ve IP adreslerini gizler. Günlüğün tamamını sohbete yapıştırma; mesaj kesilir ve okumak zorlaşır.

Sorunun yaşandığı oturumun günlüğünü gönder. Yeniden başlattıysan artık latest.log değil, tarihli dosyalardan biridir. Önemli olduğunu düşündüğün on satır yerine dosyanın tamamını gönder; neden bazen hatanın yüzlerce satır üstündedir.

Herkese açık paylaşmadan önce gözden geçir. mclo.gs IP’leri siler ama bir eklentinin bağlantı hatasında veritabanı parolanı yazdığını anlayamaz.

Yardım isterken sorun çıkmadan hemen önce neyi değiştirdiğini söyle. “Paper’ı ve üç eklentiyi güncelledim” bilgisi, sorunu daraltmak için çoğu günlükten daha faydalıdır.

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.