Plugin serwerowy nie jest modem instalowanym w launcherze gracza. Działa po stronie serwera i rozszerza jego możliwości — może dodać system działek, ekonomię, uprawnienia albo narzędzia administracyjne. Poniższa instrukcja prowadzi od wyboru właściwego pliku aż do sprawdzenia, czy plugin uruchomił się poprawnie.
plugins. Nie instaluj nowych rozszerzeń po raz pierwszy na serwerze produkcyjnym bez testu.
1. Sprawdź oprogramowanie i wersję serwera
Do uruchamiania pluginów potrzebujesz serwera zgodnego z API Bukkit. Najczęściej będzie to Paper, Purpur
albo Spigot. Czysty serwer Vanilla i większość serwerów Fabric nie odczyta pliku pluginu z rozszerzeniem
.jar. Paper jest zwykle rozsądnym wyborem na nowy serwer: zachowuje zgodność z pluginami
Bukkit/Spigot, a jednocześnie oferuje poprawki wydajności i rozbudowaną dokumentację.
Następnie porównaj wersję Minecrafta z wersjami zadeklarowanymi przy pliku. Plugin przygotowany dla 1.21 nie musi działać na 1.20.4, nawet jeśli sam serwer się uruchamia. Szczególną ostrożność zachowaj przy pluginach ingerujących w pakiety sieciowe, generowanie świata lub wewnętrzny kod serwera — są bardziej wrażliwe na aktualizacje niż proste komendy.
2. Zainstaluj plugin
-
Pobierz właściwy plik
.jar. W katalogu wybierz wydanie przypisane do Twojej wersji Minecrafta. Wersję beta instaluj tylko wtedy, gdy akceptujesz możliwość błędów. -
Zatrzymaj serwer. Nie podmieniaj pluginów podczas pracy komendą
/reload. Przeładowanie potrafi pozostawić stare zadania i listenery w pamięci, co utrudnia późniejszą diagnozę. -
Skopiuj plik do katalogu
plugins. Nie rozpakowuj pliku JAR. Jeśli katalogu jeszcze nie ma, uruchom raz poprawnie skonfigurowany serwer Paper/Spigot, a zostanie utworzony. - Uruchom serwer i obserwuj konsolę. Przy pierwszym starcie plugin zwykle tworzy własny folder z konfiguracją. Poczekaj na komunikat o pełnym uruchomieniu serwera.
- Dopiero teraz edytuj konfigurację. Po zmianach wykonaj pełny restart, chyba że autor pluginu wyraźnie udostępnia bezpieczną komendę do przeładowania ustawień.
3. Sprawdź, czy plugin działa
W konsoli lub w grze jako operator użyj komendy /plugins. Nazwa aktywnego pluginu powinna być
wyświetlona na zielono. Sama obecność na liście nie wystarcza: wykonaj podstawową funkcję pluginu, sprawdź
uprawnienia na zwykłym koncie gracza i ponownie przejrzyj log po restarcie.
Gdy plugin wymaga dodatków takich jak Vault, ProtocolLib albo PlaceholderAPI, ich brak powinien pojawić się w logu jako komunikat o brakującej zależności. Zainstaluj wymaganą zależność w zgodnej wersji i ponownie uruchom cały serwer. Nie zmieniaj nazwy pliku JAR i nie wkładaj zależności do podfolderu danego pluginu.
4. Najczęstsze problemy
Plugin nie pojawia się pod komendą /plugins
Upewnij się, że plik znajduje się bezpośrednio w katalogu plugins, ma rozszerzenie
.jar i nie jest archiwum ZIP. Wyszukaj w najnowszym pliku z katalogu logs
frazy Could not load, Invalid plugin albo nazwę pluginu.
W konsoli pojawia się UnsupportedClassVersionError
Plugin został skompilowany dla nowszej Javy niż ta uruchamiająca serwer. Dobierz wersję Javy wymaganą przez daną wersję Paper i wykonaj restart. Nie próbuj naprawiać tego przez zmianę nazwy pliku.
Plugin jest czerwony lub wyłącza się podczas startu
Najczęstsze przyczyny to brak zależności, niezgodna wersja API lub błąd konfiguracji YAML. Pierwszy wyjątek w logu jest zwykle ważniejszy niż kolejne komunikaty, które są tylko jego skutkiem.
Serwer zaczął lagować po instalacji
Wyłącz nowy plugin i porównaj zachowanie na tej samej kopii świata. Na Paper możesz użyć profilera spark, aby sprawdzić, które zadania zajmują czas procesora. Nie oceniaj wydajności wyłącznie na podstawie wskaźnika TPS z kilku sekund po starcie.
5. Aktualizacja i bezpieczne usuwanie
Przed aktualizacją przeczytaj listę zmian autora i zrób kopię folderu pluginu. Zatrzymaj serwer, podmień JAR, uruchom go i sprawdź migrację konfiguracji oraz danych. Nie kasuj starego pliku przed upewnieniem się, że masz jego kopię — powrót do wcześniejszej wersji może być potrzebny, a część aktualizacji zmienia format danych.
Przy usuwaniu pluginu najpierw zatrzymaj serwer. Usuń JAR, a folder danych zachowaj przez kilka dni jako kopię. Pluginy ekonomii, uprawnień i ochrony terenu mogą przechowywać dane potrzebne innym rozszerzeniom, dlatego sprawdź zależności przed trwałym skasowaniem ich katalogów.
Znajdź zgodny plugin
Wybierz wersję serwera, a katalog pokaże pluginy mające przypisane wydanie dla tej wersji.
Przejdź do katalogu Jak wybrać plugin?