Bir Minecraft sunucusu dünyayı saniyede 20 kez, tick adı verilen adımlarla hesaplar. Bir tick çok uzun sürerse veya RAM biterse sunucu günlüğe uyarılar yazar, en kötü durumda da kapanır. Aşağıdaki her bölüm bu mesajlardan birini açıklar: onu nasıl tanıyacağını, ne kadar ciddi olduğunu ve neler yapabileceğini. Önce sunucunun çökmesine veya kapanmasına yol açan mesajlar, ardından sunucunun çalışmaya devam ettiği uyarılar gelir.

Mesajın tamamını Konsol bölümünde veya Dosyalar altında logs/latest.log içinde, çökme raporlarını ise crash-reports/ klasöründe bulursun. Her zaman önceki satırları da oku: Sunucuyu neyin yavaşlattığı çoğu zaman orada yazar. Yapılandırma veya dünya dosyalarını değiştirmeden önce Yedekler altından bir yedek al.

“A single server tick took … seconds”: Watchdog sunucuyu kapatıyor

Mesaj şöyle görünür:

The server has not responded for <saniye> seconds! Creating thread dump
A single server tick took 60.00 seconds (should be max 0.05)

Arka planda ne oluyor: Watchdog, sunucunun hâlâ çalışıp çalışmadığını denetler. Oyun simülasyonunun bir çalışma adımı olan tick çok uzun sürerse donmuş sunucuyu kapatır ve oyun kesintiye uğrar. Paper bundan önce, o anda yürütülen işlerin anlık görüntüsü olan bir thread dump ile ara mesajlar yazar: Sunucu zamanında toparlanırsa çalışmaya devam eder. Sık görülen nedenler bellek baskısı veya ağır bir eklenti ya da moddur.

Nasıl çözersin:

  1. Dosyalar altında logs/latest.log dosyasını aç ve ilk Watchdog mesajından önceki satırları oku. Orada Stopping server yazıyorsa kapanmanın neden takıldığını araştır.
  2. Thread dump içinde Server thread altındaki en üst satırlara bak. Vanilla, Fabric ve NeoForge'da bu döküm crash-reports/ altındaki çökme raporunda yer alır. Bir eklenti veya mod adı, sunucuyu en son neyin meşgul ettiğini gösterir.
  3. RAM'i kontrol et. OutOfMemoryError: Java heap space, Java belleğinin tükendiği anlamına gelir; bu durumda belleği neyin doldurduğunu da incele.
  4. Dosyaları değiştirmeden önce sunucuyu durdur. İlgili eklentiyi Eklentiler altından veya modu Modlar altından güncelle ya da deneme amacıyla kaldır, sunucuyu yeniden başlat ve tekrar kontrol et.

Ayrıntılı bilgi: “Can't keep up” ve Watchdog zaman aşımı sorunlarını doğru şekilde çözme

“Java heap space”: Sunucunun belleği tükendi

Mesaj şöyle görünür:

An exception 'java.lang.OutOfMemoryError: Java heap space' … exceptionCaught() …
[spark] Exception occurred while rotating profiler job … java.lang.OutOfMemoryError: Java heap space
An unexpected error while handling a WorldEdit command … java.lang.OutOfMemoryError: Java heap space

Arka planda ne oluyor: Java, sunucunun belleğini heap adlı bir alanda yönetir ve bu alan mevcut yük nedeniyle dolmuştur. Büyük WorldEdit işlemleri, yüklü çok sayıda chunk (dünya bölümü), büyük mod paketleri veya çok veri tutan eklentiler yüksek miktarda bellek gerektirebilir. Sunucu çoğu zaman çöker veya kararsız hale gelir; dünya verilerinin ya da yaratıklar ve eşyalar gibi entity verilerinin kaydedilmesi de başarısız olabilir. Mesajda adı geçen iş parçacığı veya eklenti, en çok bellek tüketeni değil, belleğin nerede yetmediğini gösterir.

Nasıl çözersin:

  1. Belleği dolan işlemi sonlandırmak için sunucuyu yeniden başlat. Yük değişmezse hata tekrar ortaya çıkabilir.
  2. Bellek ihtiyacını belirle: Minecraft için RAM ihtiyacını planlama. Paketin yetmiyorsa Ayarlar ve Abonelik → Plan altından daha fazla RAM seç.
  3. Büyük WorldEdit işlemlerini parçalara böl ve gerekirse Dosyalar altında server.properties içindeki view-distance değerini düşür.
  4. Yeniden başlattıktan sonra Konsol bölümünü ve etkilenen dünya alanlarını kontrol et. chunk data (write) ile ilgili mesajlar varsa özellikle son durumun kaydedilip kaydedilmediğine bak.

Bilmekte fayda var: Bir sonraki büyük dünya değişikliğinden önce alacağın yedek, kaybolan değişiklikleri geri getirmene yardımcı olur.

“This crash report has been saved to …”: Sunucu çöktü

Mesaj şöyle görünür:

This crash report has been saved to: crash-reports/crash-<tarih>_<saat>-server.txt

Arka planda ne oluyor: Sunucu ciddi bir hata nedeniyle kapandı ve bir çökme raporu yazdı. Mesajın kendisi yalnızca bu raporun nerede olduğunu söyler. Asıl neden, örneğin bir mod, bir eklenti, dünya veya yetersiz bellek, dosyanın içinde yazar.

Nasıl çözersin:

  1. Dosyalar altında crash-reports/ klasörünü ve içindeki ilgili dosyayı aç. Dosyanın adı, çökmenin tarihini ve saatini içerir.
  2. İlk bölümü oku: Description: ifadesinin ardından kısa bir açıklama, altında ise hata satırı ve stack trace, yani hataya yol açan program noktalarının listesi yer alır.
  3. Hatada adı geçen mod veya eklentilerin sürümlerinin uyumlu olup olmadığını kontrol et. İlgili olanı Modlar veya Eklentiler altından güncelle ya da yedek aldıktan sonra deneme amacıyla kaldır.
  4. OutOfMemoryError görürsen mesajın devamını oku. Orada Java heap space yazıyorsa Java belleği dolmuştur; satın aldığın RAM yetersizse Ayarlar ve Abonelik → Plan altından daha fazla RAM seç.
  5. Sunucuyu başlat ve tamamen açılana kadar Konsol bölümünü izle.

Bilmekte fayda var: Raporu hata ayıklama için sakla ve tarih ile saati güncel çökmeyle karşılaştır. Mod sunucuları için: Forge, NeoForge ve Fabric sunucularındaki mod hataları

Oyunun ana döngüsünde hata

Mesaj şöyle görünür:

Exception in server tick loop
Caused by: java.lang.<hata-türü>: <ayrıntılar>

Arka planda ne oluyor: Ana döngü, dünyayı tick tick hesaplar. Exception adı verilen bir program hatası bu döngüye kadar ulaşmış ve onu bozmuştur. Sunucu bu durumda genellikle çöker ve bir çökme raporu yazar. Asıl neden neredeyse her zaman hemen sonraki Caused by satırında yazar.

Nasıl çözersin:

  1. Mesajı logs/latest.log dosyasında veya crash-reports/ altındaki en yeni raporda bul.
  2. Hemen altındaki Caused by satırını oku. Birden fazla varsa en alttaki genellikle sorunun kökenine götürür.
  3. Altındaki at … satırları paket ve dosya adlarını gösterir. Bunlardan ilgili eklentiyi veya modu anlayabilirsin.
  4. Eklentiler veya Modlar altından onu güncelle ya da kaldır ve sunucuyu yeniden başlat.

Bilmekte fayda var: Bu mesaj bir lag sorunu değil, somut bir hatadır. Daha fazla RAM ancak Caused by satırında OutOfMemoryError yazıyorsa işe yarar.

Ayrıntılı bilgi: “Can't keep up” ve Watchdog zaman aşımı sorunlarını doğru şekilde çözme

Bellek sınırda: GC overhead limit exceeded

Mesaj şöyle görünür:

java.lang.OutOfMemoryError: GC overhead limit exceeded

Arka planda ne oluyor: Java, artık gerekmeyen belleği otomatik olarak temizler. Buna Garbage Collection, kısaca GC denir. Bu mesaj, Java'nın neredeyse tüm zamanını temizliğe harcadığı ve bu sırada neredeyse hiç bellek geri kazanamadığı anlamına gelir. Java'nın belleği olan heap fiilen doludur. Sunucu neredeyse hiç yanıt vermez veya çöker.

Nasıl çözersin:

  1. Sunucuyu yeniden başlat.
  2. Kurulumunun ne kadar RAM gerektirdiğini belirle. Ayrıntılı bilgi: Minecraft için RAM ihtiyacını planlama
  3. Paketin yetmiyorsa Ayarlar ve Abonelik → Plan altından daha fazla RAM seç.
  4. Chunk ve entity yükünü azalt: server.properties içindeki view-distance görüş mesafesini düşür, büyük hayvan çiftliklerini küçült ve yerde duran eşyaları temizle.

Bilmekte fayda var: Yeniden başlatmak yalnızca geçici bir rahatlama sağlar. Yük aynı kalmasına rağmen kullanım her yeniden başlatmadan sonra sürekli artarak sınıra ulaşıyorsa belleği tutan bir eklenti veya mod da söz konusu olabilir.

“unable to create native thread”: Java yeni bir thread başlatamıyor

Mesaj şöyle görünür:

java.lang.OutOfMemoryError: unable to create native thread: possibly out of memory or process/resource limits reached

Arka planda ne oluyor: Thread, paralel çalışan bir iş koludur ve Java yeni bir thread başlatamamıştır. Olası darboğazlar arasında aynı anda çalışan çok fazla thread, ulaşılmış bir işlem sınırı veya Java nesnelerinin tutulduğu Java heap'i dışındaki native belleğin yetersizliği yer alır. Yeni görevler başarısız olabilir ve sunucu kararsızlaşabilir. Hatada geçen bir eklenti adı, öncelikle thread başlatmanın hangi görevde başarısız olduğunu gösterir; asıl nedeni bulmak için uygun çalışma zamanı ölçümleri gerekir.

Nasıl çözersin:

  1. Saati not al ve Dosyalar bölümünden logs/latest.log içindeki ilgili satırları, öncesindeki ve sonrasındaki mesajlarla birlikte kaydet.
  2. Hatanın oluştuğu andaki thread sayısını, işlem sınırını ve native belleği kontrol et. Bu çalışma değerlerine sahip değilsen bir destek talebi aç ve mesajın saatini belirt.
  3. Ölçüm değerlerini çalışan görevlerle karşılaştır. Eklentiler bölümünden bir eklentiyi veya Modlar bölümünden bir modu ancak ölçümler bu bağlantıyı destekliyorsa hedefli olarak güncelle; ayarlarını da kontrol et.
  4. Sunucu artık kullanılamıyorsa hata satırlarını kaydettikten sonra yeniden başlat. Konsolda yeni hata olup olmadığını kontrol et.

Bilmekte fayda var: Java heap'ini artırmak, tükenmiş bir thread veya işlem sınırını çözmez. spark hakkında: spark: Lag'i bulma ve anlama.

“Can't keep up”: Sunucu tick'lere yetişemiyor

Mesaj şöyle görünür:

Can't keep up! Is the server overloaded? Running <Zeit>ms or <Ticks> ticks behind
Can't keep up! Did the system time change, or is the server overloaded? Running <Zeit>ms behind, skipping <Ticks> tick(s)

Arka planda ne oluyor: Minecraft normalde saniyede 20 tick hesaplar, dolayısıyla bir tick için 50 milisaniyelik bir zaman bütçesi vardır. Bu işlemler çok uzun sürerse, mesajda milisaniye ve tick olarak belirtilen bir gecikme birikir. Sunucu çalışmaya devam eder ama belirgin şekilde yavaşlar: Kırılan bloklar yeniden belirir, moblar takılarak hareket eder. Nedeni genellikle bellek veya CPU baskısıdır; tekil mesajlar başlangıçta veya yeni bölgeler oluşturulurken görülebilir.

Nasıl çözersin:

  1. spark'ın kullanılabilir olup olmadığını kontrol et. Güncel Paper sürümlerinde yerleşik olarak bulunur; desteklenen diğer sunucularda uygun eklenti veya mod sürümünü kurarsın.
  2. Lag sırasında Konsolda spark tps ile ölçüm yap. MSPT, tick başına milisaniye demektir: Tick süresi sürekli olarak zaman bütçesinin üzerindeyse tick hızı düşer.
  3. Soruna neyin yol açtığını bulmak için spark profiler start --timeout 120 komutunu çalıştır ve ardından verilen bağlantıyı aç.
  4. Sunucu durdurulmuşken server.properties içindeki görüş mesafesini view-distance ve simülasyon mesafesini simulation-distance düşür. Büyük farmları hafiflet veya dünyayı önceden oluştur.
  5. RAM'in yeterli olup olmadığını kontrol et ve yapılandırma değişikliklerinden sonra sunucuyu yeniden başlat.

Ayrıntılı bilgi: “Can't keep up” ve Watchdog zaman aşımı sorunlarını doğru şekilde çözme

“DO NOT REPORT THIS TO PAPER”: Sunucu donmasında tanılama

Mesaj şöyle görünür:

--- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH ---
Server thread dump (Look for plugins here before reporting to Paper!):

Arka planda ne oluyor: Sunucu thread'i birkaç saniye takılırsa Paper, sunucunun o anda ne üzerinde çalıştığının anlık görüntüsü olan bir thread dump içeren tanılama kaydı yazar. Bu sırada oyun akışı durur; donma geçtikten sonra sunucu çalışmaya devam edebilir. Tıkanma çok uzun sürerse Watchdog sunucuyu kapatır.

Nasıl çözersin:

  1. Dump içinde Server thread dump altındaki en üst satırları oku. Orada bir eklenti veya mod adı geçiyorsa bu, sorunun kaynağına dair güçlü bir işarettir.
  2. Sunucuyu durdur, ilgili eklentiyi Eklentiler bölümünden veya modu Modlar bölümünden güncelle ya da test amacıyla kaldır ve sunucuyu yeniden başlat.
  3. Dump'lar sıklaşırsa RAM'i, eklentilerini ve server.properties içindeki görüş mesafesini view-distance kontrol et.
  4. Başlangıçta veya büyük bir dünya kaydedilirken görülen tekil dump'lara hemen müdahale etmek yerine durumu gözlemleyebilirsin.

Ayrıntılı bilgi: “Can't keep up” ve Watchdog zaman aşımı sorunlarını doğru şekilde çözme

“ChunkTaskScheduler”: Paper bir chunk'ın yüklenmesini veya oluşturulmasını bekliyor

Mesaj şöyle görünür:

[ChunkTaskScheduler] Chunk wait task info below:
[ChunkTaskScheduler] Chunk holder: NewChunkHolder{world=<Welt>, chunkX=<x>, chunkZ=<z>, …, currentGenStatus=minecraft:initialize_light, requestedGenStatus=minecraft:full, …}
[ChunkTaskScheduler] Chunk holder: NewChunkHolder{world=<Welt>, chunkX=<x>, chunkZ=<z>, …, currentGenStatus=minecraft:full, requestedGenStatus=null, …, currentChunkStatus=FULL, …}

Arka planda ne oluyor: Paper, 16 × 16 blokluk bir dünya parçası olan chunk'ın yüklenmesini veya oluşturulmasını uzun süre beklemiş ve bir tanılama kaydı yazmıştır; bu sırada sunucu takılır. currentGenStatus ulaşılan aşamayı, requestedGenStatus hedefi gösterir; null ise kayıtlı bir oluşturma hedefi olmadığı anlamına gelir, raporda tamamlanmış chunk'lar da yer alabilir. Arkasında genellikle aşırı yük vardır: dünya oluşturma, birbirinden çok uzakta bulunan çok sayıda oyuncu veya yavaş eklentiler. Daha seyrek olarak bir bölge bozulmuş olabilir.

Nasıl çözersin:

  1. Dosyalar bölümünde server.properties içindeki görüş mesafesini view-distance düşür ve sunucuyu yeniden başlat.
  2. Dünyayı önceden oluştur: Chunky: Minecraft dünyasını önceden oluşturma.
  3. spark kullanılabiliyorsa sorun sırasında Konsolda spark profiler start --timeout 120 komutuyla yükü incele. Rapor, hangi işlemlerin zaman aldığını gösterir.
  4. Sorun tekrar tekrar aynı dünyayı ve aynı chunk koordinatlarını etkiliyorsa çevredeki log satırlarında bu bölgeye ait yükleme hatalarını ara. Bozulma doğrulanırsa sunucuyu durdur, mevcut durumu yedekle ve Yedekler bölümünden sağlam bir yedeği geri yükle. Bu yedekten sonra yapılan değişiklikler kaybolur.

Bilmekte fayda var: Çok büyük koordinatlar, dünya merkezinden çok uzağa yapılan yolculuklara işaret eder. Uygun bir dünya sınırı, daha fazla keşfi sınırlar.

“The server has stopped responding”: Paper Watchdog bir donma bildiriyor

Mesaj şöyle görünür:

The server has stopped responding! This is (probably) not a Paper bug.
If you see a world save or edit, then it means you did far more than your server can handle at once
If this is the case, consider increasing timeout-time in spigot.yml but note that this will replace the crash with LARGE lag spikes

Arka planda ne oluyor: Bu satırlar, oyun akışını yürüten iş kolu olan ana thread'in uzun süre tıkandığını algılayan Paper Watchdog'un uyarı bloğuna aittir. Donma sırasında oyun akışı durur; tıkanma devam ederse Watchdog sunucuyu kapatır. Tipik nedenler arasında aşırı yüklenmiş eklentiler, büyük dünya işlemleri veya işlemi bekleten HTTP ve veritabanı erişimleri bulunur. Altındaki thread dump, o anda yürütülen program çağrılarını gösterir.

Nasıl çözersin:

  1. Dosyalar bölümünde logs/latest.log içindeki thread dump'ı oku. Adı geçen eklentilerin güncellemelerini kontrol et; yapılandırmalarını düzenle veya sunucu durdurulmuşken test amacıyla kaldır.
  2. Dump dünya düzenleme veya kaydetme işlemlerini gösteriyorsa WorldEdit gibi araçlarla yapılan büyük işlemleri daha küçük adımlara böl.
  3. Dump HTTP veya MySQL erişimlerini gösteriyorsa ilgili eklentinin bağlantısını ve hizmetin erişilebilirliğini kontrol et.
  4. spigot.yml içindeki timeout-time değerini artırmak bekleme süresini uzatır ama tıkanmayı çözmez.
  5. Donmalar tekrarlanıyorsa eklenti yükünü azalt ve RAM'i kontrol et.

Ayrıntılı bilgi: “Can't keep up” ve Watchdog zaman aşımı sorunlarını doğru şekilde çözme

BootstrapMethodError: Paper'ın dünya parçalarıyla ilgili görevi başarısız oldu

Mesaj şöyle görünür:

[ca.spottedleaf.concurrentutil.executor.thread.BalancedPrioritisedThreadPool] Exception thrown from thread <Thread>
java.lang.BootstrapMethodError: bootstrap method initialization exception

Arka planda ne oluyor: Paper, dünya parçaları olan chunk'ları ana oyunun yanı sıra ayrı thread'lerde de yükler, oluşturur ve kaydeder. Böyle bir iş parçacığında Java, programdaki bir çağrı noktasını hazırlayamadı ve ilgili görev başarısız oldu. Hatanın altındaki çağrı listesi olan stack trace'te saveChunk geçiyorsa sorun bir dünya parçasının kaydedilmesiyle ilgilidir. Olası nedenler arasında Paper'daki bir hata, uyumsuz bir eklenti veya desteklenmeyen bir Java sürümü bulunur.

Nasıl düzeltirsin:

  1. Sürüm bölümünden Paper'ı Minecraft sürümün için güncel bir kararlı build'e yükselt.
  2. Bu build'in desteklediği bir Java sürümü kullan: Minecraft sunucun hangi Java sürümüne ihtiyaç duyuyor?
  3. logs/latest.log dosyasındaki stack trace'in tamamını oku. Bir Caused by satırında bir eklentinin adı geçiyorsa onu Eklentiler bölümünden güncelle.
  4. Sunucu kütüphanelerini elle değiştirme. Bu genellikle yeni hatalara yol açar.
  5. Hata güncellemeden sonra da tekrar ediyorsa stack trace'in tamamını Paper projesine bildir.

Minecraft çökme raporunu kaydedemiyor

Mesaj şöyle görünür:

We were unable to save this crash report to disk.

Arka planda ne oluyor: Bu mesaj, çökme raporunun yazılmasıyla ilgilidir. Minecraft bir hatadan sonra tanılama bilgilerini diske kaydetmeye çalıştı, ancak rapor dosyasını kaydedemedi. Asıl hatanın nedeni daha önce Konsol çıktısında yer alır; raporun eksik olması ise sonradan hata ayıklamayı zorlaştırır.

Nasıl düzeltirsin:

  1. Önce bu mesajdan önceki satırlar dahil olmak üzere Konsol bölümündeki hata bloğunun tamamını kaydet.
  2. Dosyalar bölümünde crash-reports/ içindeki mevcut dosyaları ve logs/latest.log dosyasını kontrol et. Yazma hatasının tam mesajını oku ve kullanılabilir depolama alanını kontrol et.
  3. Orada belirtilen nedeni gider. Yola hâlâ yazılamıyorsa bir destek talebi aç ve saati ile yazma hatasını belirt.

Karşılaştığın mesaj burada yok mu?

logs/latest.log dosyasındaki mesajın tamamını ve özellikle önceki satırları oku: Aşırı yükün neredeyse her zaman ilk uyarıdan önce ortaya çıkan bir tetikleyicisi vardır. Stack trace'te veya thread dump'ta, com.<Entwickler>.<Plugin> gibi noktalarla ayrılmış klasör adlarından oluşan paket adları ve <Plugin>.jar gibi dosya adları, hangi eklentinin veya modun işin içinde olduğunu gösterir. Yapılandırma dosyalarında değişiklik yapmadan önce Yedekler bölümünden bir yedek oluştur. İlerleyemezsen bir destek talebi aç ve mesajın saatini belirt.