Belirtiler: Sunucu beklenmedik çöküyor, konsolda ERROR ya da SEVERE mesajları var, oyuncular atılıyor ya da belirli bir işlem sonrası sunucu duruyor. Bu rehber Minecraft sunucu hatalarını sistematik şekilde teşhis edip çözmek içindir.

Olası Nedenler

  • Java exception (NullPointerException, IllegalArgumentException vb.) — kod akışında beklenmedik durum
  • OutOfMemoryError — sunucuya ayrılan RAM yetersiz ya da bellek sızıntısı var
  • Plugin uyumsuzluğu — sunucu sürümü ile plugin API sürümü arasında kopukluk
  • Bozuk veri — dünya region dosyası, oyuncu verisi veya plugin veritabanı bozulmuş
  • Java sürüm uyumsuzluğu (UnsupportedClassVersionError)
  • Dosya sistemi dolu ya da yetki eksik — sunucu yazma/okuma yapamıyor

Adım Adım Çözüm

1. Adım

Hatanın kök nedenini logs/latest.log içinde arayın. Stack trace içindeki en son "Caused by:" satırı asıl nedendir

bash
tail -100 logs/latest.log | grep -A 5 "Caused by:"

2. Adım

Tüm ERROR ve SEVERE mesajlarını toplu şekilde inceleyin

bash
grep -iE "ERROR|SEVERE|Exception" logs/latest.log | tail -30

3. Adım

Crash report varsa onu açın — Minecraft crash dosyaları bağlam bilgisini daha fazla verir

bash
ls -lt crash-reports/ | head && cat crash-reports/$(ls -t crash-reports/ | head -1)

4. Adım

Hata bir plugin'den kaynaklanıyorsa (log'da plugin adı geçer), geçici olarak devre dışı bırakın ve tekrar deneyin

bash
mv plugins/ProblemliPlugin.jar plugins/ProblemliPlugin.jar.disabled

5. Adım

Plugin sürümlerinin sunucu sürümü ile uyumlu olduğunu kontrol edin

bash
grep -E "api-version|main" plugins/*/plugin.yml 2>/dev/null

6. Adım

Java sürümü ile MC sürümü eşleşmeli: 1.20.5+ için Java 21, 1.17–1.20.4 için Java 17, 1.16 ve altı için Java 8–11

bash
java -version 2>&1 | head -1

7. Adım

Disk doluluğunu kontrol edin — dolu disk pek çok garip hataya yol açar

bash
df -h $(pwd) && du -sh world* logs/ plugins/ backups/ 2>/dev/null

8. Adım

Exception metnini olduğu gibi Google'da arayın; "site:spigotmc.org OR site:github.com" eklentisiyle topluluğun bulduğu çözümü kısa yoldan bulursunuz

9. Adım

Tekrarlayan hatalar için KEYDAL Spark Analyzer aracını kullanın — ücretsiz otomatik yorumlar

bash
/spark profiler --timeout 120