Wiele pluginów trwale zapisuje dane: uprawnienia, stany kont, logi albo historię akcji budowania. Używają do tego albo bazy danych MySQL lub MariaDB, z którą łączą się przez sieć, albo plików we własnym folderze w plugins/, na przykład bazy SQLite lub H2, czyli kompletnej bazy danych w jednym pliku. Jeśli otwieranie lub zapisywanie się nie udaje, plugin nie ma dostępu do swoich danych albo nowe zmiany przepadają.
Każda sekcja poniżej dotyczy jednego komunikatu. Pełny komunikat znajdziesz w Konsola albo w Pliki w logs/latest.log. Linie bezpośrednio po nim często wskazują dokładną przyczynę. Przed każdą zmianą w folderach pluginów, plikach baz danych lub konfiguracjach utwórz kopię zapasową w Kopie zapasowe, a pliki baz danych usuwaj lub przenoś tylko przy zatrzymanym serwerze.
„Access denied for user”: baza danych odrzuca użytkownika lub hasło
Tak wygląda komunikat:
java.sql.SQLException: Access denied for user '<Użytkownik>'@'<Adres>' (using password: YES)
com.zaxxer.hikari.pool.HikariPool$PoolInitializationException: Failed to initialize pool: Could not create connection to database server. Attempted reconnect 3 times. Giving up.
Co się za tym kryje: Plugin taki jak LuckPerms lub CoreProtect próbuje połączyć się ze swoją bazą danych MySQL lub MariaDB, ale nazwa użytkownika lub hasło są nieprawidłowe. Przez to plugin nie może ani wczytywać, ani zapisywać danych: w zależności od pluginu w ogóle się nie uruchamia albo działa bez swoich uprawnień, stanów kont lub logów. Pluginy korzystające z puli połączeń HikariCP najpierw zgłaszają „Failed to initialize pool”; dokładną przyczynę podaje linia „Caused by” poniżej. Jeśli widnieje tam using password: NO, w konfiguracji w ogóle nie wpisano hasła.
Jak to naprawić:
- Sprawdź w zakładce Bazy danych lub w swoim dodatku bazy danych, jakie dane dostępowe obowiązują: host, port, nazwę bazy danych, użytkownika i hasło.
- Otwórz w zakładce Pliki konfigurację pluginu, w przypadku LuckPerms na przykład
plugins/LuckPerms/config.yml, sekcjędata. - Wpisz wszystkie wartości dokładnie tak, jak są podane w panelu. Zwróć uwagę na wielkość liter i spacje na końcu.
- Jeśli hasło zawiera znaki specjalne, takie jak
#lub:, umieść je w pojedynczych cudzysłowach. W przeciwnym razie YAML, czyli format tekstowy tych plików, odczyta wartość nieprawidłowo. - Zapisz plik i uruchom serwer ponownie.
Dobrze wiedzieć: Jeśli hasło do bazy danych zostało zresetowane, wpisz nowe w każdej konfiguracji pluginu, która korzysta z tej bazy danych.
„Exception occurred while rotating profiler job“: brakujące lub nieprawidłowe pliki pomiarowe spark
Tak wygląda komunikat:
java.lang.RuntimeException: Unable to create temporary output file
Caused by: java.nio.file.NoSuchFileException: plugins/spark/tmp-client/<File>
Caused by: java.io.IOException: Not a valid JFR file
Co się za tym kryje: spark to profiler, który sprawdza, jak Twój serwer wykorzystuje czas obliczeniowy. Przy NoSuchFileException brakuje pliku pomiarowego albo jego folderu, na przykład plugins/spark/tmp-client lub plugins/spark/tmp. JfrParsingException zgłasza problemy z odczytem danych JFR (Java Flight Recorder); Not a valid JFR file wskazuje nieprawidłowy plik pomiarowy. Serwer działa dalej, dotyczy to tylko pomiaru wydajności.
Jak to naprawić:
- Przeczytaj pełny ślad błędu w Konsola lub w Pliki w
logs/latest.log, wraz z liniami poCaused by:. - Przy
NoSuchFileExceptionsprawdź w Pliki folder podanego pliku. Decydujący jest zgłoszony ścieżka:tmp-clientlubtmp. - Utwórz faktycznie brakujący folder z dokładnie taką samą nazwą. Zachowaj istniejące foldery i pliki pomiarowe.
- Obserwuj Konsola przez kilka minut. Jeśli
Not a valid JFR filesię powtarza albo błędy nadal występują, zgłoś zgłoszenie i podaj czas, zgłoszoną ścieżkę oraz pełny ślad błędu.
Warto wiedzieć: Samo ponowne uruchomienie nie naprawi brakującego folderu. Jak używać sparka do wyszukiwania lagów, pokazuje spark: wykrywanie i rozumienie lagów.
„Communications link failure”: plugin nie może połączyć się ze swoją bazą danych
Tak wygląda komunikat:
<Plugin>-hikari - Connection is not available, request timed out after <Czas>ms.
com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure
The driver has not received any packets from the server.
Co się za tym kryje: Plugin nie może nawiązać połączenia ze swoją bazą danych MySQL lub MariaDB. Typowe przyczyny: host w konfiguracji jest błędny, baza danych jest zatrzymana albo istniejące połączenie zostało przerwane. „Hikari” to pula połączeń, która utrzymuje połączenia z bazą danych dla pluginu. Dopóki problem trwa, plugin nie ma dostępu do swoich danych.
Jak to naprawić:
- Sprawdź, czy Twój dodatek bazy danych działa.
- Porównaj host i port w konfiguracji pluginu z danymi w zakładce Bazy danych lub w dodatku. Użyj dokładnie podanego hosta.
- Zrestartuj serwer i obserwuj komunikaty startowe pluginu w zakładce Konsola.
- Jeśli nie potrzebujesz osobnej bazy danych, przełącz plugin na obsługiwany magazyn lokalny, w przypadku LuckPerms za pomocą
storage-method: h2wplugins/LuckPerms/config.yml. Dane z bazy danych nie zostaną przy tym przeniesione automatycznie.
Warto wiedzieć: Sender does not have applyedits permission w LuckPerms dotyczy uprawnień do zatwierdzania zmian z edytora webowego. Sprawdź w tym celu uprawnienia konta, które wykonuje polecenie.
Grim nie może otworzyć swojej bazy danych historii
Tak wygląda komunikat:
IMPORTANT: Could not load SQLite driver for /grim history database.
Download the minecraft-sqlite-jdbc mod/plugin …, or change history.database.type
Alternatively set history.enabled=false to remove this message …
Co się za tym kryje: Grim to plugin antycheatowy. Za pomocą /grim history pokazuje wcześniejsze analizy dotyczące gracza i zapisuje je w bazie danych SQLite, czyli bazie danych w jednym pliku. Aby ją otworzyć, Grim potrzebuje sterownika SQLite, niewielkiego dodatkowego pakietu do obsługi bazy danych. Tego sterownika brakuje, dlatego baza danych historii jest niedostępna.
Jak to naprawić:
- Zainstaluj w zakładce Pluginy lub Mody zależność minecraft-sqlite-jdbc w wersji pasującej do Twojej wersji Grima.
- Alternatywnie wybierz w konfiguracji Grima w
history.database.typeinną bazę danych historii. - Jeśli nie potrzebujesz historii, wyłącz ją: w konfiguracji jest to wartość
enabledw sekcjihistory, komunikat zapisuje ją jakohistory.enabled=false. - Całkowicie zatrzymaj serwer i uruchom go ponownie.
Warto wiedzieć: Komunikat pojawia się przy każdym starcie, dopóki nie zastosujesz jednego z trzech rozwiązań.
LuckPerms nie może zaktualizować swojej bazy danych
Tak wygląda komunikat:
[LuckPerms] Something went wrong whilst upgrading the LuckPerms database. Please report this on GitHub.
org.h2.jdbc.JdbcSQLSyntaxErrorException: Sequence "<Nazwa>" already exists; SQL statement:
Co się za tym kryje: Przy zmianie wersji LuckPerms dostosowuje strukturę swojej bazy danych do nowej wersji. Ten krok nie powiódł się w całości. Wiersz bezpośrednio po nim, zwykle komunikat H2 lub SQL, wskazuje krok, który się nie udał. H2 to plik bazy danych, który LuckPerms tworzy w folderze plugins/LuckPerms, gdy nie korzystasz z osobnej bazy danych MySQL.
Jak to naprawić:
- Zatrzymaj serwer i utwórz kopię zapasową w zakładce Kopie zapasowe, zanim spróbujesz ponownie.
- Zaktualizuj LuckPerms do aktualnego buildu, który pasuje do Twojego oprogramowania serwera i wersji.
- Nie usuwaj ani nie edytuj ręcznie plików bazy danych.
- Jeśli błąd wystąpi ponownie, przywróć kopię zapasową. Następnie pomogą oficjalna migracja LuckPerms lub wsparcie LuckPerms.
Warto wiedzieć: Dopóki LuckPerms jeszcze działa, za pomocą lp export <Plik> dodatkowo zapiszesz wszystkie uprawnienia i grupy w pliku. lp import <Plik> wczyta je później z powrotem.
Szczegółowo: Bezpieczna aktualizacja LuckPerms: platforma, kopia zapasowa i uprawnienia
„SQLException … does not exist”: brakuje folderu bazy danych SQLite
Tak wygląda komunikat:
java.sql.SQLException: path to 'plugins/<Plugin>/databases/<Plik>.db': '/home/container/plugins/<Plugin>/databases' does not exist
java.sql.SQLException: path to '/home/container/plugins/SimpleEconommy/data.db': '/home/container/plugins/SimpleEconommy' does not exist
java.sql.SQLException: path to 'plugins/MagicAbilities/data.db': '/home/container/plugins/MagicAbilities' does not exist
Co się za tym kryje: Plugin zapisuje swoje dane w bazie danych SQLite, czyli w jednym pliku w folderze pluginu. Sam plik może utworzyć, ale folderu na niego już nie. Dopóki tego folderu brakuje, plugin nie może niczego wczytać ani zapisać, na przykład stanów kont, zestawów czy warpów. Może się tak zdarzyć na przykład wtedy, gdy folder pluginu został usunięty lub przesłany tylko częściowo.
Jak to naprawić:
- Odczytaj brakujący folder bezpośrednio przed
does not exist. Może to być podfolder, taki jakdatabases, lub sam folder pluginu. - Otwórz Pliki i utwórz dokładnie ten folder. Zwróć uwagę na wielkość liter,
Databasesidatabasesto różne foldery. - Zrestartuj serwer i sprawdź, czy komunikat się już nie pojawia.
Warto wiedzieć: /home/container to najwyższy katalog, który widzisz w zakładce Pliki. Tę część ścieżki pomijasz przy tworzeniu folderu.
Plugin wysyła do SQLite polecenia, które zna tylko MySQL
Tak wygląda komunikat:
[SQLITE_ERROR] SQL error or missing database (near "<słowo>": syntax error)
Co się za tym kryje: SQLite i MySQL posługują się prawie, ale nie całkiem tym samym językiem baz danych. Plugin zapisuje swoje dane w SQLite, ale wysyła polecenia, które rozumie tylko MySQL. To błąd w pluginie, a nie w twoich plikach czy ustawieniach. Funkcje, których to dotyczy, niczego nie zapisują. Słowo po near pokazuje, w którym miejscu SQLite nie zrozumiało polecenia.
Jak to naprawić:
- Zaktualizuj plugin w sekcji Pluginy do najnowszej wersji dla twojej wersji serwera. Możliwe, że błąd został tam już naprawiony.
- Jeśli plugin obsługuje MySQL jako magazyn danych, utwórz bazę danych w sekcji Bazy danych, o ile twój plan obejmuje bazy danych.
- W konfiguracji pluginu przestaw magazyn danych na MySQL, wpisz dane dostępowe i uruchom serwer ponownie.
- Jeśli żadne z tych rozwiązań nie pomoże, zgłoś błąd autorowi pluginu i dołącz linię z logu.
Dobrze wiedzieć: Po przejściu na MySQL plugin zazwyczaj nie przenosi samodzielnie dotychczasowych danych z SQLite, chyba że oferuje do tego własną funkcję.
EzShops lub Jaloquent nie mogą połączyć się ze swoim magazynem danych
Tak wygląda komunikat:
[EzShops] Failed to initialise Jaloquent for player shops; falling back to YAML
com.github.ezframework.jaloquent.exception.StorageException: Failed to begin transaction
Co się za tym kryje: Jaloquent to biblioteka, za pomocą której EzShops zapisuje sklepy graczy w bazie danych. W tym przypadku Jaloquent nie mógł rozpocząć transakcji, czyli powiązanej ze sobą operacji zapisu, albo EzShops w ogóle nie zdołał skonfigurować swojego magazynu Jaloquent. Właściwą przyczynę podaje komunikat błędu bezpośrednio pod tym wpisem. EzShops może częściowo przełączyć się na pliki YAML – dane trafiają wtedy do plików zamiast do bazy danych.
Jak to naprawić:
- Przeczytaj w
logs/latest.logkomunikat błędu znajdujący się bezpośrednio pod tą linią. Wskazuje on przyczynę związaną z bazą danych lub magazynem, np. „Access denied” albo „Communications link failure”. - Sprawdź, czy twój dodatek bazy danych działa.
- Sprawdź host, port i dane dostępowe w konfiguracji pluginu, którego to dotyczy.
- Jeśli EzShops przełączył się na YAML, utwórz kopię zapasową w sekcji Kopie zapasowe, zanim cokolwiek zmienisz. Dzięki temu zachowasz sklepy, które w międzyczasie zostały zapisane w YAML.
- Uruchom serwer ponownie.
PvPManager nie może znaleźć folderu swojej bazy danych
Tak wygląda komunikat:
[PvPManager] Failed to batch update database
java.sql.SQLException: path to 'plugins/PvPManager/database.db': '<ścieżka>' does not exist
Co się za tym kryje: PvPManager zarządza walką między graczami i zapisuje ich dane w bazie SQLite plugins/PvPManager/database.db. W systemie plików serwera brakuje jednak folderu plugins/PvPManager. Dlatego PvPManager nie może ani otworzyć swojej bazy danych, ani do niej zapisywać, a nowe dane nie są zapisywane.
Jak to naprawić:
- Zatrzymaj serwer.
- W sekcji Pliki utwórz folder
plugins/PvPManager, zwracając uwagę na dokładną pisownię. Możesz też zainstalować PvPManager od nowa w sekcji Pluginy. - Sprawdź uprawnienia do plików: utwórz testowo plik w nowym folderze i usuń go.
- Sprawdź, czy jest jeszcze wystarczająco dużo wolnego miejsca.
- Uruchom serwer i sprawdź, czy komunikat już się nie pojawia.
Dobrze wiedzieć: Jeśli brakuje miejsca na dysku, pomoże poradnik Brak miejsca na dysku: jak naprawić błąd „No space left on device”.
EssentialsX nie może zapisać swojej pamięci podręcznej UUID
Tak wygląda komunikat:
[Essentials] Error while saving Name->UUID cache
java.io.IOException: No such file or directory
Co się za tym kryje: EssentialsX zapamiętuje, która nazwa gracza należy do którego UUID, czyli stałego identyfikatora konta Minecraft. Tę listę zapisuje jako cache, czyli pamięć podręczną, w swoim folderze danych i najpierw tworzy w tym celu plik tymczasowy. To się nie udaje, ponieważ folder plugins/Essentials nie istnieje lub nie można w nim zapisywać. Jeśli folderu rzeczywiście brakuje, EssentialsX nie może tam zapisać również pozostałych danych.
Jak to naprawić:
- Otwórz sekcję Pliki i sprawdź, czy folder
plugins/Essentialsistnieje. Jeśli nie, utwórz go. - Sprawdź, czy można w nim zapisywać: utwórz w nim testowo plik i usuń go.
- Zaktualizuj EssentialsX w sekcji Pluginy do wersji przeznaczonej dla twojej wersji serwera.
- Uruchom serwer ponownie.
Dobrze wiedzieć: Jeśli w folderze nie da się utworzyć pliku, prawdopodobnie nie należy on do użytkownika, na którym działa twój serwer. Jeśli nie wiesz, co dalej, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.
FastAsyncWorldEdit: plik historii jest uszkodzony
Tak wygląda komunikat:
Could not load block history file plugins/FastAsyncWorldEdit/history/<folder>/<plik>
An unexpected error while handling a FastAsyncWorldEdit command
java.io.EOFException: Stream ended prematurely
Co się za tym kryje: FastAsyncWorldEdit, w skrócie FAWE, zapisuje dla operacji budowania plik historii, aby można je było cofnąć poleceniem //undo. Jeden z tych plików jest niekompletny, najczęściej dlatego, że serwer został zatrzymany, gdy FAWE jeszcze zapisywał dane. Właśnie to jedno //undo nie jest wtedy możliwe. Sam twój świat nie jest tym dotknięty, a serwer działa normalnie dalej.
Jak to naprawić:
- Zazwyczaj nic nie trzeba robić. Komunikat dotyczy tylko tego jednego kroku historii.
- Jeśli komunikat się powtarza, zatrzymaj serwer.
- W sekcji Pliki usuń folder wskazany w komunikacie w
plugins/FastAsyncWorldEdit/history. - Uruchom serwer ponownie.
Dobrze wiedzieć: Po usunięciu nie da się już cofnąć operacji zapisanych w tym folderze. Więcej o //undo: WorldEdit: budowanie i cofanie zmian.
WorldEdit: nie można wczytać zapisanego schowka
Tak wygląda komunikat:
Error loading clipboard from disk
… Size exceeds Integer.MAX_VALUE
Co się za tym kryje: FAWE może zapisywać schowek gracza na dysku. Zapisanego schowka nie udało się wczytać: albo jest za duży – wtedy w komunikacie pojawia się „Size exceeds Integer.MAX_VALUE” – albo jest uszkodzony. Gracz musi ponownie skopiować swój zaznaczony obszar. Nie ma to wpływu na świat ani serwer.
Jak to naprawić:
- Zatrzymaj serwer.
- W sekcji Pliki otwórz folder
plugins/FastAsyncWorldEdit/clipboard. - Usuń plik gracza, którego to dotyczy. Jego nazwa zazwyczaj zawiera UUID gracza, czyli stały identyfikator jego konta Minecraft.
- Uruchom serwer ponownie i poproś gracza, aby ponownie skopiował zaznaczony obszar.
Dobrze wiedzieć: Bardzo duże kopie lepiej zapisywać jako schematic, czyli osobny plik z planem budowli, na przykład poleceniem //schem save <nazwa>. W razie potrzeby wczytasz go z powrotem do schowka poleceniem //schem load <nazwa>.
WorldEdit: schematic zawiera encję bez pozycji
Tak wygląda komunikat:
Failed to load a saved clipboard
java.io.IOException: Missing position for entity <Encja>
Co się za tym kryje: Encje to wszystko w świecie, co nie jest blokiem, na przykład zwierzęta, stojaki na zbroję czy ramki. Zapisany schematic, czyli plik z planem budowli, zawiera encję, której brakuje informacji o pozycji. Dlatego WorldEdit nie może w pełni wczytać tego schematica. Twój świat nie jest tym dotknięty, tylko ten jeden schematic nie daje się poprawnie wkleić.
Jak to naprawić:
- Jeśli budowla nadal stoi w jakimś świecie, zaznacz ją ponownie za pomocą WorldEdit i skopiuj poleceniem
//copybez opcji-e. W ten sposób encje zostaną pominięte. - Zapisz nową kopię poleceniem
//schem save <Nazwa>pod nową nazwą i od teraz używaj tego pliku. - Jeśli masz już tylko sam plik, otwórz go w edytorze schematiców i usuń uszkodzoną encję.
- Następnie wczytaj schematic poleceniem
//schem load <Nazwa>i sprawdź, czy komunikat się już nie pojawia.
Dobrze wiedzieć: Jeśli nie potrzebujesz zwierząt ani ramek w budowli, zapisanie jej bez encji to najszybsze rozwiązanie.
NoSuchFileException przy .cache: brakuje folderu pamięci podręcznej
Tak wygląda komunikat:
java.nio.file.NoSuchFileException: /home/container/.cache/<Plik>
Co się za tym kryje: Mod albo launcher, czyli program startowy, chciał zapisać pliki w folderze .cache w głównym katalogu twojego serwera. Ten folder jednak nie istnieje. Zwykle dzieje się tak po ponownej instalacji albo gdy folder został usunięty podczas porządków. Najczęściej problem rozwiązuje się sam, bo przy następnym uruchomieniu folder zostaje utworzony na nowo.
Jak to naprawić:
- Uruchom serwer ponownie. W większości przypadków komunikat potem znika.
- Jeśli nadal się pojawia, otwórz Pliki i w głównym katalogu utwórz testowo folder. Jeśli to się nie uda, przyczyną mogą być brakujące uprawnienia do zapisu albo zapełniona pamięć. Jeśli folder testowy udało się utworzyć, usuń go potem.
- Sprawdź, czy jest jeszcze wystarczająco dużo wolnego miejsca. Zapełniona pamięć również uniemożliwia tworzenie folderów.
- Jeśli dalej nie wiesz, co zrobić, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.
Dobrze wiedzieć: Przy zapełnionej pamięci pomoże Brak miejsca na dysku: jak naprawić „No space left on device”.
Plugin home nie może zapisać punktu teleportacji
Tak wygląda komunikat:
Failed to create home for player <ID gracza> in the database.
Co się za tym kryje: Home to zapisany punkt teleportacji. Odpowiedzialny za to plugin próbuje utworzyć nowy wpis w swojej bazie danych i mu się to nie udaje. Nowy wpis home nie zostaje zapisany; serwer działa dalej. Konkretna przyczyna po stronie bazy danych jest zwykle podana w sąsiednich komunikatach błędów.
Jak to naprawić:
- Otwórz w Konsola lub w Pliki w
logs/latest.logwiersze bezpośrednio przed komunikatem i po nim. Poszukaj nazwy pluginu i powiązanego komunikatu błędu bazy danych. - Sprawdź konfigurację zapisu danych tego pluginu. Jeśli korzysta z zewnętrznej bazy danych, porównaj adres, nazwę bazy i dane dostępowe z Bazy danych.
- Zrób kopię zapasową istniejącej bazy danych, zanim zmienisz jej ustawienia lub tabele. Następnie usuń konkretnie wskazany błąd zgodnie z dokumentacją pluginu.
- Spróbuj ponownie utworzyć home. Jeśli błąd nadal występuje, zgłoś go autorowi, podając pełny ślad błędu i godzinę.
Dobrze wiedzieć: Usunięcie bazy danych usuwa również wszystkie już zapisane punkty home.
„Could not write … NoSuchFileException”: VexBot nie może zapisać swojego pliku JSON
Tak wygląda komunikat:
[VexBot] Could not write <Plik>.json: java.nio.file.NoSuchFileException: <Ścieżka>
Co się za tym kryje: VexBot próbuje zapisać dane pluginu w pliku JSON. JSON to format tekstowy dla danych strukturalnych. Java zgłasza, że podana ścieżka nie istnieje. Serwer działa dalej, ale ta operacja zapisu pluginu kończy się niepowodzeniem.
Jak to naprawić:
- Najpierw zrób kopię istniejącego jeszcze folderu VexBot w zakładce Pliki i zatrzymaj serwer przed wprowadzaniem zmian.
- Porównaj ścieżkę w zakładce Konsola z istniejącymi folderami. Sprawdź też pisownię.
- Przywróć brakujący folder pluginu z kopii zapasowej lub z pełnej instalacji pluginu. Jeśli brakuje używanego dotąd pliku z danymi, użyj jego kopii zapasowej zamiast pustego pliku zastępczego.
- Uruchom serwer ponownie i sprawdź zakładkę Konsola. Jeśli komunikat się powtarza, otwórz zgłoszenie i podaj godzinę oraz ścieżkę, której dotyczy problem.
DGspawners nie może zapisać spawners.yml lub storage.yml
Tak wygląda komunikat:
[DGspawners] Could not save spawners.yml!
[DGspawners] Could not save storage.yml!
Co się za tym kryje: Plugin nie mógł zapisać jednego ze swoich plików z danymi. Serwer działa dalej, ale zmiany w pamięci operacyjnej nie zostają trwale zapisane przy tej nieudanej operacji. Po ponownym uruchomieniu takich zmian zabraknie. Właściwa przyczyna jest często podana w sąsiednim komunikacie błędu.
Jak to naprawić:
- Przeczytaj w
logs/latest.logwiersze bezpośrednio przed komunikatem i po nim. Zwróć uwagę na brakującą ścieżkę, brak miejsca na dysku lub odmowę dostępu. - Zrób kopię zapasową istniejących plików DGspawners w Pliki, zanim je zmienisz.
- Usuń konkretnie wskazaną przyczynę. Nie zastępuj zapisanych danych pluginu pustymi plikami.
- Następnie sprawdź Konsola pod kątem kolejnych błędów zapisu. Jeśli nie możesz sobie poradzić, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.
Baza danych nie może wykonać instrukcji SQL
Tak wygląda komunikat:
Could not execute sql statement.
Co się za tym kryje: Plugin chciał wykonać instrukcję w bazie danych, ale operacja się nie powiodła. SQL to język używany do takich zapytań i zmian. Ten krótki nagłówek wskazuje tylko nieudaną operację; konkretna przyczyna błędu jest podana w sąsiednich komunikatach bazy danych. Po usunięciu problemu trzeba ponownie sprawdzić daną operację.
Jak to naprawić:
- Otwórz w Konsola lub w
logs/latest.logpełny blok błędu i ustal, który plugin go zgłasza. - Przeczytaj powiązany komunikat bazy danych. Przy problemach z dostępem lub połączeniem sprawdź konfigurację pluginu w Pliki oraz przewidziane dane w Bazy danych; przy błędach tabel zajrzyj do instrukcji dla danej wersji pluginu.
- Zrób kopię zapasową danych, których to dotyczy, przed wprowadzeniem poprawek. Następnie wykonaj ponownie daną operację pluginu i sprawdź, czy kończy się powodzeniem.
Towny nie może ukończyć kopii zapasowej
Tak wygląda komunikat:
[Towny] Error: Could not create backup.
java.io.IOException: Request to write '<Liczba>' bytes exceeds size in header of '<Liczba>' bytes for entry '<Plik>'
Co się za tym kryje: Towny tworzy archiwum swoich danych. Dla jednego z zawartych plików w nagłówku archiwum zapisano określony rozmiar, jednak podczas kopiowania napływa więcej danych. Dlatego archiwizacja zostaje przerwana. Nieudanej kopii zapasowej nie możesz używać jako pełnego punktu przywracania.
Jak to naprawić:
- Zachowaj ostatnią poprawnie utworzoną kopię zapasową Towny. Nie zastępuj jej przerwanym archiwum.
- Zatrzymaj serwer i w sekcji Kopie zapasowe utwórz kopię zapasową bieżącego stanu. Dzięki temu dane pluginu będą chronione przed dalszymi zmianami.
- Sprawdź w sekcji Pluginy, czy jest dostępne nowsze wydanie Towny dla Twojej wersji serwera. Zainstaluj je przy zatrzymanym serwerze, a następnie uruchom go ponownie.
- Sprawdź w Konsola, czy Towny pomyślnie ukończy swoją następną kopię zapasową. Jeśli błąd się powtarza, przekaż autorowi Towny pełny blok błędu oraz używane wersje.
VaultEconomy: tożsamość konta nie zgadza się z zapisanymi danymi
Tak wygląda komunikat:
[VaultEconomy] Login identity/storage check failed
java.lang.IllegalArgumentException: UUID для ника изменился.
Co się za tym kryje: VaultEconomy porównuje bieżącą tożsamość konta ze swoimi zapisanymi danymi. UUID, czyli unikalny identyfikator konta, zmienił się dla znanej nazwy. Plugin odmawia automatycznego scalenia kont ekonomicznych. Weryfikacja tożsamości tego konta kończy się niepowodzeniem; pozostałe konta mogą działać dalej.
Jak to naprawić:
- Zabezpiecz dane ekonomiczne, których to dotyczy, zanim cokolwiek zmienisz. Dla plików serwera użyj sekcji Kopie zapasowe, a dla zewnętrznej bazy danych jej własnej procedury tworzenia kopii zapasowych.
- Sprawdź w Konsola wcześniejsze komunikaty oraz niedawne zmiany trybu logowania i proxy.
- Porównaj przekazywanie tożsamości między proxy a serwerem docelowym z ich dokumentacją. Używaj spójnego, zabezpieczonego logowania.
- Ewentualną konieczną zmianę konta wyjaśnij na podstawie dokumentacji VaultEconomy. Nie usuwaj istniejących kont. Jeśli utkniesz, otwórz zgłoszenie i podaj godzinę wystąpienia błędu.
Baza danych SQLite została przeniesiona po otwarciu
Tak wygląda komunikat:
org.sqlite.SQLiteException: [SQLITE_READONLY_DBMOVED]
The database file has been moved since it was opened
Co się za tym kryje: SQLite zapisuje dane pluginu w pliku. Jeśli ten plik został przeniesiony lub zmieniono jego nazwę po otwarciu, SQLite odmawia dalszych zapisów przez stare połączenie. W rezultacie plugin przestaje zapisywać swoje zmiany; serwer działa dalej.
Jak to naprawić:
- Poszukaj w Konsola lub w
logs/latest.logpluginu, którego to dotyczy. Łańcuch wywołań pod błędem nazywa się stacktrace i pomaga ustalić źródło. - Zatrzymaj serwer. Zabezpiecz w sekcji Pliki cały folder danych pluginu, łącznie z istniejącymi plikami towarzyszącymi.
- Sprawdź niedawne zmiany plików lub przywracania oraz oczekiwaną ścieżkę bazy danych. Przywróć przewidzianą ścieżkę.
- Uruchom serwer ponownie i sprawdź, czy plugin znów zapisuje dane. Jeśli błąd nie znika, otwórz zgłoszenie i podaj godzinę wystąpienia błędu.
LuckPerms nie może zapisać zbyt długiego kontekstu serwera
Tak wygląda komunikat:
[LuckPerms] Error whilst saving user
Value too long for column "SERVER CHARACTER VARYING(<Długość>)"
Co się za tym kryje: LuckPerms próbuje zapisać kontekst serwera, którego tekst jest dłuższy, niż pozwala kolumna bazy danych. Dana zmiana uprawnień nie zostaje pomyślnie zapisana i po ponownym wczytaniu nie jest niezawodnie dostępna. Kontekst określa, na którym serwerze ma obowiązywać dane uprawnienie. Ręczne powiększanie kolumny bazy danych nie jest potrzebne, aby poprawić nieprawidłowy wpis.
Jak to naprawić:
- Sprawdź w konsoli komunikat Value too long for column oraz podaną tam dozwoloną długość dla SERVER.
- Utwórz kopię zapasową w sekcji Kopie zapasowe i popraw zbyt długi kontekst w przypisaniu LuckPerms lub w jego konfiguracji zgodnie z instrukcją pluginu.
- Zapisz ponownie poprawioną zmianę uprawnień i sprawdź wyjście; następnie upewnij się, że LuckPerms znów potrafi wczytać ten wpis.
VaultEconomy nie uruchamia się bez powiązanej bazy danych
Tak wygląda komunikat:
[VaultEconomy] Startup aborted. Existing balances were not replaced with zeros.
Bound SQLite database missing
Co się za tym kryje: VaultEconomy nie znajduje dotychczas powiązanej bazy danych SQLite i przerywa uruchamianie pluginu. System ekonomii tego pluginu jest niedostępny; istniejące salda kont celowo nie są przy tym zastępowane zerami. SQLite zapisuje dane w lokalnych plikach. Nowa, pusta baza danych nie przywróci dotychczasowych sald.
Jak to naprawić:
- Zatrzymaj serwer i zabezpiecz bieżący stan w sekcji Kopie zapasowe, zanim zastąpisz pliki bazy danych lub zmienisz ustawienia.
- Sprawdź w sekcji Pliki ścieżkę bazy danych powiązaną w konfiguracji pluginu i przywróć odpowiednią bazę danych z pasującej kopii zapasowej.
- Uruchom serwer ponownie dopiero z właściwą bazą danych i sprawdź salda kont oraz konsolę; jeśli przyporządkowanie jest niejasne, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.
LibreLogin nie ma połączenia ze swoją bazą danych SQLite
Tak wygląda komunikat:
IllegalStateException: Not connected to the database!
AuthenticSQLiteDatabaseConnector.obtainInterface
Co się za tym kryje: LibreLogin próbuje podczas logowania uzyskać dostęp do swojej bazy danych SQLite, mimo że połączenie z bazą danych nie zostało nawiązane. Weryfikacja danych logowania kończy się niepowodzeniem i może uniemożliwić dołączenie do serwera. Komunikat błędu dotyczy lokalnego połączenia SQLite. Nowa, pusta baza danych nie przejęłaby zapisanych danych logowania.
Jak to naprawić:
- Odczytaj w sekcji Pliki w logs/latest.log pierwszy komunikat bazy danych LibreLogin przed tym śladem błędu i sprawdź, czy błąd pojawia się podczas uruchamiania, czy zatrzymywania.
- Zatrzymaj serwer, zabezpiecz stan w sekcji Kopie zapasowe i sprawdź w sekcji Pliki, czy skonfigurowany plik SQLite i jego folder istnieją.
- Usuń przyczynę zgłoszoną jako pierwszą, sprawdź w sekcji Pluginy zgodne aktualizacje i po pełnym ponownym uruchomieniu ponownie przetestuj logowanie.
UniversalAdmin: brakuje zapisanych pseudonimów
Tak wygląda komunikat:
[UniversalAdmin.core:nick] Could not load the nick of <Gracz> - they join without it
[UniversalAdmin.core:nick] Could not load the nicks
Co się za tym kryje: UniversalAdmin nie może odczytać swojego magazynu pseudonimów. Gracz, którego to dotyczy, dołącza bez zapisanego pseudonimu; pobranie całej listy również może się nie powieść. Serwer działa dalej. Poniższy ślad błędu, zwany też stacktrace, wskazuje niżej konkretny błąd zapisu danych.
Jak to naprawić:
- Otwórz
logs/latest.logw sekcji Pliki lub przejrzyj Konsola. Znajdź ostatnią linię „Caused by” w pełnym śladzie błędu. - Przed wprowadzeniem zmian zrób kopię danych pluginu. Porównaj ustawienia zapisu danych UniversalAdmin ze zgłoszoną przyczyną; jeśli korzystasz z zewnętrznej bazy danych, sprawdź też dostęp i osiągalność w sekcji Bazy danych.
- Usuń konkretnie wskazany błąd i uruchom serwer ponownie w pełni. Następnie sprawdź dołączanie do serwera i listę pseudonimów. Jeśli błąd nadal występuje, zgłoś autorowi pluginu oczyszczony ślad błędu.
„SQLITE_IOERR_SHMSIZE”: baza danych pluginu nie może zapisywać
Tak wygląda komunikat:
org.sqlite.SQLiteException: [SQLITE_IOERR_SHMSIZE] I/O error within xShmMap while trying to resize an existing shared memory segment (disk I/O error)
Co się za tym kryje: SQLite to baza danych w jednym pliku w folderze pluginu, używana na przykład przez CoreProtect. Obok tego pliku SQLite tworzy plik pomocniczy z rozszerzeniem .db-shm i nie mógł go powiększyć. Najczęściej brakuje miejsca na dysku albo zapis został odrzucony. Plugin traci dane z tej operacji zapisu, a serwer działa dalej.
Jak to naprawić:
- Sprawdź w Ustawienia i abonament → Plan, ile miejsca na dysku ma Twój serwer i ile jest zajęte.
- Usuń w zakładce Pliki stare logi i niepotrzebne już kopie zapasowe.
- Uruchom serwer ponownie.
- Jeśli błąd nadal występuje, utwórz bazę danych w zakładce Bazy danych i przełącz na nią plugin, jeśli obsługuje MySQL.
Dobrze wiedzieć: Nigdy nie usuwaj pliku .db-shm, gdy serwer działa, ponieważ należy on do bazy danych.
LuckPerms: Lokalna baza danych H2 jest już używana
Tak wygląda komunikat:
org.h2.jdbc.JdbcSQLNonTransientConnectionException: Database may be already in use: "<Plik>.mv.db"
Co się za tym kryje: H2 to w tym przypadku lokalna baza danych, w której LuckPerms przechowuje uprawnienia. Inny proces lub inna instancja pluginu ma już otwarty ten sam plik. Dlatego nowa próba dostępu do bazy danych kończy się niepowodzeniem. Serwer działa dalej, ale nie można wczytać ani zmienić danych uprawnień, których to dotyczy.
Jak to naprawić:
- Całkowicie zatrzymaj serwer. Następnie zrób kopię folderu danych LuckPerms w zakładce Pliki, aby zachować istniejącą bazę danych uprawnień.
- Sprawdź w zakładkach Pluginy i Pliki, czy LuckPerms nie jest zainstalowany kilka razy. Zostaw jeden odpowiedni plik pluginu i unikaj przeładowywania go podczas pracy serwera.
- Upewnij się, że żaden drugi serwer ani narzędzie do baz danych nie trzyma otwartego tego samego lokalnego pliku H2. Następnie uruchom tylko przewidzianą instancję.
- Sprawdź Konsolę i działanie funkcji uprawnień. Jeśli blokada nie ustąpi, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu. Nie usuwaj bazy danych ani plików blokady, gdy trwa dostęp do nich.
Twojego komunikatu tu nie ma?
Przeczytaj cały komunikat w logs/latest.log, a także linie przed nim i po nim. Przy błędach bazy danych właściwa przyczyna często znajduje się w linii z „Caused by”. Który plugin jest dotknięty problemem, zdradzają nazwa w nawiasach kwadratowych i nazwy folderów w stacktrace, czyli w liniach at … pod komunikatem, na przykład me/lucko/luckperms dla LuckPerms. Następnie sprawdź dane dostępowe, foldery i wolne miejsce. Przed każdą zmianą utwórz kopię zapasową. Jeśli nie wiesz, co dalej, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.