Instalacja pluginów na serwerze Minecraft (Paper, Purpur)

Pluginy dodają do serwera polecenia, ochronę budowli, ekonomię, minigry i wiele więcej. Gracze nie muszą niczego instalować. Ten poradnik pokazuje instalację jednym kliknięciem bezpośrednio w strefie klienta, ręczne wgrywanie pliku, konfigurację pluginu, aktualizacje i naprawę najczęstszych błędów.

Zanim zaczniesz#

• Pluginy działają tylko na Paperze, Purpurze i Folii. Na Fabricu, Forge i NeoForge zamiast pluginów używa się modów, a zakładka nazywa się Mody, zobacz Mody i modpacki. Vanilla nie obsługuje ani jednego, ani drugiego. Różnicę wyjaśnia artykuł Pluginy czy mody?
• Plugin musi obsługiwać Twoją wersję Minecrafta. Plugin dla starszej wersji często się nie ładuje albo zachowuje się nieprzewidywalnie.
• Na Folii działa tylko mniejszość pluginów. Plugin musi wyraźnie deklarować wsparcie Folii.
• Plugin może na serwerze wszystko. Dokumentacja Papera zwraca uwagę, że pluginy mają pełny i nieograniczony dostęp do serwera. Instaluj tylko pluginy z zaufanych źródeł.

Instalacja przez strefę klienta#

1. Otwórz Moje usługi, kliknij swój serwer i przejdź do zakładki Pluginy.

2. Kliknij podzakładkę Przeglądaj. Bez wyszukiwania zobaczysz najczęściej pobierane pluginy dla Twojego typu i wersji serwera.

3. W przełączniku Źródło wybierz katalog (wyjaśnienie poniżej). Zacznij od Modrinth.

4. W polu „Szukaj pluginów” wpisz nazwę, na przykład LuckPerms, i kliknij Szukaj.

5. Przy pluginie kliknij Zainstaluj. Jeśli chcesz inną wersję niż najnowsza, kliknij najpierw Wersje i wybierz ją z listy.

6. Przejrzyj okno Instalacja …:

   • Plik główny – plik pluginu, który zostanie wgrany do folderu plugins.
   • Wymagane zależności – inne pluginy, bez których plugin się nie uruchomi. Strefa klienta zainstaluje je razem z nim. Odznacz tylko te, które masz już na serwerze wgrane ręcznie.
   • Ostrzeżenia o plikach o tej samej nazwie, które instalacja nadpisze, i o pluginach, z którymi według autora nie działa.
   • Do pobrania – łączny rozmiar.

7. Kliknij Zainstaluj.

   Po zakończeniu zobaczysz komunikat Zainstalowano: z listą plików i informację „Zmiany zadziałają po restarcie serwera”.

8. Kliknij Zrestartuj i potwierdź. Pluginy ładują się tylko przy starcie serwera.

Źródła pluginów#

Suma kontrolna potwierdza, że plik trafił na serwer dokładnie w takiej postaci, w jakiej opublikował go autor. Pluginy dostępne tylko na SpigotMC lub na stronie autora wgraj ręcznie, zobacz Instalacja ręczna.

Inne oznaczenia w wynikach:

• Tylko zewnętrznie – autor hostuje plik gdzie indziej (często płatne pluginy). Nie da się go zainstalować automatycznie; pobierz go ze strony autora i wgraj ręcznie.
• Nietestowane na … – autor nie deklaruje dla tego wydania wsparcia Twojej wersji Minecrafta. Może działać, ale bez gwarancji.
• Stabilna, Beta, Alpha – kanał wydania. Na serwer z graczami instaluj wersje stabilne.

Instalacja ręczna#

Ręcznie wgrywasz pluginy, których nie ma w katalogu, na przykład płatne.

1. Pobierz plugin na komputer z oficjalnej strony autora albo z katalogu (Modrinth, Hangar, SpigotMC). Plik musi mieć rozszerzenie .jar. Jeśli pobrałeś .zip, rozpakuj go na komputerze i poszukaj w środku pliku .jar.
2. W strefie klienta przejdź do zakładki Pliki i otwórz folder plugins.
3. Kliknij Prześlij i wybierz plik .jar. Możesz go też przeciągnąć myszą na listę. Jeden plik może mieć najwyżej 100 MB.
4. Zrestartuj serwer w zakładce Konsola przyciskiem Restart.

Plugin musi leżeć bezpośrednio w folderze plugins. Serwer nie czyta podfolderów. W zakładce Pluginy ręcznie wgrany plugin pojawia się z oznaczeniem Przesłano ręcznie. Strefa klienta nie śledzi wersji ani aktualizacji takiego pluginu.

Weryfikacja#

1. Po restarcie obserwuj konsolę. Pomyślnie załadowany plugin zgłasza się linią taką jak ta:

   [12:00:08 INFO]: [LuckPerms] Enabling LuckPerms v<WERSJA>

   Zamiast <WERSJA> zobaczysz numer wersji pluginu.

2. Wpisz w konsoli plugins. Polecenie wypisze pluginy. W grze zobaczysz kolory: działające pluginy na zielono, pluginy, których nie udało się włączyć, na czerwono.

3. Szczegóły konkretnego pluginu pokaże polecenie version <NAZWA_PLUGINU>, na przykład version LuckPerms.

Konfiguracja pluginu (config.yml)#

Większość pluginów przy pierwszym starcie tworzy folder plugins/<NAZWA_PLUGINU>, a w nim plik config.yml. Na przykład LuckPerms trzyma ustawienia w plugins/LuckPerms/config.yml.

1. W zakładce Konsola zatrzymaj serwer przyciskiem Stop. Niektóre pluginy przy wyłączaniu nadpisują swój plik i Twoje zmiany by przepadły.
2. W zakładce Pliki otwórz plugins/<NAZWA_PLUGINU>/config.yml i kliknij Edytuj.
3. Zmień wartości i zapisz (Ctrl+S).
4. Uruchom serwer.

Pliki .yml są w formacie YAML. Jest on wrażliwy na drobiazgi:

# Linia zaczynająca się od krzyżyka to komentarz, serwer ją ignoruje.
nastaveni:
  zprava: "&aWitaj na serwerze!"
  max-domovu: 3
  zapnuto: true
  zakazane-svety:
    - world_nether
    - world_the_end

• Wcięcia tylko spacjami, nigdy tabulatorem. Tabulator powoduje błąd ładowania. Wcięcie decyduje, co do czego należy (zprava należy do nastaveni).
• Po dwukropku zawsze spacja: max-domovu: 3, a nie max-domovu:3.
• Tekst ze znakami specjalnymi bierz w cudzysłów. Zwłaszcza tekst zaczynający się od & albo zawierający : lub #.
• Lista to seria linii zaczynających się od myślnika i spacji, wciętych pod kluczem.
• true i false oznaczają włączone i wyłączone.

Aktualizacja pluginów#

1. W zakładce Pluginy zostań w podzakładce Zainstalowane.
2. Kliknij Sprawdź aktualizacje. Zobaczysz albo „Wszystko jest aktualne.”, albo „Dostępne aktualizacje:” z liczbą.
3. Przy pluginie kliknij Aktualizuj do …, sprawdź okno i potwierdź przyciskiem Aktualizuj.
4. Zrestartuj serwer.

Przed aktualizacją przeczytaj listę zmian na stronie projektu (link Strona projektu). Główne wersje (na przykład z 2.x na 3.x) mogą zmienić konfigurację. Przed większą aktualizacją zrób kopię zapasową, zobacz Kopie zapasowe serwerów gier. Ręcznie wgrany plugin aktualizujesz tak, że usuwasz stary .jar i wgrywasz nowy. Dwa pliki tego samego pluginu w jednym folderze powodują błąd.

Wyłączanie i usuwanie pluginu#

• Wyłącz – plugin nie załaduje się przy następnym starcie, ale zostaje na dysku razem z ustawieniami. Plik zostaje przemianowany na <plik>.jar.disabled. Przycisk Włącz przywraca go z powrotem.
• Usuń – usuwa plik pluginu z folderu plugins. Ustawienia i dane pluginu w folderze plugins/<NAZWA_PLUGINU> zostają, więc plugin znajdzie je po ponownej instalacji.

Zmiany zadziałają po restarcie serwera.

Bezpieczeństwo#

• Pobieraj pluginy tylko z katalogów (Modrinth, Hangar, SpigotMC) albo z oficjalnej strony autora.
• Nigdy nie instaluj „scrackowanych” ani „leakniętych” płatnych pluginów. Często są zmodyfikowane tak, aby atakujący przejął kontrolę nad serwerem albo zdobył uprawnienia operatora.
• Nie instaluj pluginów, których nikt nie aktualizował od lat. Często nie działają z nowymi wersjami i mają znane błędy.
• Nie instaluj obok siebie pluginów, które robią to samo (na przykład dwóch pluginów do uprawnień).

Sprawdzone propozycje pluginów znajdziesz w artykule Polecane pluginy.

Rozwiązywanie problemów#

Błędów pluginów szukaj w konsoli podczas startu serwera. Pełny log jest w pliku logs/latest.log (zakładka Pliki).

Could not load 'plugins/….jar' in folder 'plugins' i UnknownDependencyException#

[00:00:00] [Server thread/WARN] Could not load 'plugins/MyAwesomePlugin-1.0.0.jar' in folder 'plugins'
[00:00:00] [Server thread/WARN] org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'MyAwesomePlugin'.

Pluginowi brakuje innego pluginu, od którego zależy. Jego nazwa jest w nawiasach kwadratowych (tutaj Vault). Zainstaluj go i zrestartuj serwer.

Invalid plugin.yml#

Plik nie jest pluginem dla Papera. Najczęściej to mod dla Fabrica lub Forge albo niedopobrany plik. Pobierz właściwy plik jeszcze raz.

Ambiguous plugin name#

W folderze plugins są dwie wersje tego samego pluginu. Usuń starszy plik.

UnsupportedClassVersionError … class file version 69.0#

Plugin wymaga nowszej Javy niż ta, na której działa serwer. Numer wersji klasy odpowiada Javie: 65 = Java 21, 69 = Java 25. Plugin jest najpewniej przeznaczony dla nowszej wersji Minecrafta. Pobierz wersję pluginu dla swojej wersji Minecrafta albo zaktualizuj serwer, zobacz Zmiana wersji i oprogramowania.

Error occurred while enabling … (Is it up to date?)#

Plugin się załadował, ale wywalił się przy włączaniu. Pod tą linią jest zrzut błędu. Najczęstsze przyczyny to nieobsługiwana wersja Minecrafta, brakująca zależność albo błąd w jego konfiguracji. Sprawdź wersję pluginu i przejrzyj jego config.yml.

Plugin zgłasza błąd w config.yml#

W konsoli zobaczysz błąd YAML z numerem linii, często InvalidConfigurationException, mapping values are not allowed here albo wzmiankę o tabulatorze. Otwórz plik i sprawdź tę linię: tabulator zamiast spacji, brak spacji po dwukropku albo tekst ze znakami specjalnymi bez cudzysłowu.

Serwer nie startuje po instalacji pluginu i nie wiesz, który to#

Wyłączaj pluginy partiami. W zakładce Pluginy wyłącz połowę, zrestartuj i zależnie od wyniku kontynuuj z tą połową, w której jest problem. Plugin możesz też wyłączyć ręcznie, zmieniając nazwę jego pliku, na przykład na Plugin.jar.disabled.

„Na serwerze trwa właśnie zmiana oprogramowania lub instalacja modpacka”#

Poczekaj, aż zmiana w zakładce Oprogramowanie się zakończy. Potem będzie można edytować pluginy.

Jeśli nie uda Ci się naprawić błędu, wyślij nam plik logs/latest.log, zobacz kontakt z pomocą techniczną.

Dalsza lektura#

• Paper: dodawanie pluginów (otwiera się w nowym oknie)
• Paper: podstawowe rozwiązywanie problemów (otwiera się w nowym oknie)
• Hangar (otwiera się w nowym oknie)
• Modrinth: pluginy (otwiera się w nowym oknie)