Minecraft Konsol Loglarını Okumayı Öğrenin
"Konsolda bir şeyler yazıyor ama ne demek istediğini anlamıyorum." Bu cümle, forum'a yardım isteyen yeni sunucu sahiplerinin büyük çoğunluğundan gelir. Konsol logları sizi korkutmasın; bunlar aslında sunucunun size konuştuğu dildir. Bu rehberde Minecraft konsol loglarını nasıl okuyacağınızı, hata türlerini nasıl ayırt edeceğinizi ve çözüm için doğru bilgiyi nasıl çekeceğinizi adım adım anlatıyorum.
Log Dosyasının Konumu
Minecraft konsol çıktısı iki yerde bulunur:
- Anlık konsol: Sunucu penceresi veya SSH terminalinde canlı olarak akar.
- logs/latest.log: Mevcut oturumun tam log kaydı.
- logs/[tarih].log.gz: Önceki oturumların sıkıştırılmış arşivi.
Sunucu kapandıktan sonra log kaybolmaz;
logs/latest.log dosyasına kalıcı olarak yazılır.Log Satırlarının Anatomisi
Tipik bir log satırı şu formattadır:
[12:34:56 INFO]: Paper version git-Paper-123 (MC: 1.21.4)
[12:34:57 WARN]: [EssentialsX] Locale not found, using default.
[12:34:58 ERROR]: Error occurred while enabling LuckPerms v5.4 (Is it up to date?)
- [saat]: Olayın gerçekleştiği zaman.
- INFO: Bilgi mesajı; normal işleyişin parçası.
- WARN: Uyarı; sorun değil ama dikkat çekilmesi istenen bir durum.
- ERROR: Hata; bir şeyler beklendiği gibi çalışmadı.
- FATAL: Kritik hata; sunucu genellikle durur.
Bir Hatayı Aramak İçin Doğru Strateji
Log dosyası uzunsa
ERROR veya FATAL kelimelerini aratın:Linux'ta:
grep -n "ERROR\|FATAL\|Exception" logs/latest.log | head -30
Windows'ta Notepad++ ile Ctrl+F açın, "ERROR" aratın.
Stack Trace Nedir?
Java hataları genellikle "stack trace" ile birlikte gelir. Birden fazla satıra yayılan bu çıktı, hatanın tam olarak nerede oluştuğunu gösterir:
[ERROR] Could not load 'plugins/ExamplePlugin.jar'
java.lang.NoClassDefFoundError: com/example/SomeDependency
at com.example.ExamplePlugin.onEnable(ExamplePlugin.java:42)
at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:264)
at ...
Stack trace'te en önemli satır genellikle ilk Exception satırı ve ardından "at com.example..." şeklinde başlayan plugin kaynak satırıdır. Plugin adı genellikle paket adında görünür.
Yaygın Log Terimleri
- NoClassDefFoundError: Eksik bağımlılık (dependency) — başka bir plugin veya kütüphane eksik.
- ClassNotFoundException: Benzer; sınıf yüklenemedi.
- NullPointerException: Bir değerin null olması beklenmeyen bir yerde gerçekleşti; genellikle plugin hatası.
- OutOfMemoryError: Yetersiz RAM; -Xmx değerini artırın.
- UnsupportedClassVersionError: Yanlış Java sürümü.
- YAML Exception / ScannerException: Config dosyasında YAML format hatası.
Forum'da Yardım İsterken
Hata mesajını tamamıyla paylaşın; "hata var" demek yeterli değildir. Yardım isterken şunları ekleyin:
- Sunucu sürümü (Paper 1.21.4 gibi)
- Java sürümü
- İlgili log satırları (stack trace dahil)
- Sorunu tetikleyen işlem (plugin yükleme, komut, oyuncu girişi vb.)
Sonuç
Konsol logları, Minecraft sunucusunun size anlattığı hikayedir. ERROR ve FATAL satırlarını bulmayı, stack trace'i okumayı ve hata türlerini ayırt etmeyi öğrendikten sonra sorunların büyük çoğunluğunu forum'a sormadan kendi başınıza çözebileceksiniz. Her yeni hatayla bu beceri daha da güçlenir.
💡 Etkileşim için giriş yap.