Bir eklenti veya mod çalışırken bir program hatasıyla karşılaştığında Java, günlüğe stacktrace içeren bir hata mesajı yazar. Stacktrace, hata satırının altındaki “at” satırlarından oluşan listedir. O sırada programın hangi bölümünün çalıştığını gösterir ve böylece çoğu zaman sorumlu eklentiyi veya modu ele verir. Bu hataların çoğu sunucuyu durdurmaz, ancak bir işlev devre dışı kalır ve tekrarlayan hatalar konsolu doldurur.

Aşağıdaki her bölüm bir mesajı ele alıyor: nasıl göründüğünü, arkasında ne olduğunu ve neler yapabileceğini anlatıyor. Mesajın tamamını Konsol bölümünde veya Dosyalar altında logs/latest.log içinde bulabilirsin. Orada hemen önceki ve sonraki satırları da oku. Yapılandırma veya dünya dosyalarını değiştirmeden ya da eklentileri değiştirmeden önce Yedekler altında bir yedek oluştur. Eklenti dosyalarını en iyisi sunucu durdurulmuşken değiştir.

NullPointerException: Eklenti veya mod eksik bir değere erişiyor

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

Failed to handle packet <Paket>, suppressing error
java.lang.NullPointerException: Cannot invoke "com.google.gson.JsonObject.entrySet()" because "jsonobject" is null
java.lang.NullPointerException: Cannot invoke "com.google.gson.JsonElement.getAsBoolean()" because the return value of "com.google.gson.JsonObject.get(String)" is null

Arkasında ne var: Bir eklenti veya mod eksik bir nesneye erişiyor; Java bu değere “null” der. “Cannot invoke” ifadesinden sonra metot, “because” ifadesinden sonra eksik değer yazar. Bu durum bir dil dosyası veya yapılandırma okunurken de oluşabilir. İlgili işlem iptal edilir; “Skipped language file” mesajında dil dosyası atlanır. “Failed to handle packet … suppressing error” mesajında sunucu yalnızca oyuncunun o tek işlemini yok sayar ve çalışmaya devam eder. Hata, başlangıç sırasında oluşursa başlatma sürecini de kesintiye uğratabilir.

Nasıl çözersin:

  1. Mesajın tamamını Konsol bölümünde veya logs/latest.log içinde aç. Önceki satırları da oku: Adı geçen bir dil veya yapılandırma dosyası, hatanın kaynağını belirlemeye yardımcı olur.
  2. “at” satırlarına stacktrace denir: Hataya kadar uzanan çağrı zinciridir. İlk satırdan başlayarak ilgili eklentiye veya moda ulaşana kadar oku; ilk satırda Minecraft'ın kendisi yazıyor olabilir.
  3. Belirlediğin eklentiyi Eklentiler altında, modu ise Modlar altında sunucu sürümüne uygun şekilde güncelle. Dosyayı değiştirmeden önce sunucuyu durdur ve ardından yeniden başlat.
  4. Bir yapılandırma dosyası belirtiliyorsa onu yedekle ve gerekli ayarları geliştiricinin belirttikleriyle karşılaştır. Hata devam ederse geliştiriciye mesajın tamamını ve hatayı tetikleyen işlemi bildir.

Bilmekte fayda var: pl:mixin:APP:<Mod>.mixins.json, oyun akışına müdahale eden bir Mixin kullanan modu belirtir.

“Could not pass event”: Eklenti bir oyun olayında çöküyor

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

Could not pass event <Ereignis> to <Plugin> v<Version>
java.lang.NoSuchMethodError: …
io.netty.channel.unix.Errors$NativeIoException: bind(..) failed with error(-99): Cannot assign requested address

Arkasında ne var: Eklentiler; sunucuya katılma, envanter tıklaması veya hasar gibi olaylara (event) tepki verir. Bir eklenti bu sırada bir exception, yani bir Java hatası fırlatırsa işlemi yarıda kesilir. “to” ifadesinden sonra eklenti ve sürümü, öncesinde ise olay yazar. “NoSuchMethodError” veya “NoSuchFieldError”, uyumsuz bir sunucu sürümüne işaret eder. “IllegalArgumentException”, örneğin geçersiz bir renk değeri veya uygun olmayan bir veri türü anlamına gelebilir. “Cannot assign requested address” ile birlikte görülen “bind(..) failed” ise eklentinin, çoğunlukla Geyser'ın, girilen ağ adresini kullanamadığı anlamına gelir. Sunucu çalışmaya devam eder, ancak eklentinin ilgili işlevi bu olayda devre dışı kalır.

Nasıl çözersin:

  1. Konsol bölümünde “to” ifadesinden sonraki eklenti adını ve sürümünü, ayrıca altındaki hata satırını oku.
  2. Sürüm altında hangi sunucu sürümünün çalıştığını kontrol et ve eklentinin sayfasında bu sürümü destekleyen bir sürüm ara.
  3. Sunucuyu durdur, uygun sürümü Eklentiler altından yükle ve yeniden başlat.
  4. “bind(..) failed” hatasında Dosyalar altından eklentinin yapılandırmasındaki adresi ve portu kontrol et. Eklenti, sunucuya ait olmayan bir adresi kullanamaz.
  5. Hata devam ederse tetikleyen işlemle birlikte hata mesajının tamamını eklenti geliştiricisine bildir.

Bilmekte fayda var: “NoSuchMethodError” ve “NoSuchFieldError” hakkında ayrıntılı bilgi: Eklenti sunucu sürümüyle uyumlu değil.

“Task … generated an exception”: Eklenti görevi arka planda başarısız oluyor

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

[<Plugin>] Task #<Nummer> for <Plugin> v<Version> generated an exception
java.lang.IllegalArgumentException: missing required data class org.bukkit.Color
java.lang.IllegalStateException: Cannot modify read-only score

Arkasında ne var: Örneğin parçacıklar veya hologramlar için zamanlanmış bir eklenti görevi (task), bir Java hatası yani exception nedeniyle yarıda kesilmiştir. Tekrarlayan hatalar, çoğunlukla örneğin bir güncellemeden sonra sunucu sürümüyle oluşan uyumsuzluğa işaret eder. Geçersiz değerler veya salt okunur skorlara erişim girişimleri de bu hataya yol açabilir. Sunucu çalışmaya devam eder, ancak bir eklenti işlevi devre dışı kalır ve tekrarlayan hatalar konsolu doldurur.

Nasıl çözersin:

  1. “for” ifadesinden sonraki eklenti adını ve altındaki hata satırını oku.
  2. Eklentiler altında sunucu sürümüne uygun daha yeni bir sürüm olup olmadığını kontrol et. Sunucuyu durdur, yeni sürümü yükle ve yeniden başlat.
  3. Uygun bir sürüm yoksa sunucuyu durdur ve Dosyalar altından .jar dosyasını plugins/ klasöründen ayrı bir klasöre taşı. Ardından yeniden başlat. Sürekli oluşan hatalar sunucuyu yavaşlatabilir.
  4. Konsol bölümünde mesajın kaybolup kaybolmadığını kontrol et. Güncel sürümde de görünmeye devam ederse geliştiriciye bildir.

Bilmekte fayda var: “missing required data class”, eksik parçacık verisine, burada bir renge işaret eder. “Cannot modify read-only score”, salt okunur bir skorla ilgilidir; bu erişimi eklentinin düzeltmesi gerekir. “NoSuchMethodError” veya “NoSuchFieldError”, sürüm uyumsuzluğuna işaret eder.

“Error executing task” / “Command … failed”: Görev veya komut yarıda kesiliyor

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

[Essentials] Command <Befehl> failed:
[<Plugin>] Plugin <Plugin> v<Version> generated an exception while executing task <Nummer>
Error executing task on Server

Arkasında ne var: Bir komut veya zamanlanmış bir görev, bir exception yani Java hatası nedeniyle yarıda kesilmiştir. Eklenti hatasında sunucu çalışmaya devam eder, ilgili işlev ise devre dışı kalır; “Error executing task on Server” mesajı sunucunun kendi görevlerinde de görülür. MissingResourceException eksik bir kaynak veya dil girdisini, sectionPos out of bounds ise geçersiz bir bölüm konumunu belirtir. Neden, mesajın altında, iç içe geçmiş hatalarda ise “Caused by” ifadesinden sonra yazar.

Nasıl çözersin:

  1. “Caused by” satırını veya mesajın hemen altındaki ilk hata satırını oku.
  2. Eklentiyi mesajdan veya hataya kadar uzanan çağrı zinciri olan at … satırlarından belirle. Burada gerekli ek eklentiler de belirtilmiş olabilir.
  3. Eklentiyi ve ilgili bağımlılıkları Eklentiler altında sunucu sürümüne uygun ve birbiriyle uyumlu sürümlere güncelle. Dosyaları değiştirmeden önce sunucuyu durdur ve ardından yeniden başlat.
  4. İşlemi tekrarla. Hata devam ederse mesajın tamamıyla birlikte eklenti geliştiricisine bildir. Çağrı zincirinde yalnızca Minecraft sınıfları geçiyorsa bir destek talebi aç; işlemi ve saatini belirt.

Bilmekte fayda var: NoSuchMethodError veya NoSuchFieldError, eksik metotlara veya alanlara işaret eder: Desteklenen sunucu sürümünü ve bağımlılıkları kontrol et.

ClassCastException: Mod veya eklenti farklı bir veri türü bekliyor

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

Failed to clear dangling mod jars
java.lang.ClassCastException: Cannot cast <PaketA>.<KlasseA> to <PaketB>.<KlasseB>
java.lang.ClassCastException: class net.minecraft.block.AirBlock cannot be cast to class net.minecraft.block.AbstractBannerBlock

Sorunun nedeni: Bir mod veya eklenti, ilgili bir bileşenin sağladığından farklı bir veri türü bekliyor. Bu durum örneğin bir mod güncellendiğinde, ona bağlı başka bir mod güncellenmediğinde ortaya çıkar. Hata, bir mod yapılandırması okunurken de oluşabilir. Çoğu zaman yalnızca ilgili işlev devre dışı kalır; örneğin blok verilerinin yüklenmesi veya yüklenen mod dosyalarının temizlenmesi.

Nasıl düzeltirsin:

  1. Dosyalar bölümünde logs/latest.log içindeki mesajın tamamını oku. Sınıf adlarının önündeki paket adları, işin içindeki modları veya eklentileri tanımana yardımcı olur; java.lang.String ise metin için kullanılan Java veri türünü ifade eder.
  2. En son hangi bileşenin güncellendiğini kontrol et. İlgili modları veya eklentileri birbiriyle uyumlu sürümlere getir: birlikte güncelle ya da önceki duruma geri döndür.
  3. Bir modpack kullanıyorsan tek tek modlar yerine modpack'in tamamını güncelle.
  4. Mesajda bir yapılandırma girdisi geçiyorsa onu, kurulu mod sürümünün belgelerine göre kontrol et.
  5. Yeniden başlat ve işlemi tekrarla.

Mod çakışmaları hakkında daha fazlası: Forge, NeoForge ve Fabric'te mod hataları.

ArrayIndexOutOfBoundsException: Var olmayan bir liste öğesine erişim

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

java.lang.ArrayIndexOutOfBoundsException: Index 3 out of bounds for length 3
[DonateCase] Error occurred while loading item: <Eintrag>
java.lang.ArrayIndexOutOfBoundsException: Index 45 out of bounds for length 45

Sorunun nedeni: Bir eklenti veya mod, bir dizide, yani sabit uzunluklu bir listede geçersiz bir konuma erişmeye çalışıyor. Java saymaya 0'dan başlar: Uzunluk 3 ise yalnızca 0 ile 2 arasındaki konumlar vardır; negatif konumlar da geçersizdir. Sık görülen nedenler arasında eksik komut argümanları veya yapılandırma değerleri, eski bir eklentinin sunucu sürümünü yanlış okuması ya da DonateCase örneğindeki gibi bir menü öğesinin menü boyutunun dışında kalması yer alır. Hatanın oluştuğu yere göre bir işlev devre dışı kalır veya başlatma başarısız olur.

Nasıl düzeltirsin:

  1. Hata satırlarını Konsol'da veya Dosyalar bölümünde logs/latest.log içinde oku. Altındaki “at” satırları, stack trace olarak da bilinen çağrı zincirini gösterir; burada ilgili eklentiyi veya modu ara.
  2. Hata bir komutla ilgiliyse gerekli argümanları kontrol et. Yapılandırma değerlerini şablonla veya bir yedekle karşılaştır. Menü hatalarında ayarlanan konumların menü boyutuna uyup uymadığını kontrol et.
  3. İlgili eklentiyi Eklentiler bölümünden veya modu Modlar bölümünden, sunucuna ve loader'ına uygun bir sürüme güncelle. Loader, modları yükleyen yazılımdır. Ardından yeniden başlat.
  4. Hata devam ederse hata mesajını, çağrı zincirini ve hatayı tetikleyen durumu geliştiriciye bildir.

Bir eklentinin yapılandırma dosyası hatalı.

NumberFormatException: Sayı olması gereken bir metin

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

[DeluxeMenus-Modern] Input for comparison requirement is an invalid number: %statistic_hours_played%
java.lang.NumberFormatException: For input string: "%statistic_hours_played%"
java.lang.NumberFormatException: For input string: "craftbukkit"

Sorunun nedeni: Oyun, bir mod veya bir eklenti bir metin değerini sayı olarak okumak istedi, ancak bu metin bir sayı değildi. Tırnak işaretleri değerin kendisini gösterir; nedeni bir yapılandırma, beklenmeyen bir veri değeri ya da sürüm veya program hatası olabilir. Yüzde işaretli bir yer tutucu, örneğin DeluxeMenus'teki sayı kontrolünde olduğu gibi, gerçek değeriyle değiştirilememiştir; çoğu zaman bu tür yer tutucuları dolduran eklenti olan PlaceholderAPI için uygun genişletme veya değeri sağlayan eklenti eksiktir. craftbukkit gibi bir kelime, eski bir eklentinin sunucu sürümünü yanlış okuduğuna işaret edebilir.

Nasıl düzeltirsin:

  1. Stack trace'in tamamını, yani hata mesajının altındaki çağrı zincirini incele ve orada adı geçen bileşeni güncelle.
  2. Yer tutucu söz konusuysa oyun içinde /papi parse me <Platzhalter> komutuyla bir değer döndürüp döndürmediğini test et. Değer dönmüyorsa değeri sağlayan eklentiyi kontrol et ve uygun PlaceholderAPI genişletmesini /papi ecloud download <Name> komutuyla kur. Ardından /papi reload ile yükle.
  3. Mesajda bir dosya veya ayar geçiyorsa değeri eklentinin varsayılan yapılandırmasıyla karşılaştır.
  4. Yeniden başlat ve işlemi tekrar tetikle.

Ek bilgi içermeyen ArrayIndexOutOfBoundsException

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

[<Plugin>] Error occurred while loading item: 2
java.lang.ArrayIndexOutOfBoundsException

Sorunun nedeni: Bir önceki bölümde olduğu gibi, bir eklenti veya mod geçersiz bir liste indeksi kullandı. Ancak burada indeks ve uzunluk bilgisi yok. Bu, aynı hata çok sık tekrarlandığında görülür: Java bu durumda performans nedeniyle ayrıntıları atlar. Önceki satır, çoğu zaman hangi eklentinin o anda ne yapmaya çalıştığını gösterir; örnekte bu, bir öğe yüklemektir. Altındaki ilk stack trace satırı, varsa, hataya neden olan bileşeni belirtir.

Nasıl düzeltirsin:

  1. Mesajın hemen önündeki satırı oku. Eklentinin adı çoğu zaman orada köşeli parantez içinde yazar.
  2. Mesajın altındaki ilk stack trace satırını oku.
  3. İkisi de yoksa logs/latest.log dosyasında yukarılara çıkıp hatanın ilk geçtiği yeri ara. Hata orada genellikle hâlâ eksiksiz yer alır. Eski loglar logs/ klasöründe sıkıştırılmış olarak bulunur.
  4. İlk adı geçen eklentiyi veya modu güncelle. Önceki satırda belirli bir öğe geçiyorsa onu eklentinin yapılandırmasında kontrol et.
  5. Hata devam ederse geliştiriciye bildir.

ExceptionInInitializerError: Eklenti veya mod sınıfı başlatılamıyor

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

Exception in thread "ForkJoinPool-3-worker-1" java.lang.ExceptionInInitializerError
Caused by: <Fehlerart>: <Meldung>

Sorunun nedeni: Java her sınıfı, yani bir programın her yapı taşını, ilk kullanımda bir kez başlatır. Bir eklentinin veya modun sınıfı tam da bu sırada çöktü. Bundan sonra sınıf, sunucunun bu çalışma süresi boyunca kullanılamaz; bu yüzden ardından çoğu zaman aynı sınıf adıyla “NoClassDefFoundError” gibi başka hatalar gelir. Asıl nedeni ve genellikle ilgili eklentiyi veya modu, altındaki “Caused by” zinciri gösterir. Hatanın oluştuğu yere göre bir işlev devre dışı kalır veya eklenti ya da mod hiç yüklenmez.

Nasıl düzeltirsin:

  1. Konsol'da veya logs/latest.log içinde mesajın altındaki ilk “Caused by” satırını oku.
  2. Altındaki “at” satırlarından eklentiyi veya modu belirle; örneğin .jar uzantılı dosya adından anlayabilirsin.
  3. Onu güncelle veya sunucu sürümüne ve sunucu yazılımına uygun bir sürümle değiştir.
  4. Sunucuyu yeniden başlat. Sınıf ancak bir sonraki başlatmada yeniden kurulur.

Sürüm sorunlarında şu rehber yardımcı olur: Eklenti sunucu sürümüyle uyumlu değil.

“location-candidate error” / “Failed to save a model”: Eklenti görevi başarısız oluyor

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

[OlEncounters] First unexpected location-candidate error during this search
com.olencounters.location.LocationFinder$UngeneratedChunkException: Location search refused to generate a chunk
[OpenAudioMc] WARNING: Failed to save a model. This is a error. (ClientDataStore) (IllegalArgumentException/java.lang.ArithmeticException: long overflow)

Arka planda ne oluyor: Bir eklenti, kendi görevlerinden birini yürütürken hatayla karşılaştı; örneğin kaydetme, bir mesajı işleme, başlatma veya bir konum arama sırasında. OlEncounters burada henüz oluşturulmamış bir chunk'a, yani bir dünya bölümüne denk geliyor ve arama sırasında bu bölümü oluşturmayı reddediyor. OpenAudioMc ise bir sayı taşması nedeniyle verileri kaydedemiyor: Bir hesaplamanın sonucu, kullanılan sayı türüne sığmıyor. Hataya bağlı olarak yalnızca bu işlem başarısız olur veya eklenti kendini devre dışı bırakır; veri kaybı yaşamamak için kaydetme hatalarıyla kısa sürede ilgilenmelisin.

Şöyle çözersin:

  1. Konsol bölümünde eklentinin adını ve mesajın hemen altındaki satırları oku.
  2. Eklentiyi Eklentiler bölümünden güncelle ve sunucuyu yeniden başlat.
  3. Hata devam ederse bir yedek al, sunucu durdurulmuşken eklentiyi deneme amacıyla kaldır ve başlatmanın ardından mesajın kaybolup kaybolmadığını kontrol et.
  4. Hatayı, konsoldaki satırlarla ve hatanın ortaya çıktığı işlemle birlikte eklentinin geliştiricisine bildir.

Kaydetme işlemi tekrar tekrar başarısız oluyorsa: Eklenti veritabanına veya dosyalara kayıt yapamıyor.

#!#! içeren Skript hata raporu: Bir script yüklenmiyor

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

#!#! Current node: <Zeile aus der .sk-Datei>
#!#! End of Error.

Arka planda ne oluyor: Skript, sunucu işlevlerini .sk uzantılı basit metin dosyalarında yazmanı sağlayan bir eklentidir. Bir script'i veya eklentinin bir addon'unu yüklerken ciddi bir hata tespit ederse, tüm satırları #!#! ile başlayan bir rapor yazar. Sık görülen nedenler: skript-reflect veya SkBee gibi bir addon, kurulu Skript sürümüyle uyumlu değildir ya da bir eklenti dosyası sunucu çalışırken değiştirilmiştir. İkinci durumda raporda “zip file closed” ifadesi yer alır. Etkilenen script çalışmaz, sunucu ise çalışmaya devam eder.

Şöyle çözersin:

  1. Raporda “Current node” satırını (etkilenen .sk dosyasını belirtir) ve “Caused by” satırını oku.
  2. Proje sayfalarından hangi addon sürümlerinin Skript sürümünle uyumlu olduğunu kontrol et ve Skript ile addon'ları birbiriyle uyumlu sürümlere getir.
  3. Eklenti dosyalarını yalnızca sunucu durdurulmuşken değiştir ve ardından sunucuyu yeniden başlat.
  4. Script'i /sk reload <datei> ile yükle ve Konsol bölümündeki çıktıyı oku.

Bilmekte fayda var: Script'ler Dosyalar bölümünde plugins/Skript/scripts/ klasöründe bulunur. Bir dosyayı değiştirmeden önce yedeğini al.

IndexOutOfBoundsException: “must be less than size”

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

Caused by: java.lang.IndexOutOfBoundsException: index (1) must be less than size (1)

Arka planda ne oluyor: Oyun, bir mod veya bir eklenti, listede bulunmayan bir girdiye erişmeye çalıştı. “index (1) must be less than size (1)” şu anlama gelir: Listede 0 numaralı tek bir girdi var, ancak 1 numaralı girdi istendi. Bir yapılandırmanın bununla ilgisi olabilir, ancak mesaj tek başına bunu kanıtlamaz. Önünde “Caused by:” yazıyorsa bu mesaj, daha yukarıda bildirilen bir hatanın nedenidir. Neyin çalışmadığını bu üstteki mesaj gösterir.

Şöyle çözersin:

  1. logs/latest.log dosyasındaki stack trace'in tamamını, üstündeki hata mesajıyla birlikte oku.
  2. Harici bir bileşeni, yani Java veya java.base ya da com.google.common gibi bir kütüphane yerine bir eklentiyi veya modu belirten ilk “at” satırını bul.
  3. Bu bileşeni güncelle ve sunucuyu yeniden başlat.
  4. Yalnızca bağlam menü girdileri veya ödüller gibi belirli bir listeye işaret ediyorsa, bu listenin yapılandırmasında eksik veya boş girdi olup olmadığını kontrol et.

“Asynchronous Save Players”: Paper, oyuncu verilerinin kaydedilmesini bekliyor

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

Asynchronous Save Players! Blocking thread until it returns
java.lang.IllegalStateException: null
at org.bukkit.craftbukkit.util.ServerShutdownThread.run(ServerShutdownThread.java:<Zeile>)

Arka planda ne oluyor: Bir eklenti, tüm oyuncu verilerinin kaydedilmesini bir arka plan thread'inden, yani dünyayı hesaplayan ana thread'in yanında paralel çalışan bir iş parçacığından başlatabilir. Paper, kaydetme bitene kadar bu thread'i engeller; bu sırada kısa takılmalar yaşanabilir. ServerShutdownThread içeren varyant, kapanış sırasında görülür. Normal çalışma sırasında sunucu, kaydetme bittikten sonra çalışmaya devam eder; kapanış sırasında ise mesaj, zaten devam eden kapatma sürecinin bir parçasıdır.

Şöyle çözersin:

  1. Mesajın altındaki “at” satırlarının tamamını oku. Bu satırlar ilgili program parçalarını gösterir; ilk satırlar genellikle Paper'a veya Minecraft'a aittir.
  2. Bu satırlardan biri bir eklentiyi belirtiyorsa, eklentiyi Eklentiler bölümünden güncelle ve sunucuyu yeniden başlat. Uyarı devam ederse, çağrı listesinin tamamıyla birlikte eklentinin geliştiricisine bildir.
  3. Liste yalnızca sunucu bileşenlerini ve ServerShutdownThread satırını gösteriyorsa, Konsol bölümünde kapanıştan önceki satırları da oku. Sunucunun o sırada planlı olarak durdurulup durdurulmadığını kontrol et.
  4. Uyarı belirli bir eklenti görünmeden tekrarlanıyorsa veya kaydetme sorunları yaşanıyorsa bir destek talebi aç ve mesajın saatini belirt.

“Unhandled exception executing command”: Eklenti komutu yarıda kesiliyor

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

org.bukkit.command.CommandException: Unhandled exception executing command '<befehl>' in plugin <Plugin> v<Version>
Caused by: <Fehlerart>: <Meldung>

Arka planda ne oluyor: Bir eklenti, komutlarından birini çalıştırırken hata verdi. Komut ve eklenti mesajda yazar. Çoğu zaman eklenti, sunucu sürümüyle veya bağımlı olduğu başka bir eklentiyle uyumlu değildir. Komutu giren kişi sohbette genellikle yalnızca dahili bir hata olduğuna dair genel bir uyarı görür. Komut çalıştırılmamıştır, sunucu ise çalışmaya devam eder.

Şöyle çözersin:

  1. Mesajın altındaki “Caused by” satırını oku.
  2. Sürüm bölümünden sunucu sürümünü kontrol et ve eklentiyi Eklentiler bölümünden bu sürüme uygun bir sürüme güncelle.
  3. Hata satırı, eklentinin bağımlı olduğu başka bir eklentiyi belirtiyorsa onu da uyumlu bir sürüme getir.
  4. Sunucuyu yeniden başlat ve komutu test et. Hata devam ederse bu satırla birlikte eklentinin geliştiricisine bildir.

Bağımlılıklar hakkında daha fazla bilgi: Eklenti başka bir eklentiye ihtiyaç duyuyor.

Log'da “[ACF]” içeren komut hatası

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

[<Plugin>] [ACF] Exception in command: <befehl>
[<Plugin>] [ACF] java.lang.NoSuchMethodError: <Methode>

Arka planda ne oluyor: Birçok eklenti, komutlarını hazır bir kütüphane olan Aikar Command Framework (ACF) ile oluşturur. Bir komut exception ile sonlanırsa ACF, hatayı stack trace ile birlikte yazdırır ve her satırın başına eklentinin adını ekler. Yani ilk parantezdeki ad ACF değil, etkilenen eklentidir. Çıktıda “IncompatibleClassChangeError” veya “NoSuchMethod” geçiyorsa eklenti, sunucu sürümüyle uyumlu değildir. Komut çalıştırılmamıştır, sunucu ise çalışmaya devam eder.

Şöyle çözersin:

  1. İlk köşeli parantezdeki eklenti adını ve “Exception” veya “Error” içeren ilk hata satırını oku.
  2. Eklentiyi Eklentiler bölümünden sunucu sürümüne uygun bir sürüme güncelle.
  3. Sunucuyu yeniden başlat ve komutu test et.
  4. Hata devam ederse ilk hata satırıyla birlikte eklentinin geliştiricisine bildir.

Bilmekte fayda var: ACF'yi kendin kurman veya güncellemen gerekmez. İlgili eklentinin içinde gelir.

GravesX: Bir arka plan görevinde hata

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

[GravesX] Async task for GravesX v<Version> generated an exception
java.lang.NullPointerException: Cannot invoke "<Methode>" because "version2" is null

Sorunun nedeni: GravesX, bir oyuncu öldüğünde eşyalarını içeren bir mezar oluşturur. Eklenti, örneğin iki sürüm numarasını karşılaştırırken bir değer (“version2”) eksik olduğunda arka plan görevinde NullPointerException hatası verir. Bu, sunucu veya hosting kaynaklı bir sorun değil, eklentinin kendi hatasıdır. Sunucu normal şekilde çalışmaya devam eder.

Çözüm adımları:

  1. Plugins bölümünden GravesX'i en yeni sürüme güncelle ve sunucuyu yeniden başlat.
  2. Konsol bölümünde mesajın tekrar görünüp görünmediğini kontrol et.
  3. Hata devam ederse mesajın tamamıyla birlikte GravesX projesine bildir.
  4. Düzeltme gelene kadar eklentiyi deneme amaçlı devre dışı bırakmak istersen önce açık mezarları boşalttır. Eklenti olmadan mezarlar her zamanki gibi açılamaz.

FastAsyncWorldEdit: Komut dahili olarak başarısız oldu

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

An unexpected error while handling a FastAsyncWorldEdit command
java.lang.NullPointerException

Sorunun nedeni: FastAsyncWorldEdit (FAWE), büyük alanları tek seferde düzenlemeni sağlayan hızlı bir WorldEdit çeşididir. FAWE bir komutu işlerken eksik bir değerle karşılaşmıştır. İşlem tamamlanamadığı için değişiklik dünyaya yalnızca kısmen uygulanmış olabilir. Sunucu çalışmaya devam eder.

Çözüm adımları:

  1. Oyun içinde komutun neleri değiştirdiğini kontrol et. Gerekirse //undo ile son adımı geri alabilirsin.
  2. Plugins bölümünden FAWE'yi sunucu sürümüne uygun bir sürüme güncelle ve sunucuyu yeniden başlat.
  3. Komutu yeniden çalıştır.
  4. Hata devam ederse tam stack trace'i ve kullandığın komutu FAWE geliştiricilerine bildir.

Geri almayla ilgili temel bilgiler: WorldEdit: inşa etme ve geri alma.

Bilmekte fayda var: FAWE'yi normal WorldEdit'in yanına ek olarak kurma. İkisi birlikte uyumlu çalışmaz, yalnızca birini kullan.

“An unexpected exception occurred while performing command”: LibreLogin komutu başarısız oluyor

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

[LibreLogin] An unexpected exception occurred while performing command …

Sorunun nedeni: LibreLogin bir giriş eklentisidir: Oyuncular, çoğunlukla çevrimdışı moddaki sunucularda, bir parolayla giriş yapar. Eklenti, giriş veya kayıt gibi komutlarından birini çalıştırırken beklenmeyen bir exception nedeniyle durmuştur. Komut oyuncu için başarısız olur. Sorun giriş komutundaysa oyuncu, komut yeniden çalışana kadar ilerleyemez. Sunucunun kendisi çalışmaya devam eder.

Çözüm adımları:

  1. Konsol bölümünde mesajın altındaki exception'ı oku ve hangi komutta oluştuğunu not al.
  2. Plugins bölümünden LibreLogin'i güncelle ve sunucuyu yeniden başlat.
  3. Komutu bir oyuncuyla yeniden dene.
  4. Hata devam ederse exception'ı ve komutu eklenti geliştiricisine bildir.

Exception'da bir veritabanından söz ediliyorsa: Eklenti veritabanını açamıyor.

LibreLogin: Ağ işleyicisi iki kez kaydedilmiş

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

java.lang.IllegalArgumentException: Duplicate handler name: pe-decoder-librelogin

Sorunun nedeni: Her oyuncu bağlantısı, ağ hattı (network pipeline) adı verilen bir dizi işleme adımından geçer. LibreLogin veya PacketEvents kütüphanesi, aynı adımı, yani gelen veriler için kullanılan bir kod çözücüyü ikinci kez eklemeye çalışır. Bu durumda yeni bağlantılar başarısız olabilir. Tipik nedenler arasında eklenti klasöründeki iki LibreLogin dosyası, birbiriyle uyumsuz LibreLogin ve PacketEvents sürümleri veya eklentilerin sunucu çalışırken yeniden yüklenmesi yer alır.

Çözüm adımları:

  1. Dosyalar bölümünde plugins/ klasörünü aç ve LibreLogin'in yalnızca bir kez bulunduğunu kontrol et. Yedek aldıktan sonra eski kopyaları sil.
  2. LibreLogin'i ve kuruluysa PacketEvents'i birlikte güncelle.
  3. Sunucuyu durdur ve tamamen yeniden başlat. /reload veya bir eklenti yöneticisiyle yeniden yükleme yapmak burada yeterli olmaz.
  4. Bir oyuncuyla sunucuya katılmayı dene.

Yinelenen dosyalar hakkında daha fazla bilgi: Eklenti dosyası bozuk veya yinelenmiş.

LightAntiCheat-Plus: Hareket denetiminde hata

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

[LightAntiCheat-Plus] Exception in event bus subscription: <Prüfung>
java.lang.UnsupportedOperationException: remove

Sorunun nedeni: LightAntiCheat-Plus, diğer işlevlerinin yanı sıra oyuncu hareketlerini de denetleyen bir anti-cheat eklentisidir. Denetimlerinden biri, değiştirilemeyen bir listeyi boşaltmaya çalışır. Bu, eklentinin kendi hatasıdır. İlgili denetim devre dışı kalabilir veya yanlış sonuçlar verebilir; yani hileleri gözden kaçırabilir ya da dürüst oyuncuları haksız yere şüpheli gösterebilir. Sunucu çalışmaya devam eder.

Çözüm adımları:

  1. Plugins bölümünden LightAntiCheat-Plus'ı güncelle ve sunucuyu yeniden başlat.
  2. Mesaj görünmeye devam ederse düzeltme gelene kadar eklentinin yapılandırmasında ilgili SpeedD denetimini devre dışı bırak. Yapılandırmayı Dosyalar bölümünde, plugins/ altındaki eklenti klasöründe bulabilirsin. Önce dosyayı yedekle.
  3. Sunucuyu yeniden başlat ve Konsol bölümünde mesajın kaybolup kaybolmadığını kontrol et.
  4. Düzeltilmiş bir sürüm yayımlandığında denetimi yeniden etkinleştir.

Bilmekte fayda var: Bu mesaj görünmeye devam ettiği sürece hareketle ilgili hile şüphelerine temkinli yaklaş.

MagicSpells bir büyüde hata bildiriyor

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

[MagicSpells] AN EXCEPTION HAS OCCURED:
[MagicSpells] This error has been saved in the errors folder.
Error saving spellbook for player '<Spieler>'

Sorunun nedeni: MagicSpells, özel büyüler oluşturmaya yarayan bir eklentidir. Büyüleri çalıştırırken veya kaydederken, çoğunlukla yapılandırmasındaki bir girdiyi bu sürüm anlayamadığı için hata bildirir. Efektler EffectLib kütüphanesi üzerinden çalışır; “Unexpected EffectLib Error” içeren mesajlar bu efektlerle ilgilidir. MagicSpells ayrıca plugins/MagicSpells/errors klasörüne bir rapor kaydeder. Büyü kitabı (spellbook) kaydedilemezse bu oyuncunun mevcut durumu kaydedilmez.

Çözüm adımları:

  1. Dosyalar bölümünde plugins/MagicSpells/errors klasörünü ve en yeni raporu aç. Raporda büyünün adı ve ilgili ayar belirtilir.
  2. Büyü dosyalarında bu ayarı yazım hataları veya eski bir MagicSpells sürümünden kalan değerler açısından kontrol et. Önce dosyayı yedekle.
  3. MagicSpells ve EffectLib'i güncel ve sunucu sürümünle uyumlu tut.
  4. Sunucuyu yeniden başlat ve büyüyü dene.

SinglePlayerSleep: Yatakta uyuma çalışmıyor

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

[SinglePlayerSleep] INTERNAL ERROR: Unable to process PlayerBedEnterEvent

Sorunun nedeni: SinglePlayerSleep, herkesin yatağa girmesi yerine tek bir oyuncu uyuduğunda gecenin geçmesini sağlar. Eklenti, oyuncu yatağa girerken çökmüştür. Uyku işlevi bu deneme için çalışmayabilir ve gece atlanmaz. Bunun nedeni çoğunlukla eklenti sürümünün Minecraft sürümüyle uyumsuz olmasıdır. Sunucu çalışmaya devam eder.

Çözüm adımları:

  1. Sürüm bölümünde hangi Minecraft sürümünün çalıştığını kontrol et.
  2. Plugins bölümünden SinglePlayerSleep'i bu sürüme uygun bir sürüme güncelle ve sunucuyu yeniden başlat.
  3. Oyun içinde dene: Gece yatağa yat ve gecenin geçip geçmediğini kontrol et.
  4. Hata devam ederse mesajın altındaki exception'ı eklenti geliştiricisine bildir.

Daha fazla bilgi: Minecraft oyun kuralları açıklaması.

Bilmekte fayda var: Yeni Minecraft sürümlerinde, oyuncuların yüzde kaçının uyuması gerektiğini belirleyen ayrı bir oyun kuralı bulunur. Bu kural eklentinin yerini alabilir.

PacketEvents bağlantıya dahil olamıyor

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

PacketEvents failed to add a decoder to the netty pipeline

Sorunun nedeni: PacketEvents, anti-cheat veya giriş eklentileri gibi diğer eklentilerin ağ paketlerini okumasını sağlayan bir kütüphanedir. Bunun için her bağlantının ağ hattına (pipeline) decoder adı verilen kendi adımını ekler. Netty, sunucunun bağlantıları yönetmek için kullandığı ağ kütüphanesidir. Bu ekleme işlemi başarısız olmuştur: Başka bir ağ işleyicisi veya uyumsuz bir PacketEvents sürümü beklenen sıralamayı engelliyor. Bu durumda PacketEvents'e dayanan eklentiler söz konusu bağlantı için düzgün çalışmaz.

Çözüm adımları:

  1. PacketEvents, Geyser ve Floodgate ile giriş ve anti-cheat eklentilerini birlikte, sunucu sürümüne uygun sürümlere güncelle.
  2. Dosyalar bölümünde plugins/ klasöründe hiçbir dosyanın iki kez bulunmadığını kontrol et.
  3. Sunucuyu durdur ve çalışır durumdayken yeniden yükleme yapmadan tamamen yeniden başlat.
  4. Sunucuya Java ile, Geyser kullanıyorsan Bedrock ile de katılmayı dene.

Bedrock oyuncuları için: Bedrock ve Geyser: Günlükteki mesajlar.

StringIndexOutOfBoundsException: Boş veya çok kısa metin değeri

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

java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

Sorunun nedeni: Bir eklenti veya mod, bir metinden belirli bir karakteri, örneğin bir önekin ilk karakterini okumak istemiştir. Ancak metin daha kısadır, “length 0” durumunda ise tamamen boştur. Çoğu zaman beklenen bir yapılandırma değeri boştur; örneğin yalnızca '' olarak girilmiş bir önek, renk tanımı veya ad. Sunucu çalışmaya devam eder, ancak bu metne ihtiyaç duyan işlev devre dışı kalır.

Çözüm adımları:

  1. Stacktrace içinde eklenti veya mod adı geçen ilk satırı oku.
  2. Dosyalar bölümünde bu eklentinin plugins/<Plugin>/ klasöründeki yapılandırmasını aç ve '' gibi boş değerleri veya değeri olmayan girdileri ara. Öncesinde dosyanın yedeğini al.
  3. Geçerli bir değer gir veya eklentinin şablonundaki varsayılan değeri kullan.
  4. Eklentiyi güncelle ve sunucuyu yeniden başlat.

Hatalı ayarlar hakkında daha fazla bilgi: Eklentinin yapılandırma dosyası hatalı.

“NoSuchFieldException: childHandler”: Ağ eklentisi sunucuyla uyumlu değil

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

java.lang.NoSuchFieldException: childHandler

Sorunun nedeni: Netty, sunucunun bağlantıları kabul etmek için kullandığı ağ kütüphanesidir. Bazı eklentiler, bağlantılara dahil olmak için bu kütüphanenin dahili bölümlerine doğrudan erişir. Burada bir ağ eklentisi, yüklü sunucu veya Netty sürümünde bulunmayan dahili “childHandler” alanını arıyor. Yani eklenti başka bir sunucu derlemesi için hazırlanmıştır. Bu durum genellikle ağ, proxy veya protokol eklentilerini etkiler ve işlevleri devre dışı kalır.

Çözüm adımları:

  1. Mesajın altındaki stacktrace'i oku ve ViaVersion, ProtocolLib veya Geyser gibi ilk ağ, proxy veya protokol eklentisini bul.
  2. Sürüm bölümünde hangi sunucu sürümünün çalıştığını kontrol et. Sunucu yazılımının tam sürümü (build) ayrıca logs/latest.log dosyasının ilk satırlarında yer alır.
  3. Bulduğun eklentiyi bu sunucu derlemesine uygun bir sürüme güncelle ve sunucuyu yeniden başlat.
  4. Henüz uygun bir sürüm yoksa, geliştirici güncelleme yayımlayana kadar eklentiyi geçici olarak devre dışı bırak.

Ayrıntılı bilgi: Eklenti sunucu sürümüyle uyumlu değil.

“Unhandled exception during tab completion”: Eklenti komutu öneri sunmuyor

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

Exception when <Spieler> attempted to tab complete
org.bukkit.command.CommandException: Unhandled exception during tab completion for command '<Befehl>' in plugin <Plugin> v<Version>

Sorunun nedeni: Tab tuşuna basıldığında Minecraft, ilgili eklentiden olası tamamlamaları ister. Bu sırada eklentinin öneri işlevi başarısız olur. İlk satırda Tab tuşuna basan oyuncunun adı yer alır. Sunucu çalışmaya devam eder, yalnızca ilgili komut için öneriler görünmez. Altındaki stacktrace adı verilen hata izi, sürece dahil olan program çağrılarını gösterir.

Çözüm adımları:

  1. Mesajın tamamını Konsol bölümünde veya Dosyalar bölümündeki logs/latest.log dosyasında oku. Eklentiyi, komutu ve altındaki ilk somut hata mesajını not al.
  2. Sürüm bölümünde sunucu sürümünü kontrol et ve Eklentiler bölümünden söz konusu eklentinin bu sürüme uygun bir sürümünü yükle.
  3. Sunucuyu tamamen yeniden başlat ve aynı komutu Tab tuşuyla tekrar dene.
  4. Hata devam ederse tüm hata izini eklentinin geliştiricisine gönder ve önerilerin hangi noktada çalışmadığını açıkla.

Bir arama kuralı işlenirken StackOverflowError

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

Exception in thread "<Hintergrundaufgabe>" java.lang.StackOverflowError

Sorunun nedeni: Düzenli ifade, örneğin komut filtrelerinde kullanılan bir metin arama kuralıdır. Java bu kuralı kontrol ederken iç içe çok fazla çağrı yapar ve böylece çağrı yığınını doldurur. Adı geçen arka plan görevi sonlandırılır ve işi yarım kalır; sunucu çalışmaya devam eder. StackOverflowError, Java belleğinin dolmasından farklı bir hatadır.

Çözüm adımları:

  1. Tüm hata izini Konsol bölümünde veya Dosyalar bölümündeki logs/latest.log dosyasında aç. Thread adına ve eklenti çağrılarına bakarak sorumlu eklentiyi bul.
  2. Eklentinin ayarlarını yedekle ve yapılandırılabilir arama veya komut kurallarını kontrol et. Hatayı tetikleyen kuralı kendin ayarladıysan basitleştir.
  3. Eklentiler bölümünden eklentiyi uygun bir sürüme güncelle ve sunucuyu tamamen yeniden başlat.
  4. Kural eklentiye sabit olarak yerleştirilmişse tüm hata izini ve hatanın oluştuğu girdiyi geliştiriciye bildir.

Paper, bir arka plan thread'inden gelen “entity add” işlemini engelliyor

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

Thread <Thread> failed main thread check: entity add

Sorunun nedeni: Paper, oyun dünyasındaki değişikliklerin doğru thread üzerinde yapılıp yapılmadığını kontrol eder. Thread, programın ayrı bir yürütme koludur. Burada bir arka plan görevi dünyaya bir varlık eklemeye çalışır ve koruma denetimi tarafından durdurulur. İlgili işlem başarısız olur; sunucu çalışmaya devam eder.

Çözüm adımları:

  1. Konsol bölümünde veya Dosyalar bölümünde logs/latest.log dosyasındaki tüm hata izini aç. Kısaltılmış mesaj çoğu zaman yalnızca sunucu çağrılarını gösterir.
  2. İlk eklenti çağrısına kadar okumaya devam et ve hatayı hangi işlemin tetiklediğini not al.
  3. Eklentiler bölümünden bu eklentinin sunucu sürümüne uygun bir sürümünü yükle ve sunucuyu tamamen yeniden başlat.
  4. Hata devam ederse tüm hata iziyle birlikte eklentinin geliştiricisine bildir. Eklenti çağrısının doğru thread'e taşınması gerekir.

Bilmekte fayda var: Koruma denetimini açık bırak. Denetimi kapatmak, dünyaya yapılan hatalı erişimi düzeltmez.

Ganimet hesaplaması eksik zorunlu değerler nedeniyle başarısız oluyor

Hata mesajı şöyle görünür:

java.lang.IllegalArgumentException: Missing required parameters: [<Parameter>]

Sorunun nedeni: Minecraft, ganimet ve eşya çıktılarını hesaplamak için o anki duruma ait bilgilere ihtiyaç duyar. Buradaki çağıran işlev, zorunlu değerlerin tamamını sağlamıyor. Bu yüzden hesaplama iptal oluyor. Hangi eylemin etkilendiğini tam hata raporundan ve mesajın göründüğü andan anlayabilirsin.

Sorunu şöyle çözersin:

  1. Mesajı, altındaki çağrı listesiyle birlikte Konsol bölümünde veya Dosyalar altındaki logs/latest.log dosyasında aç. Bu listeye stack trace denir.
  2. Listede adı geçen ilk eklentiyi bul ve hatayı hangi eylemin tetiklediğini not et.
  3. Bu eklentiyi Eklentiler altında güncelle ve Sürüm bölümünde sunucu yazılımının eklentiyle uyumlu olup olmadığını kontrol et.
  4. Aynı eylemi yeniden dene. Hata devam ederse tam raporu ilgili projeye ilet.

Oritech'te “NoSuchElementException”: Blok üzerindeki eşya eylemi iptal oluyor

Hata mesajı şöyle görünür:

Failed to handle packet <Paket>, suppressing error
java.util.NoSuchElementException: null
    at <Paket>.ItemFluidApi.tryFluidBlockItemInteraction(<Datei>:<Zeile>)

Sorunun nedeni: Oritech modu, bir eşyanın bir blok üzerinde kullanıldığı bir eylemi işliyor. Modun sıvı işleme kodu bu sırada boş bir listenin ilk öğesini okumaya çalışıyor. Java da bunun için NoSuchElementException, yani var olmayan bir öğeye erişim hatası bildiriyor. Eylem iptal olur; sunucu diğer görevleri işlemeye devam eder.

Sorunu şöyle çözersin:

  1. Kullanılan eşyayı, bloğu ve saati not et. Değişiklik yapmadan önce Yedekler altında bir yedek oluştur.
  2. Modlar altında uygun bir Oritech güncellemesi olup olmadığına bak. Minecraft sürümü, loader ve Mod paketi kullanıyorsan paketin öngördüğü mod sürümleri birbiriyle uyumlu olmalıdır.
  3. Hata devam ederse şimdilik onu tetikleyen eylemden kaçın. Durumu, logs/latest.log dosyasındaki tam hata izini de ekleyerek Oritech geliştiricisine bildir.

BeautyQuests: Görev ilerlemesi yan panelde güncellenmiyor

Hata mesajı şöyle görünür:

[BeautyQuests.ScoreboardManager] Failed to refresh line {quest_advancement} for player <Spieler>
java.util.NoSuchElementException: No value present

Sorunun nedeni: BeautyQuests, yan panele görev ilerlemesi için bir yer tutucu yerleştirir. Bu sırada eklentinin beklediği sayısal değer eksik kalıyor. İlgili panel satırı güncellenmez, ancak sunucu çalışmaya devam eder.

Sorunu şöyle çözersin:

  1. Konsol bölümünde veya Dosyalar altındaki logs/latest.log dosyasında mesajın hangi görevde ortaya çıktığını kontrol et. Altındaki hata izi, ilgili eklenti çağrılarını gösterir.
  2. Eklenti yapılandırmasını yedekle ve BeautyQuests'i Eklentiler altında sunucu sürümünle uyumlu bir sürüme güncelle. Ardından sunucuyu tamamen yeniden başlat.
  3. Hata devam ederse Dosyalar altından {quest_advancement} içeren panel satırını BeautyQuests yapılandırmasından geçici olarak kaldır.
  4. Temizlenmiş tam hata izini ve ilgili görev yapılandırmasını eklenti geliştiricisine bildir. Paylaşmadan önce kişisel bilgileri kaldır.

TAB, yeniden yüklemeden sonra kullanımdan kaldırılmış bir nesneyi kullanıyor

Hata mesajı şöyle görünür:

[TAB] java.lang.IllegalStateException: This instance got discarded because plugin was reloaded. Obtain a new instance.

Sorunun nedeni: TAB, yeniden yükleme sırasında dahili nesnelerini değiştirdi. Başka bir eylem ise TAB'ın kullanımdan kaldırdığı eski bir nesneye hâlâ erişmeye çalışıyor. Bu yüzden ilgili yer tutucu kaydı iptal olur ve görüntünün bazı bölümleri eksik kalabilir. Sunucu çalışmaya devam eder.

Sorunu şöyle çözersin:

  1. Sunucuyu tamamen yeniden başlat ve ardından Konsol bölümünü kontrol et. Tam yeniden başlatma, ilgili bileşenlerin hepsini birlikte yeniden yükler.
  2. Mesaj yeniden görünürse yapılandırmayı yedekle, TAB'ı ve eklentilerini birbiriyle uyumlu sürümlere güncelle. Fabric kullanıyorsan Modlar bölümünü, kendin yüklediğin dosyalar için Dosyalar bölümünü kullan.
  3. Şimdilik yalnızca tam yeniden başlatma kullan. Mesajı hangi eylemin yeniden tetiklediğini not et.
  4. Hatalar sürerse temizlenmiş hata izini ve kurulu sürümleri TAB geliştiricisine ilet.

Bir eklenti, yeniden yükleme veya durdurma sırasında arka plan görevlerini çalışır durumda bırakıyor

Hata mesajı şöyle görünür:

Nag author: '<Autor>' of '<Plugin>' about the following: This plugin is not properly shutting down its async tasks when it is being shut down.

Sorunun nedeni: Adı geçen eklenti, asenkron görevlerini düzgün şekilde sonlandırmıyor. Bunlar, sunucunun ana döngüsünün yanında yürütülen işlerdir. Yeniden yüklemeden sonra eski ve yeni eklenti görevleri birbiriyle çakışabilir; normal durdurma sırasında da hata mesajları oluşabilir.

Sorunu şöyle çözersin:

  1. Konsol bölümünde hangi eklentinin adının geçtiğini ve mesajın yeniden yükleme sırasında mı yoksa normal durdurma sırasında mı göründüğünü kontrol et.
  2. Mesaj yeniden yüklemeden sonra çıktıysa sunucuyu tamamen yeniden başlat. Bundan sonra eklenti değişiklikleri için tam yeniden başlatma kullan.
  3. Eklenti yapılandırmasını yedekle ve ilgili eklentiyi Eklentiler altında uygun bir sürüme güncelle.
  4. Mesaj normal durdurmalarda da görünmeye devam ederse ilgili log satırlarını ve sunucu sürümünü ekleyerek eklenti geliştiricisine bildir.

Paper, bir arka plan iş parçacığından gelen POI erişimini engelliyor

Hata mesajı şöyle görünür:

[ca.spottedleaf.moonrise.common.util.TickThread] Thread failed main thread check: Accessing poi chunk off-main, context=<Threadkontext>

Sorunun nedeni: POI, “Point of Interest” anlamına gelir ve köylülerin çalışma yerleri gibi önemli noktaları ifade eder. Burada bir arka plan iş parçacığı, bir dünya bölümüne ait bu verilere erişmeye çalışıyor. Paper bu erişime yalnızca sorumlu oyun iş parçacığında izin verir ve ilgili eylemi iptal eder.

Sorunu şöyle çözersin:

  1. Konsol bölümünde veya Dosyalar altındaki logs/latest.log dosyasında tam hata izini aç. Hata izi, mesajın altındaki çağrı satırlarıdır; bunlarda bir eklentinin adının geçip geçmediğini kontrol et.
  2. Yedekler altında bir yedek oluştur. Paper'ı Sürüm altında, ilgili eklentileri de Eklentiler altında birbiriyle uyumlu sürümlere güncelle.
  3. Sunucuyu tamamen yeniden başlat ve aynı eylemin hatayı yeniden tetikleyip tetiklemediğini gözlemle.
  4. Mesaj herhangi bir eklentiyle bağlantılı olmadan devam ederse temizlenmiş hata izini, sunucu sürümünü ve hatayı tetikleme adımlarını Paper ekibine ilet. Bir eklentinin adı geçiyorsa durumu o eklentinin geliştiricisine bildir.

LuckPerms oyuncu verileri sunucuya katılım sırasında henüz hazır değil

Hata mesajı şöyle görünür:

Couldn't place player in world
java.lang.IllegalStateException: Capability has not been initialised

Sorunun nedeni: Sunucuya katılım, bir izin sorgusu nedeniyle başarısız oluyor. Hata izi LuckPerms'e işaret ediyor; eklentinin Capability adı verilen oyuncuya özel veri deposu bu aşamada henüz hazır değil. Bu nedenle ilgili oyuncu dünyaya başarıyla yerleştirilemiyor.

Sorunu şöyle çözersin:

  1. Konsol bölümünde veya logs/latest.log dosyasında hatadan önceki LuckPerms mesajlarını oku ve ilgili modları not al.
  2. Modlar bölümünde LuckPerms'in ve sorguyu yapan modun NeoForge ve Minecraft sürümünle uyumlu olup olmadığını kontrol et. Ortak olarak desteklenen sürümleri kullan.
  3. Sunucuyu tamamen yeniden başlat ve katılmayı tekrar dene. Hata devam ederse tam hata izini ve sürüm bilgilerini ilgili mod geliştiricilerine bildir.

Bir sıvı sorgusu beklenen kazanı bulamıyor

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

java.lang.IllegalStateException: Unexpected error: no cauldron at location BlockPos{<Position>}

Sorunun nedeni: Bir sıvı arayüzü, sorgulanan konumda bir kazan bekliyor ancak farklı bir blok durumuyla karşılaşıyor. Hata izinde Jade, sıvı bilgilerini okumak için bu arayüzü sorguluyor. İlgili sorgu iptal olur, bu nedenle bu bloğa ait bilgiler eksik görünebilir.

Nasıl düzeltirsin:

  1. logs/latest.log dosyasındaki tam hata izini oku ve mesajın hangi blok işleminde tekrarlandığını kontrol et.
  2. Yedekler bölümünde bir yedek oluştur. Modlar bölümünde Jade'i, ilgili sıvı modlarını ve NeoForge sürümünü ortak olarak desteklenen sürümlerle eşleştir.
  3. Sunucuyu tamamen yeniden başlat ve işlemi tekrarla. Hata devam ederse tam olarak hangi işlemi yaptığını ve hata izini ilgili geliştiricilere bildir.

MoreRelics bir savaş işleminde geçersiz bir sayısal değer hesaplıyor

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

Exception caught during firing event: max is NaN

Sorunun nedeni: NaN, geçersiz bir hesaplama değerini ifade eden “Not a Number” (sayı değil) kısaltmasıdır. MoreRelics, bir savaş işlemi sırasında bu değeri bir sayı kontrolüne üst sınır olarak iletir. Kontrol bu değeri reddeder ve ilgili olayın işlenmesi iptal edilir; sunucu ardından diğer olayları işlemeye devam eder.

Nasıl düzeltirsin:

  1. Konsol bölümünde veya logs/latest.log dosyasında tam hata izini oku ve hatayı tetikleyen işlemi not al.
  2. Yedekler bölümünde bir yedek oluştur. Modlar bölümünde Mod paketin ve NeoForge ile uyumlu bir MoreRelics sürümü olup olmadığını kontrol et.
  3. Sunucuyu tamamen yeniden başlat ve aynı işlemi test et. Hata devam ederse hata izini, mod listeni ve kullandığın eşyaları veya efektleri geliştiriciye bildir.

Citizens, paket verilerini gönderirken boş bir değer nedeniyle başarısız oluyor

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

java.lang.NullPointerException
    at Citizens-<Version>.jar//net.citizensnpcs.PacketEventsHook.<Methode>(<Datei>:<Zeile>)

Sorunun nedeni: Citizens, paket verilerini gönderirken PacketEvents bağlantısı üzerinden eksik bir değere erişmeye çalışıyor. Java bu boş değere null adını verir ve bir NullPointerException ile işlemi durdurur. İlgili paket işleme başarısız olur; bu nedenle NPC'lerin, yani bilgisayar kontrollü karakterlerin güncellemeleri eksik kalabilir.

Nasıl düzeltirsin:

  1. logs/latest.log dosyasındaki tam hata izini oku ve hatanın hangi NPC işleminde oluştuğunu not al.
  2. Yedekler bölümünde mevcut durumu yedekle. Eklentiler bölümünde Citizens, PacketEvents ve sunucu yazılımın için ortak olarak desteklenen sürümleri kontrol et.
  3. Gerekirse Dosyalar bölümünden dosyaları değiştir, sunucuyu tamamen yeniden başlat ve aynı işlemi test et. Hata devam ederse hata izini ve sürüm bilgilerini geliştiriciye bildir.

NovaSync, işletim sistemi güncellemeleri için gereken yardımcı programı bulamıyor

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

[NovaSyncPlugin] [os-updates] helper start failed subcmd=status err=IOException:Cannot run program "sudo": Exec failed, error: 2 (No such file or directory)

Sorunun nedeni: NovaSync, işletim sistemi güncellemeleri için harici bir yardımcı programı başlatmaya çalışıyor. Bunun için eklenti, komutları başka kullanıcı yetkileriyle çalıştırmaya yarayan sudo programını çağırıyor. Sunucu ortamı bu programı bulamadığı için güncelleme özelliğinin hazırlığı veya durum sorgusu başarısız oluyor. Oyun sunucusu çalışmaya devam eder.

Nasıl düzeltirsin:

  1. Konsol bölümünde veya Dosyalar altındaki logs/latest.log dosyasında mesajın tamamını oku ve saatini not al.
  2. Kurulu NovaSync sürümünün kılavuzunda os-updates gereksinimlerini ve ihtiyaç duyulan yardımcı programı kontrol et.
  3. Yardımcı programın sunucu ortamında kullanılabilir olup olmadığını netleştirmek için bir destek talebi aç; mesajın saatini ve eklenti sürümünü belirt.

Bilmekte fayda var: Bu mesaj, Minecraft eklentilerinin güncellenmesini değil, NovaSync'in işletim sistemi güncelleme özelliğini ilgilendirir.

ProtocolLib bir hata raporunu eşleştiremiyor

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

[ProtocolLib] Error filtering reports: java.lang.IllegalArgumentException: Cannot find report name for Plugin %s tried to register listener for unknown packet %s

Sorunun nedeni: ProtocolLib, diğer eklentilerin sunucu ile oyun istemcisi arasındaki mesajlar olan ağ paketlerini işlemesine yardımcı olur. Burada ek olarak bir tanılama raporunun eşleştirilmesi de başarısız oluyor. Rapor, bilinmeyen bir paket türünün kaydedilmesiyle ilgilidir. Sunucu çalışmaya devam eder; ancak ilgili paket işlevinin ve tanılamasının kontrol edilmesi gerekir.

Nasıl düzeltirsin:

  1. Konsol bölümünde veya logs/latest.log dosyasında mesajın hemen öncesindeki ve sonrasındaki satırları oku. Burada ilgili eklentiyi ve paket türünü ara.
  2. ProtocolLib'in ve bu eklentinin desteklediği sunucu sürümlerini kontrol et. Eklentiler bölümünde ikisini de uyumlu sürümlere güncelle.
  3. Dosyaları değiştirmeden önce sunucuyu durdur, ardından tamamen yeniden başlat. Daha önce sorun yaşanan işlevi tekrar kontrol et.
  4. Mesaj görünmeye devam ederse tam hata bloğunu ve kullanılan sürümleri eklenti geliştiricisine ilet.

EliteMobs mühimmat işlevini etkinleştiremiyor

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

[EliteMobs] Cannot enable native ammunition for <Verbindung>: java.util.NoSuchElementException: packet_handler

Sorunun nedeni: EliteMobs, bir bağlantı için yerel mühimmat işlevini kurmaya çalışıyor. Handler, ağ verileri için dahili bir işleme adımıdır. packet_handler adlı beklenen adım, sorgulanan konumda bulunmuyor. Bu nedenle söz konusu alt işlev etkinleştirilmez; sunucu çalışmaya devam eder.

Nasıl düzeltirsin:

  1. Konsol bölümünde veya logs/latest.log dosyasında yakındaki mesajları oku. Bağlantı kurulurken daha önce oluşan hatalara dikkat et.
  2. EliteMobs'un desteklediği sunucu sürümlerini Sürüm bölümündeki sürümünle karşılaştır. Geliştiricinin belirttiği bağımlılıkları da kontrol et.
  3. Sunucuyu durdur ve Eklentiler bölümünde EliteMobs'u uyumlu bir sürüme güncelle. Ardından sunucuyu tamamen yeniden başlat ve ilgili işlevi test et.
  4. Hata devam ederse tam hata bloğunu, sunucu sürümünü ve eklenti listesini EliteMobs geliştiricisine bildir. Bu bilgiler, eksik işleme adımının kaynağını daraltmaya yardımcı olur.

LuckPerms çelişkili şekilde izin verilen bir girişi engelliyor

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

[LuckPerms] Player connection was re-allowed for <Spieler-ID>

Arka planda ne oluyor: Sunucuya katılma sırasında eklentiler birbiriyle çelişen kararlar verdi. LuckPerms, yetki işlemlerini güvence altına almak için yeniden izin verilen bağlantıyı engelliyor. İlgili katılma başarısız olur; sunucu çalışmaya devam eder.

Nasıl çözersin:

  1. Konsol bölümünde veya logs/latest.log dosyasında başarısız katılmadan hemen önceki mesajları oku. Veri yükleme hatalarını ve giriş eklentilerinin mesajlarını ara.
  2. Bir veritabanı veya veri yükleme hatası belirtiliyorsa önce bu hatayı gider. Ardından hangi giriş eklentisinin önceki bir reddi geri aldığını kontrol et.
  3. İlgili bileşenleri Plugins bölümünde hem birbiriyle hem de sunucu sürümüyle uyumlu sürümlere güncelle. Dosyaları değiştirmeden önce sunucuyu durdur ve ardından yeniden başlat.
  4. Katılmayı yeniden dene. Çakışma devam ederse ilgili eklenti geliştiricilerine hata bloğunun tamamını ve eklenti listesini ilet.

Bilmekte fayda var: Çakışmayı aşmak için giriş doğrulamasını kapatma.

Apotheosis: Boş bir eşya nedeniyle blok eylemi başarısız oluyor

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

Failed to handle packet <Paket>, suppressing error
java.lang.IllegalArgumentException: Expected resource to be non-empty: minecraft:air [0]
at <Loader>/dev.shadowsoffire.apotheosis.affix.salvaging.<Aufruf>

Arka planda ne oluyor: Apotheosis, bir blok eylemi sırasında parçalama işlevine ulaşıyor. Bu sırada NeoForge'un aktarım arayüzüne boş bir eşya yığını iletiliyor; oysa bu arayüz var olan bir eşya bekliyor. Bu yüzden etkileşim iptal olur, sunucu ise çalışmaya devam eder. Stack trace, yani hata mesajının altındaki çağrı zinciri, burada Apotheosis ve NeoForge üzerinden geçer.

Nasıl çözersin:

  1. Mevcut durumu Yedekler bölümünde yedekle. Mesajı hangi blok eyleminin tetiklediğini not et ve şimdilik bu eylemden kaçın.
  2. Mesajın tamamını Konsol bölümünde veya Dosyalar üzerinden logs/latest.log içinde aç. Hatadan önceki satırları da kaydet.
  3. Modlar bölümünde Apotheosis'in ve gerektirdiği modların Minecraft ve NeoForge sürümünle uyumlu olup olmadığını kontrol et. Mod paketi kullanıyorsan birbiriyle uyumlu bir paket sürümü kullan. Dosyaları değiştirmeden önce sunucuyu durdur ve ardından yeniden başlat.
  4. Mesaj devam ederse mod geliştiricisine hata izinin tamamını, yüklü sürümleri ve hatayı tetikleyen eylemi ilet.

ProtocolLib: Eklenti geçici bir oyuncunun UUID'sini sorguluyor

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

[<Plugin>] Unhandled exception occurred in onPacketSending(PacketEvent) for <Plugin>
java.lang.UnsupportedOperationException: The method getUniqueId is not supported for temporary players.

Arka planda ne oluyor: ProtocolLib, bağlantı kurulurken geçici oyuncu nesneleri sağlar. Benzersiz hesap kimliği olan UUID henüz bu nesne üzerinden sorgulanamaz. Buna rağmen bir eklenti, paket gönderirken bunu yapmaya çalışıyor. Bu nedenle eklentinin paket işleyicisi, yani bu işten sorumlu işlev, iptal olur; sunucu çalışmaya devam eder.

Nasıl çözersin:

  1. Konsol bölümünde “for” ifadesinden sonra hangi eklentinin yazdığını oku. Hata izinin tamamını logs/latest.log dosyasından kaydet.
  2. Plugins bölümünde bu eklentinin ve ProtocolLib'in sunucu sürümünü destekleyip desteklemediğini kontrol et. Birbiriyle uyumlu sürümler kullan.
  3. Dosyaları değiştirmeden önce sunucuyu durdur. Ardından sunucuyu tamamen yeniden başlat ve katılmayı yeniden dene.
  4. Hata devam ederse hata izinin tamamıyla birlikte yüklü sürümleri ve hatayı tetikleyen eylemi ilgili eklentinin geliştiricisine bildir.

GodWand: Bekleme süresi için geçersiz paket

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

java.lang.IllegalArgumentException: Invalid skill cooldown packet
  at net.godwand.network.SkillCooldownPayload.<init>(<Datei>:<Zeile>)

Arka planda ne oluyor: GodWand, asa kullanılırken bir yeteneğin bekleme süresine ait paketi reddediyor. Bu süre, yeteneğin ne zaman yeniden kullanılabileceğini belirler. Eşya eylemi başarısız olur, sunucu ise çalışmaya devam eder.

Nasıl çözersin:

  1. Konsol bölümünü veya logs/latest.log dosyasını aç ve mesajın tamamını oku. Devamındaki hata izi, yani stack trace, ilgili GodWand sınıfını gösterir.
  2. Sunucudaki ve istemcilerdeki GodWand sürümlerini karşılaştır. Modlar bölümünde desteklenen Minecraft ve NeoForge sürümlerini de kontrol et.
  3. Sunucuyu durdur, uyumlu bir sürüm yükle ve sunucuyu tamamen yeniden başlat. Eşya eylemini yeniden dene.
  4. Hata devam ederse mod geliştiricisine hata izini ve hatayı tetikleyen eylemi bildir. Rapordan kişisel bilgileri çıkar.

ModelEngine: Oyuncu modeli için skin adresi eksik

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

java.lang.RuntimeException: Skin URL is null
  at com.ticxo.modelengine.api.model.limb.UserLimbRegistry.generate(<Datei>:<Zeile>)

Arka planda ne oluyor: ModelEngine, katılma sırasında bir oyuncunun skin'iyle model parçaları oluşturmaya çalışıyor. Bunun için gereken görsel adresi eksik; “null” burada hiçbir değer bulunmadığı anlamına gelir. İlgili model işlevi başarısız olur, sunucu ise çalışmaya devam eder.

Nasıl çözersin:

  1. Yeniden katıldıktan sonra aynı mesajın görünüp görünmediğini Konsol bölümünde veya logs/latest.log dosyasında kontrol et.
  2. İlgili istemcinin skin'ini kontrol etmesini ve yeniden katılmasını sağla. Gerekirse kullanılan skin eklentisini de kontrol et.
  3. ModelEngine'in ve ilgili eklentilerin sunucu sürümüyle uyumunu karşılaştır. Plugins üzerinden eklenti dosyalarını değiştirmeden önce sunucuyu durdur ve ardından yeniden başlat.
  4. Hata devam ederse ModelEngine geliştiricisine hata izinin, yani hatanın altındaki çağrı zincirinin tamamını ilet. Kişisel bilgileri çıkar.

Bir mod geçersiz bir blok durumu ayarlıyor

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

Cannot set property <Eigenschaft> to <Wert> on Block{<Block>}, it is not an allowed value

Arka planda ne oluyor: Bir blok etkileşimi sırasında bir mod, izin verilen değerlerin dışında bir özellik değeri ayarlıyor. Minecraft ilgili paket işlemini iptal eder ve bloktaki eylem başarısız olur. Hata izi, programdaki çağrı zincirini gösterir; ilk sırada adı geçen mod sınıfı, kontrole başlamak için iyi bir noktadır.

Nasıl çözersin:

  1. Dosyalar bölümünde logs/latest.log dosyasını aç ve hata izinden ilgili modu ve etkilenen blok özelliğini belirle.
  2. Modlar bölümünde modun Minecraft sürümüne uygun bir düzeltmesi olup olmadığını kontrol et ve öncesinde dünyayı Yedekler bölümünde yedekle.
  3. Güncellemeden sonra sunucuyu tamamen yeniden başlat ve aynı blok eylemini dene; sorun çözülene kadar bu eylemden kaçın.

Minecraft çok fazla zincirleme blok güncellemesini atlıyor

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

Too many chained neighbor updates. Skipping the rest. First skipped position: <Position>

Arka planda ne oluyor: Bir blok güncellemesi zinciri, Minecraft'ın koruma sınırına ulaşıyor. Bu zincirdeki diğer güncellemeler atlanır; bu nedenle örneğin Redstone devreleri geçici olarak beklendiği gibi tepki vermeyebilir. Sunucu çalışmaya devam eder; ilgili zincirdeki bazı blok tepkileri gerçekleşmez. Koruma sınırını yükseltmek, soruna yol açan zinciri ortadan kaldırmaz.

Nasıl çözersin:

  1. Konsolda belirtilen konumun hangi devreye veya mod makinesine ait olduğunu belirle ve tetikleyicisini durdur.
  2. Dünyayı Yedekler bölümünden yedekle ve aynı anda tetiklenen zinciri, örneğin devreyi bölerek küçült.
  3. Değişikliği tam bir yeniden başlatmanın ardından test et; mod bloklarında Modlar bölümünde uygun bir hata düzeltmesi olup olmadığını kontrol et.

UnstableFarlandsExpansion onarım için uygun bir orman bulamıyor

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

[UnstableFarlandsExpansion] Forest repair stopped; backup retained if editing began
No verified old-generator forest found; nothing changed

Arka planda ne oluyor: UnstableFarlandsExpansion'ın orman onarımı, eski oluşturucuya ait doğrulanmış bir orman bulamıyor ve işlemi iptal ediyor. Bu iptalde dünya değişmeden kalır; istenen onarım gerçekleştirilmez. Sunucu çalışmaya devam eder. Eklenti, denetimi uygun bir başlangıç yapısı tespit edemediği için onarımı burada bilinçli olarak sonlandırır.

Şöyle çözersin:

  1. Konsolda mesajın tamamını incele ve neden olarak gerçekten No verified old-generator forest found ifadesinin gelip gelmediğini kontrol et.
  2. Kurulu eklenti sürümünün kılavuzunu oku ve seçilen alanın desteklenen eski oluşturucudan gelip gelmediğini kontrol et.
  3. Yeni bir onarım denemesinden önce Yedekler bölümünde bir yedek oluştur ve yalnızca kılavuza göre uygun olan bir alan seç.

Bir mod, arka plan iş parçacığından bir varlık ekliyor

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

A mod is trying to add an entity from offthread, this should be avoided. Printing trace:

Arka planda ne oluyor: Bir mod, dünyaya bu iş için ayrılmış oyun iş parçacığının dışından bir varlık ekliyor. Bu eş zamanlı erişim güvenli değildir ve varlıkların işlenmesini bozabilir; ardından gelen hata izi ilgili modları gösterir. İş parçacığı (thread), programın bir yürütme koludur. Tanılama amaçlı istisna, çağrı yolunu gösterir; burada güvenli olmayan erişimi bulmaya yarar.

Şöyle çözersin:

  1. Dosyalar üzerinden logs/latest.log içindeki hata izini oku ve varlık ekleme çağrısını yapan modu bul.
  2. Yedekler bölümünde bir yedek oluştur ve Modlar bölümünde bu mod ile bağımlılıkları için uygun bir hata düzeltmesi olup olmadığını kontrol et.
  3. Güncellemeden sonra sunucuyu tamamen yeniden başlat ve tetikleyiciyi tekrar test et; sorun devam ederse hata izinin tamamını mod geliştiricilerine gönder.

Paper, geçersiz bir liste boyutu nedeniyle bir oyuncunun girişini yapamıyor

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

Couldn't place player in world
IllegalArgumentException: arraySize cannot be negative but was: <negativer Wert>

Arka planda ne oluyor: Bir oyuncu dünyaya yerleştirilirken negatif boyutlu bir liste isteniyor. Bu oyuncunun girişi söz konusu dahili hata nedeniyle başarısız olur; sunucu diğer görevleri işlemeye devam eder. Mesaj, dahili bir listenin boyut hesaplamasıyla ilgilidir. Daha yüksek bir RAM planı bu negatif değeri düzeltmez.

Şöyle çözersin:

  1. Dosyalar üzerinden logs/latest.log içindeki hata izinin tamamını ve hemen öncesindeki katılım mesajlarını incele.
  2. Yedekler bölümünde bir yedek oluştur; Sürüm bölümünde daha yeni ve uygun bir Paper derlemesi olup olmadığını, ayrıca ilgili eklentilerin uyumlu sürümlerini kontrol et.
  3. Güncellemeden sonra sunucuyu tamamen yeniden başlat ve katılmayı test et; hata devam ederse tam günlükle birlikte bildir.

LibreLogin, oyun iş parçacığında engelleyici bir erişim gerçekleştiriyor

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

[LibreLogin] AN IO OPERATION IS BEING PERFORMED ON THE MAIN THREAD! THIS IS A SERIOUS BUG!

Arka planda ne oluyor: LibreLogin, sunucunun ana iş parçacığında bir giriş veya çıkış erişimi tespit ediyor. Bu erişim beklerken oyunun işlenmesi takılabilir; ardından gelen hata izi, soruna yol açan eklenti çağrısını gösterir. Giriş ve çıkış erişimleri örneğin dosyaları veya veritabanı içeriklerini okur ya da yazar. Oyun iş parçacığında bu erişimlerin bekleme süreleri, devam eden oyun görevleriyle çakışır.

Şöyle çözersin:

  1. Dosyalar üzerinden logs/latest.log içinde LibreLogin uyarısının hemen altındaki hata izinin tamamını oku ve tetikleyiciyi not al.
  2. Yedekler bölümünde bir yedek oluştur ve Eklentiler bölümünde LibreLogin ile ilgili eklentiler için sunucu sürümüne uygun bir hata düzeltmesi olup olmadığını kontrol et.
  3. Güncellemeden sonra sunucuyu tamamen yeniden başlat; uyarı tekrar ederse hata iziyle birlikte eklenti geliştiricilerine bildir.

Paper, arka plan iş parçacığından yapılan bir oyuncu atma işlemini engelliyor

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

Thread <Plugin-Thread> failed main thread check: player kick
java.lang.IllegalStateException: Asynchronous player kick!

Arka planda ne oluyor: İş parçacığı (thread), programın bir yürütme koludur. Oyuncular üzerindeki işlemlerin burada oyunun ana iş parçacığında gerçekleşmesi gerekir. Bir eklenti ise atma işlemini arka plan görevinden çağırıyor ve Paper bu erişimi engelliyor. Yalnızca bu atma işlemi başarısız olur; sunucu çalışmaya devam eder.

Şöyle çözersin:

  1. Hata izinin tamamını Konsol bölümünde veya Dosyalar üzerinden logs/latest.log içinde aç. Ardından gelen çağrı satırları, yani stack trace, ilgili eklentiyi gösterir.
  2. Eklentiler bölümünde Sürüm değerine uygun bir güncelleme olup olmadığını kontrol et. Dosya değişimi için sunucuyu durdur ve ardından yeniden başlat.
  3. Atma işlemini tetiklemesi gereken eylemi yeniden test et. Hata devam ederse eklenti geliştiricisine hata izinin tamamını gönder ve bu eylemi açıkla.

AntiRelog, bekleme süreleriyle ilgili bir paketi okuyamıyor

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

[AntiRelog] Unhandled exception occurred in onPacketSending(PacketEvent) for AntiRelog
com.comphenix.protocol.reflect.FieldAccessException: Field index 0 is out of bounds for length 0

Arka planda ne oluyor: AntiRelog, eşyaların bekleme sürelerini ProtocolLib üzerinden işler. Bunun için bir ağ paketinden, yani oyuna gönderilen bir mesajdan bir alan okur. Beklenen alan bu biçimde mevcut değildir ve bu bekleme süresinin işlenmesi iptal edilir. Sunucu çalışmaya devam eder.

Şöyle çözersin:

  1. Mesajın tamamını Konsol bölümünde veya Dosyalar altında logs/latest.log içinde aç. Sunucu, AntiRelog ve ProtocolLib sürümlerini not al.
  2. Eklenti sayfalarından hangi sürümlerin birbiriyle ve sunucu sürümünle çalıştığını kontrol et. AntiRelog ve ProtocolLib'i Eklentiler bölümünde buna göre güncelle.
  3. Dosyaları değiştirmeden önce sunucuyu durdur ve ardından tamamen yeniden başlat.
  4. Hata tekrar ortaya çıkarsa AntiRelog geliştiricisine mesajın tamamını, sürümleri ve hatayı tetikleyen oyun içi eylemi gönder.

Bir oyuncu, eksik bir değer nedeniyle sunucuya katılamıyor

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

Couldn't place player in world
java.lang.NullPointerException

Arka planda ne oluyor: Sunucu, bir oyuncuyu katılım sırasında dünyaya yerleştiremiyor. Bu sırada programın bir bölümü, Java'da “null” olarak adlandırılan eksik bir değere erişiyor. İlgili giriş iptal edilir; sunucu çalışmaya devam eder. Ardından gelen hata satırları, ilgili program bölümünü bulmana yardımcı olur.

Şöyle çözersin:

  1. Oyuncudan sunucuya yeniden katılmayı denemesini iste ve hatanın tekrarlanıp tekrarlanmadığını kontrol et.
  2. Tam mesajı Konsol üzerinden veya Dosyalar bölümündeki logs/latest.log içinde aç. Önceki satırları da oku. Devamındaki “at” satırları, hataya giden çağrı zincirini yani stack trace'i oluşturur.
  3. Bu çağrı zincirinde ilgili bir eklentinin adı geçiyorsa, eklentinin sunucu sürümünü destekleyip desteklemediğini Eklentiler bölümünden ve eklentinin sayfasından kontrol et. Dosya değiştirmeden önce sunucuyu durdur, ardından yeniden başlat.
  4. Katılım sorunu devam ederse veya sorunun hangi bileşenden kaynaklandığını belirleyemezsen bir destek talebi aç ve mesajın görüldüğü saati belirt.

NameTag, isim gösterimini devre dışı bırakırken başarısız oluyor

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

[NameTag] Failed to disable Name Tag implementation: Plugin attempted to register task while disabled

Sorunun nedeni: NameTag, isim gösterimini kapatırken sunucuya bir görev daha kaydetmeye çalışır. Ancak eklenti bu sırada zaten devre dışı kalmıştır. Bu yüzden sunucu görevi reddeder ve NameTag bu kapatma işlemini hatayla sonlandırır. Sorun, eklentinin temizleme işlemini etkiler.

Çözüm adımları:

  1. Konsol üzerinden veya Dosyalar bölümündeki logs/latest.log içinden mesajın normal durdurma sırasında mı yoksa eklenti yeniden yüklendikten sonra mı göründüğünü kontrol et.
  2. Sunucuyu tamamen yeniden başlat. NameTag için eklenti yeniden yükleyici kullanma ve Eklentiler bölümünde sunucu Sürümüne uygun bir yayın olup olmadığını kontrol et.
  3. Hata normal durdurma sırasında tekrarlanıyorsa, hassas bilgilerden arındırılmış tam hata izini ve ilgili sürümleri NameTag geliştiricisine bildir. Dosya değiştirmeden önce ayarlarını yedekle.

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

Önceki satırlar dahil mesajın tamamını oku. Eklentinin o anda ne yapmaya çalıştığı çoğu zaman orada yazar. Stack trace'teki “at” satırlarında yer alan <Plugin>.jar gibi dosya adları ve paket adları, sorumlu eklentiyi veya modu ele verir. java.base, net.minecraft, org.bukkit veya io.papermc içeren satırlar Java'ya ve sunucuya aittir. Bir yedek al, soruna neden olan eklentiyi veya modu güncelle ve sunucuyu yeniden başlat. Sorunu çözemezsen bir destek talebi aç ve mesajın görüldüğü saati belirt.