Pluginy zapisują swoje ustawienia zwykle w plikach YAML w folderze plugins/<Plugin>/. YAML to format tekstowy, który buduje swoją strukturę za pomocą wcięć ze spacji. Wystarczy jeden tabulator lub brakujący cudzysłów, aby plugin nie mógł już odczytać pliku. Każda sekcja poniżej omawia jeden komunikat. Jeśli trafiłeś tu przez „Dowiedz się więcej” z Kondycja serwera, jesteś już we właściwym miejscu.

Pełny tekst znajdziesz w Konsola lub w Pliki w logs/latest.log. Prawie zawsze podaje on plik, często także wiersz i kolumnę. Pod nim często znajduje się stacktrace, czyli lista wciętych wierszy at, która pokazuje, w którym miejscu programu powstał błąd. Przed każdą zmianą plików konfiguracyjnych lub plików świata utwórz kopię zapasową w Kopie zapasowe. Najlepiej edytuj pliki przy zatrzymanym serwerze, ponieważ niektóre pluginy nadpisują swoją konfigurację przy wyłączaniu.

Błąd składni YAML w pliku pluginu

Tak wygląda komunikat:

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

Co się za tym kryje: Plugin nie może odczytać swojej konfiguracji YAML. YAML to format tekstowy, którego struktura zależy od wcięć. while parsing a block mapping i expected <block end> wskazują na błędną strukturę, a sequence entries are not allowed here na źle umieszczony element listy. Przy could not find expected ':' między kluczem a wartością może brakować dwukropka lub spacji po nim. W zależności od pluginu brakuje części ustawień albo całego pluginu.

Jak to naprawić:

  1. Otwórz wskazany plik w zakładce Pliki. Przy Cannot load configuration from stream poszukaj pluginu i jego konfiguracji w sąsiednich wierszach logu.
  2. Sprawdź zgłoszony wiersz i wcześniejsze wpisy. line i column podają wiersz i kolumnę, ale przyczyna może leżeć wyżej.
  3. Do wcięć używaj spacji zamiast tabulatorów. Wpisy na tym samym poziomie wyrównuj tak samo, a elementy listy z - umieszczaj w osobnych wierszach.
  4. Oddzielaj klucze i proste wartości dwukropkiem i spacją, np. admin-only: false. Wartości tekstowe zaczynające się od znaków specjalnych, takich jak &, { czy backticki, ujmij w cudzysłów. Zamykaj cudzysłowy i usuń skopiowane przypadkiem ramki Markdown z trzech backticków.
  5. Sprawdź plik walidatorem YAML i zrestartuj serwer. Przed sprawdzaniem online usuń z pliku tajne wartości.

„Could not deserialize” lub „unknown world”: nie można odczytać wpisu w pliku pluginu

Tak wygląda komunikat:

[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

Co się za tym kryje: Pluginy zapisują przedmioty (kity, towary w sklepach, elementy menu) i miejsca (domy, warpy, punkty spawnu) jako bloki danych w swoich plikach YAML. Przedmiotu zapisanego w starszej wersji Minecrafta czasem nie da się już wczytać w obecnym formacie („Could not deserialize found primitive”). Jeśli pod komunikatem widnieje Location i unknown world, zapisane miejsce wskazuje na świat, który już nie istnieje albo nie był jeszcze załadowany podczas odczytu. Serwer działa dalej, brakuje tylko tych wpisów.

Jak to naprawić:

  1. Znajdź plugin, którego to dotyczy. Wiersze bezpośrednio przed komunikatem i po nim zwykle podają plugin lub jego plik.
  2. Zatrzymaj serwer, utwórz kopię zapasową w zakładce Kopie zapasowe, otwórz plik w zakładce Pliki i usuń lub odnów wadliwe wpisy przedmiotów. Następnie uruchom serwer ponownie.
  3. Utwórz przedmioty od nowa w grze, np. kit lub towar w sklepie.
  4. Przy unknown world: usuń miejsce lub ustaw je ponownie poleceniami pluginu. Jeśli świat nadal istnieje, zadbaj o to, żeby był załadowany.
  5. Po następnym restarcie sprawdź Konsolę.

Dobrze wiedzieć: Jeśli usunąłeś świat lub zmieniłeś jego nazwę, stare domy i warpy prowadzą donikąd. Komunikat zniknie dopiero wtedy, gdy usuniesz te wpisy.

„open_command … already exists”: DeluxeMenus pomija menu

Tak wygląda komunikat:

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

Co się za tym kryje: W DeluxeMenus każde menu może mieć własne polecenie, którym gracze je otwierają. Znajduje się ono w pliku menu pod open_command. Jeśli dwa pliki menu mają to samo polecenie, DeluxeMenus pomija drugie menu i nie da się go otworzyć w grze. Wiersz „Skipping menu” podaje pominięte menu. Wszystkie pozostałe menu i serwer działają normalnie. Najczęstsza przyczyna: plik menu został skopiowany jako szablon, a polecenia nie zmieniono.

Jak to naprawić:

  1. Otwórz w zakładce Pliki folder plugins/DeluxeMenus/gui_menus.
  2. Znajdź plik pominiętego menu oraz plik, który używa tego samego open_command.
  3. Nadaj pominiętemu menu własne, jeszcze wolne polecenie.
  4. Zapisz i przeładuj DeluxeMenus poleceniem /dm reload – w grze ze ukośnikiem, w Konsoli bez niego.
  5. Otwórz testowo menu jego nowym poleceniem.

Dobrze wiedzieć: Jeśli menu otwiera się tylko z poziomu innego menu, zwykle nie potrzebuje własnego polecenia. Wtedy możesz po prostu pominąć w nim open_command.

„Failed to autoload world …”: Multiverse nie ładuje świata

Tak wygląda komunikat:

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

Co się za tym kryje: Multiverse-Core zarządza światami w plugins/Multiverse-Core/worlds.yml. Jeśli brakuje prawidłowego folderu świata, nie może go załadować. Przy BUKKIT_NAMESPACED_KEY_MISMATCH świat jest już załadowany, ale pod innym wewnętrznym identyfikatorem, niż oczekuje Multiverse. Problemy z ładowaniem powodują też podwójnie wpisane światy Netheru/Endu lub zaimportowane, niezaładowane światy (WORLD_EXIST_UNLOADED). Serwer i pozostałe światy działają dalej.

Jak to naprawić:

  1. Przy WORLD_FOLDER_INVALID sprawdź w zakładce Pliki, czy folder świata jest kompletny i pasuje do struktury folderów Twojego oprogramowania serwera. Brakujące dane przywróć z kopii zapasowej.
  2. Jeśli świat już nie istnieje, usuń nieaktualny wpis poleceniem /mv remove <Świat>.
  3. Jeśli istnieje, ale nie jest załadowany, użyj /mv load <Świat>.
  4. Przy BUKKIT_NAMESPACED_KEY_MISMATCH porównaj oba identyfikatory z komunikatu. Dopasuj przypisanie w Multiverse zgodnie z instrukcją dla Twojej wersji serwera.
  5. Nie wpisuj dodatkowo Netheru i Endu, jeśli serwer ładuje je przez server.properties lub bukkit.yml.
  6. Zrestartuj serwer i sprawdź Konsolę.

Dobrze wiedzieć: Zamiast korzystać ze starych porad dotyczących Chunkstera, przywróć dane z kopii zapasowych; zobacz Dane świata uszkodzone, nieaktualne lub niemożliwe do zapisania.

DeluxeMenus: plik menu jest nieprawidłowy

Tak wygląda komunikat:

[DeluxeMenus] Detected invalid configuration in file: <Menu>.yml
org.bukkit.configuration.InvalidConfigurationException: while scanning a simple key
 in 'reader', line <Wiersz>, column <Kolumna>:

Co się za tym kryje: DeluxeMenus nie może przetworzyć wskazanego pliku menu i nie ładuje tego menu. Gracze po wpisaniu powiązanego polecenia nie zobaczą żadnego interfejsu, a wszystkie pozostałe menu działają dalej. Dokładną przyczynę podają wiersze bezpośrednio pod komunikatem – najczęściej jest to błąd YAML z numerem wiersza i kolumny. Typowy przypadek to brak spacji po dwukropku, czyli hide_attributes:true zamiast hide_attributes: true.

Jak to naprawić:

  1. Przeczytaj wiersze pod komunikatem i zanotuj wiersz oraz kolumnę.
  2. Otwórz plik menu w zakładce Pliki, zwykle w folderze plugins/DeluxeMenus/gui_menus.
  3. Popraw to miejsce: spacja po każdym dwukropku, do wcięć tylko spacje, teksty z & lub # w cudzysłowie.
  4. Jeśli nie ma błędu YAML, sprawdź opcje z instrukcją DeluxeMenus, np. nazwy materiałów lub zapis warunków.
  5. Przeładuj poleceniem /dm reload i otwórz menu, żeby je przetestować.

Dobrze wiedzieć: # po spacji rozpoczyna w YAML komentarz. Bez cudzysłowu reszta wiersza zostaje wtedy pominięta, np. przy kolorach w formacie hex.

„FileNotFoundException”: brakuje pliku pluginu lub nie da się go utworzyć

Tak wygląda komunikat:

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

Co się za tym kryje: Plugin nie może odczytać ani utworzyć potrzebnego pliku w plugins/. Przyczyną może być usunięty plik albo brakujący lub przemianowany podfolder; przy pierwszym uruchomieniu niektórych plików danych jeszcze nie ma. FileOutputStream lub FileWriter w stosie wywołań pod błędem oznaczają próbę zapisu, która również kończy się niepowodzeniem, gdy brakuje folderu nadrzędnego. W zależności od pluginu plik zostanie utworzony później, część funkcji przestanie działać albo plugin się wyłączy.

Jak to naprawić:

  1. Zrestartuj serwer raz i sprawdź, czy komunikat się powtarza.
  2. Sprawdź w zakładce Pliki całą ścieżkę razem z podfolderami. Nazwy muszą zgadzać się z komunikatem, łącznie z wielkością liter.
  3. Jeśli nadal brakuje folderów danych lub plików, zatrzymaj serwer i przywróć je z kopii w zakładce Kopie zapasowe.
  4. Jeśli to nie pomoże, zabezpiecz folder pluginu i zainstaluj plugin ponownie zgodnie z jego instrukcją.

Dobrze wiedzieć: Nowo utworzony plik startuje z pustymi danymi lub wartościami domyślnymi. Utracone dane graczy odzyskasz z odpowiedniej kopii zapasowej.

„Could not set generator for default world”: brakuje pluginu generatora świata

Tak wygląda komunikat:

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

Co się za tym kryje: Generator świata to program, który tworzy nowy teren. W bukkit.yml lub w konfiguracji świata ustawiony jest dla świata generator z pluginu, ale ten plugin nie jest zainstalowany albo nie został załadowany. Serwer generuje wtedy nowe obszary zwykłym generatorem. Już odkryte tereny pozostają bez zmian, ale na ich krawędziach krajobraz może się dziwnie urywać lub nie pasować.

Jak to naprawić:

  1. Otwórz w Pliki plik bukkit.yml i znajdź sekcję worlds:. Pod nazwą świata znajdziesz tam generator: <Plugin>.
  2. Jeśli chcesz zachować generator, zainstaluj wskazany plugin w Pluginy w odpowiedniej wersji.
  3. Jeśli go już nie potrzebujesz, usuń wpis generator.
  4. Zrestartuj serwer i sprawdź w Konsola, czy komunikat zniknął.

Dobrze wiedzieć: Nazwa po generator: musi dokładnie odpowiadać nazwie pluginu. Literówka powoduje ten sam komunikat, mimo że plugin jest zainstalowany.

„Loading a newer configuration than is supported”: konfiguracja jest nowsza niż oprogramowanie

Tak wygląda komunikat:

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 (<wersja pliku> > <obsługiwana wersja>)! You may have to backup & delete your global config file to start the server.

Co się za tym kryje: Konfiguracja została zapisana przez nowszą wersję niż ta, która działa teraz. Typową przyczyną jest downgrade, czyli przejście na starszą wersję pluginu lub Minecrafta. Pierwsza liczba w nawiasie to wersja pliku, druga to najwyższa wersja, którą zna zainstalowany program. Nowsze ustawienia są ignorowane. Jeśli komunikat mówi o „global config file”, pochodzi on od samego Papera i zwykle chodzi o config/paper-global.yml.

Jak to naprawić:

  1. Sprawdź, czy niedawno nie obniżyłeś wersji jakiegoś pluginu albo wersji serwera w zakładce Wersja.
  2. Albo: zaktualizuj ponownie do wersji, do której pasuje konfiguracja.
  3. Albo: przywróć konfigurację w zakładce Kopie zapasowe z kopii z czasów starej wersji.
  4. Jeśli nie masz pasującej kopii, pobierz plik w zakładce Pliki, usuń go i zrestartuj serwer. Zostanie utworzony nowy plik, a swoje zmiany przeniesiesz potem ręcznie.

Dobrze wiedzieć: Jak bezpiecznie zmienić wersję, opisuje poradnik Bezpieczna zmiana wersji Minecrafta i modloadera.

MinecraftWarriors3 nie może znaleźć folderu mapy

Tak wygląda komunikat:

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

Co się za tym kryje: MinecraftWarriors3 pobiera oficjalną mapę z folderu źródłowego wpisanego w swojej konfiguracji. Tego folderu brakuje. Mapy nie da się więc ani skopiować, ani uruchomić, a wszystko, co na niej działa, przestaje funkcjonować. Sam serwer działa dalej.

Jak to naprawić:

  1. Otwórz w zakładce Pliki ścieżkę z komunikatu. Kropka na początku (./) oznacza katalog główny serwera.
  2. Jeśli folderu brakuje, wgraj tam mapę. Pliki świata muszą leżeć bezpośrednio w folderze, a nie w dodatkowym podfolderze, który często powstaje przy rozpakowywaniu archiwum.
  3. Jeśli mapa leży gdzie indziej albo folder ma inną nazwę, popraw ścieżkę w konfiguracji w plugins/MinecraftWarriors3/. Wielkość liter ma znaczenie.
  4. Zrestartuj serwer i sprawdź Konsola.

Dobrze wiedzieć: Jak w całości wgrać świat, pokazuje poradnik Wgrywanie i bezpieczna zmiana świata Minecraft.

„Failed to load …”: plugin nie może załadować menu lub konfiguracji

Tak wygląda komunikat:

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

Co się za tym kryje: Plugin nie mógł odczytać jednego ze swoich plików, na przykład menu, konfiguracji, pliku językowego, hologramu albo NPC (postaci sterowanej przez serwer). Najczęściej przyczyną jest błąd formatu, zdublowana nazwa lub błędnie zapisany warunek. W DeluxeMenus dane menu zostaje pominięte; w GrimAC nie udaje się załadować ani przeładować konfiguracji. Zależnie od pluginu brakuje pojedynczych funkcji albo plugin nie uruchamia się w pełni.

Jak to naprawić:

  1. Przeczytaj linie pod komunikatem. Często podają plik, linię i przyczynę.
  2. Otwórz plik w zakładce Pliki i porównaj go z przykładem z dokumentacji pluginu. Przy warunkach w menu sprawdź też zapis wyrażeń.
  3. Jeśli nie możesz znaleźć błędu, zrób kopię pliku i zatrzymaj serwer. Zmień nazwę pliku zamiast go usuwać. Pozwól wygenerować nowy plik domyślny tylko wtedy, gdy dokumentacja przewiduje taką drogę.
  4. Przenoś swoje teksty i ustawienia ze starego pliku kawałek po kawałku i uruchom serwer ponownie.

Dobrze wiedzieć: Nowy plik nie zawiera Twoich dotychczasowych menu, hologramów ani NPC. W razie potrzeby przywróć takie wpisy z Kopie zapasowe.

„InvalidConfigurationException”: błąd w pliku YAML pluginu

Jak wygląda komunikat:

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

Co się za tym kryje: YAML to format pliku, którego struktura opiera się na wcięciach i dwukropkach. „mapping values are not allowed here” często wskazuje na dwukropek ze spacją po nim w niezabezpieczonej wartości tekstowej albo na błędne wcięcie. „while parsing a block mapping” i „expected <block end>” oznaczają błędną strukturę, np. źle wcięty element listy zaczynający się od -. Plugin nie korzysta wtedy z pliku i wraca do wartości domyślnych albo w ogóle się nie uruchamia; EssentialsX zmienia nazwę uszkodzonego pliku i tworzy nowy.

Jak to naprawić:

  1. Zrób kopię zapasową wskazanego pliku i otwórz go w zakładce Pliki. Sprawdź wiersze podane w komunikacie oraz wiersze przed nimi.
  2. Do wcięć używaj wyłącznie spacji, a klucze na tym samym poziomie wcinaj dokładnie tak samo. Sprawdź też wcięcia elementów list.
  3. Teksty zawierające dwukropek ujmij w cudzysłów, np. message: "Achtung: Neustart".
  4. Walidator YAML w przeglądarce pokaże Ci miejsce błędu. Po poprawce zrestartuj serwer.

Dobrze wiedzieć: Jeśli EssentialsX zmienił nazwę pliku, Twoja stara wersja leży obok. Przenieś swoje zmiany do nowego pliku, zamiast kopiować z powrotem uszkodzony.

„Unknown function or variable”: nieprawidłowa formuła w konfiguracji pluginu

Tak wygląda komunikat:

de.slikey.exp4j.tokenizer.UnknownFunctionOrVariableException: Unknown function or variable '<Znak>' at pos <Pozycja> in expression '<Wyrażenie>'
net.objecthunter.exp4j.tokenizer.UnknownFunctionOrVariableException: Unknown function or variable '<Znak>' …

Co się za tym kryje: Niektóre pluginy obliczają wartości na podstawie formuł w swojej konfiguracji, np. ceny, nagrody czy czasy odnowienia. Używana do tego biblioteka obliczeniowa exp4j, którą pluginy czasem dołączają pod własną nazwą pakietu, zna tylko liczby, operatory, wbudowane funkcje i zmienne udostępniane przez plugin. Jeśli w formule znajdzie się coś innego, np. „100t” zamiast „100”, obliczenie zostaje przerwane. Powiązana funkcja pluginu nie działa wtedy zgodnie z zamierzeniem. Serwer działa dalej.

Jak to naprawić:

  1. Zanotuj wyrażenie po in expression. Po variable znajduje się znak, który przeszkadza.
  2. Znajdź plugin na podstawie stack trace, czyli wciętych wierszy at poniżej. Zwykle widnieje tam nazwa pliku pluginu, np. <Plugin>.jar//.
  3. Wyszukaj to wyrażenie w plikach konfiguracyjnych tego pluginu. Przy wielu plikach pomaga pobranie folderu przez SFTP i przeszukanie go na własnym komputerze.
  4. Zastąp je liczbą lub prawidłową formułą. Jakie zmienne są dozwolone, znajdziesz w dokumentacji pluginu.
  5. Przeładuj plugin albo zrestartuj serwer.

Dobrze wiedzieć: Dostęp SFTP skonfigurujesz tak: Edycja plików serwera w panelu i połączenie przez SFTP.

FancyNpcs: akcja NPC z pustym zakresem losowania

Tak wygląda komunikat:

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

Co się za tym kryje: Akcja NPC z FancyNpcs ma coś wylosować, na przykład jedną z kilku kolejnych akcji. Jeśli pula wyboru jest pusta albo zakres liczb jest ujemny, nie da się wylosować liczby i akcja zostaje przerwana. Gracze zauważają to po tym, że po kliknięciu NPC nic się nie dzieje albo dzieje się tylko część. Serwer i pozostałe NPC działają dalej.

Jak to naprawić:

  1. Zaktualizuj FancyNpcs do najnowszej wersji dla Twojej wersji serwera.
  2. Sprawdź akcje danego NPC. Każde losowanie potrzebuje co najmniej jednego wpisu, a granice liczbowe muszą być dodatnie.
  3. Dane NPC znajdziesz w zakładce Pliki w folderze plugins/FancyNpcs. Przed zmianą utwórz kopię zapasową i edytuj pliki tylko przy zatrzymanym serwerze.
  4. Uruchom serwer i kliknij NPC, żeby to przetestować.

Dobrze wiedzieć: Komunikat nie podaje nazwy NPC. Jeśli masz kilka NPC z losowymi akcjami, testuj je po kolei i obserwuj przy tym Konsola.

Tekst ze starymi kodami kolorów w polu MiniMessage

Tak wygląda komunikat:

Legacy formatting codes have been detected in a MiniMessage string …

Co się za tym kryje: MiniMessage to sposób zapisu formatowania tekstu za pomocą tagów w nawiasach ostrych, np. <red> albo <bold>. Wiele aktualnych pluginów używa go do czatu, tytułów i menu. MiniMessage nie rozumie starych kodów kolorów z & lub §. Jeśli taki kod znajdzie się w tekście, tekst wyświetla się z błędnym formatowaniem albo wcale. Serwer działa dalej.

Jak to naprawić:

  1. Znajdź plugin. Zwykle podaje go linia przed komunikatem albo stacktrace pod nim.
  2. W zakładce Pliki otwórz jego plik konfiguracyjny lub językowy i zastąp stare kody tagami:
    • &c zamień na <red>, &a na <green>, &e na <yellow>
    • &l zamień na <bold>, &o na <italic>, &r na <reset>
    • &#37FF00 lub §x§3§7… zamień na <#37FF00>
  3. Jeśli plugin oferuje w swoich ustawieniach tryb legacy dla starych kodów, możesz zamiast tego go włączyć.
  4. Przeładuj plugin lub zrestartuj serwer i sprawdź tekst w grze.

Dobrze wiedzieć: Nigdy nie mieszaj obu sposobów zapisu w jednym tekście. Wystarczy jeden pozostawiony znak &, żeby pojawił się komunikat.

Paxel: brakuje wartości dla poziomu narzędzia

Tak wygląda komunikat:

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

Co się za tym kryje: Paxel to narzędzie łączące kilof, siekierę i łopatę. Plugin Paxel oferuje je w kilku poziomach, a każdy poziom wymaga w konfiguracji określonych obowiązkowych wartości. Dla wskazanego poziomu brakuje jednej z nich. Takiego paxla nie da się wtedy wytworzyć ani wydać. Często dzieje się tak po aktualizacji, gdy nowa wersja oczekuje ustawienia, którego w starym pliku jeszcze nie ma.

Jak to naprawić:

  1. W zakładce Pliki otwórz konfigurację w folderze plugins/Paxel.
  2. Znajdź poziom z komunikatu i uzupełnij wskazane ustawienie. Jako wzór posłuży Ci kompletny poziom z tego samego pliku.
  3. Możesz też zmienić nazwę pliku i uruchomić serwer ponownie. Plugin zapisze wtedy domyślną konfigurację aktualnej wersji, a Ty przeniesiesz swoje zmiany.
  4. Zrestartuj serwer i sprawdź Konsola.

Dobrze wiedzieć: Przy uzupełnianiu zachowaj takie samo wcięcie jak przy pozostałych wartościach poziomu, w przeciwnym razie pojawi się błąd YAML.

„Permission node … is invalid”: błędna definicja uprawnienia w pluginie

Tak wygląda komunikat:

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

Co się za tym kryje: Każdy plugin opisuje w swoim pliku plugin.yml, który znajduje się wewnątrz pliku JAR pluginu, uprawnienia, które ze sobą wnosi. Jednego z tych opisów nie udało się wczytać. Podana nazwa może być przy tym całkowicie poprawna. Kolejne linie Data cannot be null i 'default' key contained unknown value wskazują na brakujące dane definicji lub nieprawidłową wartość default. Zwykle plugin mimo to się uruchamia, ale to uprawnienie nie zostaje utworzone z wartościami domyślnymi.

Jak to naprawić:

  1. Odczytaj z komunikatu, którego pluginu to dotyczy.
  2. Zaktualizuj go do builda pasującego do Twojej wersji serwera. Wymień plik JAR przy zatrzymanym serwerze.
  3. Jeśli to Twój własny plugin, sprawdź cały blok permissions w plugin.yml pod kątem formatu Bukkit, a nie tylko nazwę. Każdy wpis to sekcja z właściwościami takimi jak description, default (true, false, op lub not op) i children.
  4. Zrestartuj serwer.

Dobrze wiedzieć: Jeśli i tak sam nadajesz uprawnienia za pomocą pluginu do uprawnień, takiego jak LuckPerms, komunikat zwykle ma niewielki wpływ na Twoich graczy.

SuntexSocial: proxy SOCKS5 bez adresu

Tak wygląda komunikat:

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

Co się za tym kryje: SuntexSocial łączy Twój serwer z botem Telegram. W konfiguracji ustawiono, że bot łączy się z internetem przez proxy SOCKS5. Proxy to serwer pośredniczący, przez który przechodzi połączenie. Adres tego proxy (telegram.proxy.host) jest jednak pusty. Dlatego bot Telegram się nie uruchamia, a serwer Minecraft działa normalnie dalej.

Jak to naprawić:

  1. W zakładce Pliki otwórz konfigurację w folderze plugins/SuntexSocial.
  2. Jeśli potrzebujesz proxy, wpisz w sekcji telegram i proxy przy host nazwę hosta, a do tego odpowiedni port. Oba dane otrzymasz od dostawcy proxy.
  3. Jeśli nie potrzebujesz proxy, wyłącz proxy SOCKS5 w tej samej konfiguracji.
  4. Zrestartuj serwer i sprawdź, czy bot odpowiada.

Dobrze wiedzieć: Proxy jest potrzebne tylko wtedy, gdy Telegram nie jest bezpośrednio osiągalny z sieci serwera. Bez takiego powodu zostaw je wyłączone.

Plugin generatora świata uruchamia się za późno

Tak wygląda komunikat:

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

Co się za tym kryje: Dla głównego świata ustawiono generator z pluginu, ale plugin uruchamia się dopiero po tym, jak serwer wczyta światy. Świat korzysta wtedy ze zwykłego generatora, więc nowe obszary wyglądają inaczej niż planowano. Dla już wygenerowanych obszarów nic się nie zmienia. Serwer działa normalnie.

Jak to naprawić:

  1. Sprawdź w instrukcji pluginu generatora, jak skonfigurować go dla głównego świata.
  2. Zwykle generator wpisuje się w bukkit.yml w sekcji worlds: przy nazwie głównego świata.
  3. Plugin musi się wczytać przy starcie serwera, czyli przed światami. Określa to twórca w plugin.yml za pomocą load: STARTUP. Jeśli komunikat mimo to się pojawia, sprawdź, czy zainstalowana wersja pasuje do Twojej wersji serwera.
  4. Zrestartuj serwer i sprawdź Konsola.

Dobrze wiedzieć: Obszary, które powstały już przy użyciu zwykłego generatora, pozostaną takie, jakie są. Jeśli cały świat ma powstać z nowym generatorem, potrzebujesz nowego świata. Wcześniej zabezpiecz stary w zakładce Kopie zapasowe.

LuckPerms nie może odczytać pliku importu

Tak wygląda komunikat:

[LuckPerms] Error whilst reading from the import file

Co się za tym kryje: Podczas importu LuckPerms przejmuje grupy, uprawnienia i dane graczy z pliku, który został wcześniej utworzony poleceniem eksportu, na przykład przy przenosinach z innego serwera. LuckPerms nie mógł odczytać wybranego pliku albo przetworzyć jego formatu. Import zostaje przerwany. Serwer działa dalej.

Jak to naprawić:

  1. Sprawdź w zakładce Pliki, czy plik znajduje się w folderze plugins/LuckPerms i czy jego nazwa dokładnie odpowiada nazwie podanej w poleceniu.
  2. Prześlij plik w niezmienionej postaci, tak jak utworzył go eksport, czyli bez rozpakowywania, zmiany nazwy czy edycji.
  3. Przeczytaj komunikat o błędzie bezpośrednio pod tą linią. Wskazuje on dokładne miejsce, w którym odczyt się nie powiódł.
  4. Następnie uruchom import ponownie poleceniem /lp import <Plik>.

Dobrze wiedzieć: Jak tworzyć i sprawdzać grupy oraz uprawnienia w LuckPerms, pokazuje Konfiguracja LuckPerms: uprawnienia i grupy.

Ustawienie Paper zawiera nieznaną wartość

Tak wygląda komunikat:

Encountered an unexpected exception
org.spongepowered.configurate.serialize.SerializationException: [<Ścieżka ustawienia>] <nieznana wartość> …

Co się za tym kryje: Paper odczytuje swoje ustawienia z plików config/paper-global.yml, config/paper-world-defaults.yml oraz – osobno dla każdego świata – z pliku paper-world.yml w folderze świata. W jednym z tych plików znajduje się wartość, której Twoja wersja serwera nie zna, na przykład przedmiot lub składnik danych, który istnieje dopiero w nowszej wersji albo zmienił nazwę. Ustawienie nie zostaje zastosowane. Zdarza się to zwykle po przejściu na starszą wersję lub gdy pliki zostały skopiowane z innego serwera.

Jak to naprawić:

  1. Przeczytaj komunikat: w nawiasach kwadratowych podana jest ścieżka ustawienia, czyli klucze od zewnętrznego do wewnętrznego, a po niej nieznana wartość.
  2. Otwórz odpowiedni plik w zakładce Pliki w folderze config lub w folderze świata i przejdź wzdłuż tej ścieżki.
  3. Popraw wartość na nazwę, którą zna Twoja wersja, albo ją usuń.
  4. Uruchom serwer ponownie.

Dobrze wiedzieć: Jeśli usuniesz całe ustawienie, Paper przy następnym uruchomieniu ponownie wpisze wartość domyślną.

„key already exists …”: BMenu wczytuje identyfikator menu wielokrotnie

Tak wygląda komunikat:

[BMenu] key already exists <Obszar>:<Menu>

Co się za tym kryje: BMenu zarządza menu za pomocą unikalnych identyfikatorów. Jeśli zajęty już identyfikator zostanie zarejestrowany ponownie, plugin odrzuca nowy wpis i zachowuje istniejący. W efekcie może brakować zmian w drugiej definicji menu albo może pojawić się inne menu niż oczekiwane. Serwer działa dalej.

Jak to naprawić:

  1. Zanim zaczniesz edytować pliki menu, utwórz kopię zapasową swoich ustawień w zakładce Kopie zapasowe.
  2. Odczytaj pełny identyfikator w zakładce Konsola. W zakładce Pliki porównaj identyfikatory definicji menu BMenu i sprawdź także zaimportowane menu pod kątem zduplikowanych definicji.
  3. Usuń zbędną kopię albo nadaj drugiemu menu unikalny identyfikator. Dostosuj również odwołania do zmienionego identyfikatora.
  4. Uruchom serwer całkowicie od nowa i przetestuj dotknięte menu. Jeśli komunikat nadal się pojawia mimo unikalnych definicji, zgłoś przebieg autorowi BMenu, dołączając pełny log startowy.

Dobrze wiedzieć: O tym, który wpis zostanie zachowany, decyduje kolejność rejestracji. Dlatego nie polegaj na określonej kolejności plików.

SCore: baza głów odrzuca identyfikator głowy

Tak wygląda komunikat:

[SCore] Error when creating the Head: <Wartość głowy> invalid head database id ! (<Wartość głowy>)

Co się za tym kryje: SCore ma utworzyć niestandardową głowę, ale nie może rozwiązać ustawionej wartości za pomocą bazy głów. Identyfikator bazy danych wskazuje na zapisaną w niej głowę, natomiast wartość tekstury opisuje jej wygląd. Dotkniętej głowy brakuje, a serwer działa dalej.

Jak to naprawić:

  1. Sprawdź w zakładce Konsola, który plugin oparty na SCore wczytuje daną głowę. Otwórz jego definicję głowy w zakładce Pliki.
  2. Porównaj ustawiony format z instrukcją tego pluginu. Użyj prawidłowego identyfikatora głowy; wartość tekstury wpisuj wyłącznie w pole udokumentowane do tego celu.
  3. Jeśli podłączona jest baza głów, sprawdź jej komunikaty startowe i poczekaj, aż w pełni się wczyta. Następnie przetestuj głowę ponownie.
  4. Po poprawce uruchom serwer ponownie i sprawdź dotknięty element wyświetlania lub przedmiot.

Multiverse: nazwa domyślnego świata koliduje z innym światem

Tak wygląda komunikat:

[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 '<Świat>' 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.

Co się za tym kryje: Po zmianie level-name Multiverse ma przejąć nazwę domyślnego świata. Nowa nazwa jest jednak w jego konfiguracji światów już przypisana do innego świata. Dlatego przejęcie zostaje przerwane i trzeba poprawić przypisanie domyślnego świata.

Jak to naprawić:

  1. Utwórz kopię zapasową w zakładce Kopie zapasowe i zatrzymaj serwer przed wprowadzeniem zmian.
  2. W zakładce Pliki porównaj wpis level-name w server.properties z plikiem Multiverse worlds.yml. Sprawdź, który istniejący świat ma faktycznie być światem domyślnym.
  3. Jeśli zmiana była niezamierzona, przywróć dotychczasową nazwę tego domyślnego świata. W przypadku planowanej zmiany nazwy najpierw rozwiąż konflikt zgodnie z instrukcją Multiverse.
  4. Uruchom serwer i sprawdź w zakładce Konsola, czy przypisanie się powiodło. Następnie sprawdź, czy wchodzisz do zamierzonego świata.

UltimateDonutSmp: polecenie nagrody ze skrzynki kończy się błędem

Tak wygląda komunikat:

[UltimateDonutSmp] Failed to grant crate reward <Nagroda> from crate <Skrzynka> to <Gracz>
org.bukkit.command.CommandException: Unhandled exception executing <Polecenie>

Co się za tym kryje: UltimateDonutSmp wykonuje polecenie w ramach nagrody ze skrzynki. To polecenie kończy się błędem, więc dana akcja nagrody się nie powodzi. Serwer działa dalej; konfiguracja skrzynki i pełny ślad błędu pokazują, którego polecenia to dotyczy.

Jak to naprawić:

  1. Otwórz pełny komunikat w zakładce Konsola lub w zakładce Pliki w logs/latest.log. Przeczytaj także kolejne linie z przyczyną.
  2. Sprawdź w zakładce Pliki polecenie nagrody dotkniętej skrzynki. Porównaj jego zapis i placeholdery graczy z instrukcją Twojej wersji UltimateDonutSmp.
  3. Zaktualizuj plugin w zakładce Pluginy do odpowiedniej wersji i po poprawce uruchom serwer ponownie.
  4. Przetestuj nagrodę w kontrolowany sposób. Przed ponownym przyznaniem sprawdź, czy część nagrody nie została już wypłacona lub wydana, aby nic nie zostało rozdane podwójnie.

Bezpieczna konfiguracja panelu NovaSync i zastąpienie domyślnych danych logowania

Tak wygląda komunikat:

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

Co się za tym kryje: W panelu NovaSync brakuje konta właściciela, czyli konta do zarządzania panelem. Jednocześnie w magazynie danych dostępowych pluginu nadal znajdują się domyślne dane logowania. Bezpieczna konfiguracja początkowa jest więc niekompletna i trzeba ją dokończyć. Serwer gry działa dalej; ostrzeżenie dotyczy dostępu do panelu pluginu.

Jak to naprawić:

  1. Przeczytaj pełny komunikat w Konsola lub w sekcji Pliki w logs/latest.log.
  2. Otwórz w swoim panelu NovaSync podaną ścieżkę /dashboard i przejdź cały kreator konfiguracji. Załóż przy tym swoje konto właściciela.
  3. Zastąp domyślne dane logowania własnymi danymi z silnym hasłem, używanym tylko w tym miejscu. Następnie sprawdź, czy NovaSync ponownie wyświetla ostrzeżenie.

Warto wiedzieć: Danych logowania nie umieszczaj w zgłoszeniu ani w publicznie udostępnianym fragmencie logu. Jeśli utkniesz, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.

DonutShop: polecenie zakupu kończy się błędem, Shardy są zwracane

Tak wygląda komunikat:

[DonutShop] Shard shop command failed for <Gracz> ("<Polecenie>"); refunding <Kwota> Shard.

Co się za tym kryje: DonutShop próbuje przyznać zakupioną usługę za pomocą zapisanego polecenia. To polecenie kończy się błędem, a plugin zgłasza zwrot Shardów. Serwer działa dalej; problem dotyczy tej transakcji zakupu.

Jak to naprawić:

  1. Przeczytaj w Konsola komunikaty bezpośrednio przed poleceniem zakupu. Mogą wskazywać nieznane polecenie lub nieprawidłowy parametr.
  2. Otwórz odpowiedni wpis sklepu w sekcji Pliki. Porównaj nazwę polecenia, argumenty i placeholder gracza z dokumentacją odpowiedniego pluginu.
  3. Sprawdź, czy plugin wykonujący polecenie jest zainstalowany w sekcji Pluginy i czy według Konsola został poprawnie załadowany.
  4. Wprowadź poprawkę zgodnie z instrukcją DonutShop. Następnie przetestuj pojedynczy zakup i sprawdź nagrodę oraz saldo Shardów.

ExecutableItems: w poleceniu specjalnym brakuje wartości true lub false

Tak wygląda komunikat:

[ExecutableItems] INVALID COMMAND A SCommand contains an invalid boolean: <Wartość> for command: <Polecenie>

Co się za tym kryje: ExecutableItems sprawdza argumenty polecenia specjalnego. Wartość logiczna (boolean) to informacja tak/nie zapisywana jako true lub false. W przewidzianym dla niej miejscu znajduje się inna wartość. Przez to dana akcja przedmiotu jest nieprawidłowa; serwer działa dalej.

Jak to naprawić:

  1. Otwórz komunikat w Konsola i znajdź podane polecenie w konfiguracji danego przedmiotu w sekcji Pliki.
  2. Przed edycją zrób kopię pliku. Porównaj całą sekwencję argumentów z dokumentacją zainstalowanej wersji ExecutableItems.
  3. Wpisz true lub false w przewidzianym miejscu. Sprawdź też położenie kolejnych poleceń, jeśli argumenty zostały przesunięte.
  4. Po zapisaniu uruchom serwer ponownie i przetestuj właśnie tę akcję przedmiotu.

ExecutableItems: świat w disableItemsPerWorld jest nieprawidłowy

Tak wygląda komunikat:

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

Co się za tym kryje: ExecutableItems ma blokować określone przedmioty w poszczególnych światach. Jeden z wpisanych światów nie jest rozpoznawany przez plugin jako prawidłowy, załadowany świat. Reguła blokady z tego wpisu nie może więc zostać poprawnie przypisana. Serwer działa dalej.

Jak to naprawić:

  1. Sprawdź w Konsola, czy wybrany świat został poprawnie załadowany. Najpierw usuń zgłoszony tam błąd ładowania.
  2. Zrób kopię konfiguracji ExecutableItems w sekcji Pliki i znajdź opcję disableItemsPerWorld.
  3. Porównaj wpis z faktyczną nazwą załadowanego świata. Popraw pisownię i usuń wpisy dotyczące światów usuniętych na stałe.
  4. Uruchom serwer całkowicie od nowa. Sprawdź Konsola i przetestuj, czy wskazane przedmioty są zablokowane w danym świecie.

BAirDropFNV: świat stałego miejsca zrzutu nie jest załadowany

Tak wygląda komunikat:

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

Co się za tym kryje: BAirDropFNV używa dla airdropu stałego miejsca z konfiguracji. Powiązany świat nie jest załadowany, więc tego miejsca nie da się użyć. Ten airdrop nie dochodzi do skutku, a serwer działa dalej.

Jak to naprawić:

  1. Sprawdź w Konsola, które światy są ładowane przy starcie i czy wcześniej pojawia się błąd ładowania wybranego świata.
  2. Zatrzymaj serwer i zrób kopię konfiguracji BAirDropFNV w sekcji Pliki.
  3. Porównaj nazwę świata przy stałym miejscu zrzutu z faktyczną nazwą załadowanego świata. Popraw wpis na wybrany istniejący świat.
  4. Jeśli potrzebny jest dodatkowy świat, usuń błąd jego ładowania. Następnie uruchom serwer ponownie i jeszcze raz sprawdź airdrop.

Plugin odczytuje archiwum jako plik konfiguracyjny

Tak wygląda komunikat:

Cannot load plugins/<Plugin>/<Folder>/<Archiwum>.tar.gz
InvalidConfigurationException: unacceptable code point

Co się za tym kryje: Plugin próbuje odczytać skompresowane archiwum ze swojego folderu danych jako konfigurację YAML. Czytnik tekstu odrzuca dane binarne; ten plik nie zostaje załadowany. YAML to tekstowy format ustawień. Sama zmiana nazwy pliku archiwum nie zamienia jego zawartości na ten format.

Jak to naprawić:

  1. Zatrzymaj serwer i utwórz kopię w sekcji Kopie zapasowe, zanim przeniesiesz pliki w folderze danych pluginu.
  2. Sprawdź w sekcji Pliki archiwum wskazane w Konsoli i przenieś je z folderu konfiguracyjnego odczytywanego przez plugin do osobnego miejsca.
  3. Pozostaw prawidłowe pliki konfiguracyjne w przewidzianym folderze, uruchom serwer ponownie i sprawdź, czy dane kity lub wpisy pluginu zostają załadowane.

Purpur pomija nieznane bloki w ustawieniach siekiery

Tak wygląda komunikat:

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

Co się za tym kryje: Purpur wczytuje tutaj reguły zeskrobywania utlenienia i wosku za pomocą siekiery. Jeden z wpisanych identyfikatorów bloków nie istnieje w uruchomionej wersji Minecraft. Purpur pomija tę regułę i dalej przetwarza pozostałe ustawienia. Może się to zdarzyć na przykład po przeniesieniu konfiguracji z innej wersji.

Jak to naprawić:

  1. Sprawdź uruchomioną wersję w zakładce Wersja i zrób kopię pliku purpur.yml w zakładce Pliki, zanim cokolwiek zmienisz.
  2. Zatrzymaj serwer. Znajdź zgłoszone wpisy w tools.axe.weatherables i tools.axe.waxables, uwzględniając też ewentualne odrębne ustawienia dla poszczególnych światów.
  3. Usuń nieznane wpisy bloków albo popraw je na podstawie dokumentacji Purpur dla Twojej wersji. Pozostałe ustawienia zostaw bez zmian.
  4. Uruchom serwer i sprawdź w zakładce Konsola, czy komunikaty zniknęły.

„Failed to update enchantment”: plugin nie wczytuje zaklęcia

Tak wygląda komunikat:

[dev.by1337.item.util.dfu.YamlUpdater] Failed to update enchantment! Expected '<Format>', but got '{<Zaklęcie>=<Poziom>}'.

Co się za tym kryje: Pluginy autorstwa by1337, np. BMenu czy BCases, odczytują przedmioty z plików YAML i podczas ładowania przekształcają starsze wpisy do nowego formatu. Zaklęcie jest zapisane w formie, której konwerter nie zna, np. jako przypisanie w nawiasach klamrowych. Tego zaklęcia brakuje wtedy na przedmiocie, ale plugin i serwer działają dalej.

Jak to naprawić:

  1. W Pliki przeszukaj folder pluginu pod kątem wartości z komunikatu, np. nazwy zaklęcia.
  2. Zrób kopię pliku i zapisz zaklęcie w formie podanej w dokumentacji pluginu.
  3. Zrestartuj serwer i sprawdź w Konsola, czy komunikat zniknął.
  4. Jeśli nadal się pojawia, zaktualizuj plugin w Pluginy.

Dobrze wiedzieć: YAML to format tekstowy, w którym wcięcia i zapis muszą być dokładnie poprawne.

AbstractMenus: plik menu z błędem składni, nieznaną akcją lub nazwą dźwięku

Tak wygląda komunikat:

[AbstractMenus] Cannot parse menu file '<Menu>': Reader: <Wiersz>: Expecting close brace } or a comma, got end of file
[AbstractMenus] Action '<Akcja>' is not exists
[AbstractMenus] [Near line <Wiersz>] Cannot load menu '<Menu>': Cannot read sound action with sound name '<Dźwięk>'. Invalid sound name.

Co się za tym kryje: AbstractMenus zapisuje menu w formacie HOCON, czyli zapisie podobnym do JSON. Jeśli brakuje nawiasu lub przecinka, w tekście znajduje się niewidoczny znak sterujący (0xd, windowsowy znak końca wiersza), nazwa akcji jest błędnie zapisana albo wersja serwera nie zna nazwy dźwięku, menu się nie ładuje. Pozostałe menu i serwer działają dalej.

Jak to naprawić:

  1. Otwórz w Pliki wskazany plik menu w folderze AbstractMenus.
  2. Przejdź do wskazanego wiersza i uzupełnij brakujące nawiasy lub przecinki.
  3. Zapisz plik z uniksowymi końcami wierszy i popraw błędnie zapisane nazwy akcji.
  4. Zastąp nazwy dźwięków nazwami, które zna twoja wersja Minecraft.
  5. Zrestartuj serwer i sprawdź Konsola.

BMenu: plik menu zawiera nieprawidłowe wartości

Tak wygląda komunikat:

[BMenu] Errors in plugins/BMenu/menu/<Plik>.yml
  - Errors in 'color':
      - Expected '#AARRGGBB', but got '%<Placeholder>%'

Co się za tym kryje: BMenu odczytuje swoje menu z plików YAML, czyli formatu tekstowego opartego na wcięciach. Jakaś wartość nie pasuje do oczekiwanego formatu: zamiast koloru jest placeholder, którego BMenu w tym miejscu nie rozwija, slot wyposażenia ma inną nazwę niż w twojej wersji serwera albo formuła obliczeniowa nie dostaje liczby. Menu ładuje się tylko częściowo lub wcale, a serwer działa dalej.

Jak to naprawić:

  1. Otwórz w Pliki plik z komunikatu w folderze plugins/BMenu.
  2. Idź za wpisami komunikatu aż do błędnego pola, np. color lub slot.
  3. Wpisz prawidłową wartość, np. stały kolor, taki jak #FF202020, albo slot wyposażenia znany twojej wersji.
  4. W przypadku formuł sprawdź, czy wszystkie placeholdery zwracają wartość.
  5. Zrestartuj serwer i sprawdź Konsola.

BCases: animacja skrzynki z nieznanym dostawcą

Tak wygląda komunikat:

[BCases] Failed to load animation from /home/container/plugins/BCases/animations/<Folder>/<Plik>.yml
java.lang.IllegalArgumentException: Unknown provider: <Dostawca>:<Animacja>

Co się za tym kryje: BCases odtwarza animację podczas otwierania skrzynki. Każdy plik animacji wskazuje dostawcę, czyli rozszerzenie, które wykonuje animację. Wskazany dostawca nie jest zainstalowany, często dlatego, że pliki animacji zostały skopiowane z innego pakietu. BCases pomija tę animację, wszystkie pozostałe działają dalej.

Jak to naprawić:

  1. Przeczytaj w komunikacie fragment po „Unknown provider”. Nazwa przed dwukropkiem wskazuje brakujące rozszerzenie.
  2. Zainstaluj to rozszerzenie w sekcji Pluginy, jeśli chcesz korzystać z tej animacji.
  3. W przeciwnym razie usuń plik w sekcji Pliki z plugins/BCases/animations i przestaw skrzynki, które go używają, na istniejącą animację.
  4. Uruchom serwer ponownie i sprawdź Konsolę.

ChunkLoader się nie uruchamia: wartość w konfiguracji ma nieprawidłowy format

Tak wygląda komunikat:

[ChunkLoader] ChunkLoader could not start safely
java.lang.IllegalArgumentException: <Ustawienie> must be a number

Co się za tym kryje: ChunkLoader podczas uruchamiania wczytuje swoją konfigurację i sprawdza każdą wartość. Jeśli wartość nie pasuje do oczekiwanego formatu, plugin przerywa swoje uruchamianie. Po „IllegalArgumentException:” znajdują się nazwa ustawienia i format: „a number” oznacza liczbę, „a whole number” liczbę całkowitą, „a list of …” listę. Serwer działa dalej, brakuje tylko funkcji ChunkLoadera.

Jak to naprawić:

  1. Otwórz w sekcji Pliki folder plugins/ChunkLoader, a w nim plik konfiguracyjny.
  2. Znajdź wskazane ustawienie. Kropki w nazwie oznaczają zagnieżdżone poziomy: loader.max-per-player to max-per-player poniżej loader.
  3. Wpisz wartość w poprawnym formacie: liczby bez cudzysłowów, liczby całkowite bez miejsc po przecinku, listy z - przed każdym wpisem. Plik jest zapisany w YAML, formacie tekstowym, w którym liczą się wcięcia.
  4. Zapisz plik, uruchom serwer ponownie i sprawdź w Konsoli, czy komunikat zniknął.

SCore: tekstura głowy zawiera nieprawidłowe dane Base64

Jak wygląda komunikat:

[SCore] Error when creating the Head with headValue: <Wartość tekstury> - Illegal base64 character <Kod znaku>

Co się za tym kryje: SCore tworzy dla innego pluginu głowę z własną teksturą. W tym celu odczytuje wpisaną wartość jako Base64, czyli tekstowe kodowanie danych. Jeden ze znaków nie pasuje do tego formatu, dlatego tej głowy nie da się utworzyć. Serwer działa dalej.

Jak to naprawić:

  1. Przeczytaj w Konsola wcześniejsze wiersze i przypisz wpis głowy do pluginu, który korzysta z SCore.
  2. Zrób kopię zapasową jego konfiguracji w zakładce Pliki i otwórz odpowiedni wpis.
  3. Porównaj pole z instrukcją do tej wersji pluginu. Wpisz pełne, oczekiwane dane tekstury; nazwa wyświetlana ich nie zastąpi.
  4. Zrestartuj serwer i sprawdź dany element w grze oraz Konsola. Jeśli błąd nie znika, przekaż autorowi pluginu oczyszczony komunikat i odpowiedni fragment konfiguracji.

FoShop: zdublowane miejsce w menu głównym

Jak wygląda komunikat:

[FoShop] shops:layout: public GUI layout: [<Plik>] duplicate main menu slot <Numer>.

Co się za tym kryje: FoShop sprawdza układ swoich menu sklepu. Kilka wpisów zajmuje to samo miejsce w menu głównym, przez co konfiguracja jest sprzeczna. FoShop zgłasza zastrzeżenia do tego układu. Serwer działa dalej.

Jak to naprawić:

  1. Zanotuj z Konsola podany plik i numer miejsca.
  2. Zrób kopię zapasową plików menu FoShop w zakładce Pliki. Wyszukaj ten numer w ustawieniach miejsc menu głównego, również w innych plikach menu sklepu.
  3. Przypisz odpowiednim wpisom różne miejsca obsługiwane przez FoShop. Sprawdź dozwolone pozycje w instrukcji do Twojej wersji pluginu.
  4. Zrestartuj serwer i otwórz menu główne w grze. Sprawdź w Konsola, czy zdublowane miejsce zostało usunięte i czy pojawiają się inne błędy.

zAuctionHouse nie rozpoznaje ustawionego typu sortowania

Jak wygląda komunikat:

[zAuctionHouse] Impossible to find the sort type : <Typ sortowania>, skip it...

Co się za tym kryje: Konfiguracja zawiera typ sortowania, którego zAuctionHouse w zainstalowanej wersji nie zna. Plugin pomija tę opcję. Brakuje wtedy danej możliwości sortowania, a serwer działa dalej.

Jak to naprawić:

  1. Sprawdź w Konsola, które typy sortowania są zgłaszane. Kilka komunikatów może dotyczyć różnych opcji.
  2. Zanim wprowadzisz zmiany, zrób kopię zapasową konfiguracji zAuctionHouse w zakładce Pliki.
  3. Porównaj wartości z instrukcją lub niezmienioną przykładową konfiguracją tej samej wersji pluginu. Zastąp nieznane wpisy obsługiwanymi typami sortowania albo usuń te opcje.
  4. Zrestartuj serwer i sprawdź sortowanie w grze. Następnie przejrzyj Konsola, aby upewnić się, że nie została żadna inna nieprawidłowa opcja.

SmartSpawner: komenda give nie znajduje gracza

Jak wygląda komunikat:

[SmartSpawner] Error executing give command: No player was found

Co się za tym kryje: SmartSpawner próbuje przekazać przedmiot za pomocą komendy give. Podany cel nie pasuje do żadnego dostępnego gracza, dlatego przekazanie zostaje przerwane. Serwer i pozostałe funkcje gry działają dalej. Przyczyną może być błędna nazwa, pusty placeholder gracza albo gracz, który w międzyczasie się rozłączył.

Jak to naprawić:

  1. Otwórz Konsola i sprawdź komunikaty bezpośrednio przed tym błędem, aby znaleźć komendę lub akcję, która go wywołała.
  2. Sprawdź podany cel i to, czy docelowy gracz jest online. Przy automatycznie generowanej komendzie upewnij się też, że placeholder gracza rzeczywiście został podmieniony.
  3. Jeśli komenda pochodzi z konfiguracji, zrób kopię zapasową tego pliku w zakładce Pliki i popraw w nim cel zgodnie z instrukcją pluginu.
  4. Powtórz przekazanie dla konkretnego, dostępnego gracza i sprawdź, czy przedmiot do niego trafił.

Twojego komunikatu tu nie ma?

Przeczytaj cały komunikat w Konsola lub w logs/latest.log, także wiersze bezpośrednio przed nim. Często widać tam, który plugin właśnie wczytuje swoje pliki. W stacktrace poniżej rozpoznasz plugin po nazwie pliku JAR lub po folderze plugins/<Plugin>/ w ścieżce. Jeśli komunikat podaje plik z wierszem i kolumną, prawie zawsze chodzi o błąd formatu, jak w sekcjach powyżej. Przed każdą zmianą utwórz kopię zapasową. Jeśli nie możesz sobie poradzić, otwórz zgłoszenie i podaj godzinę komunikatu.