Eklentiler ayarlarını genellikle plugins/<Plugin>/ klasöründeki YAML dosyalarında saklar. YAML, yapısını boşluklarla yapılan girintilerle oluşturan bir metin biçimidir. Tek bir sekme karakteri veya eksik bir tırnak işareti bile bir eklentinin dosyayı okuyamaması için yeterlidir. Aşağıdaki her bölüm tek bir hata mesajını ele alır. Sunucu Sağlığı bölümünden “Daha fazla bilgi” bağlantısıyla geldiysen zaten doğru yerdesin.

Tam metni Konsol içinde veya Dosyalar altında logs/latest.log dosyasında bulabilirsin. Mesaj neredeyse her zaman dosyanın adını, çoğu zaman da satır ve sütununu belirtir. Altında sıklıkla bir stack trace, yani hatanın programın neresinde oluştuğunu gösteren girintili at satırlarından oluşan bir liste yer alır. Yapılandırma veya dünya dosyalarında herhangi bir değişiklik yapmadan önce Yedekler altından bir yedek oluştur. Dosyaları en iyisi sunucu durdurulmuşken düzenle, çünkü bazı eklentiler kapanırken yapılandırmalarının üzerine yazar.

Bir eklenti dosyasında YAML söz dizimi hatası

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

Cannot load plugins/<Plugin>/<Datei>.yml
Cannot load configuration from stream
could not find expected ':'

Arka planda ne oluyor: Eklenti YAML yapılandırmasını okuyamıyor; YAML, yapısı girintiye bağlı olan bir metin biçimidir. while parsing a block mapping ve expected <block end> hatalı bir yapıya, sequence entries are not allowed here ise yanlış yerleştirilmiş bir liste girdisine işaret eder. could not find expected ':' mesajında anahtar ile değer arasındaki iki nokta üst üste veya ondan sonraki boşluk eksik olabilir. Eklentiye bağlı olarak bazı ayarlar veya eklentinin tamamı devre dışı kalır.

Nasıl düzeltirsin:

  1. Dosyalar altında belirtilen dosyayı aç. Cannot load configuration from stream mesajında eklentiyi ve yapılandırmasını çevredeki log satırlarında ara.
  2. Bildirilen satırı ve önceki girdileri kontrol et. line ve column satırı ve sütunu belirtir; asıl neden daha yukarıda olabilir.
  3. Girinti için sekme yerine boşluk kullan. Aynı seviyedeki girdileri aynı hizaya getir; - ile başlayan liste girdileri kendi satırlarında yer alır.
  4. Anahtarları ve basit değerleri iki nokta üst üste ve boşlukla ayır, örneğin admin-only: false. &, { veya ters tırnak gibi özel karakterlerle başlayan metin değerlerini tırnak içine al. Açık kalan tırnakları kapat ve yanlışlıkla kopyalanmış üç ters tırnaklı Markdown çerçevelerini kaldır.
  5. Dosyayı bir YAML doğrulayıcıyla kontrol et ve sunucuyu yeniden başlat. Çevrim içi kontrolden önce gizli değerleri kaldır.

“Could not deserialize” veya “unknown world”: Eklenti dosyasındaki girdi okunamıyor

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

[org.bukkit.configuration.serialization.ConfigurationSerialization] Could not call method 'public static org.bukkit.Location org.bukkit.Location.deserialize(java.util.Map)' of class org.bukkit.Location for deserialization
java.lang.IllegalArgumentException: unknown world

Arka planda ne oluyor: Eklentiler eşyaları (kitler, mağaza ürünleri, menü öğeleri) ve konumları (home'lar, warp'lar, doğma noktaları) YAML dosyalarında veri blokları olarak saklar. Eski bir Minecraft sürümünde kaydedilmiş bir eşya bazen güncel eşya biçimiyle okunamaz (“Could not deserialize found primitive”). Mesajın altında Location ve unknown world yazıyorsa kayıtlı bir konum, artık var olmayan veya okuma sırasında henüz yüklenmemiş bir dünyayı gösteriyordur. Sunucu çalışmaya devam eder, yalnızca bu girdiler eksik kalır.

Nasıl düzeltirsin:

  1. Etkilenen eklentiyi bul. Mesajın hemen öncesindeki ve sonrasındaki satırlar genellikle eklentiyi veya dosyasını belirtir.
  2. Sunucuyu durdur, Yedekler altından bir yedek oluştur, dosyayı Dosyalar altında aç ve etkilenen eşya girdilerini kaldır veya yenile. Ardından sunucuyu yeniden başlat.
  3. Kit veya mağaza ürünü gibi eşyaları oyun içinde yeniden oluştur.
  4. unknown world mesajında konumu eklentinin komutlarıyla sil veya yeniden ayarla. Dünya hâlâ mevcutsa yüklü olduğundan emin ol.
  5. Bir sonraki yeniden başlatmadan sonra Konsol çıktısını kontrol et.

Bilmekte fayda var: Bir dünyayı sildiysen veya yeniden adlandırdıysan eski home'lar ve warp'lar artık geçersiz bir konumu gösterir. Mesaj ancak bu girdiler kaldırıldığında kaybolur.

“open_command … already exists”: DeluxeMenus bir menüyü atlıyor

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

[DeluxeMenus] open_command specified for menu: <Menü> already exists for another menu!
Skipping menu: <Menü>

Arka planda ne oluyor: DeluxeMenus'te her menünün, oyuncuların onu açmak için kullandığı kendi komutu olabilir. Bu komut menü dosyasında open_command altında yer alır. İki menü dosyası aynı komutu içeriyorsa DeluxeMenus ikinci menüyü atlar ve bu menüye oyun içinden ulaşılamaz. “Skipping menu” satırı atlanan menüyü belirtir. Diğer tüm menüler ve sunucu normal şekilde çalışmaya devam eder. En yaygın neden, bir menü dosyasının şablon olarak kopyalanması ve komutun değiştirilmemesidir.

Nasıl düzeltirsin:

  1. Dosyalar altında plugins/DeluxeMenus/gui_menus klasörünü aç.
  2. Atlanan menünün dosyasını ve aynı open_command değerini kullanan dosyayı bul.
  3. Atlanan menüye henüz kullanılmayan, kendine ait bir komut ver.
  4. Kaydet ve DeluxeMenus'ü /dm reload ile yeniden yükle; komutu oyun içinde eğik çizgiyle, Konsol içinde eğik çizgisiz kullan.
  5. Menüyü yeni komutuyla açarak test et.

Bilmekte fayda var: Bir menü yalnızca başka bir menünün içinden açılıyorsa genellikle kendi komutuna ihtiyaç duymaz. Bu durumda oradaki open_command satırını tamamen kaldırabilirsin.

“Failed to autoload world …”: Multiverse bir dünyayı yüklemiyor

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

[Multiverse-Core] Failed to autoload world '<Welt>': Failure{reason=WORLD_FOLDER_INVALID}
[Multiverse-Core] Failed to import world <Welt>: Failure{reason=WORLD_FOLDER_INVALID}
[Multiverse-Core] Failed to autoload world '<Welt>': Failure{reason=BUKKIT_NAMESPACED_KEY_MISMATCH}: Namespace mismatch detected! …

Arka planda ne oluyor: Multiverse-Core dünyaları plugins/Multiverse-Core/worlds.yml dosyasında yönetir; geçerli bir dünya klasörü yoksa dünyayı yükleyemez. BUKKIT_NAMESPACED_KEY_MISMATCH durumunda dünya zaten yüklüdür, ancak Multiverse'ün beklediğinden farklı bir dahili kimlikle yüklenmiştir. İki kez kaydedilmiş Nether/End dünyaları veya içe aktarılmış ama yüklenmemiş dünyalar (WORLD_EXIST_UNLOADED) da yükleme sorunlarına yol açar; sunucu ve diğer dünyalar çalışmaya devam eder.

Nasıl düzeltirsin:

  1. WORLD_FOLDER_INVALID durumunda Dosyalar altında dünya klasörünün eksiksiz olup olmadığını ve sunucu yazılımının klasör yapısına uyup uymadığını kontrol et. Eksik verileri bir yedekten geri yükle.
  2. Dünya artık yoksa eski girdiyi /mv remove <Welt> ile kaldır.
  3. Dünya mevcut ama yüklü değilse /mv load <Welt> komutunu kullan.
  4. BUKKIT_NAMESPACED_KEY_MISMATCH durumunda mesajdaki iki kimliği karşılaştır. Multiverse eşlemesini sunucu sürümüne uygun kılavuza göre düzelt.
  5. Sunucu Nether ve End dünyalarını server.properties veya bukkit.yml üzerinden yüklüyorsa onları ayrıca ekleme.
  6. Sunucuyu yeniden başlat ve Konsol çıktısını kontrol et.

Bilmekte fayda var: Chunkster'a yönelik eski önerilerin yerine yedekten geri yükleme yap; bkz. Dünya verileri bozuk, eski veya kaydedilemiyor.

DeluxeMenus: Menü dosyası geçersiz

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

[DeluxeMenus] Detected invalid configuration in file: <Menü>.yml
org.bukkit.configuration.InvalidConfigurationException: while scanning a simple key
 in 'reader', line <Zeile>, column <Spalte>:

Arka planda ne oluyor: DeluxeMenus belirtilen menü dosyasını işleyemiyor ve bu menüyü yüklemiyor. Oyuncular ilgili komutu kullandığında hiçbir arayüz görmez, diğer tüm menüler çalışmaya devam eder. Kesin nedeni mesajın hemen altındaki satırlar gösterir; bu genellikle satır ve sütun bilgisi içeren bir YAML hatasıdır. Tipik bir örnek, iki noktadan sonra boşluğun unutulmasıdır: hide_attributes: true yerine hide_attributes:true yazılması.

Sorunu şöyle çözersin:

  1. Mesajın altındaki satırları oku, satır ve sütun numarasını not al.
  2. Menü dosyasını Dosyalar bölümünde aç; dosya genellikle plugins/DeluxeMenus/gui_menus klasöründedir.
  3. İlgili yeri düzelt: her iki noktadan sonra bir boşluk bırak, girintilerde yalnızca boşluk kullan, & veya # içeren metinleri tırnak içine al.
  4. YAML hatası yoksa seçenekleri DeluxeMenus kılavuzuyla karşılaştır; örneğin malzeme adlarını veya koşulların yazımını kontrol et.
  5. /dm reload ile yeniden yükle ve test etmek için menüyü aç.

Bilmekte fayda var: YAML'da boşluktan sonra gelen # bir yorum başlatır. Tırnak işareti kullanılmazsa satırın geri kalanı kaybolur; bu durum özellikle hex renklerde görülür.

“FileNotFoundException”: Eklenti dosyası eksik veya oluşturulamıyor

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

java.io.FileNotFoundException: plugins/DigitalClockRemastered/terrainbackups/<Datei> (No such file or directory)
java.io.FileNotFoundException: plugins/AuctionHouse/auctions.dat (No such file or directory)
java.io.FileNotFoundException: plugins/MagicSpells/spellbooks/<Datei> (No such file or directory)

Arka planda ne oluyor: Bir eklenti, plugins/ altında ihtiyaç duyduğu bir dosyayı okuyamıyor veya oluşturamıyor. Nedeni silinmiş bir dosya ya da eksik veya yeniden adlandırılmış bir alt klasör olabilir; ilk başlatmada bazı veri dosyaları henüz mevcut değildir. Hatanın altındaki çağrı yığınında görünen FileOutputStream veya FileWriter, bir yazma girişimine işaret eder; üst klasör eksikse bu girişim de başarısız olur. Eklentiye bağlı olarak dosya daha sonra oluşturulur, bir işlev devre dışı kalır veya eklenti kendini kapatır.

Sorunu şöyle çözersin:

  1. Sunucuyu bir kez yeniden başlat ve mesajın tekrar görünüp görünmediğini kontrol et.
  2. Dosyalar bölümünde alt klasörler dahil tüm yolu kontrol et. Adlar, büyük-küçük harf dahil mesajdakiyle aynı olmalıdır.
  3. Veri klasörleri veya dosyalar hâlâ eksikse sunucuyu durdur ve bunları Yedekler bölümünden bir yedekten geri yükle.
  4. Bu da işe yaramazsa eklenti klasörünü yedekle ve eklentiyi kılavuzuna göre yeniden kur.

Bilmekte fayda var: Yeni oluşturulan bir dosya boş verilerle veya varsayılan değerlerle başlar. Kaybolan oyuncu verilerini uygun bir yedekten geri alabilirsin.

Ayarlanan dünya oluşturucu kurulu değil

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

Could not set generator for default world '<Welt>': Plugin '<Plugin>' does not exist

Arka planda ne oluyor: Dünya oluşturucu, yeni arazi üreten programdır. bukkit.yml dosyasında veya dünya yapılandırmasında bu dünya için bir eklentiye ait oluşturucu tanımlanmış, ancak bu eklenti kurulu değil veya yüklenmemiş. Bu durumda sunucu yeni bölgeleri normal oluşturucuyla üretir. Daha önce keşfedilmiş alanlar olduğu gibi kalır, ancak kenarlarda arazi uyumsuz biçimde devam edebilir.

Sorunu şöyle çözersin:

  1. Dosyalar bölümünde bukkit.yml dosyasını aç ve worlds: kısmını bul. Dünya adının altında generator: <Plugin> satırı yer alır.
  2. Oluşturucuyu korumak istiyorsan belirtilen eklentinin uygun bir sürümünü Eklentiler bölümünden kur.
  3. Artık ihtiyacın yoksa generator girdisini kaldır.
  4. Sunucuyu yeniden başlat ve Konsol bölümünde mesajın kaybolup kaybolmadığını kontrol et.

Bilmekte fayda var: generator: ifadesinden sonraki ad, eklentinin adıyla tam olarak aynı olmalıdır. Eklenti kurulu olsa bile bir yazım hatası aynı mesaja yol açar.

“Loading a newer configuration than is supported”: Yapılandırma, yazılımdan daha yeni

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

Warning: This command deletes or removes game content. Create a backup first and check the command’s target.

[Configurations] Loading a newer configuration than is supported (<Dateiversion> > <unterstützte Version>)! You may have to backup & delete your global config file to start the server.

Arka planda ne oluyor: Yapılandırma, şu anda çalışan sürümden daha yeni bir sürüm tarafından yazılmış. Bunun tipik nedeni sürüm düşürmedir, yani daha eski bir eklenti veya Minecraft sürümüne geçilmesidir. Parantez içindeki ilk sayı dosyanın sürümünü, ikincisi ise kurulu programın tanıdığı en yüksek sürümü gösterir. Daha yeni ayarlar yok sayılır. Mesajda “global config file” ifadesi geçiyorsa mesaj doğrudan Paper'dan gelir ve genellikle config/paper-global.yml dosyasını kasteder.

Sorunu şöyle çözersin:

  1. Yakın zamanda bir eklentinin sürümünü veya Sürüm bölümünden sunucu sürümünü düşürüp düşürmediğini kontrol et.
  2. Birinci seçenek: Yapılandırmanın uyumlu olduğu sürüme yeniden yükselt.
  3. İkinci seçenek: Yapılandırmayı Yedekler bölümünden eski sürüme ait bir yedekten geri yükle.
  4. Uygun bir yedek yoksa dosyayı Dosyalar bölümünden indir, sil ve sunucuyu yeniden başlat. Yeni bir dosya oluşturulur; ardından özelleştirmelerini elle aktarırsın.

Bilmekte fayda var: Sürümü güvenle nasıl değiştireceğini Minecraft sürümünü ve mod yükleyicisini güvenle değiştirme rehberinde bulabilirsin.

MinecraftWarriors3 haritanın klasörünü bulamıyor

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

[MinecraftWarriors3] [Offizielle Map] Quell-Ordner der Map nicht gefunden: ./plugins/MinecraftWarriors3/maps/<Map-Ordner>

Arka planda ne oluyor: MinecraftWarriors3, resmî haritayı yapılandırmasında tanımlı bir kaynak klasörden alır. Bu klasör eksik. Bu yüzden harita ne kopyalanabilir ne de başlatılabilir ve haritada çalışan her şey devre dışı kalır. Sunucunun kendisi çalışmaya devam eder.

Sorunu şöyle çözersin:

  1. Dosyalar bölümünde mesajdaki yolu aç. Baştaki nokta (./) sunucunun ana dizinini ifade eder.
  2. Klasör eksikse haritayı oraya yükle. Dünya dosyaları doğrudan klasörün içinde olmalıdır; bir arşivi açarken sık sık oluşan ek bir alt klasörün içinde olmamalıdır.
  3. Harita başka bir yerdeyse veya klasörün adı farklıysa plugins/MinecraftWarriors3/ altındaki yapılandırmada yolu düzelt. Büyük-küçük harf farkı önemlidir.
  4. Sunucuyu yeniden başlat ve Konsol bölümünü kontrol et.

Bilmekte fayda var: Bir dünyayı eksiksiz nasıl yükleyeceğini Minecraft dünyasını yükleme ve güvenle değiştirme rehberinde bulabilirsin.

“Failed to load …”: Eklenti menüyü veya yapılandırmayı yükleyemiyor

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

[DeluxeMenus] Failed to load menu items for menu: <Menü>
[GrimAC] Failed to reload config: java.lang.RuntimeException: Failed to load config
Could not load messages.yml!

Arka planda ne oluyor: Bir eklenti, dosyalarından birini okuyamadı; bu bir menü, yapılandırma, dil dosyası, hologram veya NPC (sunucu tarafından yönetilen bir karakter) olabilir. Genellikle nedeni bir biçim hatası, yinelenen bir ad veya yanlış yazılmış bir koşuldur. DeluxeMenus'te etkilenen menü atlanır; GrimAC'te ise yapılandırmanın yüklenmesi veya yeniden yüklenmesi başarısız olur. Eklentiye bağlı olarak bazı işlevler eksik kalır veya eklenti tam olarak başlamaz.

Sorunu şöyle çözersin:

  1. Mesajın altındaki satırları oku. Bu satırlar çoğu zaman dosyayı, satırı ve nedeni belirtir.
  2. Dosyayı Dosyalar bölümünde aç ve eklenti kılavuzundaki örnekle karşılaştır. Menü koşullarında ifadelerin yazımını da kontrol et.
  3. Hatayı bulamazsan dosyayı yedekle ve sunucuyu durdur. Dosyayı silmek yerine yeniden adlandır. Yeni bir varsayılan dosyanın oluşturulmasına yalnızca kılavuz bu yolu öngörüyorsa izin ver.
  4. Metinlerini ve ayarlarını eski dosyadan parça parça aktar ve sunucuyu yeniden başlat.

Bilmekte fayda var: Yeni bir dosya, mevcut menülerini, hologramlarını veya NPC'lerini içermez. Gerekirse bu kayıtları Yedekler bölümünden geri yükle.

“InvalidConfigurationException”: Bir eklentinin YAML dosyası hatalı

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

[<Plugin>] Failed to load <Datei>; the original file will not be replaced.
[BMenu] Errors in <Datei>
org.bukkit.configuration.InvalidConfigurationException: while parsing a block mapping

Sorunun nedeni: YAML, yapısını girintiler ve iki nokta üst üste işaretleriyle oluşturan bir dosya biçimidir. “mapping values are not allowed here” mesajı çoğunlukla tırnak içine alınmamış bir metin değerinde iki nokta üst üste ve ardından gelen boşluğa ya da yanlış girintiye işaret eder. “while parsing a block mapping” ve “expected <block end>” ise hatalı bir yapıyı, örneğin - ile başlayan yanlış girintili bir liste öğesini gösterir. Bu durumda eklenti dosyayı kullanmaz ve varsayılan değerlere döner ya da hiç başlamaz; EssentialsX bozuk dosyanın adını değiştirip yeni bir dosya oluşturur.

Nasıl çözersin:

  1. Mesajda belirtilen dosyayı yedekle ve Dosyalar bölümünde aç. Mesajda geçen satırları ve onlardan önceki satırları kontrol et.
  2. Girinti için yalnızca boşluk kullan; aynı seviyedeki anahtarların girintisi tam olarak aynı olmalı. Liste öğelerinin girintisini de kontrol et.
  3. İki nokta üst üste içeren metinleri tırnak içine al, örneğin message: "Achtung: Neustart".
  4. Tarayıcı üzerinden kullanabileceğin bir YAML doğrulayıcı hatanın yerini gösterir. Düzeltmeden sonra sunucuyu yeniden başlat.

Bilmekte fayda var: EssentialsX dosyanın adını değiştirdiyse eski sürümün hemen yanında durur. Bozuk dosyayı geri kopyalamak yerine değişikliklerini yeni dosyaya aktar.

Eklenti yapılandırmasında geçersiz hesaplama formülü

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

net.objecthunter.exp4j.tokenizer.UnknownFunctionOrVariableException: Unknown function or variable '<Ausdruck>' …

Sorunun nedeni: Bazı eklentiler fiyat, ödül veya bekleme süresi gibi değerleri yapılandırmalarındaki formüllerle hesaplar. Bunun için kullanılan exp4j hesaplama kütüphanesi yalnızca sayıları, işlem işaretlerini, yerleşik fonksiyonları ve eklentinin sağladığı değişkenleri tanır. Formülde başka bir şey varsa, örneğin “100” yerine “100t” yazıyorsa, hesaplama iptal edilir. Eklentinin ilgili işlevi de bu durumda beklendiği gibi çalışmaz. Sunucu çalışmaya devam eder.

Nasıl çözersin:

  1. Mesajda tek tırnak içinde yer alan ifadeyi not al.
  2. Eklentiyi, mesajın altındaki girintili at satırlarından oluşan stack trace yardımıyla bul. Orada genellikle eklentinin dosya adı yazar, örneğin <Plugin>.jar//.
  3. İfadeyi bu eklentinin yapılandırma dosyalarında ara. Çok sayıda dosya varsa klasörü SFTP ile indirip kendi bilgisayarında aramak işini kolaylaştırır.
  4. İfadeyi bir sayıyla veya geçerli bir formülle değiştir. Hangi değişkenlere izin verildiğini eklentinin kılavuzunda bulabilirsin.
  5. Eklentiyi yeniden yükle veya sunucuyu yeniden başlat.

Bilmekte fayda var: SFTP erişimini şu rehberle kurabilirsin: Panelde sunucu dosyalarını düzenleme ve SFTP ile bağlanma.

FancyNpcs: Boş rastgele aralığa sahip NPC eylemi

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

Exception in thread "FancyNpcs-ActionExecutor" java.lang.IllegalArgumentException: bound must be positive

Sorunun nedeni: FancyNpcs ile oluşturulan bir NPC'nin eylemi, örneğin birkaç sonraki eylemden birini seçmek gibi rastgele bir seçim yapmaya çalışır. Seçim listesi boşsa veya sayı aralığı negatifse rastgele sayı üretilemez ve eylem iptal edilir. Oyuncular bunu, NPC'ye tıkladıklarında hiçbir şey olmamasından veya eylemin yalnızca bir kısmının gerçekleşmesinden anlar. Sunucu ve diğer NPC'ler çalışmaya devam eder.

Nasıl çözersin:

  1. FancyNpcs'i sunucu sürümüne uygun en güncel sürüme yükselt.
  2. Etkilenen NPC'nin eylemlerini kontrol et. Her rastgele seçimde en az bir öğe bulunmalı, sayı sınırları da pozitif olmalı.
  3. NPC verileri Dosyalar bölümündeki plugins/FancyNpcs klasöründe bulunur. Değişiklik yapmadan önce yedek al ve dosyaları yalnızca sunucu durdurulmuşken düzenle.
  4. Sunucuyu başlat ve test etmek için NPC'ye tıkla.

Bilmekte fayda var: Mesajda NPC'nin adı geçmez. Rastgele eylemlere sahip birden fazla NPC'n varsa bunları tek tek test et ve bu sırada Konsol'u takip et.

MiniMessage alanında eski renk kodları içeren metin

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

Legacy formatting codes have been detected in a MiniMessage string …

Sorunun nedeni: MiniMessage, <red> veya <bold> gibi köşeli parantezli etiketlerle metin biçimlendirmeye yarayan bir yazım şeklidir. Güncel eklentilerin çoğu bunu sohbet, başlık ve menülerde kullanır. MiniMessage, & veya § ile yazılan eski renk kodlarını anlamaz. Bir metinde böyle bir kod varsa metin yanlış biçimlendirilmiş olarak görünür veya hiç görünmez. Sunucu çalışmaya devam eder.

Nasıl çözersin:

  1. Eklentiyi bul. Mesajdan önceki satır veya altındaki stack trace genellikle eklentinin adını verir.
  2. Dosyalar bölümünde eklentinin yapılandırma veya dil dosyasını aç ve eski kodları etiketlerle değiştir:
    • &c yerine <red>, &a yerine <green>, &e yerine <yellow>
    • &l yerine <bold>, &o yerine <italic>, &r yerine <reset>
    • &#37FF00 veya §x§3§7… yerine <#37FF00>
  3. Eklentinin ayarlarında eski kodlar için bir Legacy modu varsa bunun yerine o modu açabilirsin.
  4. Eklentiyi yeniden yükle veya sunucuyu yeniden başlat ve metni oyun içinde kontrol et.

Bilmekte fayda var: Aynı metinde iki yazım şeklini asla karıştırma. Unutulan tek bir & bile bu mesajın çıkması için yeterlidir.

Paxel: Bir alet seviyesi için değer eksik

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

[Paxel] Setting "<Einstellung>" for tier "<Stufe>" is not defined in the config!

Sorunun nedeni: Paxel; kazma, balta ve küreği tek bir araçta birleştiren bir alettir. Paxel eklentisi bu aleti birkaç seviyede sunar ve her seviye için yapılandırmada belirli zorunlu değerler bulunmalıdır. Belirtilen seviyede bu değerlerden biri eksiktir. Bu durumda söz konusu Paxel üretilemez veya verilemez. Bu sorun çoğunlukla, yeni sürümün eski dosyada henüz bulunmayan bir ayarı beklediği güncellemelerden sonra görülür.

Nasıl çözersin:

  1. Dosyalar bölümünde plugins/Paxel klasöründeki yapılandırmayı aç.
  2. Mesajda geçen seviyeyi bul ve belirtilen ayarı ekle. Aynı dosyadaki eksiksiz bir seviyeyi şablon olarak kullanabilirsin.
  3. Alternatif olarak dosyanın adını değiştirip sunucuyu yeniden başlatabilirsin. Eklenti bu durumda güncel sürümün varsayılan yapılandırmasını oluşturur, sen de özelleştirmelerini yeni dosyaya aktarırsın.
  4. Sunucuyu yeniden başlat ve Konsol'u kontrol et.

Bilmekte fayda var: Ekleme yaparken seviyedeki diğer değerlerle aynı girintiyi kullanmaya dikkat et, aksi takdirde YAML hatası alırsın.

“Permission node … is invalid”: Eklentideki izin tanımı hatalı

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

Permission node '<Plugin>.<Recht>' in plugin description file for <Plugin> v<Version> is invalid
java.lang.IllegalArgumentException: Data cannot be null
java.lang.IllegalArgumentException: 'default' key contained unknown value

Sorunun nedeni: Her eklenti, sahip olduğu izinleri eklenti JAR'ının içinde yer alan plugin.yml dosyasında tanımlar. Bu tanımlardan biri yüklenememiştir. Belirtilen ad tamamen doğru olabilir. Sonraki satırlarda yer alan Data cannot be null ve 'default' key contained unknown value ifadeleri, eksik tanım verilerine veya default için geçersiz bir değere işaret eder. Eklenti çoğunlukla yine de başlar, ancak bu izin varsayılan değerleriyle oluşturulmaz.

Nasıl çözersin:

  1. Hangi eklentinin etkilendiğini mesajdan oku.
  2. Eklentiyi sunucu sürümüne uygun bir derlemeye güncelle. Bunun için JAR dosyasını sunucu durdurulmuşken değiştir.
  3. Kendi yazdığın bir eklentiyse yalnızca adı değil, plugin.yml dosyasındaki permissions bloğunun tamamını Bukkit biçimine göre kontrol et. Her girdi; description, default (true, false, op veya not op) ve children gibi özellikler içeren bir bölümdür.
  4. Sunucuyu yeniden başlat.

Bilmekte fayda var: Yetkileri zaten LuckPerms gibi bir yetki eklentisiyle kendin veriyorsan bu mesajın oyuncuların üzerinde genellikle pek etkisi olmaz.

SuntexSocial: Adresi olmayan SOCKS5 proxy

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

[SuntexSocial] … SOCKS5 proxy is enabled, but telegram.proxy.host is empty

Sorunun nedeni: SuntexSocial, sunucunu bir Telegram botuna bağlar. Yapılandırmada botun internete bir SOCKS5 proxy üzerinden çıkması ayarlanmış. Proxy, bağlantının üzerinden geçtiği aracı bir sunucudur. Ancak bu proxy'nin adresi (telegram.proxy.host) boş. Bu yüzden Telegram botu başlamaz, Minecraft sunucusu ise normal şekilde çalışmaya devam eder.

Çözüm adımları:

  1. Dosyalar bölümünde plugins/SuntexSocial klasöründeki yapılandırmayı aç.
  2. Proxy'ye ihtiyacın varsa telegram ve proxy altında host alanına ana bilgisayar adını, ayrıca uygun portu gir. İkisini de proxy sağlayıcından alabilirsin.
  3. Proxy'ye ihtiyacın yoksa aynı yapılandırmada SOCKS5 proxy'yi kapat.
  4. Sunucuyu yeniden başlat ve botun yanıt verip vermediğini kontrol et.

Bilmekte fayda var: Proxy yalnızca Telegram'a sunucunun ağından doğrudan erişilemiyorsa gereklidir. Böyle bir neden yoksa kapalı bırak.

Dünya oluşturucu eklentisi çok geç başlıyor

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

Could not set generator for default world '<Welt>': Plugin '<Plugin>' is not enabled yet

Sorunun nedeni: Ana dünya için bir eklentiye ait oluşturucu ayarlanmış, ancak eklenti ancak sunucu dünyaları yükledikten sonra başlıyor. Bu durumda dünya normal oluşturucuyu kullanır, yani yeni bölgeler planlandığından farklı görünür. Daha önce oluşturulmuş bölgelerde hiçbir şey değişmez. Sunucu normal şekilde çalışır.

Çözüm adımları:

  1. Oluşturucu eklentisinin kılavuzunda ana dünya için nasıl kurulduğunu oku.
  2. Oluşturucu genellikle bukkit.yml dosyasında worlds: altına, ana dünyanın adının yanına yazılır.
  3. Eklentinin sunucu başlarken, yani dünyalardan önce yüklenmesi gerekir. Bunu geliştirici plugin.yml dosyasında load: STARTUP ile belirler. Mesaj yine de görünüyorsa kurulu sürümün sunucu sürümünle uyumlu olup olmadığını kontrol et.
  4. Sunucuyu yeniden başlat ve Konsol çıktısını kontrol et.

Bilmekte fayda var: Normal oluşturucuyla oluşmuş bölgeler olduğu gibi kalır. Dünyanın tamamının yeni oluşturucuyla oluşmasını istiyorsan yeni bir dünyaya ihtiyacın var. Eski dünyayı önceden Yedekler bölümünde yedekle.

LuckPerms içe aktarma dosyasını okuyamıyor

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

[LuckPerms] Error whilst reading from the import file

Sorunun nedeni: LuckPerms, içe aktarma sırasında grupları, yetkileri ve oyuncu verilerini daha önce dışa aktarmayla oluşturulmuş bir dosyadan alır; örneğin başka bir sunucudan taşınırken. LuckPerms seçilen dosyayı okuyamadı veya biçimini işleyemedi. İçe aktarma iptal edilir. Sunucu çalışmaya devam eder.

Çözüm adımları:

  1. Dosyalar bölümünde dosyanın plugins/LuckPerms klasöründe olduğunu ve adının komuttaki adla tam olarak eşleştiğini kontrol et.
  2. Dosyayı dışa aktarmanın oluşturduğu haliyle, yani arşivden çıkarmadan, yeniden adlandırmadan veya düzenlemeden yükle.
  3. Bu satırın hemen altındaki hata mesajını oku. Mesaj, okumanın başarısız olduğu yeri tam olarak gösterir.
  4. Ardından içe aktarmayı /lp import <Datei> komutuyla yeniden başlat.

Bilmekte fayda var: LuckPerms'te grupları ve yetkileri nasıl oluşturup kontrol edeceğini LuckPerms kurulumu: Yetkiler ve gruplar rehberinde bulabilirsin.

Paper ayarı bilinmeyen bir değer içeriyor

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

Encountered an unexpected exception
org.spongepowered.configurate.serialize.SerializationException: [<Pfad der Einstellung>] <unbekannter Wert> …

Sorunun nedeni: Paper ayarlarını config/paper-global.yml ve config/paper-world-defaults.yml dosyalarından, her dünya için de dünya klasöründeki paper-world.yml dosyasından okur. Bu dosyalardan birinde sunucu sürümünün tanımadığı bir değer var; örneğin yalnızca daha yeni bir sürümde bulunan veya adı değiştirilmiş bir eşya ya da veri bileşeni. Ayar uygulanmaz. Bu durum genellikle daha eski bir sürüme geçtikten sonra veya dosyalar başka bir sunucudan kopyalandığında görülür.

Çözüm adımları:

  1. Mesajı oku: Köşeli parantez içinde ayarın yolu, yani dıştan içe doğru anahtarlar yer alır, ardından bilinmeyen değer gelir.
  2. Dosyalar bölümünde config klasöründeki veya dünya klasöründeki ilgili dosyayı aç ve yolu takip et.
  3. Değeri sürümünün tanıdığı bir adla düzelt veya kaldır.
  4. Sunucuyu yeniden başlat.

Bilmekte fayda var: Bir ayarı tamamen kaldırırsan Paper bir sonraki başlatmada varsayılan değeri yeniden ekler.

“key already exists …”: BMenu bir menü kimliğini birden çok kez yüklüyor

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

[BMenu] key already exists <Bereich>:<Menü>

Sorunun nedeni: BMenu, menüleri benzersiz kimliklerle yönetir. Kullanımda olan bir kimlik yeniden kaydedilirse eklenti yeni girdiyi yok sayar ve mevcut olanı korur. Bu nedenle ikinci menü tanımındaki değişiklikler eksik kalabilir veya beklenenden farklı bir menü görünebilir. Sunucu çalışmaya devam eder.

Çözüm adımları:

  1. Menü dosyalarını düzenlemeden önce Yedekler bölümünde ayarlarının yedeğini oluştur.
  2. Tam kimliği Konsol çıktısından oku. Dosyalar bölümünde BMenu menü tanımlarının kimliklerini karşılaştır ve içe aktarılan menülerde de yinelenen tanımlar olup olmadığını kontrol et.
  3. Gereksiz kopyayı kaldır veya ikinci menüye benzersiz bir kimlik ver. Değiştirilen kimliğe yapılan başvuruları da güncelle.
  4. Sunucuyu tamamen yeniden başlat ve ilgili menüleri test et. Tanımlar benzersiz olduğu halde mesaj devam ediyorsa olayı tam başlatma günlüğüyle birlikte BMenu geliştiricisine bildir.

Bilmekte fayda var: Hangi girdinin korunacağını kayıt sırası belirler. Bu yüzden belirli bir dosya sırasına güvenme.

SCore: Kafa kimliği kafa veritabanı tarafından reddediliyor

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

[SCore] Error when creating the Head: <Kopfwert> invalid head database id ! (<Kopfwert>)

Sorunun nedeni: SCore özel bir kafa oluşturmaya çalışıyor, ancak ayarlanan değeri kafa veritabanı üzerinden çözümleyemiyor. Veritabanı kimliği, orada kayıtlı bir kafayı işaret eder; doku değeri ise kafanın görünümünü tanımlar. İlgili kafa eksik kalır, sunucu ise çalışmaya devam eder.

Çözüm adımları:

  1. Konsol üzerinden kafayı şu anda hangi SCore eklentisinin yüklediğini kontrol et. Ardından Dosyalar bölümünde bu eklentinin kafa tanımını aç.
  2. Ayarlanan biçimi bu eklentinin kılavuzuyla karşılaştır. Geçerli bir kafa kimliği kullan; doku değerini yalnızca bunun için belgelenmiş alana gir.
  3. Bir kafa veritabanı bağlıysa başlangıç mesajlarını kontrol et ve tamamen yüklenmesini bekle. Ardından kafayı yeniden test et.
  4. Düzeltmeden sonra sunucuyu yeniden başlat ve etkilenen görüntüyü veya eşyayı kontrol et.

Multiverse: Varsayılan dünya adı başka bir dünyayla çakışıyor

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

[Multiverse-Core] Unable to migrate default world's name caused by level-name change.
[Multiverse-Core] We have detected a clash between the default name '<Welt>' and an existing non-default world in your worlds.yml file.
[Multiverse-Core] Please change the level-name in server.properties to something else and restart the server.

Sorunun nedeni: Multiverse, level-name değiştikten sonra varsayılan dünyanın adını devralmaya çalışır. Yeni ad, Multiverse'in dünya yapılandırmasında zaten başka bir dünyaya atanmıştır. Bu nedenle devralma işlemi iptal edilir ve varsayılan dünya eşleştirmesinin düzeltilmesi gerekir.

Çözüm adımları:

  1. Değişiklik yapmadan önce Yedekler bölümünde bir yedek oluştur ve sunucuyu durdur.
  2. Dosyalar bölümünde server.properties içindeki level-name girdisini Multiverse'in worlds.yml dosyasıyla karşılaştır. Mevcut dünyalardan hangisinin gerçekten varsayılan dünya olması gerektiğini kontrol et.
  3. Değişiklik istemeden yapıldıysa bu varsayılan dünyanın önceki adını geri yükle. Planlı bir yeniden adlandırma için önce Multiverse kılavuzuna göre çakışmayı gider.
  4. Sunucuyu başlat ve eşleştirmenin başarılı olup olmadığını Konsol üzerinden kontrol et. Ardından istediğin dünyaya girip girmediğini kontrol et.

UltimateDonutSmp: Bir sandığın ödül komutu başarısız oluyor

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

[UltimateDonutSmp] Failed to grant crate reward <Belohnung> from crate <Kiste> to <Spieler>
org.bukkit.command.CommandException: Unhandled exception executing <Befehl>

Sorunun nedeni: UltimateDonutSmp, bir sandık ödülü için bir komut çalıştırır. Bu komut hatayla sonlandığı için ilgili ödül işlemi başarısız olur. Sunucu çalışmaya devam eder; hangi komutun etkilendiğini sandık yapılandırmasından ve hata izinin tamamından görebilirsin.

Çözüm adımları:

  1. Mesajın tamamını Konsol üzerinden veya Dosyalar bölümündeki logs/latest.log dosyasından aç. Sonraki satırlarda belirtilen nedenleri de oku.
  2. Dosyalar bölümünde etkilenen sandığın ödül komutunu kontrol et. Yazımını ve oyuncu yer tutucularını kullandığın UltimateDonutSmp sürümünün kılavuzuyla karşılaştır.
  3. Eklentiyi Eklentiler bölümünden uyumlu bir sürüme güncelle ve düzeltmeden sonra sunucuyu yeniden başlat.
  4. Ödülü kontrollü bir şekilde test et. Hiçbir şeyin iki kez dağıtılmaması için yeniden vermeden önce ödülün bir kısmının zaten ödenip ödenmediğini veya verilip verilmediğini kontrol et.

NovaSync panelini güvenli şekilde kurma ve varsayılan giriş bilgilerini değiştirme

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

[NovaSyncPlugin] [CRITICAL] dashboard.creds: no OWNER account configured AND defaults still in vault

Sorunun nedeni: NovaSync panelinde, panelin yönetimi için kullanılan sahip hesabı eksiktir. Aynı zamanda eklentinin kimlik bilgisi deposunda hâlâ varsayılan giriş bilgileri bulunur. Bu nedenle güvenli ilk kurulum tamamlanmamıştır ve bitirilmesi gerekir. Oyun sunucusu çalışmaya devam eder; uyarı yalnızca eklentinin paneline erişimle ilgilidir.

Çözüm adımları:

  1. Mesajın tamamını Konsol üzerinden veya Dosyalar bölümündeki logs/latest.log dosyasından oku.
  2. NovaSync panelinde belirtilen /dashboard yolunu aç ve kurulum sihirbazını baştan sona tamamla. Bu sırada sahip hesabını oluştur.
  3. Varsayılan giriş bilgilerini, yalnızca burada kullandığın güçlü bir parolaya sahip kendi giriş bilgilerinle değiştir. Ardından NovaSync'in uyarıyı yeniden verip vermediğini kontrol et.

Bilmekte fayda var: Giriş bilgilerini destek talebine veya herkese açık paylaşılan günlük alıntılarına ekleme. Sorunu çözemezsen bir destek talebi aç ve mesajın saatini belirt.

DonutShop: Satın alma komutu başarısız oluyor, Shard'lar iade ediliyor

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

[DonutShop] Shard shop command failed for <Spieler> ("<Befehl>"); refunding <Betrag> Shard.

Sorunun nedeni: DonutShop, satın alınan hizmeti tanımlı bir komutla vermeye çalışır. Bu komut başarısız olur ve eklenti Shard'ların iade edildiğini bildirir. Sunucu çalışmaya devam eder; yalnızca bu satın alma işlemi etkilenir.

Çözüm adımları:

  1. Konsol üzerinden satın alma komutundan hemen önceki mesajları oku. Bu mesajlarda bilinmeyen bir komut veya geçersiz bir parametre belirtilmiş olabilir.
  2. Dosyalar bölümünde etkilenen mağaza girdisini aç. Komut adını, argümanları ve oyuncu yer tutucularını ilgili eklentinin belgeleriyle karşılaştır.
  3. Komutu çalıştıran eklentinin Eklentiler bölümünde kurulu olup olmadığını ve Konsol çıktısına göre başarıyla yüklenip yüklenmediğini kontrol et.
  4. Düzeltmeyi DonutShop kılavuzuna göre uygula. Ardından tek bir satın alma işlemini test et, ödülü ve Shard bakiyesini kontrol et.

ExecutableItems: Özel komutta true veya false eksik

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

[ExecutableItems] INVALID COMMAND A SCommand contains an invalid boolean: <Wert> for command: <Befehl>

Sorunun nedeni: ExecutableItems, bir özel komutun argümanlarını kontrol eder. Boolean değer, true veya false olarak yazılan bir evet-hayır bilgisidir. Bunun için ayrılan yerde başka bir değer bulunuyor. Bu nedenle ilgili eşya işlemi geçersiz olur; sunucu çalışmaya devam eder.

Çözüm adımları:

  1. Mesajı Konsol üzerinden aç ve belirtilen komutu Dosyalar bölümünde ilgili eşya yapılandırmasında bul.
  2. Düzenlemeden önce dosyayı yedekle. Argüman dizisinin tamamını kurulu ExecutableItems sürümünün belgeleriyle karşılaştır.
  3. Öngörülen yere true veya false yaz. Argümanlar kaydıysa sonraki komutların konumunu da kontrol et.
  4. Kaydettikten sonra sunucuyu yeniden başlat ve tam olarak bu eşya işlemini test et.

ExecutableItems: disableItemsPerWorld içindeki dünya geçersiz

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

[ExecutableItems] Invalid world: <Welt> in the option disableItemsPerWorld

Sorunun nedeni: ExecutableItems, belirli eşyaları dünya bazında engellemeye çalışır. Bunun için girilen bir dünya, eklenti tarafından geçerli ve yüklenmiş bir dünya olarak tanınmaz. Bu nedenle bu girdinin engelleme kuralı doğru şekilde eşleştirilemez. Sunucu çalışmaya devam eder.

Çözüm adımları:

  1. Konsol bölümünde istediğin dünyanın başarıyla yüklenip yüklenmediğini kontrol et. Orada bildirilen bir yükleme hatası varsa önce onu gider.
  2. Dosyalar bölümünden ExecutableItems yapılandırmasını yedekle ve disableItemsPerWorld seçeneğini bul.
  3. Girdiyi, yüklenen dünyanın gerçek adıyla karşılaştır. Yazımı düzelt ve kalıcı olarak kaldırılmış dünyalara ait girdileri sil.
  4. Sunucuyu tamamen yeniden başlat. Konsol bölümünü kontrol et ve ilgili eşyaların etkilenen dünyada gerçekten engellenip engellenmediğini test et.

BAirDropFNV: Sabit bırakma noktasının dünyası yüklü değil

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

[BAirDropFNV] World error in airdrop default static location not loaded!

Sorunun nedeni: BAirDropFNV, bir airdrop için yapılandırmasındaki sabit bir konumu kullanır. Bu konumun ait olduğu dünya yüklü olmadığından konum kullanılamaz. Sunucu çalışmaya devam ederken bu airdrop gerçekleşmez.

Çözümü şöyle:

  1. Konsol bölümünde başlangıçta hangi dünyaların yüklendiğini ve istediğin dünya için öncesinde bir yükleme hatası görünüp görünmediğini kontrol et.
  2. Sunucuyu durdur ve Dosyalar bölümünden BAirDropFNV yapılandırmasını yedekle.
  3. Sabit bırakma noktasındaki dünya bilgisini, yüklenen bir dünyanın gerçek adıyla karşılaştır. Girdiyi, kullanmak istediğin mevcut dünyaya göre düzelt.
  4. Ek bir dünyaya ihtiyacın varsa o dünyanın yükleme hatasını gider. Ardından sunucuyu yeniden başlat ve airdrop'u tekrar kontrol et.

Bir eklenti, arşivi yapılandırma dosyası olarak okuyor

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

Cannot load plugins/<Plugin>/<Ordner>/<Archiv>.tar.gz
InvalidConfigurationException: unacceptable code point

Sorunun nedeni: Bir eklenti, veri klasöründeki sıkıştırılmış bir arşivi YAML yapılandırması olarak okumaya çalışıyor. Metin okuyucu ikili verileri reddeder ve bu dosya yüklenmez. YAML, ayarlar için kullanılan bir metin biçimidir. Bir arşiv dosyasını yalnızca yeniden adlandırmak, içeriğini bu biçime dönüştürmez.

Çözümü şöyle:

  1. Sunucuyu durdur ve eklentinin veri klasöründeki dosyaları taşımadan önce Yedekler bölümünden bir yedek oluştur.
  2. Konsolda belirtilen arşivi Dosyalar bölümünden kontrol et ve eklentinin okuduğu yapılandırma klasöründen ayrı bir konuma taşı.
  3. Geçerli yapılandırma dosyalarını ait oldukları klasörde bırak, sunucuyu yeniden başlat ve ilgili kitlerin veya eklenti girdilerinin yüklenip yüklenmediğini kontrol et.

Purpur, balta ayarlarındaki bilinmeyen blokları atlıyor

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

Invalid block for `tools.axe.weatherables`: <Block>
Invalid block for `tools.axe.waxables`: <Block>

Sorunun nedeni: Purpur burada baltayla oksidasyon ve balmumu kazıma kurallarını okur. Girilen blok kimliklerinden biri, çalışan Minecraft sürümünde mevcut değildir. Purpur bu kuralı atlar ve diğer ayarları işlemeye devam eder. Bu durum, örneğin başka bir sürümden yapılandırma aktarıldıktan sonra ortaya çıkabilir.

Çözümü şöyle:

  1. Çalışan Sürüm bilgisini kontrol et ve herhangi bir değişiklik yapmadan önce Dosyalar bölümünden purpur.yml dosyasını yedekle.
  2. Sunucuyu durdur. Bildirilen girdileri, dünya bazında farklılaşan olası ayarlar dahil olmak üzere tools.axe.weatherables ve tools.axe.waxables altında bul.
  3. Bilinmeyen blok girdilerini kaldır veya sürümüne uygun Purpur belgelerine göre düzelt. Diğer ayarları koru.
  4. Sunucuyu başlat ve Konsol bölümünde mesajların kaybolup kaybolmadığını kontrol et.

Mesajın burada yok mu?

Mesajın tamamını, hemen önceki satırlar dahil olmak üzere Konsol bölümünde veya logs/latest.log dosyasında oku. Hangi eklentinin o anda dosyalarını yüklediği çoğu zaman orada yazar. Altındaki stacktrace'te eklentiyi JAR dosyasının adından veya yoldaki plugins/<Plugin>/ klasöründen anlayabilirsin. Mesaj satır ve sütun numarasıyla bir dosya belirtiyorsa sorun neredeyse her zaman yukarıdaki bölümlerde olduğu gibi bir biçim hatasıdır. Her değişiklikten önce bir yedek oluştur. Sorunu çözemezsen bir destek talebi aç ve mesajın saatini belirt.