Wiele pluginów nie działa samodzielnie. Pluginy premium sprawdzają przy starcie klucz licencyjny, integracje z Discordem, Telegramem czy VK potrzebują tokenu (czegoś w rodzaju hasła dla bota lub interfejsu), pluginy do czatu głosowego otwierają własny port sieciowy, a niektóre pobierają z internetu dodatkowe biblioteki lub bazy danych. Jeśli czegoś z tego brakuje albo zostanie to odrzucone, plugin zapisuje komunikat w logu. Zwykle przestaje działać tylko funkcja tego pluginu; w jednym przypadku plugin celowo zatrzymuje serwer.

Każda sekcja poniżej opisuje jeden komunikat. Pełny komunikat znajdziesz w zakładce Konsola lub w Pliki w logs/latest.log, a konfigurację pluginów w plugins/<Plugin>/. Zanim wprowadzisz w niej zmiany, utwórz kopię zapasową w zakładce Kopie zapasowe. Klucze i tokeny są tajne: nikomu ich nie pokazuj i wycinaj je ze zrzutów ekranu.

DonutShop odrzuca klucz licencyjny

Tak wygląda komunikat:

[DonutShop]             DONUTSHOP ERROR
[DonutShop] The licensing server rejected this key.

Co się za tym kryje: DonutShop to plugin sklepu, który przy starcie sprawdza swój klucz licencyjny na serwerze licencyjnym autora. Ta weryfikacja nie powiodła się przy ostatnim starcie. Nawet wpisana, niepusta wartość może być nieprawidłowa, wygasła lub wystawiona dla innej instalacji. Serwer Minecraft może przy tym działać dalej, ale DonutShop nie jest niezawodnie dostępny: gracze nie mogą polegać na sklepie.

Jak to naprawić:

  1. Zdobądź lub sprawdź darmowy klucz licencyjny na oficjalnej stronie projektu DonutShop na Modrinth.
  2. W sekcji Pliki otwórz konfigurację DonutShop (plugins/DonutShop/config.yml) i wpisz klucz przy license-key. Umieść go w cudzysłowie, bez spacji przed nim ani po nim.
  3. Zapisz plik i uruchom serwer ponownie.
  4. Sprawdź w Konsola: błąd jest naprawiony dopiero wtedy, gdy baner „DONUTSHOP ERROR” nie pojawia się już przy nowym starcie.

Dobrze wiedzieć: Jeśli przeniosłeś klucz z innego serwera, zdobądź osobny klucz dla tego serwera.

„Failed to load libraries”: LibreLogin zatrzymuje serwer podczas startu

Tak wygląda komunikat:

[LibreLogin] Failed to load libraries, stopping server to prevent damage
… Failed to download library <Biblioteka>

Co się za tym kryje: LibreLogin to plugin logowania, przez który gracze logują się hasłem. Podczas startu pobiera biblioteki, czyli fragmenty programu, których sam nie zawiera, m.in. PacketEvents. Jeśli to pobieranie się nie powiedzie, LibreLogin celowo zatrzymuje serwer, zamiast pozwolić mu działać tylko częściowo. Serwer nie uruchomi się więc, dopóki problem nie zostanie rozwiązany.

Jak to naprawić:

  1. Uruchom serwer ponownie. Jeśli źródło pobierania było tylko chwilowo niedostępne, kolejna próba często się udaje.
  2. Zaktualizuj LibreLogin w zakładce Pluginy do najnowszej wersji dla Twojego oprogramowania serwera. Jeśli masz PacketEvents zainstalowany jako osobny plugin, zaktualizuj również jego.
  3. Uruchom serwer ponownie i sprawdź w Konsola, czy biblioteki są teraz ładowane.
  4. Jeśli komunikat pojawia się przy każdym starcie, serwer nie może połączyć się z adresem pobierania. Przyczyną może być dostęp do internetu, rozwiązywanie nazw (DNS, które tłumaczy adresy na numery IP) albo sam adres. Jeśli nie wiesz, co dalej, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.

Dobrze wiedzieć: Jak aktualizować i wymieniać pluginy, pokazuje poradnik Instalowanie pluginów Minecraft i zarządzanie nimi.

„Packet queue has … packets”: Simple Voice Chat nie nadąża

Tak wygląda komunikat:

[voicechat] Packet queue has <Liczba> packets
[voicechat] Dropping voice chat packets!

Co się za tym kryje: Simple Voice Chat przesyła głos między graczami, którzy są blisko siebie w grze. Komunikat oznacza: czat głosowy nie nadąża z przetwarzaniem, pakiety głosowe gromadzą się w kolejce lub są odrzucane. Przyczyną jest chwilowo przeciążony serwer z niskim TPS (ticki na sekundę, takt Minecrafta; normalnie 20) lub wysokim obciążeniem CPU. Gracze słyszą wtedy urywany lub brakujący głos, podczas gdy sam serwer działa dalej.

Jak to naprawić:

  1. Sprawdź, co generuje obciążenie, na przykład za pomocą spark: spark: znajdowanie i rozumienie lagów na serwerze Minecraft.
  2. Zmniejsz zasięg widzenia (view-distance) i zasięg symulacji (simulation-distance) w sekcji Pliki w server.properties. Zapisz i uruchom ponownie, aby serwer ładował mniej chunków (fragmentów świata o wymiarach 16 × 16 bloków).
  3. Zmniejsz liczbę bytów (stworzeń, zwierząt, leżących przedmiotów) w pojedynczych miejscach i sprawdź pluginy, które generują duże obciążenie.
  4. Jeśli to nie wystarczy, przejdź w Ustawienia i abonament → Plan na wyższą wydajność.

Dobrze wiedzieć: Pojedyncze komunikaty krótko po starcie lub podczas eksplorowania nowych obszarów są nieszkodliwe, o ile ustają.

Simple Voice Chat nie może zająć swojego portu UDP

Tak wygląda komunikat:

[voicechat] Failed to run voice chat at UDP port <Port>
[voicechat] Disabling Simple Voice Chat

Co się za tym kryje: Simple Voice Chat przesyła głos przez własny port UDP. UDP to protokół sieciowy do szybkiego przesyłania danych w czasie rzeczywistym, takich jak głos. Ustawiony port nie należy do twojego serwera lub jest już zajęty, na przykład dlatego, że wciąż wpisana jest wartość domyślna z instrukcji pluginu. Bez portu czat głosowy się wyłącza; sama gra działa normalnie dalej.

Jak to naprawić:

  1. W sekcji Pliki otwórz plik plugins/voicechat/voicechat-server.properties. Jeśli używasz Simple Voice Chat jako moda, znajduje się on w config/voicechat/voicechat-server.properties.
  2. Ustaw port na numer portu twojego serwera. Twój port gry jest otwarty dla TCP i UDP.
  3. Zapisz plik i uruchom serwer ponownie.
  4. Sprawdź w Konsola, czy komunikat już się nie pojawia, i przetestuj czat głosowy w grze.

Szczegółowo: Konfiguracja Simple Voice Chat na serwerze Minecraft.

Dobrze wiedzieć: Port UDP może otworzyć jednocześnie tylko jeden program. Jeśli inny plugin używa już tego samego portu, na przykład Geyser dla graczy Bedrock, jeden z nich potrzebuje innego portu przypisanego do twojego serwera.

„No bot token”: logowanie do Discorda nie powiodło się

Tak wygląda komunikat:

[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.

Co się za tym kryje: Rozszerzenia Discorda logują się za pomocą własnego bota. Potrzebują do tego jego tokena, czyli tajnego ciągu znaków działającego jak hasło; jeśli go brakuje lub jest nieprawidłowy, połączenie z Discordem nie działa, podczas gdy Minecraft działa dalej; EssentialsDiscord wyłącza przy tym własne rozszerzenie. W przypadku voicechat-discord typy danych mogą być też nieprawidłowe: token musi być tekstem, a vc_id liczbą.

Jak to naprawić:

  1. Utwórz bota w Discord Developer Portal lub wybierz istniejącego. W razie potrzeby wygeneruj nowy token.
  2. Wpisz token w konfiguracji w sekcji Pliki: dla DiscordSRV w plugins/DiscordSRV/config.yml pod BotToken, dla DiscordWhitelist w plugins/DiscordWhitelist/config.yml pod discord.bot-token. W przypadku innych rozszerzeń obowiązuje ich instrukcja.
  3. W voicechat-discord token musi być ciągiem znaków, a vc_id liczbą wymaganą zgodnie z instrukcją.
  4. W razie potrzeby zaproś bota na swój serwer Discord, zapisz i uruchom Minecraft ponownie.

Dobrze wiedzieć: Nigdy nie udostępniaj tokena; jeśli wycieknie, zresetuj go. Przy błędach intents włącz w Developer Portal wymagane „Privileged Gateway Intents”.

„Could not download GeoLiteAPI database”: brak bazy danych krajów

Tak wygląda komunikat:

[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: <Domena>

Co się za tym kryje: Niektóre pluginy, na przykład AuthMe, pobierają bazę danych do przypisywania adresów IP do krajów; to pobieranie się nie powiodło. Przy FileNotFoundException z „No such file or directory” brakuje wskazanego pliku lokalnego lub powiązanego folderu. Przy UnknownHostException nie można rozwiązać nazwy hosta źródła pobierania. Plugin działa dalej; funkcje zależne od kraju pozostają bez bazy danych nieaktywne.

Jak to naprawić:

  1. Przy chwilowych problemach z pobieraniem następny restart spróbuje ponownie.
  2. Przy „No such file or directory” sprawdź w sekcji Pliki wskazaną lokalizację oraz ścieżkę w konfiguracji pluginu. Skonfiguruj bazę danych zgodnie z instrukcją dla twojej wersji pluginu.
  3. Przy UnknownHostException sprawdź w oficjalnej instrukcji pluginu, czy twoje wydanie pluginu i jego źródło pobierania są nadal aktualne. Przy zatrzymanym serwerze zaktualizuj plugin do odpowiedniego wydania.
  4. Jeśli twoja wersja pluginu wymaga klucza licencyjnego, wpisz swój ważny klucz w przewidzianym do tego polu konfiguracji.
  5. Zapisz, uruchom ponownie i sprawdź Konsola.

Dobrze wiedzieć: Jeśli nie korzystasz z funkcji zależnych od kraju, możesz zignorować ten komunikat. Pozostałe funkcje działają dalej.

DonutShop jest zablokowany bez klucza licencyjnego

Tak wygląda komunikat:

[DonutShop]             DONUTSHOP LOCKED
[DonutShop] No license key is set in config.yml.
[DonutShop] Then run: /link <your-key>

Co się za tym kryje: DonutShop uruchamia się tylko z kluczem licencyjnym. W jego config.yml nie wpisano żadnego klucza, dlatego sklep pozostaje zablokowany. Klucz jest darmowy, ale musisz go raz odebrać od autora. Sam serwer Minecraft nie jest tym dotknięty.

Jak to naprawić:

  1. Odbierz od autora pluginu darmowy klucz. Drogę do niego, link do Discorda, podaje komunikat w wierszach wokół banera.
  2. Wykonaj /link <twój-klucz>, tak jak wskazuje komunikat, albo wpisz klucz w plugins/DonutShop/config.yml.
  3. Uruchom serwer ponownie.
  4. Sprawdź w Konsola, czy baner „DONUTSHOP LOCKED” zniknął.

Warto wiedzieć: Jeśli potem pojawi się „DONUTSHOP ERROR”, klucz został odrzucony. Wtedy pomoże sekcja o odrzuconej licencji DonutShop.

Token VK pluginu zostaje odrzucony

Tak wygląda komunikat:

com.vk.api.sdk.exceptions.ApiAuthException: User authorization failed (5): User authorization failed: invalid access_token (4).

Co się za tym kryje: Niektóre pluginy łączą się z VK, siecią społecznościową VKontakte. Potrzebują do tego tokenu dostępu, czyli swego rodzaju hasła do interfejsu. VK odrzuciło wpisany token („invalid access_token”), więc jest on nieprawidłowy, wygasł albo został unieważniony. Funkcje VK pluginu są wyłączone, reszta serwera działa normalnie.

Jak to naprawić:

  1. Wygeneruj w VK nowy token dostępu z uprawnieniami, których wymaga plugin. Jakie to uprawnienia, znajdziesz w instrukcji pluginu.
  2. Otwórz w Pliki konfigurację pluginu w plugins/<Plugin>/ i zastąp stary token nowym.
  3. Zapisz plik i uruchom serwer ponownie.
  4. Sprawdź w Konsola, czy komunikat już się nie pojawia.

Warto wiedzieć: Którego pluginu to dotyczy, pokazuje stacktrace poniżej, czyli wcięte wiersze z at …. Obok com.vk.api pojawia się tam nazwa pakietu pluginu.

Plugin nie może udostępnić swojego resourcepacka

Tak wygląda komunikat:

java.io.IOException: HTTP 403 dla http://<adres>/<paczka>.zip
Failed to start resourcepack server: Server is not publicly reachable on <adres>:<port>

Co się za tym kryje: Niektóre pluginy dostarczają graczom własny resourcepack. W tym celu pobierają go z jakiegoś adresu, składają go samodzielnie albo uruchamiają mały wbudowany serwer WWW, z którego gracze go pobierają. Jeden z tych kroków się nie powiódł. Gracze nie dostają wtedy paczki, a tekstury lub funkcje, które od niej zależą, są niedostępne. Serwer działa dalej.

Jak to naprawić:

  1. Odczytaj status HTTP w komunikacie: 403 oznacza odmowę dostępu, 404 oznacza, że nie znaleziono pliku.
  2. Otwórz w przeglądarce adres paczki z konfiguracji pluginu. Musi on od razu pobierać plik ZIP i nie może wyświetlać strony podglądu ani logowania.
  3. Popraw adres albo wgraj paczkę w miejsce, które udostępnia ją publicznie.
  4. Jeśli plugin korzysta z wbudowanego serwera WWW, wpisz tam tylko port przypisany do twojego serwera w panelu i publicznie dostępny.
  5. Uruchom serwer ponownie.

„accessToken=MISSING”: brakuje klucza API lub tokenu

Tak wygląda komunikat:

Please set your <usługa> API key
accessToken=MISSING
[BedrockVoiceChat] Config validation failed: useEmbeddedServer=false, bvcServer=MISSING, accessToken=MISSING

Co się za tym kryje: Plugin współpracuje z zewnętrzną usługą i potrzebuje do tego klucza API lub danych dostępowych. Klucz API lub token identyfikuje plugin w tej usłudze. Jeśli tych danych brakuje, plugin nie działa; reszta serwera działa dalej. W BedrockVoiceChat useEmbeddedServer=false oznacza zewnętrzny tryb pracy: przy bvcServer=MISSING brakuje dodatkowo adresu serwera usługi głosowej.

Jak to naprawić:

  1. Przeczytaj cały komunikat i instrukcję pluginu: podają one wymagane pola i używaną usługę.
  2. Zdobądź klucz lub token zgodnie z instrukcją usługi. W przypadku usług hostowanych samodzielnie przejmij dane dostępowe z ich konfiguracji.
  3. Otwórz w Pliki wskazaną konfigurację pluginu i wpisz brakujące wartości. W BedrockVoiceChat w zewnętrznym trybie pracy potrzebujesz zarówno bvcServer, jak i accessToken. Zachowaj obowiązujący format pliku i wcięcia.
  4. Zapisz plik i uruchom serwer ponownie.

Warto wiedzieć: Jeśli plugin zgłosi potem, że nie może odczytać pliku, pomoże Plik konfiguracyjny pluginu jest błędny.

„No License Key Found”: plugin nie znajduje prawidłowego klucza licencyjnego

Tak wygląda komunikat:

No License Key Found!
[<Plugin>] No valid product license found in config!
Authentication failed! API key is invalid

Co się za tym kryje: To plugin premium albo plugin, który wymaga klucza od dostawcy, i nie znajduje w swojej konfiguracji prawidłowego klucza. Wtedy całkowicie się wyłącza lub wyłącza poszczególne funkcje. Serwer działa dalej, tylko bez funkcji tego pluginu.

Jak to naprawić:

  1. Odszukaj klucz z Twojego zakupu, np. na koncie na stronie, na której kupiłeś plugin, albo zapytaj dostawcę.
  2. W zakładce Pliki otwórz plik wskazany w komunikacie, zwykle plugins/<Plugin>/license.yml lub plugins/<Plugin>/config.yml, i wpisz klucz.
  3. Zapisz plik i uruchom serwer ponownie.
  4. Jeśli nie masz klucza, usuń plugin w zakładce Pluginy, zamiast zostawiać go na stałe z błędami.

Dobrze wiedzieć: Pobieraj pluginy premium wyłącznie z oficjalnej strony sprzedaży. Wersje z nieoficjalnych źródeł, z których usunięto sprawdzanie licencji, nierzadko zawierają złośliwe oprogramowanie.

Bot Telegram pluginu się nie uruchamia

Tak wygląda komunikat:

Error removing old webhook

Co się za tym kryje: Plugin z integracją Telegrama loguje się przy starcie do Telegrama za pomocą bota. Najpierw usuwa przy tym stary webhook, czyli zapisany adres, na który Telegram wysyłałby nowe wiadomości. To się nie udało, najczęściej dlatego, że token bota jest nieprawidłowy albo Telegram był chwilowo niedostępny. Funkcja Telegrama pozostaje wyłączona, serwer Minecraft działa normalnie dalej.

Jak to naprawić:

  1. Otwórz w Telegramie czat z @BotFather i wyświetl token swojego bota albo wygeneruj nowy.
  2. Otwórz w Pliki konfigurację pluginu w plugins/<Plugin>/ i zastąp token. Skopiuj go w całości, token bota zaczyna się od liczby i dwukropka.
  3. Zapisz plik i uruchom serwer ponownie.
  4. Sprawdź w Konsola, czy komunikat już się nie pojawia.

Warto wiedzieć: Jeśli komunikat pojawia się tylko raz i przy następnym starcie już go nie ma, Telegram był chwilowo niedostępny. Wtedy nie musisz niczego zmieniać.

„Failed to bind”: plugin nie może otworzyć własnego portu sieciowego

Tak wygląda komunikat:

Failed to bind to /<Adres>:<Port>
[PlasmoVoice] Failed to start the udp server
io.netty.channel.unix.Errors$NativeIoException: bind(..) failed with error(-99): Cannot assign requested address

Co się za tym kryje: Niektóre pluginy otwierają własny port sieciowy, np. dla czatu głosowego, takiego jak Plasmo Voice, albo dla strony internetowej z mapą lub statystykami. Ustawiony adres lub port nie jest dostępny na Twoim serwerze: port nie jest do niego przypisany, jest już zajęty albo w konfiguracji wpisano stały adres IP, którego serwer nie może w ten sposób użyć. „Cannot assign requested address” wskazuje na ten ostatni przypadek. Funkcja pluginu pozostaje wyłączona, reszta serwera działa dalej.

Jak to naprawić:

  1. W zakładce Pliki otwórz konfigurację pluginu w plugins/<Plugin>/ i znajdź wpisy dotyczące portu i adresu.
  2. Wpisz port, który jest przypisany do Twojego serwera w panelu i jest jeszcze wolny.
  3. Zostaw adres pusty albo ustaw 0.0.0.0. Oznacza to: dostępny na wszystkich interfejsach sieciowych serwera.
  4. Zapisz plik, uruchom serwer ponownie i sprawdź w Konsola, czy komunikat już się nie pojawia.

Dobrze wiedzieć: Dany port może otworzyć tylko jeden program naraz. Jeśli dwa pluginy używają tego samego portu, każdy potrzebuje własnego. Więcej o portach: Sprawdzanie portów Minecraft i błędów połączenia.

„Address already in use”: port czatu głosowego, RCON lub usługi dodatkowej jest zajęty

Tak wygląda komunikat:

Unable to initialise RCON on <Adres>:<Port>
Failed to start the udp server … Address already in use
[voicechat] Voice chat server error … java.net.BindException: Address already in use

Co się za tym kryje: Plugin lub usługa dodatkowa, taka jak czat głosowy, własna strona internetowa, Query albo RCON, próbuje otworzyć port, który jest już zajęty. Często w jej konfiguracji wpisany jest port gry. Problem może dotyczyć także modów czatu głosowego na Fabric. Serwer działa dalej i gracze mogą dołączać, nie działa tylko ta jedna funkcja.

Jak to naprawić:

  1. Przeczytaj w Konsola linie przed błędem. Wskazują one plugin lub usługę, np. RCON albo czat głosowy.
  2. Otwórz w zakładce Pliki konfigurację wskazanego pluginu lub moda. W przypadku Query i RCON wpisy query.port i rcon.port znajdują się w server.properties.
  3. Wpisz port przypisany do twojego serwera, który nie jest portem gry i nie jest używany przez żadną inną usługę dodatkową.
  4. Dla Simple Voice Chat i innych obsługiwanych pluginów kreatory w zakładce Pluginy automatycznie ustawiają wolny port.
  5. Zapisz, uruchom serwer ponownie i sprawdź Konsola.

Dobrze wiedzieć: Sam restart nie pomoże, dopóki wpisany jest ten sam zajęty port. Więcej na ten temat: Sprawdź porty Minecraft i błędy połączenia.

DonatePay: niedozwolony znak w adresie zapytania

Tak wygląda komunikat:

java.net.URISyntaxException: Illegal character in query at index <Pozycja>: <Adres z usuniętym tokenem>

Co się za tym kryje: Integracja DonatePay próbuje pobrać nowe darowizny, ale nie potrafi przetworzyć zbudowanego w tym celu adresu. URI to adres o określonej strukturze; jego część z zapytaniem zawiera tutaj niedozwolony znak. Przez to pobieranie darowizn się nie udaje, a serwer Minecraft działa dalej.

Jak to naprawić:

  1. Otwórz Konsola albo logs/latest.log w zakładce Pliki i sprawdź, czy ślad błędu wskazuje na integrację DonatePay.
  2. Sprawdź konfigurację pluginu w zakładce Pliki. Porównaj wpisane dane dostępowe z instrukcją i usuń przypadkowo skopiowane spacje lub cudzysłowy.
  3. Zaktualizuj integrację w zakładce Pluginy albo podmień samodzielnie wgrany plik w zakładce Pliki. Uruchom serwer całkowicie od nowa.
  4. Jeśli komunikat nadal się pojawia, przekaż autorowi pluginu oczyszczony ślad błędu. Zanim go udostępnisz, usuń wszystkie wartości tokenów.

Plugin plecaka nie może użyć swojej paczki zasobów

Tak wygląda komunikat:

[ᴠᴢʙᴀᴄᴋᴘᴀᴄᴋ] Die URL der Datei '<Plik>.zip' ist ungültig!

Co się za tym kryje: Plugin nie może użyć ustawionego pliku paczki zasobów. Albo adres jest nieprawidłowy, albo zewnętrzna paczka została rozpoznana jako uszkodzona. W efekcie plecak wyświetla się z błędnymi lub brakującymi teksturami i czcionkami; serwer działa dalej.

Jak to naprawić:

  1. Sprawdź w zakładce Pliki w konfiguracji pluginu, jaki plik paczki i adres są ustawione.
  2. Porównaj plik z instrukcją dla twojej wersji pluginu. Użyj prawidłowego bezpośredniego adresu pobierania i kompletnego, pasującego archiwum.
  3. Uruchom serwer całkowicie od nowa. Pozwól klientowi ponownie pobrać poprawioną paczkę i sprawdź tekstury plecaka oraz czcionki.

libdatachannel: nie udaje się połączenie kanału danych lub wysyłanie

Tak wygląda komunikat:

[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

Co się za tym kryje: libdatachannel to biblioteka do połączeń danych. SCTP to używany przy tym protokół transmisji. Połączenie nie zostaje nawiązane lub nie może już wysyłać danych; połączenie danego pluginu lub moda przestaje działać. Serwer gry działa dalej.

Jak to naprawić:

  1. Spróbuj ponownie nawiązać dane połączenie. Sprawdź, czy nie udaje się tylko pojedyncze dołączenie, czy kilka połączeń.
  2. Przeczytaj w Konsola linie przed komunikatem i po nim. Przypisz bibliotekę do wskazanego tam pluginu lub moda.
  3. Porównaj jego ustawienia sieciowe i wymagania z dokumentacją. Sprawdź zwłaszcza przewidziane tam porty i dostępność drugiej strony połączenia.
  4. Sprawdź w zakładce Pluginy lub Mody, czy jest dostępna odpowiednia aktualizacja. Jeśli błąd nie ustępuje, otwórz zgłoszenie i podaj godzinę oraz towarzyszące komunikaty.

Netty: powiadomienie sieciowe trafia na zakończony wykonawca

Tak wygląda komunikat:

Failed to submit a listener notification task. Event loop shut down?
java.util.concurrent.RejectedExecutionException: event executor terminated

Co się za tym kryje: Netty przetwarza zadania sieciowe w pętli zdarzeń. Tutaj pętla została już zakończona, a mimo to ma zostać dodane do kolejki kolejne powiadomienie. Powiadomienie zostaje odrzucone. Podczas zatrzymywania serwera może to być błąd towarzyszący; w trakcie gry może to zakłócać działanie funkcji sieciowej.

Jak to naprawić:

  1. Sprawdź godzinę w Konsola i porównaj ją z momentem uruchamiania lub zatrzymywania serwera.
  2. Jeśli błąd występuje podczas normalnej pracy, zapisz pełny komunikat z logs/latest.log wraz z wcześniejszymi błędami. Kolejne linie wywołań to tzw. stacktrace, który może wskazać zaangażowany komponent.
  3. Sprawdź przypisany komponent w zakładce Pluginy oraz Wersja serwera pod kątem wzajemnie pasujących aktualizacji. Podmieniaj pliki przy zatrzymanym serwerze.
  4. Uruchom serwer całkowicie od nowa i ponów dane połączenie. Jeśli błąd nie ustępuje, otwórz zgłoszenie z godziną i pełnym komunikatem.

Lavalink nie może wczytać utworu z YouTube bez logowania

Tak wygląda komunikat:

dev.lavalink.youtube.AllClientsFailedException: All clients failed to load the item.
Client [<Klient>] failed: This video requires login.

Co się za tym kryje: Funkcja muzyczna korzysta z Lavalinka, usługi do wczytywania i odtwarzania dźwięku. Jego rozszerzenie YouTube otrzymuje dla żądanego utworu odpowiedź, że wymagane jest logowanie. Ten utwór nie zostanie wczytany; serwer gry działa dalej.

Jak to naprawić:

  1. Sprawdź, czy utwór jest dostępny na YouTube bez logowania. Dla porównania spróbuj innego publicznie dostępnego utworu.
  2. Przeczytaj pełny komunikat w Konsola lub w logs/latest.log. Zanotuj wersje moda muzycznego i jego integracji z YouTube.
  3. Sprawdź w dokumentacji tych komponentów, czy są dostępne odpowiednie aktualizacje. Zatrzymaj serwer przed wymianą w sekcji Mody, a następnie uruchom go ponownie.
  4. Jeśli pobieranie nadal nie działa, zgłoś ślad błędu autorowi. Usuń z raportu dane osobowe i dane dostępowe.

ForcePack: sprawdź link do paczki zasobów

Tak wygląda komunikat:

[ForcePack] Your URL has an invalid or unknown format.
URLs must have no redirects and use the .zip extension.

Co się za tym kryje: ForcePack sprawdza ustawiony link do pobrania paczki zasobów. Link nie odpowiada oczekiwanemu bezpośredniemu formatowi ZIP albo nie zostaje rozpoznany przez weryfikację. ForcePack mimo to się uruchamia; weryfikacja może zakwestionować również działający link. Decydujące jest to, czy klient faktycznie może pobrać paczkę.

Jak to naprawić:

  1. Przetestuj skonfigurowany link bez logowania. Powinien on bezpośrednio dostarczać plik ZIP, bez strony podglądu i bez przekierowania.
  2. Zatrzymaj serwer i zabezpiecz konfigurację ForcePacka w sekcji Pliki.
  3. Wpisz odpowiedni bezpośredni link do pobrania i uruchom serwer ponownie. Następnie przetestuj pobieranie paczki zasobów za pomocą klienta.
  4. Jeśli pobieranie działa już z zakwestionowanym linkiem, zgłoś autorowi pluginu rodzaj linku i wersję ForcePacka.

e4mc nie może nawiązać połączenia tunelowego

Tak wygląda komunikat:

error in e4mc
bind(..) failed: Address family not supported by protocol

Co się za tym kryje: e4mc nie może otworzyć potrzebnego gniazda sieciowego, ponieważ wybrana rodzina adresów nie jest obsługiwana w środowisku uruchomieniowym. Połączenie tunelowe e4mc się nie udaje; sam serwer Minecraft może działać dalej. Gniazdo (socket) to dostęp programu do sieci. Ten komunikat różni się od zajętego już portu.

Jak to naprawić:

  1. Sprawdź w konsoli, czy Address family not supported by protocol pojawia się bezpośrednio w błędzie e4mc.
  2. Sprawdź w sekcji Mody wersję e4mc pasującą do twojego loadera oraz jej wskazówki dotyczące serwerów dedykowanych; przed zmianami utwórz kopię w sekcji Kopie zapasowe.
  3. Jeśli nie korzystasz z tunelu e4mc, usuń moda przy zatrzymanym serwerze i uruchom go ponownie; jeśli go potrzebujesz, otwórz zgłoszenie z komunikatem błędu i godziną jego wystąpienia.

Funkcja muzyczna nie może pobrać utworu

Tak wygląda komunikat:

Error in loading item <Zapytanie o muzykę>
FriendlyException: Something went wrong when looking up the track

Co się za tym kryje: Biblioteka muzyczna Lavaplayer nie może odnaleźć ani wczytać żądanego utworu. To życzenie muzyczne kończy się niepowodzeniem; serwer Minecraft i inne funkcje gry działają dalej. Ślad błędu pokazuje zaangażowane wywołania programu. Dokładniejsze informacje o dostawcy często znajdują się we wcześniejszych komunikatach tego samego zapytania.

Jak to naprawić:

  1. Sprawdź w konsoli komunikaty bezpośrednio przed śladem błędu oraz to, czy przekazano wyszukiwanie, czy bezpośredni link do multimediów.
  2. Przetestuj inny dostępny utwór ze źródła obsługiwanego przez mod muzyczny; sprawdź też, czy pierwotny utwór jest publicznie dostępny.
  3. W sekcji Mody dopasuj mod muzyczny i jego zależności do zgodnych wersji, a po zmianie uruchom serwer w pełni ponownie.

Link muzyczny nie dostarcza obsługiwanego formatu audio

Tak wygląda komunikat:

URL resolution failed [UNKNOWN] url=<Link do multimediów> detail=FriendlyException: Unknown file format.

Co się za tym kryje: Funkcja muzyczna nie rozpoznaje pod przekazanym linkiem obsługiwanego formatu audio. Żądany utwór lub podlinkowana kolekcja nie zostanie więc wczytana; serwer gry działa dalej. Dostępna strona internetowa to jeszcze nie bezpośrednio odtwarzalny plik audio. Dostawca musi być obsługiwany przez zainstalowaną integrację muzyczną.

Jak to naprawić:

  1. Sprawdź link oraz źródła obsługiwane przez twój mod muzyczny; strony artystów, strony albumów i skrócone linki wymagają odpowiedniej integracji.
  2. Przetestuj pojedynczy, publicznie dostępny utwór z wyraźnie obsługiwaną formą linku zamiast strony przeglądowej.
  3. Sprawdź w sekcji Mody, czy są odpowiednie aktualizacje moda muzycznego i jego integracji ze źródłami; po zmianach uruchom serwer ponownie i powtórz pobieranie.

Plasmo Voice brakuje danych klucza dla połączenia czatu głosowego

Tak wygląda komunikat:

[PlasmoVoice] Failed to encode encryption data: <Błąd>
VoiceServerPlayerEntity(<Dane sesji>) has empty public key

Co się za tym kryje: Plasmo Voice wymienia dane klucza podczas konfigurowania połączenia czatu głosowego. Klucz publiczny to ta część, za pomocą której dane połączenia są szyfrowane dla odbiorcy. W tej sesji go brakuje, dlatego plugin nie może przygotować danych. Problem dotyczy czatu głosowego tego połączenia; Minecraft działa dalej.

Jak to naprawić:

  1. Poproś gracza, którego to dotyczy, aby opuścił serwer i dołączył ponownie. Następnie sprawdź, czy połączenie głosowe zostaje nawiązane.
  2. Porównaj wersje Plasmo Voice na kliencie i serwerze z informacjami o kompatybilności podanymi przez autora. Zaktualizuj plugin serwerowy w sekcji Pluginy przy zatrzymanym serwerze, a klienta odpowiednio do niego.
  3. Jeśli błąd nadal występuje, przeczytaj pełny ślad błędu w logs/latest.log w sekcji Pliki. Zgłoś autorowi pluginu wersje oraz kroki prowadzące do błędu; zanonimizuj przy tym dane sesji.

ChunkVeil zatrzymuje uruchamianie, bo brakuje jego ochrony

Tak wygląda komunikat:

[ChunkVeil] Strict startup policy is stopping the server because ChunkVeil could not protect it.

Co się za tym kryje: ChunkVeil nie może skonfigurować swojej ochrony przesyłania fragmentów świata. Jego rygorystyczna reguła uruchamiania wyłącza więc cały serwer. Gracze mogą ponownie dołączyć dopiero wtedy, gdy serwer uruchomi się pomyślnie. Wcześniejsze komunikaty ChunkVeil wyjaśniają, która część konfiguracji się nie powiodła.

Jak to naprawić:

  1. Przeczytaj komunikaty ChunkVeil sprzed zatrzymania w Konsola lub w logs/latest.log w sekcji Pliki. Wykonaj /chunkveil verify, jeśli serwer nadal przyjmuje polecenia.
  2. Sprawdź w sekcjach Pluginy i Wersja, czy ChunkVeil i ProtocolLib pasują do używanej wersji serwera. Napraw konkretnie wskazaną zależność lub ustawienie; przed zmianami zrób kopię plików.
  3. Uruchom serwer całkowicie od nowa i sprawdź, czy ChunkVeil zgłasza aktywną ochronę. Nie omijaj reguły ochrony zamiast naprawienia błędu.

ChunkVeil: ochrona w czasie działania jest nieaktywna

Tak wygląda komunikat:

[ChunkVeil] Runtime protection is INACTIVE.

Co się za tym kryje: ChunkVeil zgłasza, że jego ochrona podczas działania serwera nie jest aktywna. Brakuje więc przewidzianego zabezpieczenia ruchu pakietów dla fragmentów świata. Konkretna przyczyna jest podana w sąsiednich komunikatach diagnostycznych. Dodatkowo zgłoszona rygorystyczna reguła uruchamiania może z tego powodu zatrzymać serwer.

Jak to naprawić:

  1. Przeczytaj w Konsola lub w sekcji Pliki w logs/latest.log komunikaty ChunkVeil przed tym ostrzeżeniem i po nim. Użyj /chunkveil verify, jeśli serwer przyjmuje polecenia.
  2. Porównaj obsługiwane wersje ChunkVeil i ProtocolLib w sekcji Pluginy z Wersja serwera. Usuń przyczynę wskazaną w raporcie diagnostycznym i przed zmianami zrób kopię plików.
  3. Uruchom serwer całkowicie od nowa i ponownie sprawdź stan ochrony. Jeśli nadal jest nieaktywna, zgłoś autorowi pluginu oczyszczone komunikaty diagnostyczne oraz użyte wersje.

MinecraftAIChatbot nie odpowiada: wszystkie modele AI zawiodły

Tak wygląda komunikat:

[MinecraftAIChatbot] [minecraft-ai-chatbot] all <Liczba> models exhausted, giving up on this request

Co się za tym kryje: Plugin wysyła zapytania z czatu do usługi AI. Jeśli jakiś model jest niedostępny, próbuje następnego wpisanego modelu. Tutaj zawiodły wszystkie modele, dlatego zapytanie pozostaje bez odpowiedzi. Typowe przyczyny to nieprawidłowy klucz API, wyczerpany limit albo dostawca, który jest akurat niedostępny. Serwer działa dalej, brakuje tylko odpowiedzi chatbota.

Jak to naprawić:

  1. W zakładce Pliki otwórz folder pluginu i sprawdź w konfiguracji klucze API oraz nazwy modeli.
  2. Zaloguj się u dostawcy AI i sprawdź, czy Twój klucz jest ważny i czy limit wystarcza.
  3. Sprawdź stronę statusu dostawcy, czy usługa nie ma akurat zakłóceń.
  4. Uruchom serwer ponownie, aby plugin wczytał zmienioną konfigurację.

Dobrze wiedzieć: Jeśli komunikat pojawia się tylko sporadycznie, dostawca był zwykle chwilowo przeciążony.

NSR-AI: Brak aktywnego klucza API do połączenia z AI

Tak wygląda komunikat:

[NSR-AI] No active API keys found. AI functionality will be limited.

Co się za tym kryje: NSR-AI nie może znaleźć aktywnego klucza API. Taki klucz pozwala pluginowi korzystać z zewnętrznej usługi AI. Bez niego funkcje AI są ograniczone. Serwer Minecraft nadal działa.

Jak to naprawić:

  1. Sprawdź w dokumentacji NSR-AI, jakiego dostawcę i jakie ustawienia obsługuje twoja wersja pluginu.
  2. Otwórz konfigurację pluginu w zakładce Pliki. Sprawdź, czy przewidziany klucz jest wpisany i aktywowany zgodnie z instrukcją.
  3. Sprawdź u dostawcy, czy używany klucz jest nadal ważny. Wpisuj ważny klucz wyłącznie w przeznaczone do tego pole.
  4. Po poprawce uruchom serwer całkowicie od nowa. Sprawdź w Konsola, czy komunikat zniknął, i przetestuj wybraną funkcję AI.

Dobrze wiedzieć: Klucze API to dane dostępowe. Usuń je z komunikatów o błędach i fragmentów konfiguracji, zanim komukolwiek je przekażesz.

SimpleCloud: API odrzuca żądania bez danych dostępowych

Tak wygląda komunikat:

app.simplecloud.api.CloudApiException: Authorization header or X-Network-Credential header is required (401)

Co się za tym kryje: API, czyli interfejs do zarządzania SimpleCloud, oczekuje danych logowania w nagłówku każdego żądania. Tutaj ich brakuje, dlatego odpowiedź zawiera status HTTP 401. Dotknięte placeholdery i aktualizacje danych chmury kończą się niepowodzeniem. Serwer Minecraft działa dalej.

Jak to naprawić:

  1. Przeczytaj w Konsola wcześniejsze komunikaty startowe pluginów SimpleCloud. Sprawdź, które żądanie zostaje odrzucone.
  2. Porównaj konfigurację połączenia z chmurą z dokumentacją Twojej wersji SimpleCloud. Sprawdź zwłaszcza, czy przewidziane dane dostępowe są dostarczane.
  3. Zrób kopię dotkniętych plików konfiguracyjnych w Pliki, zanim zmienisz je przy zatrzymanym serwerze. Następnie uruchom serwer ponownie w całości.
  4. Ponownie sprawdź placeholdery i aktualizacje. Jeśli nie możesz sobie poradzić, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu. Zamaż klucze i tokeny w dołączonych logach.

DiscordStatus nie ma uprawnień do wysyłania wiadomości

Tak wygląda komunikat:

[DiscordStatus] Failed to send lifecycle message
InsufficientPermissionException: Missing permission: MESSAGE_SEND

Co się za tym kryje: DiscordStatus próbuje wysłać na Discord komunikat o uruchomieniu, zatrzymaniu lub inny komunikat o statusie. Bot nie ma na kanale docelowym wymaganego uprawnienia do wysyłania wiadomości. Przez to wiadomość nie zostaje wysłana; może też nie powieść się inicjalizacja połączenia. Serwer Minecraft działa dalej.

Jak to naprawić:

  1. Sprawdź w Pliki w konfiguracji DiscordStatus, który kanał jest ustawiony jako docelowy.
  2. Otwórz uprawnienia tego kanału na Discordzie. Zezwól roli bota na wyświetlanie kanału i wysyłanie wiadomości.
  3. Skontroluj nadpisania uprawnień na poziomie kanału dla roli i samego bota. Blokada w tym miejscu może zniweczyć poza tym prawidłowe uprawnienia roli.
  4. Uruchom serwer Minecraft ponownie w całości i sprawdź w Konsola, czy DiscordStatus może wysłać swój komunikat o statusie.

SimpleCloud: logowanie do usługi komunikatów NATS odrzucone

Tak wygląda komunikat:

[app.simplecloud.api.shaded.nats.client.impl.ErrorListenerLoggerImpl] errorOccurred, Connection: <Identyfikator>, Error: Authorization Violation

Co się za tym kryje: NATS to usługa komunikatów, przez którą SimpleCloud wymienia informacje. Usługa odpowiada, ale nie akceptuje logowania tego połączenia. Komunikacja z chmurą, która przez nie przebiega, przestaje działać. Serwer Minecraft działa dalej.

Jak to naprawić:

  1. Przeczytaj komunikaty startowe połączenia SimpleCloud w Konsola i poszukaj dodatkowych informacji o nawiązywaniu połączenia.
  2. Na podstawie dokumentacji Twojej wersji SimpleCloud sprawdź, czy przewidziana usługa NATS i jej dane dostępowe są wpisane.
  3. Porównaj używane pluginy chmury w Pluginy z konfiguracją chmury. Przed zmianami zrób kopię plików konfiguracyjnych w Pliki i edytuj je przy zatrzymanym serwerze.
  4. Uruchom serwer ponownie w całości i jeszcze raz sprawdź połączenie. Jeśli nie możesz sobie poradzić, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu. Udostępniaj dane dostępowe wyłącznie zamazane.

SimpleCloud: przekroczenie czasu w usłudze komunikatów NATS

Tak wygląda komunikat:

[app.simplecloud.api.shaded.nats.client.impl.ErrorListenerLoggerImpl] exceptionOccurred, Connection: <Identyfikator>, Exception: java.util.concurrent.TimeoutException

Co się za tym kryje: NATS to usługa komunikatów używana do komunikacji SimpleCloud. Jedna z operacji tego połączenia nie została ukończona w wyznaczonym limicie czasu. Dotknięta wymiana komunikatów kończy się niepowodzeniem, a serwer Minecraft działa dalej. Kolejne linie pokazują, czy połączenie jest potem ponownie dostępne.

Jak to naprawić:

  1. Przeczytaj w Konsola linie przed przekroczeniem czasu i po nim. Sprawdź, czy później pojawia się informacja o udanym połączeniu.
  2. Jeśli połączenie zostało przywrócone, obserwuj, czy komunikat pojawia się ponownie i czy funkcje chmury znów działają.
  3. Jeśli problem się powtarza, sprawdź na podstawie dokumentacji Twojej wersji chmury ustawioną usługę NATS i jej dostępność. Przed zmianami zrób kopię plików w Pliki i zatrzymaj serwer przed edycją.
  4. Jeśli nie możesz sobie poradzić, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu oraz dotkniętą funkcję chmury. Zamaż dane dostępowe w dołączonych logach.

SimpleCloud nie może przypisać serwera dla placeholderów

Tak wygląda komunikat:

Failed to load server placeholder for target <Gracz>
java.lang.IllegalStateException: SIMPLECLOUD_UNIQUE_ID environment variable is not set

Co się za tym kryje: Placeholder to fragment tekstu, który plugin zastępuje aktualnymi wartościami. Do swoich placeholderów serwera SimpleCloud potrzebuje identyfikatora bieżącego serwera w chmurze. Jest on przekazywany przez zmienną środowiskową, której tutaj brakuje. Dotknięte wartości nie mogą zostać wyświetlone; serwer Minecraft działa dalej.

Jak to naprawić:

  1. Sprawdź w Konsola, które placeholdery SimpleCloud nie są rozwiązywane i które pluginy ich żądają.
  2. Jeśli korzystasz z SimpleCloud, porównaj pełne połączenie serwera z dokumentacją Twojej wersji. Identyfikator musi należeć do konfiguracji chmury.
  3. Jeśli nie korzystasz z połączenia z chmurą, zrób kopię dotkniętych plików wyświetlania w Pliki i usuń z nich placeholdery SimpleCloud przy zatrzymanym serwerze.
  4. Po zmianach uruchom serwer ponownie w całości i sprawdź wyświetlanie. Jeśli nie możesz sobie poradzić, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.

Nie ma tu Twojego komunikatu?

Przeczytaj cały komunikat w zakładce Konsola lub w logs/latest.log, łącznie z wierszami przed nim. Nazwa w nawiasach kwadratowych na początku wiersza, na przykład [DiscordSRV], zwykle wskazuje plugin. Jeśli jej brakuje, pomoże stacktrace: we wciętych wierszach z at … znajdują się nazwy pakietów i folderów, które wskazują na plugin lub mod. Jakich kluczy, tokenów lub portów potrzebuje plugin, wyjaśnia jego strona projektu. Zanim zmienisz konfigurację, utwórz kopię zapasową. Jeśli utkniesz, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.