Birçok eklenti tek başına çalışmaz. Premium eklentiler başlangıçta bir lisans anahtarını kontrol eder, Discord, Telegram veya VK bağlantıları bir token'a (bir bot veya arayüz için bir tür parola) ihtiyaç duyar, sesli sohbet eklentileri kendi ağ portunu açar, bazıları ise internetten kütüphane veya veritabanı indirir. Bunlardan biri eksikse veya reddedilirse eklenti loga bir mesaj yazar. Genellikle yalnızca o eklentinin işlevi devre dışı kalır; tek bir durumda ise eklenti sunucuyu bilerek durdurur.
Aşağıdaki her bölüm bir mesajı ele alıyor. Mesajın tamamını Konsol'da veya Dosyalar altında logs/latest.log içinde, eklenti yapılandırmalarını ise plugins/<Plugin>/ altında bulursun. Bunları değiştirmeden önce Yedekler altından bir yedek oluştur. Anahtarlar ve token'lar gizlidir: Kimseye gösterme ve ekran görüntülerinden kırp.
DonutShop lisans anahtarını reddediyor
Mesaj şöyle görünür:
[DonutShop] DONUTSHOP ERROR
[DonutShop] The licensing server rejected this key.
Sebebi nedir: DonutShop, başlangıçta lisans anahtarını geliştiricisinin lisans sunucusunda doğrulayan bir mağaza eklentisidir. Bu doğrulama son başlatmada başarısız oldu. Girilmiş ve boş olmayan bir değer bile geçersiz, süresi dolmuş veya başka bir kurulum için verilmiş olabilir. Minecraft sunucusu bu sırada çalışmaya devam edebilir, ancak DonutShop güvenilir şekilde kullanılamaz: Oyuncular mağazanın düzgün çalışacağına güvenemez.
Nasıl çözersin:
- Ücretsiz lisans anahtarını resmi Modrinth'teki DonutShop proje sayfasından al veya kontrol et.
- Dosyalar altında DonutShop yapılandırmasını (
plugins/DonutShop/config.yml) aç ve anahtarılicense-keyalanına gir. Anahtarı tırnak içine al, önünde veya arkasında boşluk bırakma. - Dosyayı kaydet ve sunucuyu yeniden başlat.
- Konsol'u kontrol et: Hata ancak yeni başlatmada “DONUTSHOP ERROR” başlığı artık görünmüyorsa giderilmiştir.
Bilmekte fayda var: Anahtarı başka bir sunucudan aldıysan bu sunucu için kendine ayrı bir anahtar edin.
LibreLogin sunucuyu durduruyor: Kütüphane yüklenemiyor
Mesaj şöyle görünür:
[LibreLogin] Failed to load libraries, stopping server to prevent damage
… Failed to download library <Bibliothek>
Sebebi nedir: LibreLogin, oyuncuların parolayla giriş yapmasını sağlayan bir oturum açma eklentisidir. Başlangıçta, kendi içinde bulunmayan program parçalarını, yani kütüphaneleri indirir; PacketEvents de bunlardan biridir. Bu indirme başarısız olursa LibreLogin yarı işlevsel şekilde çalışmaya devam etmek yerine sunucuyu bilerek durdurur. Yani sorun çözülene kadar sunucu başlamaz.
Nasıl çözersin:
- Sunucuyu bir kez yeniden başlat. İndirme kaynağına yalnızca kısa süreliğine ulaşılamadıysa bir sonraki denemede genellikle sorun kalmaz.
- Eklentiler altından LibreLogin'i sunucu yazılımına uygun en yeni sürüme güncelle. PacketEvents sende ayrı bir eklenti olarak kuruluysa onu da güncelle.
- Yeniden başlat ve kütüphanelerin artık yüklenip yüklenmediğini Konsol'dan kontrol et.
- Mesaj her başlatmada görünüyorsa sunucu indirme adresine ulaşamıyordur. Bunun nedeni internet erişimi, ad çözümleme (DNS, adresleri IP numaralarına çevirir) veya adresin kendisi olabilir. Sorunu çözemezsen bir destek talebi aç ve mesajın saatini belirt.
Bilmekte fayda var: Eklentileri nasıl güncelleyip değiştireceğini Minecraft eklentilerini kurma ve yönetme rehberinde bulabilirsin.
“Packet queue has … packets”: Simple Voice Chat yetişemiyor
Mesaj şöyle görünür:
[voicechat] Packet queue has <Anzahl> packets
[voicechat] Dropping voice chat packets!
Sebebi nedir: Simple Voice Chat, oyunda birbirine yakın olan oyuncular arasında sesi iletir. Bu mesaj, sesli sohbetin işleme hızına yetişemediği, ses paketlerinin bir kuyrukta biriktiği veya atıldığı anlamına gelir. Bunun nedeni, o anda aşırı yüklenmiş ve TPS değeri düşük (saniye başına tick, Minecraft'ın çalışma temposu; normali 20'dir) ya da CPU yükü yüksek bir sunucudur. Sunucu çalışmaya devam ederken oyuncular sesi kesik kesik duyar veya hiç duyamaz.
Nasıl çözersin:
- Yükün kaynağını örneğin spark ile bul: spark: Minecraft sunucusundaki lag'i bulma ve anlama.
- Dosyalar altında
server.propertiesiçindeki görüş mesafesini (view-distance) ve simülasyon mesafesini (simulation-distance) düşür. Sunucunun daha az chunk (16 × 16 blokluk dünya parçaları) yüklemesi için kaydet ve yeniden başlat. - Belirli noktalardaki entity (yaratıklar, hayvanlar, yerdeki eşyalar) sayısını azalt ve çok yük oluşturan eklentileri kontrol et.
- Bu yeterli olmazsa Ayarlar ve Abonelik → Plan altından daha yüksek performanslı bir plana geç.
Bilmekte fayda var: Başlatmadan hemen sonra veya yeni bölgeler keşfedilirken görülen tekil mesajlar, kısa sürede kesildiği sürece sorun değildir.
Simple Voice Chat UDP portunu alamıyor
Mesaj şöyle görünür:
[voicechat] Failed to run voice chat at UDP port <Port>
[voicechat] Disabling Simple Voice Chat
Sebebi nedir: Simple Voice Chat, sesi kendine ait bir UDP portu üzerinden iletir. UDP, ses gibi hızlı gerçek zamanlı veriler için kullanılan ağ yöntemidir. Ayarlanan port sunucuna ait değildir veya zaten kullanılıyordur; örneğin eklenti kılavuzundaki varsayılan değer hâlâ girili olabilir. Port olmadan sesli sohbet kapanır; oyunun kendisi normal şekilde çalışmaya devam eder.
Nasıl çözersin:
- Dosyalar altında
plugins/voicechat/voicechat-server.propertiesdosyasını aç. Simple Voice Chat sende mod olarak çalışıyorsa dosyaconfig/voicechat/voicechat-server.propertieskonumundadır. portdeğerini sunucunun port numarası olarak ayarla. Oyun portun TCP ve UDP için açıktır.- Dosyayı kaydet ve sunucuyu yeniden başlat.
- Mesajın artık görünmediğini Konsol'dan kontrol et ve sesli sohbeti oyun içinde test et.
Ayrıntılı bilgi: Minecraft sunucusunda Simple Voice Chat kurulumu.
Bilmekte fayda var: Bir UDP portunu aynı anda yalnızca tek bir program açabilir. Aynı portu başka bir eklenti, örneğin Bedrock oyuncuları için Geyser zaten kullanıyorsa ikisinden birinin sunucuna atanmış başka bir port kullanması gerekir.
“No bot token”: Discord girişi başarısız oluyor
Mesaj şöyle görünür:
[DiscordSRV] No bot token has been set in the config; a bot token is required to connect to Discord.
[EssentialsDiscord] An error occurred while logging into Discord … No token provided!
[DiscordWhitelist] Edit plugins/DiscordWhitelist/config.yml and set discord.bot-token, then run /discordwhitelist reload.
Sebebi nedir: Discord eklentileri kendi botlarıyla oturum açar. Bunun için botun parola gibi gizli bir karakter dizisi olan token'ına ihtiyaç duyarlar; token eksik veya geçersizse Minecraft çalışmaya devam ederken Discord bağlantısı kurulmaz; EssentialsDiscord bu durumda kendi eklentisini devre dışı bırakır. voicechat-discord'da ayrıca veri türleri yanlış olabilir: token metin, vc_id ise sayı olmalıdır.
Nasıl çözersin:
- Discord Developer Portal'da bir bot oluştur veya mevcut botunu seç. Gerekirse yeni bir token üret.
- Token'ı Dosyalar bölümünden yapılandırmaya gir: DiscordSRV için
plugins/DiscordSRV/config.ymldosyasındaBotTokenalanına, DiscordWhitelist içinplugins/DiscordWhitelist/config.ymldosyasındadiscord.bot-tokenalanına. Diğer eklentilerde kendi kılavuzlarını izle. - voicechat-discord kullanıyorsan
tokenbir karakter dizisi,vc_idise kılavuzda belirtilen sayı olmalıdır. - Gerekirse botu Discord sunucuna davet et, ardından kaydet ve Minecraft'ı yeniden başlat.
Bilmekte fayda var: Token'ı asla kimseyle paylaşma; herkese açık bir yerde yayımlandıysa sıfırla. Intent hatalarında Developer Portal'da istenen “Privileged Gateway Intents” seçeneklerini etkinleştir.
“Could not download GeoLiteAPI database”: Ülke veritabanı eksik
Mesaj şöyle görünür:
[AuthMe] Could not download GeoLiteAPI database [FileNotFoundException]: plugins/AuthMe/GeoLite2-Country.mmdb (No such file or directory)
[DigitalClockRemastered] [DigitalClock] Error when downloading file GeoLiteCity.dat: java.net.UnknownHostException: <Domain>
Arka planda ne oluyor: AuthMe gibi bazı eklentiler, IP adreslerini ülkelerle eşleştirmek için bir veritabanı indirir; bu indirme başarısız olmuştur. “No such file or directory” ifadesini içeren FileNotFoundException hatasında belirtilen yerel dosya veya ilgili klasör eksiktir. UnknownHostException hatasında ise indirme kaynağının ana makine adı çözümlenemiyordur. Eklenti çalışmaya devam eder; ancak ülkeye bağlı işlevler veritabanı olmadan devre dışı kalır.
Nasıl düzeltirsin:
- Geçici indirme sorunlarında bir sonraki yeniden başlatmada indirme tekrar denenir.
- “No such file or directory” hatasında Dosyalar bölümünden belirtilen konumu ve eklenti yapılandırmasındaki dosya yolunu kontrol et. Veritabanını eklenti sürümünün kılavuzuna göre kur.
UnknownHostExceptionhatasında, eklenti sürümünün ve indirme kaynağının hâlâ güncel olup olmadığını resmî eklenti kılavuzundan kontrol et. Sunucu durdurulmuşken eklentiyi uygun bir sürüme güncelle.- Eklenti sürümün lisans anahtarı istiyorsa geçerli anahtarını yapılandırmadaki ilgili alana gir.
- Kaydet, yeniden başlat ve Konsol bölümünü kontrol et.
Bilmekte fayda var: Ülkeye bağlı işlevleri kullanmıyorsan bu mesajı görmezden gelebilirsin. Diğer işlevler çalışmaya devam eder.
DonutShop lisans anahtarı olmadan kilitli kalıyor
Mesaj şöyle görünür:
[DonutShop] DONUTSHOP LOCKED
[DonutShop] No license key is set in config.yml.
[DonutShop] Then run: /link <your-key>
Arka planda ne oluyor: DonutShop yalnızca bir lisans anahtarıyla başlar. config.yml dosyasında anahtar girili olmadığı için mağaza kilitli kalır. Anahtar ücretsizdir, ancak bir kereliğine geliştiriciden alman gerekir. Minecraft sunucusunun kendisi bundan etkilenmez.
Nasıl düzeltirsin:
- Ücretsiz anahtarı eklentinin geliştiricisinden al. Oraya ulaşmanı sağlayan Discord bağlantısı, mesajda banner'ın çevresindeki satırlarda yer alır.
- Mesajda belirtildiği gibi
/link <dein-schlüssel>komutunu çalıştır veya anahtarıplugins/DonutShop/config.ymldosyasına gir. - Sunucuyu yeniden başlat.
- Konsol bölümünde “DONUTSHOP LOCKED” banner'ının kaybolup kaybolmadığını kontrol et.
Bilmekte fayda var: Ardından “DONUTSHOP ERROR” görünürse anahtar reddedilmiştir. Bu durumda reddedilen DonutShop lisansıyla ilgili bölüme göz at.
Eklentinin VK token'ı reddediliyor
Mesaj şöyle görünür:
com.vk.api.sdk.exceptions.ApiAuthException: User authorization failed (5): User authorization failed: invalid access_token (4).
Arka planda ne oluyor: Bazı eklentiler, sosyal ağ VKontakte'yi (VK) sunucuya bağlar. Bunun için API'ye özel bir tür parola olan erişim token'ına ihtiyaç duyarlar. VK, girilen token'ı reddetmiştir (“invalid access_token”); yani token geçersizdir, süresi dolmuştur veya iptal edilmiştir. Eklentinin VK işlevleri devre dışı kalır, sunucunun geri kalanı normal şekilde çalışır.
Nasıl düzeltirsin:
- VK'de eklentinin istediği izinlere sahip yeni bir erişim token'ı oluştur. Hangi izinlerin gerektiği eklentinin kılavuzunda yazar.
- Dosyalar bölümünde
plugins/<Plugin>/altındaki eklenti yapılandırmasını aç ve eski token'ı yenisiyle değiştir. - Dosyayı kaydet ve sunucuyu yeniden başlat.
- Konsol bölümünde mesajın artık görünmediğini kontrol et.
Bilmekte fayda var: Hangi eklentinin etkilendiğini, mesajın altındaki stack trace'te, yani at … ile başlayan girintili satırlarda görebilirsin. Orada com.vk.api ifadesinin yanında eklentinin paket adı da yer alır.
Eklenti kaynak paketini sağlayamıyor
Mesaj şöyle görünür:
java.io.IOException: HTTP 403 dla http://<Adresse>/<Pack>.zip
Failed to start resourcepack server: Server is not publicly reachable on <Adresse>:<Port>
Arka planda ne oluyor: Bazı eklentiler oyunculara kendi kaynak paketlerini sunar. Bunun için paketi bir adresten indirir, kendileri oluşturur veya oyuncuların paketi alabileceği küçük bir yerleşik web sunucusu başlatır. Bu adımlardan biri başarısız olmuştur. Bu durumda oyuncular paketi alamaz; pakete bağlı dokular veya işlevler eksik kalır. Sunucu çalışmaya devam eder.
Nasıl düzeltirsin:
- Mesajdaki HTTP durum kodunu oku: 403 erişimin reddedildiği, 404 ise dosyanın bulunamadığı anlamına gelir.
- Eklenti yapılandırmasındaki paket adresini tarayıcıda aç. Adres ZIP dosyasını doğrudan indirmeli, önizleme veya giriş sayfası göstermemelidir.
- Adresi düzelt veya paketi herkese açık olarak sunan bir yere yükle.
- Eklenti yerleşik bir web sunucusu kullanıyorsa oraya yalnızca panelde sunucuna atanmış ve dışarıdan erişilebilen bir port gir.
- Sunucuyu yeniden başlat.
“accessToken=MISSING”: API anahtarı veya token eksik
Mesaj şöyle görünür:
Please set your <Dienst> API key
accessToken=MISSING
[BedrockVoiceChat] Config validation failed: useEmbeddedServer=false, bvcServer=MISSING, accessToken=MISSING
Arka planda ne oluyor: Eklenti harici bir hizmetle birlikte çalışır ve bunun için bir API anahtarına veya erişim bilgilerine ihtiyaç duyar. API anahtarı veya token, eklentinin kimliğini hizmete doğrular. Bu bilgiler eksikse eklenti çalışmaz; sunucunun geri kalanı çalışmaya devam eder. BedrockVoiceChat'te useEmbeddedServer=false harici çalışma modunu gösterir: bvcServer=MISSING ise ayrıca ses hizmetinin sunucu bilgisinin de eksik olduğunu belirtir.
Nasıl düzeltirsin:
- Mesajın tamamını ve eklenti kılavuzunu oku: Gerekli alanlar ve kullanılan hizmet burada belirtilir.
- Anahtarı veya token'ı hizmetin kılavuzuna göre edin. Kendi barındırdığın hizmetlerde erişim bilgilerini o hizmetin kurulumundan al.
- Dosyalar bölümünde belirtilen eklenti yapılandırmasını aç ve eksik değerleri gir. BedrockVoiceChat'i harici modda kullanıyorsan hem
bvcServerhem deaccessTokengerekir. Dosyanın mevcut biçimini ve girintilerini koru. - Dosyayı kaydet ve sunucuyu yeniden başlat.
Bilmekte fayda var: Eklenti bundan sonra dosyayı okuyamadığını bildirirse Eklentinin yapılandırma dosyası hatalı kılavuzuna göz at.
Premium eklenti geçerli bir lisans anahtarı bulamıyor
Mesaj şöyle görünür:
No License Key Found!
Please enter a valid key in license.yml
Authentication failed! API key is invalid
Arka planda ne oluyor: Eklenti ya premium bir eklentidir ya da sağlayıcıdan alınan bir anahtara ihtiyaç duyar ve yapılandırmasında geçerli bir anahtar bulamaz. Bu durumda tamamen devre dışı kalır veya bazı işlevlerini kapatır. Sunucu çalışmaya devam eder, yalnızca bu eklentinin işlevleri olmadan.
Nasıl düzeltirsin:
- Anahtarı satın alma bilgilerinden bul; örneğin eklentiyi satın aldığın sitedeki hesabına bak ya da sağlayıcıya sor.
- Dosyalar bölümünde hata mesajında belirtilen dosyayı aç, genellikle
plugins/<Plugin>/license.ymlveyaplugins/<Plugin>/config.ymlolur, ve anahtarı gir. - Dosyayı kaydet ve sunucuyu yeniden başlat.
- Anahtarın yoksa eklentiyi sürekli hatalarla çalıştırmak yerine Eklentiler bölümünden kaldır.
Bilmekte fayda var: Premium eklentileri yalnızca resmi satış sayfasından indir. Lisans denetimi kaldırılmış, resmi olmayan kaynaklardan gelen sürümlerde sıklıkla zararlı yazılım bulunur.
Eklentinin Telegram botu başlamıyor
Hata mesajı şöyle görünür:
Error removing old webhook
Arka planda ne oluyor: Telegram bağlantılı bir eklenti, başlatılırken bir bot ile Telegram'da oturum açar. Bu sırada önce eski bir webhook'u, yani Telegram'ın yeni mesajları göndereceği kayıtlı bir adresi kaldırır. Bu işlem, genellikle bot token'ı geçersiz olduğu veya Telegram'a o anda ulaşılamadığı için başarısız olmuştur. Telegram işlevi kapalı kalır, Minecraft sunucusu ise normal şekilde çalışmaya devam eder.
Nasıl düzeltirsin:
- Telegram'da @BotFather ile sohbeti aç ve botunun token'ını görüntüle ya da yeni bir token oluştur.
- Dosyalar bölümünde
plugins/<Plugin>/altındaki eklenti yapılandırmasını aç ve token'ı değiştir. Token'ı eksiksiz kopyala; bir bot token'ı bir sayı ve iki nokta üst üste ile başlar. - Dosyayı kaydet ve sunucuyu yeniden başlat.
- Konsol bölümünde mesajın artık görünmediğini kontrol et.
Bilmekte fayda var: Mesaj yalnızca bir kez görünüp sonraki başlatmada çıkmıyorsa Telegram'a kısa süreliğine ulaşılamamıştır. Bu durumda hiçbir şeyi değiştirmen gerekmez.
Eklenti kendi ağ portunu açamıyor
Hata mesajı şöyle görünür:
Failed to bind to /<Adresse>:<Port>
[PlasmoVoice] Failed to start the udp server
Arka planda ne oluyor: Bazı eklentiler, örneğin Plasmo Voice gibi bir sesli sohbet ya da harita veya istatistik içeren bir web sayfası için kendi ağ portunu açar. Ayarlanan adres veya port sunucunda kullanılamıyor: Port sunucuna atanmamış, zaten kullanımda ya da yapılandırmada sunucunun bu şekilde kullanamayacağı sabit bir IP adresi yazılı. Eklentinin bu işlevi kapalı kalır, sunucunun geri kalanı çalışmaya devam eder.
Nasıl düzeltirsin:
- Dosyalar bölümünde
plugins/<Plugin>/altındaki eklenti yapılandırmasını aç ve port ile adres ayarlarını bul. - Panelde sunucuna atanmış ve henüz boşta olan bir port gir.
- Adresi boş bırak veya
0.0.0.0olarak ayarla. Bu, sunucunun tüm ağ arayüzlerinden erişilebilir olması anlamına gelir. - Dosyayı kaydet, sunucuyu yeniden başlat ve Konsol bölümünde mesajın artık görünmediğini kontrol et.
Bilmekte fayda var: Bir portu aynı anda yalnızca tek bir program açabilir. İki eklenti aynı portu kullanıyorsa her birine ayrı bir port gerekir. Portlar hakkında daha fazlası: Minecraft portları ve bağlantı hatalarını kontrol etme.
“Address already in use”: Sesli sohbet, RCON veya ek bir hizmet için port kullanımda
Hata mesajı şöyle görünür:
Unable to initialise RCON on <Adresse>:<Port>
Failed to start the udp server … Address already in use
[voicechat] Voice chat server error … java.net.BindException: Address already in use
Arka planda ne oluyor: Bir eklenti veya sesli sohbet, özel bir web sayfası, Query ya da RCON gibi ek bir hizmet, zaten kullanımda olan bir portu açmaya çalışıyor. Çoğu zaman yapılandırmasında oyun portu yazılıdır. Fabric üzerindeki sesli sohbet modları da bundan etkilenebilir. Sunucu çalışmaya devam eder ve oyuncular katılabilir, yalnızca bu işlev kapalı kalır.
Nasıl düzeltirsin:
- Konsol bölümünde hatadan önceki satırları oku. Bu satırlarda eklentinin veya RCON ya da sesli sohbet gibi hizmetin adı geçer.
- Dosyalar bölümünde adı geçen eklentinin veya modun yapılandırmasını aç. Query ve RCON için
query.portvercon.portayarlarıserver.propertiesdosyasındadır. - Sunucuna atanmış, oyun portu olmayan ve başka bir ek hizmetin kullanmadığı bir port gir.
- Simple Voice Chat ve desteklenen diğer eklentiler için Eklentiler bölümündeki sihirbazlar boş bir portu otomatik olarak ayarlar.
- Kaydet, sunucuyu yeniden başlat ve Konsol bölümünü kontrol et.
Bilmekte fayda var: Aynı dolu port yazılı kaldığı sürece yalnızca yeniden başlatmak işe yaramaz. Daha fazlası için: Minecraft portları ve bağlantı hatalarını kontrol etme.
DonatePay: Sorgu adresinde geçersiz karakter
Hata mesajı şöyle görünür:
java.net.URISyntaxException: Illegal character in query at index <Position>: <Adresse mit entferntem Token>
Arka planda ne oluyor: DonatePay entegrasyonu yeni bağışları sorgulamak istiyor, ancak bunun için oluşturduğu adresi işleyemiyor. URI, yapılandırılmış bir adrestir; buradaki sorgu bölümünde izin verilmeyen bir karakter bulunuyor. Bu nedenle bağış sorgusu başarısız olur, Minecraft sunucusu ise çalışmaya devam eder.
Nasıl düzeltirsin:
- Konsol bölümünü veya Dosyalar altındaki
logs/latest.logdosyasını aç ve hata izinde DonatePay entegrasyonunun geçip geçmediğini kontrol et. - Dosyalar bölümünde eklenti yapılandırmasını kontrol et. Girilen erişim bilgilerini kılavuzla karşılaştır ve yanlışlıkla kopyalanmış boşlukları veya tırnak işaretlerini kaldır.
- Entegrasyonu Eklentiler bölümünden güncelle ya da kendin yüklediğin dosyasını Dosyalar bölümünden değiştir. Sunucuyu tamamen yeniden başlat.
- Mesaj devam ederse temizlenmiş hata izini eklenti geliştiricisine ilet. Paylaşmadan önce tüm token değerlerini kaldır.
Sırt çantası eklentisi kaynak paketini kullanamıyor
Hata mesajı şöyle görünür:
[ᴠᴢʙᴀᴄᴋᴘᴀᴄᴋ] Die URL der Datei '<Datei>.zip' ist ungültig!
Arka planda ne oluyor: Eklenti, ayarlanan bir kaynak paketi dosyasını kullanamıyor. Ya adres geçersizdir ya da harici paket hatalı olarak algılanmıştır. Bu yüzden sırt çantası görünümünde dokular ve yazı tipleri yanlış görünür veya eksik olur; sunucu çalışmaya devam eder.
Nasıl düzeltirsin:
- Dosyalar bölümünde eklenti yapılandırmasında hangi paket dosyasının ve adresin ayarlı olduğunu kontrol et.
- Dosyayı eklenti sürümünün kılavuzuyla karşılaştır. Geçerli bir doğrudan indirme adresi ve bu sürüme uygun, eksiksiz bir arşiv kullan.
- Sunucuyu tamamen yeniden başlat. İstemcinin düzeltilmiş paketi yeniden yüklemesini sağla, ardından sırt çantası dokularını ve yazı tiplerini kontrol et.
libdatachannel: Veri kanalı bağlantısı veya gönderimi başarısız oluyor
Hata mesajı şöyle görünür:
[tel.schich.libdatachannel.LibDataChannel] SCTP connection failed
[tel.schich.libdatachannel.LibDataChannel] {anonymous}::wrap@320: Sending failed, errno=2
{anonymous}::wrap@320: Sending failed, errno=104
Arka planda ne oluyor: libdatachannel, veri bağlantıları için kullanılan bir kütüphanedir. SCTP ise bu sırada kullanılan aktarım yöntemini ifade eder. Bir bağlantı kurulamıyor veya artık veri gönderemiyor; etkilenen eklenti ya da mod bağlantısı kesilir. Oyun sunucusu çalışmaya devam eder.
Nasıl düzeltirsin:
- Etkilenen bağlantıyı yeniden dene. Yalnızca tek bir katılımın mı yoksa birden fazla bağlantının mı başarısız olduğunu kontrol et.
- Konsol bölümünde mesajdan önceki ve sonraki satırları oku. Kütüphaneyi orada adı geçen plugin veya modla eşleştir.
- Bu plugin veya modun ağ ayarlarını ve gereksinimlerini belgeleriyle karşılaştır. Özellikle belgelerde belirtilen portları ve karşı tarafın erişilebilirliğini kontrol et.
- Plugin'ler veya Modlar bölümünde uygun bir güncelleme olup olmadığına bak. Hata devam ederse bir destek talebi aç ve saati ile eşlik eden mesajları belirt.
Netty: Ağ bildirimi sonlandırılmış bir yürütücüye denk geliyor
Mesaj şöyle görünür:
Failed to submit a listener notification task. Event loop shut down?
java.util.concurrent.RejectedExecutionException: event executor terminated
Arka planda ne oluyor: Netty, ağ görevlerini bir olay döngüsünde işler. Burada bir bildirim daha kuyruğa alınmak istenirken bu döngü çoktan sonlanmıştır. Bildirim yok sayılır. Bu durum sunucu durdurulurken yan hata olarak görülebilir; oyun sırasında ise bir ağ işlevi aksayabilir.
Nasıl düzeltirsin:
- Konsol bölümündeki saati kontrol et ve sunucunun başlatılma veya durdurulma zamanıyla karşılaştır.
- Hata sunucu çalışırken ortaya çıkıyorsa tam mesajı önceki hatalarla birlikte
logs/latest.logdosyasından kaydet. Sonraki çağrı satırlarına stack trace denir ve bunlar ilgili bileşeni gösterebilir. - Plugin'ler bölümünde ilgili bileşeni, ayrıca sunucu Sürüm bölümünü birbiriyle uyumlu güncellemeler açısından kontrol et. Dosyaları yalnızca sunucu durdurulmuşken değiştir.
- Sunucuyu tamamen yeniden başlat ve etkilenen bağlantıyı tekrar dene. Hata devam ederse saati ve tam mesajı belirterek bir destek talebi aç.
Lavalink, oturum açmadan bir YouTube parçasını yükleyemiyor
Mesaj şöyle görünür:
dev.lavalink.youtube.AllClientsFailedException: All clients failed to load the item.
Client [<Client>] failed: This video requires login.
Arka planda ne oluyor: Müzik işlevi, ses yükleyip çalmaya yarayan bir hizmet olan Lavalink'i kullanır. Lavalink'in YouTube eklentisi, istenen parça için oturum açılması gerektiği yanıtını alır. Bu parça yüklenmez; oyun sunucusu çalışmaya devam eder.
Nasıl düzeltirsin:
- Parçanın YouTube'da oturum açmadan erişilebilir olup olmadığını kontrol et. Karşılaştırmak için herkese açık başka bir parça dene.
- Tam mesajı Konsol bölümünde veya
logs/latest.logdosyasında oku. Müzik modunun ve YouTube bağlantı bileşeninin sürümlerini not al. - Bu bileşenlerin belgelerinde uygun güncellemeler olup olmadığına bak. Modlar bölümünde değişiklik yapmadan önce sunucuyu durdur, ardından yeniden başlat.
- Parça yine alınamıyorsa hata izini geliştiriciye bildir. Rapordan kişisel bilgileri ve erişim bilgilerini çıkar.
ForcePack: Kaynak paketi bağlantısını kontrol et
Mesaj şöyle görünür:
[ForcePack] Your URL has an invalid or unknown format.
URLs must have no redirects and use the .zip extension.
Arka planda ne oluyor: ForcePack, kaynak paketi için ayarlanan indirme bağlantısını denetler. Bağlantı beklenen doğrudan ZIP biçimine uymuyordur veya denetim tarafından tanınmıyordur. ForcePack yine de başlar; denetim, çalışan bir bağlantıya da itiraz edebilir. Önemli olan, bir istemcinin paketi gerçekten indirip indiremediğidir.
Nasıl düzeltirsin:
- Yapılandırılan bağlantıyı oturum açmadan test et. Bağlantı, önizleme sayfası veya yönlendirme olmadan doğrudan ZIP dosyasını sunmalıdır.
- Sunucuyu durdur ve ForcePack yapılandırmasını Dosyalar üzerinden yedekle.
- Uygun bir doğrudan indirme bağlantısı gir ve sunucuyu yeniden başlat. Ardından kaynak paketinin indirilmesini bir istemciyle test et.
- İtiraz edilen bağlantıyla indirme zaten çalışıyorsa bağlantı türünü ve ForcePack sürümünü plugin geliştiricisine bildir.
e4mc tünel bağlantısını kuramıyor
Mesaj şöyle görünür:
error in e4mc
bind(..) failed: Address family not supported by protocol
Arka planda ne oluyor: Seçilen adres ailesi çalışma ortamında desteklenmediği için e4mc gerekli bir ağ soketini açamaz. e4mc tünel bağlantısı başarısız olur; asıl Minecraft sunucusu çalışmaya devam edebilir. Soket, bir programın ağa erişim noktasıdır. Bu mesaj, zaten kullanımda olan bir port hatasından farklıdır.
Nasıl düzeltirsin:
- Konsolda Address family not supported by protocol ifadesinin doğrudan e4mc hatasının içinde yer aldığını doğrula.
- Modlar bölümünde loader'ına uygun bir e4mc sürümünü ve bu sürümün özel sunucularla ilgili notlarını kontrol et; değişiklik yapmadan önce Yedekler bölümünden yedek al.
- e4mc tünelini kullanmıyorsan sunucu durdurulmuşken modu kaldır ve sunucuyu yeniden başlat; tünele ihtiyacın varsa hata mesajını ve saati belirterek bir destek talebi aç.
Müzik işlevi bir parçayı getiremiyor
Mesaj şöyle görünür:
Error in loading item <Musikanfrage>
FriendlyException: Something went wrong when looking up the track
Arka planda ne oluyor: Lavaplayer müzik kütüphanesi istenen parçayı bulamaz veya yükleyemez. Bu müzik isteği başarısız olur; Minecraft sunucusu ve diğer oyun işlevleri çalışmaya devam eder. Hata izi, sürece dahil olan program çağrılarını gösterir. Sağlayıcıyla ilgili daha ayrıntılı bilgiler çoğunlukla aynı isteğin önceki mesajlarında bulunur.
Nasıl düzeltirsin:
- Konsolda hata izinden hemen önceki mesajları incele ve arama mı yoksa doğrudan medya bağlantısı mı gönderildiğini kontrol et.
- Müzik modunun desteklediği bir kaynaktan erişilebilir başka bir parça dene; asıl parçanın herkese açık olup olmadığını da kontrol et.
- Modlar bölümünde müzik modu ile bağımlılıklarının sürümlerinin uyumlu olduğundan emin ol ve bir değişiklikten sonra sunucuyu tamamen yeniden başlat.
Müzik bağlantısı desteklenen bir ses biçimi sunmuyor
Mesaj şöyle görünür:
URL resolution failed [UNKNOWN] url=<Medienlink> detail=FriendlyException: Unknown file format.
Arka planda ne oluyor: Müzik işlevi, verilen bağlantıda desteklenen bir ses biçimi algılayamaz. Bu nedenle istenen parça veya bağlantısı verilen koleksiyon yüklenmez; oyun sunucusu çalışmaya devam eder. Erişilebilir bir web sayfası, doğrudan çalınabilir bir ses dosyası anlamına gelmez. Sağlayıcının, kurulu müzik bağlantı bileşeni tarafından işlenebilmesi gerekir.
Nasıl düzeltirsin:
- Bağlantıyı ve müzik modunun desteklediği kaynakları kontrol et; sanatçı sayfaları, albüm sayfaları ve kısa bağlantılar için uygun bir bağlantı bileşeni gerekir.
- Genel bir sayfa yerine, açıkça desteklenen bir bağlantı biçimiyle herkese açık tek bir parçayı test et.
- Modlar bölümünde müzik modu ve kaynak bağlantı bileşenleri için uygun güncellemeleri kontrol et; değişikliklerden sonra sunucuyu yeniden başlat ve parçayı tekrar iste.
Plasmo Voice'ta bir sesli sohbet bağlantısı için anahtar verileri eksik
Mesaj şöyle görünür:
[PlasmoVoice] Failed to encode encryption data: <Fehler>
VoiceServerPlayerEntity(<Sitzungsdaten>) has empty public key
Arka planda ne oluyor: Plasmo Voice, sesli sohbet bağlantısı kurulurken anahtar verileri değiş tokuş eder. Açık anahtar, bağlantı verilerinin alıcı için şifrelenmesini sağlayan parçadır. Bu oturumda açık anahtar eksik olduğu için eklenti verileri hazırlayamıyor. Sorun yalnızca bu bağlantının sesli sohbetini etkiler; Minecraft çalışmaya devam eder.
Nasıl düzeltirsin:
- Etkilenen oyuncunun sunucudan çıkıp yeniden girmesini sağla. Ardından ses bağlantısının kurulup kurulmadığını kontrol et.
- İstemci ve sunucudaki Plasmo Voice sürümlerini geliştiricinin uyumluluk bilgileriyle karşılaştır. Sunucu durdurulmuşken Eklentiler bölümünden sunucu eklentisini güncelle, istemciyi de buna uygun şekilde güncelle.
- Hata devam ederse Dosyalar bölümünden
logs/latest.logdosyasındaki hata izinin tamamını oku. Sürümleri ve hataya giden adımları eklenti geliştiricisine bildir; bunu yaparken oturum verilerini anonimleştir.
ChunkVeil, koruması eksik olduğu için başlatmayı durduruyor
Mesaj şöyle görünür:
[ChunkVeil] Strict startup policy is stopping the server because ChunkVeil could not protect it.
Arka planda ne oluyor: ChunkVeil, dünya parçalarının aktarımı için korumasını kuramıyor. Bu nedenle katı başlatma kuralı tüm sunucuyu kapatıyor. Sunucu başarıyla başlayana kadar oyuncular yeniden giremez. Bu satırdan önceki ChunkVeil mesajları, kurulumun hangi bölümünün başarısız olduğunu açıklar.
Nasıl düzeltirsin:
- Durmadan önceki ChunkVeil mesajlarını Konsol bölümünde veya Dosyalar altındaki
logs/latest.logdosyasında oku. Sunucu hâlâ komut kabul ediyorsa/chunkveil verifykomutunu çalıştır. - Eklentiler ve Sürüm bölümlerinden ChunkVeil ile ProtocolLib'in kullandığın sunucu sürümüyle uyumlu olup olmadığını kontrol et. Mesajlarda belirtilen bağımlılığı veya ayarı düzelt; değişiklik yapmadan önce dosyaları yedekle.
- Sunucuyu tamamen yeniden başlat ve ChunkVeil'in aktif koruma bildirip bildirmediğini kontrol et. Hatayı gidermek yerine koruma kuralını devre dışı bırakma.
ChunkVeil: Çalışma zamanı koruması etkin değil
Mesaj şöyle görünür:
[ChunkVeil] Runtime protection is INACTIVE.
Arka planda ne oluyor: ChunkVeil, sunucu çalışırken korumasının aktif olmadığını bildiriyor. Bu durumda dünya parçalarına ait paket trafiği için öngörülen güvenlik önlemi devrede değildir. Asıl neden, bu mesajın çevresindeki tanılama mesajlarında yazar. Ayrıca katı başlatma kuralının da bildirilmesi durumunda sunucu bu yüzden durabilir.
Nasıl düzeltirsin:
- Konsol bölümünde veya Dosyalar altındaki
logs/latest.logdosyasında bu uyarıdan önceki ve sonraki ChunkVeil mesajlarını oku. Sunucu komut kabul ediyorsa/chunkveil verifykomutunu kullan. - ChunkVeil ve ProtocolLib'in desteklediği sürümleri Eklentiler bölümünde sunucunun Sürüm bilgisiyle karşılaştır. Tanılama raporunda belirtilen nedeni düzelt ve değişiklik yapmadan önce dosyaları yedekle.
- Sunucuyu tamamen yeniden başlat ve koruma durumunu tekrar kontrol et. Koruma hâlâ etkin değilse temizlenmiş tanılama mesajlarını ve ilgili sürümleri eklenti geliştiricisine bildir.
Mesajın burada yok mu?
Mesajın tamamını, önceki satırlarla birlikte Konsol bölümünde veya logs/latest.log dosyasında oku. Satır başındaki köşeli parantez içinde yer alan ad, örneğin [DiscordSRV], genellikle eklentiyi gösterir. Ad yoksa stack trace yardımcı olur: at … ile başlayan girintili satırlardaki paket ve klasör adları eklentiye veya moda işaret eder. Bir eklentinin hangi anahtarlara, token'lara veya portlara ihtiyaç duyduğunu proje sayfası açıklar. Yapılandırmayı değiştirmeden önce yedek al. Sorunu çözemezsen bir destek talebi aç ve mesajın saatini belirt.