Bilgi Bankası

Minecraft sunucunuz açılırken aniden kapanıyor, konsolda yüzlerce satır hata çıkıyor veya crash-report oluşturuyorsa ilk yapılması gereken modları rastgele silmek ya da sunucuyu yeniden kurmak değildir.

Özellikle modlu Minecraft sunucularında tek bir uyumsuz mod, eksik dependency, yanlış Java sürümü veya Forge / NeoForge / Fabric sürüm uyuşmazlığı yüzlerce hata satırının oluşmasına neden olabilir.

Bu rehberde ağırlıklı olarak Windows Server ve Windows VDS üzerinde Minecraft crash loglarının nasıl okunacağını, gerçek hatanın nerede aranması gerektiğini ve latest.log ile crash-reports dosyalarının nasıl inceleneceğini anlatacağız. Linux kullanıcıları için gerekli komutları da rehberin devamında bulabilirsiniz.

1. Minecraft sunucusu crash verdiğinde hangi dosyalara bakılır?

Minecraft sunucu klasöründe hata teşhisi için en önemli iki konum genellikle şunlardır:

logs\latest.log
crash-reports\

latest.log, Minecraft'ın son çalıştırılması sırasında oluşan logları içerir.

crash-reports klasörü ise Minecraft'ın crash report oluşturabildiği kritik çökmelerde ayrıntılı rapor içerebilir.

Windows Server üzerinde örnek bir sunucu klasörü şöyle görünebilir:

C:\MinecraftServer\
├── mods\
├── config\
├── logs\
│   └── latest.log
├── crash-reports\
├── server.properties
├── server.jar
└── run.bat

Her crash durumunda mutlaka crash-reports dosyası oluşmayabilir. Bu nedenle crash report yoksa hata yoktur şeklinde düşünmeyin. Böyle durumlarda logs\latest.log dosyası özellikle önemlidir.

2. Windows'ta latest.log dosyası nasıl açılır?

Windows Server kullanıyorsanız Minecraft sunucu klasörüne girin ve:

logs

klasörünü açın.

Buradaki:

latest.log

dosyasını Not Defteri, Notepad++, Visual Studio Code veya başka bir metin editörü ile açabilirsiniz.

Dosyanın son kısmı çoğu zaman önemlidir çünkü Minecraft'ın kapanmadan hemen önce ne yaptığını burada görebilirsiniz.

Ancak yalnızca dosyanın son satırına bakmak her zaman doğru teşhis sağlamaz. Asıl hata daha yukarıda başlamış, alttaki satırlar ise yalnızca bu hatanın sonucu olabilir.

3. Windows PowerShell ile latest.log dosyasının sonunu görüntüleme

Büyük log dosyalarını Not Defteri ile açmak yerine PowerShell kullanabilirsiniz.

Minecraft sunucu klasöründe PowerShell açarak:

Get-Content .\logs\latest.log -Tail 100

komutunu çalıştırabilirsiniz.

Bu komut log dosyasının son 100 satırını gösterir.

Daha fazla satır görmek için:

Get-Content .\logs\latest.log -Tail 300

kullanabilirsiniz.

Sunucuyu çalıştırırken logu canlı takip etmek için:

Get-Content .\logs\latest.log -Wait -Tail 50

komutu kullanılabilir.

Böylece Minecraft çalışırken yeni log satırları PowerShell ekranında görüntülenir.

4. Log içerisinde ERROR kelimesini aramak yeterli mi?

Hayır.

Minecraft ve özellikle Forge, NeoForge veya Fabric kullanılan modlu sunucularda çok sayıda WARN ve ERROR satırı görülebilir. Bunların tamamı sunucunun crash sebebi olmak zorunda değildir.

Örneğin:

[WARN] Failed to check for updates

gibi bir mesaj yalnızca bir modun güncelleme sunucusuna bağlanamadığını gösterebilir.

Buna karşılık:

Failed to start the minecraft server

veya:

ModLoadingException

gibi mesajlar doğrudan başlangıç probleminin parçası olabilir.

Bu nedenle log okurken yalnızca satırın başında ERROR yazmasına değil, hatanın bağlamına bakılmalıdır.

5. Windows PowerShell ile önemli hata kelimelerini arayın

latest.log içerisinde belirli hata ifadelerini PowerShell ile arayabilirsiniz:

Select-String -Path .\logs\latest.log -Pattern "ERROR","FATAL","Exception","Caused by","ModLoadingException"

Bu komut ilgili ifadelerin geçtiği satırları listeler.

Özellikle şu ifadeler teşhis sırasında değerlidir:

• Caused by:
• ModLoadingException
• Missing
• requires
• UnsupportedClassVersionError
• Mixin
• OutOfMemoryError
• Failed to start

6. "Caused by" satırı neden önemlidir?

Java hatalarında ekranda uzun bir stack trace görebilirsiniz.

Örneğin:

java.lang.RuntimeException: Failed to start server
    at ...
    at ...
    at ...
Caused by: java.lang.IllegalStateException: Example error
    at ...
    at ...

Üstte görünen RuntimeException genel bir sonuç olabilir. Daha aşağıdaki Caused by: satırı ise hatanın gerçek kaynağına daha yakın bilgi verebilir.

Bazı hatalarda birden fazla Caused by: bulunabilir:

Exception
  ↓
Caused by: ...
  ↓
Caused by: ...
  ↓
Asıl hata

Bu nedenle ilk Exception satırını görüp hemen karar vermek yerine stack trace'in devamını incelemek gerekir.

7. ModLoadingException görüyorsanız neye bakmalısınız?

Forge veya NeoForge sunucularında sık karşılaşılan hatalardan biri:

ModLoadingException

hatasıdır.

Örneğin log içerisinde şöyle bir mesaj bulunabilir:

Mod examplemod requires neoforge 26.1.2.75 or above
Currently, neoforge is 21.2.1-beta

Buradaki problem doğrudan anlaşılabilir:

• Mod daha yeni NeoForge istiyor.
• Sunucuda daha eski NeoForge çalışıyor.

Böyle bir durumda modu silmek ilk çözüm olmamalıdır.

Eğer onlarca mod aynı yeni NeoForge veya Minecraft sürümünü istiyorsa problem tek tek modlarda değil, sunucunun yanlış runtime ile çalıştırılmasında olabilir.

8. "requires" ve "missing dependency" hatalarını okuyun

Modlu Minecraft sunucularında bir mod başka bir moda ihtiyaç duyabilir.

Örneğin:

Mod examplemod requires librarymod 5.0 or above
Currently, librarymod is not installed

Bu durumda examplemod bozuk olmak zorunda değildir. İhtiyaç duyduğu dependency eksiktir.

Benzer şekilde:

requires minecraft 1.xx.x or above

veya:

requires neoforge xx.x.x or above

mesajları sürüm uyumsuzluğunu gösterir.

Bir modun adının hata içerisinde geçmesi her zaman "bu modu sil" anlamına gelmez.

9. Java sürümü hatasını nasıl anlarsınız?

Sunucu yanlış Java sürümüyle başlatılıyorsa şu ifadelerle karşılaşabilirsiniz:

UnsupportedClassVersionError

veya Java class version hakkında bir hata görülebilir.

Windows CMD veya PowerShell üzerinde aktif Java sürümünü kontrol edin:

java -version

Java executable dosyasının nereden çalıştırıldığını görmek için Windows CMD üzerinde:

where java

kullanabilirsiniz.

Birden fazla sonuç çıkıyorsa sistemde birden fazla Java kurulumu bulunuyor olabilir.

Örneğin doğru Java'yı yüklemiş olmanız, Minecraft'ın otomatik olarak onu kullandığı anlamına gelmez.

run.bat veya başlangıç komutunda doğrudan belirli Java executable dosyasını kullanabilirsiniz:

"C:\Program Files\Java\jdk-21\bin\java.exe" -Xms4G -Xmx8G -jar server.jar nogui

Kullanmanız gereken Java sürümü Minecraft ve mod loader sürümünüze göre belirlenmelidir.

10. OutOfMemoryError görüyorsanız

Log içerisinde:

java.lang.OutOfMemoryError: Java heap space

görüyorsanız Java heap belleği yetersiz kalmış olabilir.

Başlangıç komutunda örneğin:

java -Xms4G -Xmx8G -jar server.jar nogui

kullanılıyorsa:

• -Xms4G başlangıç heap değerini,
• -Xmx8G maksimum heap değerini

belirtir.

Ancak burada önemli bir nokta vardır: Her crash problemi RAM problemi değildir.

Logda açıkça mod sürümü, Java veya dependency hatası bulunuyorsa yalnızca RAM artırmak problemi çözmez.

11. Mixin hatası gördüğünüzde hemen o modu silmeyin

Modlu sunucularda aşağıdakine benzer mesajlar görülebilir:

Mixin apply failed
MixinTransformerError
InvalidMixinException

Mixin hataları mod uyumsuzluğundan kaynaklanabilir ancak stack trace içerisinde adı geçen ilk mod her zaman gerçek suçlu değildir.

Bir mod başka bir modun değiştirdiği Minecraft class'ı üzerinde işlem yapıyor olabilir. Bu nedenle:

• Minecraft sürümünü,
• Forge / NeoForge / Fabric sürümünü,
• ilgili modların sürümlerini,
• gerekli dependency'leri

birlikte kontrol etmek gerekir.

12. crash-reports klasörü nasıl incelenir?

Minecraft bir crash report oluşturduysa Windows Server üzerinde:

crash-reports\

klasörüne girin.

Dosya isimleri genellikle tarih ve saat içerir:

crash-2026-08-13_16.42.10-server.txt

En yeni dosyayı açın.

Crash report içerisinde özellikle şu bölümler yararlı olabilir:

• Hata açıklaması
• Exception / stack trace
• Caused by satırları
• Mod listesi
• Minecraft sürümü
• Java sürümü
• Forge / NeoForge / Fabric bilgileri

Crash report'un tamamını okumadan yalnızca ilk beş satıra bakarak karar vermek yanlış teşhise neden olabilir.

13. Windows'ta en yeni crash report'u PowerShell ile bulun

En son oluşturulan crash report dosyasını görmek için:

Get-ChildItem .\crash-reports\ | Sort-Object LastWriteTime -Descending | Select-Object -First 1

En yeni crash report'un son 100 satırını görüntülemek için:

$crash = Get-ChildItem .\crash-reports\ | Sort-Object LastWriteTime -Descending | Select-Object -First 1
Get-Content $crash.FullName -Tail 100

Bu yöntem özellikle Uzak Masaüstü üzerinden Windows Server yöneten kullanıcılar için hızlı bir teşhis yöntemi olabilir.

14. "Exit code" tek başına gerçek hatayı söylemez

Bazı başlatıcılarda veya scriptlerde Minecraft kapandıktan sonra yalnızca bir exit code görebilirsiniz.

Örneğin:

Process exited with code 1

Exit code 1 tek başına sorunun nedenini açıklamaz.

Bu yalnızca uygulamanın hata durumunda kapandığını gösterebilir.

Gerçek sebebi bulmak için:

logs\latest.log

ve varsa:

crash-reports\

incelenmelidir.

15. Sunucu aniden kapanıyorsa Windows Event Viewer da kontrol edilebilir

Bazen Minecraft logu yarıda kesilir ve Java tarafında düzgün bir crash report oluşmaz.

Özellikle tüm Java işlemi beklenmedik şekilde kapanıyorsa Windows tarafını da kontrol etmek faydalı olabilir.

Windows Server üzerinde:

Event Viewer
→ Windows Logs
→ Application

bölümünü kontrol edebilirsiniz.

Burada Java veya sistem tarafından oluşturulan hata kayıtları bulunabilir.

Bu yöntem özellikle JVM'nin kendisinin çöktüğü veya işletim sistemi seviyesinde bir problem oluştuğu durumlarda yardımcı olabilir.

16. Windows'ta çalışan Java işlemlerini kontrol edin

Minecraft'ın gerçekten kapanıp kapanmadığını kontrol etmek için CMD üzerinde:

tasklist | findstr java

kullanabilirsiniz.

PowerShell üzerinde:

Get-Process java -ErrorAction SilentlyContinue

kullanılabilir.

Sunucu crash verdiğini düşündüğünüz halde Java işlemi hâlâ çalışıyorsa farklı bir Minecraft instance'ı veya takılı kalmış bir Java işlemi bulunabilir.

17. Client modlarını server'a kopyalamak crash sebebi olabilir

Modpack içerisindeki bütün modların dedicated server üzerinde çalışması gerektiğini varsaymak doğru değildir.

Bazı modlar yalnızca Minecraft client tarafı için hazırlanmıştır.

Örneğin görüntü, arayüz, shader veya istemci optimizasyonu yapan bazı modların dedicated server üzerinde bulunması gerekmeyebilir.

Bir client modunu sunucuya koyduktan sonra crash başladıysa log içerisinde:

• client class,
• dedicated server,
• environment,
• dist,
• client-only

gibi ifadeler aranabilir.

Ancak modun yalnızca dosya adına bakarak client-only olduğuna karar vermek yerine mod geliştiricisinin açıklamasını ve hata logunu kontrol etmek gerekir.

18. Windows'ta hızlı crash teşhis komutları

Windows Server üzerinde hızlı kontrol için PowerShell'de aşağıdaki komutlar kullanılabilir:

java -version

Get-Content .\logs\latest.log -Tail 200

Select-String -Path .\logs\latest.log -Pattern "ERROR","FATAL","Exception","Caused by","ModLoadingException","OutOfMemoryError"

Get-ChildItem .\crash-reports\ | Sort-Object LastWriteTime -Descending | Select-Object -First 5

Get-Process java -ErrorAction SilentlyContinue

CMD tercih ediyorsanız temel kontroller:

java -version
where java
tasklist | findstr java

şeklinde yapılabilir.

19. Linux / Ubuntu üzerinde latest.log nasıl incelenir?

Linux kullanıyorsanız aynı mantık geçerlidir. Sadece Windows komutlarının yerine Linux karşılıklarını kullanırsınız.

Log dosyasının son 100 satırını görmek için:

tail -n 100 logs/latest.log

Logu canlı takip etmek için:

tail -f logs/latest.log

Önemli hata ifadelerini aramak için:

grep -Ei 'error|fatal|exception|caused by|modloadingexception|outofmemory' logs/latest.log

Çalışan Java işlemlerini görmek için:

pgrep -a java

Java sürümünü kontrol etmek için:

java -version

20. Linux'ta en yeni crash report'u bulun

Crash report dosyalarını tarihe göre sıralamak için:

ls -lt crash-reports/

En yeni crash report'un son kısmını görüntülemek için dosya adını kullanabilirsiniz:

tail -n 100 crash-reports/crash-DOSYA-ADI.txt

Windows ve Linux arasında komutlar değişse de teşhis mantığı aynıdır.

21. Her ERROR satırı crash sebebi değildir

Minecraft loglarını okurken yapılan en büyük hatalardan biri ekrandaki ilk kırmızı veya ERROR satırını gerçek sebep kabul etmektir.

Örneğin bir modun update checker servisine bağlanamaması hata üretebilir fakat sunucu birkaç saniye sonra:

Done (11.523s)! For help, type "help"

mesajına ulaşıyorsa sunucu başarıyla açılmıştır.

Dolayısıyla önce şu soruyu sorun:

Sunucu gerçekten crash mi verdi?
            ↓
Yoksa yalnızca WARN / ERROR satırı mı yazdı?

Done mesajı görülüyorsa logdaki her hata kritik değildir.

22. Hatanın en üstte değil kökünde ne olduğuna bakın

Crash log analizinde doğru yaklaşım genellikle şöyledir:

Sunucu neden kapandı?
        ↓
latest.log son bölümünü kontrol et
        ↓
Exception / Caused by satırlarını bul
        ↓
ModLoadingException var mı?
        ↓
Eksik dependency var mı?
        ↓
Minecraft / loader sürümü uyuyor mu?
        ↓
Java sürümü doğru mu?
        ↓
RAM gerçekten tükendi mi?
        ↓
Client-only mod var mı?

Bu sıra rastgele mod silmekten çok daha güvenlidir.

23. "Son eklediğim modu silersem düzelir" yaklaşımı her zaman doğru değildir

Yeni bir mod ekledikten sonra sunucu crash verdiyse elbette yeni mod önemli bir şüphelidir. Ancak o modun kendisi bozuk olmayabilir.

Örneğin yeni mod:

• başka bir library gerektiriyor olabilir,
• daha yeni NeoForge gerektiriyor olabilir,
• farklı Minecraft sürümü için indirilmiş olabilir,
• başka bir modla çakışıyor olabilir.

Bu nedenle doğru soru:

Hangi mod hata veriyor?

değil, çoğu zaman:

Log bu modun neden yüklenemediğini söylüyor?

olmalıdır.

24. Destek talebi açarken hangi bilgileri göndermelisiniz?

Minecraft sunucunuz için teknik destek talebi oluştururken yalnızca:

Sunucum açılmıyor.

yazmak teşhis süresini uzatabilir.

Mümkünse aşağıdaki bilgileri birlikte gönderin:

• Minecraft sürümü
• Forge / NeoForge / Fabric sürümü
• Java sürümü
• latest.log dosyası
• Varsa en yeni crash report
• Hata başlamadan önce yaptığınız son değişiklik

Java sürümünü Windows'ta:

java -version

komutuyla öğrenebilirsiniz.

Bu bilgiler problemin çok daha hızlı daraltılmasını sağlar.

Minecraft crash çözümünde önemli olan logu doğru okumaktır

Modlu Minecraft sunucusunda yüzlerce hata satırı bulunması yüzlerce ayrı problem olduğu anlamına gelmez.

Tek bir yanlış Java sürümü, yanlış NeoForge kurulumu veya eksik dependency onlarca modun arka arkaya hata vermesine neden olabilir.

Bu nedenle:

100 hata satırı
      ≠
100 farklı problem

Çoğu zaman asıl yapılması gereken ilk hatayı değil, hata zincirinin kök nedenini bulmaktır.

Batihost'ta sadece sunucu vermiyoruz, Minecraft da biliyoruz.

Minecraft sunucunuz crash veriyor, latest.log yüzlerce hata içeriyor, Forge / NeoForge başlamıyor, Java hatası alıyor veya hangi modun problemi oluşturduğunu bulamıyorsanız rastgele dosya silmek yerine önce logların doğru analiz edilmesi gerekir.

Batihost olarak özellikle Windows Server ve Minecraft sunucularında müşterilerimize yalnızca CPU, RAM ve disk kaynağı sunmakla kalmıyor; sunucu tarafında karşılaşılan teknik problemlerin teşhisinde de yardımcı oluyoruz.

Batihost Minecraft Sunucu ve Windows VDS hizmetlerini inceleyin