Plugin, który się nie wczytuje: co mówi Paper i czego od Ciebie chce

Zacznij od komendy plugins

Wpisz plugins w zakładce „Konsola” albo /plugins w grze jako operator; pl robi to samo. Odpowiedź zaczyna się od Server Plugins i łącznej liczby, a potem dzieli nazwy na pluginy Paper i pluginy Bukkit. W grze każda nazwa ma kolor i ten kolor to Twoja pierwsza wskazówka. Konsola panelu usuwa kolory serwera, więc tam kierujesz się nazwą.

Initializing plugins...
Initialized 2 plugins
Bukkit plugins (2):
 - LuckPerms (5.5.71), Vault (2.20.2)

To podsumowanie startu to najbardziej przydatna lista, jaką masz. Plugin wymieniony tutaj został poprawnie przeczytany i zawiódł później, więc szukaj jego nazwy niżej. Plugin, którego tu brakuje, został pominięty, zanim Paper poznał jego nazwę, co wskazuje na sam plik. Kliknięcie nazwy w grze uruchamia /version dla tego pluginu i pokazuje, które wydanie naprawdę działa.

Linijka, która podaje powód

W zakładce „Konsola” ustaw menu poziomu na „Błędy” i szukaj linijek zaczynających się od Could not load albo Error occurred while enabling. Powód stoi w linijkach pod nimi, które nie mają słowa ERROR, więc ten filtr je ukrywa. Gdy znasz już nazwę pluginu, wróć do „Wszystkie poziomy” i wpisz nazwę w „Szukaj w logach...”. Cały przebieg jest w logs/latest.log, a poradnik o logach i raportach crashy pokazuje, jak czytać stack trace.

Jedna linijka wygląda groźnie, a jest nieszkodliwa: The spark plugin will not be loaded as this server bundles the spark profiler. Paper już zawiera spark, więc dodatkowy jar jest pomijany, a komendy spark dalej działają.

Unknown dependency, miękkie zależności i kolejność wczytywania

Could not load 'plugins/<file>.jar' in 'plugins'
org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Vault].
Please download and install these plugins to run '<plugin>'.

Każdy plugin niesie krótki opis samego siebie, w tym innych pluginów, na których polega. Paper zna trzy rodzaje takich relacji, a tylko jedna może zatrzymać wczytanie pluginu:

Nazwy w nawiasach to nazwy pluginów, a nie nazwy plików, i muszą się dokładnie zgadzać. Ma to znaczenie przy Vault: jego ostatnie wydanie pochodzi z lipca 2020. VaultUnlocked jest nadal aktualizowany pod 26.2 i w swoim opisie nazywa się Vault, więc zadowala pluginy, które proszą o Vault. VaultUnlocked i LuckPerms są w katalogu pluginów w zakładce „Pluginy”. Paper wymienia w tej jednej linijce każdą brakującą twardą zależność pluginu, więc zainstaluj je wszystkie przed restartem. Poradnik o ekonomii wyjaśnia, do czego służy Vault.

Pluginy Paper deklarują to inaczej

Nowsze pluginy mogą używać zamiast tego paper-plugin.yml. Wymieniają zależności osobno dla wczesnego etapu bootstrap i dla działającego serwera, każdą oznaczoną jako required albo nie i wczytywaną BEFORE albo AFTER, albo z pominiętą kolejnością jako OMIT. W przeciwieństwie do pluginów Bukkit nie dostają pomocy, gdy dwa pluginy czekają na siebie nawzajem. Pojawiają się na liście pod Paper Plugins, a Paper ostrzega, że nie obsługują przeładowania, więc zamiast tego zrestartuj.

Unsupported API version albo za stara Java

Could not load plugin '<file>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: Unsupported API version 26.2

api-version w plugin.yml podaje wersję Minecrafta, pod którą plugin zbudowano, a serwer starszy od niej go odrzuca. Liczba w błędzie należy do pluginu: oznaczony 26.2 nie wczyta się na 26.1.2, a oznaczony 1.21.4 nie wczyta się na 1.21.1, bo od 1.20.5 liczy się też ostatnia część numeru.

• Weź wydanie zrobione dla Twojej wersji. W katalogu pluginów lista „Wersja” na każdej karcie zawiera tylko wydania dopasowane do typu i wersji serwera pokazanych obok tytułu katalogu.
• Albo podnieś serwer do wersji, której chce plugin, jeśli Twoje pozostałe pluginy też tam istnieją.

Plugin bez żadnego api-version nadal się wczytuje, z ostrzeżeniem Legacy plugin ... does not specify an api-version. i żółtą gwiazdką na liście. Paper opisuje takie pluginy jako zrobione na bardzo starych, niewspieranych wersjach gry.

Za tą samą linijką Could not load plugin może też stać błąd class file version. Chodzi wtedy o Javę, a nie Minecrafta: plugin skompilowano dla nowszej Javy, niż ma Twój serwer. Poradnik o wersji Javy zamienia obie liczby na wersje Javy i wyjaśnia, jak nasz panel wybiera środowisko uruchomieniowe.

Pliki, które nigdy nie były pluginem dla tego serwera

Paper bierze pod uwagę tylko pliki kończące się na .jar, które leżą bezpośrednio w folderze plugins, i w każdym z nich szuka paper-plugin.yml albo plugin.yml. Wszystko inne jest ignorowane bez słowa albo odrzucane jedną linijką.

Wiele projektów publikuje osobne pobranie dla każdej platformy, a rozróżnia je nazwa pliku. LuckPerms ma dla jednego wydania jary LuckPerms-Bukkit, LuckPerms-Velocity i LuckPerms-Bungee, do tego pliki Fabric, Forge i NeoForge. Paper i Purpur potrzebują tego z Bukkit; plik Velocity należy do proxy sieci.

Archiwum w plugins dostaje w zakładce „Pliki” przycisk „Rozpakuj”. Potem otwórz każdy folder, który powstał: jar w środku nadal leży o jeden poziom za głęboko. Najprościej rozpakować na własnym komputerze, wysłać tylko jar i usunąć archiwum.

Dwie kopie tego samego pluginu

Ambiguous plugin name 'LuckPerms' for files 'plugins/LuckPerms-Bukkit-5.5.71.jar' and 'plugins/LuckPerms-Bukkit-5.5.53.jar' in 'plugins'

Wysłanie nowej wersji obok starej, zamiast na jej miejsce, zostawia dwa jary z tą samą nazwą pluginu. Paper zatrzymuje jeden i nie sprawdza, który jest nowszy, więc stare wydanie może dalej działać, podczas gdy Ty myślisz, że aktualizacja się udała.

1. 1

   Usuń starszy jar

   „Installed on this server” w zakładce „Pluginy” wymienia każdy jar z jego rozmiarem; powyżej dwudziestu pluginów pomaga „Filtruj po nazwie pliku”. Użyj „Usuń” przy starym pliku, a jeśli okno proponuje usunięcie folderu ustawień, zostaw to niezaznaczone: nowszy jar używa tego samego folderu.

2. 2

   Zajrzyj do plugins/update

   Jeśli w plugins istnieje folder update, jar w nim zastępuje przy następnym starcie plugin o tej samej nazwie, a potem opuszcza ten folder. Zapomniana stara kopia w tym miejscu po cichu cofa Twoją aktualizację.

3. 3

   Zrestartuj i potwierdź

   Zrestartuj i uruchom version z nazwą pluginu, żeby zobaczyć, które wydanie działa.

Wczytany, a potem nie udało się go włączyć

Enabling <plugin> v<version>
Error occurred while enabling <plugin> v<version> (Is it up to date?)

Tutaj jar był w porządku, a plugin zaczął własną konfigurację, która się nie udała. Linijki Caused by: pod spodem zwykle prowadzą do tego pluginu, a nie do Papera. Pytanie Papera w nawiasie wskazuje pierwszą rzecz do sprawdzenia: wydanie zrobione dla innej wersji serwera.

Cannot load plugins/<plugin>/config.yml
mapping values are not allowed here
found character ... that cannot start any token. (Do not use ... for indentation)

Pierwszy komunikat często oznacza wartość zawierającą dwukropek bez cudzysłowów wokół. Drugi to tabulator, którego YAML nie przyjmuje we wcięciach. Oba podają numer linii i kolumny: otwórz plik przez „Edytuj” w zakładce „Pliki”, przejdź do tej linii i wcinaj tylko spacjami.

Gdy pliku nie da się uratować, użyj „Zmień nazwę”, na przykład na config.yml.broken, i zrestartuj. Jeśli plugin tworzy domyślne ustawienia przy starcie, zapisze świeży plik, a Ty przepiszesz do niego swoje wartości z pliku o zmienionej nazwie.

Sposób na znalezienie winowajcy

Gdy żadna linijka nie wskazuje pluginu, na przykład gdy dwa pluginy walczą o jedną komendę, zawężaj celowo. Paper pomija pliki, które nie kończą się na .jar, więc zmiana nazwy wyłącza plugin bez usuwania czegokolwiek.

1. 1

   Zapisz obecny stan

   Zrestartuj raz i skopiuj podsumowanie startu oraz wynik plugins. To przywrócisz na końcu.

2. 2

   Zostaw biblioteki włączone

   Pluginy, od których zależą inne, takie jak VaultUnlocked albo plugin uprawnień, zostają aktywne. Odstawienie ich dodaje tylko linijki unknown dependency i zaciemnia test.

3. 3

   Odstaw połowę pozostałych

   W zakładce „Pliki” otwórz plugins i przez „Zmień nazwę” dodaj .off do połowy pozostałych jarów, tak że Example.jar staje się Example.jar.off. Zrestartuj serwer zamiast przeładowywać.

4. 4

   Dziel dalej

   Problem zniknął? Jest w odstawionej połowie, więc włącz z powrotem połowę z nich. Nadal jest? Odstaw połowę aktywnych. Trzydzieści pluginów to około pięciu rund.

5. 5

   Przywróć nazwy

   Usuń .off z każdego pliku o zmienionej nazwie, zrestartuj i porównaj plugins ze swoją pierwszą listą.

Jeśli po drodze sam serwer przestanie startować, to inny problem, opisany w poradniku o starcie. Wybór oprogramowania serwera na początek opisuje porównanie Paper, Purpur i Spigot.