Jak zainstalować plugin na serwerze

Plugin zainstalujesz z katalogu w zakładce Wtyczki albo przez wgranie oficjalnego pliku .jar do folderu plugins. Po instalacji zrestartuj serwer i sprawdź konsolę. Poniżej opisujemy obie ścieżki oraz dobór zgodnej wersji.

Skąd pobierać pluginy

Pluginy pobieraj wyłącznie z zaufanych, oficjalnych źródeł. Plik .jar uruchamia się z pełnymi uprawnieniami na Twoim serwerze, więc losowe strony z "darmowymi pluginami" to prosta droga do złośliwego kodu. Trzy miejsca, którym warto ufać:

• SpigotMC to repozytorium pluginów Bukkit i Spigot, z ocenami oraz komentarzami społeczności.
• Modrinth to nowoczesna platforma z osobną sekcją Plugins. Uważaj, aby nie pobrać moda zamiast pluginu, bo te same tytuły bywają w obu sekcjach.
• Hangar to oficjalne repozytorium pluginów prowadzone przez zespół PaperMC.

Zanim pobierzesz plik, sprawdź na stronie pluginu, które wersje Minecrafta obsługuje. Plugin zbudowany pod inną wersję gry zwykle nie wczyta się poprawnie.

Wymagania

Zanim zaczniesz, upewnij się, że masz:

• serwer na silniku Paper, Spigot lub Purpur (dla nowych serwerów polecamy Paper),
• pobrany plik .jar pluginu w wersji zgodnej z Twoją wersją Minecrafta,
• dostęp do panelu voxelhost.

Silnik zobaczysz i zmienisz w Ustawienia > Konfiguracja serwera, w sekcji Silnik.

Instalacja z katalogu w panelu

1. Otwórz zakładkę Wtyczki, a następnie Przeglądaj. Wybierz źródło Modrinth lub Hangar i wyszukaj projekt, sprawdzając jego nazwę oraz autora.

2. Kliknij Zainstaluj przy właściwym projekcie. Panel pokazuje wydania zgodne z silnikiem i wersją Minecrafta serwera oraz wymagane zależności. Przejrzyj wybraną wersję przed zatwierdzeniem.

   

   Wybór zgodnego wydania EssentialsX w katalogu Wtyczki

3. Potwierdź Zainstaluj i poczekaj na zakończenie. Wtyczka pojawi się w podzakładce Zainstalowane. Zrestartuj serwer, aby ją uruchomić, i sprawdź wynik komendy pl, jak opisano niżej.

Filtr zgodności katalogu pomaga dobrać plik, ale nie zastępuje sprawdzenia wymagań projektu ani testu z pozostałymi dodatkami. Jeśli pluginu nie ma w katalogu, użyj ręcznego przesyłania.

Ręczna instalacja pliku jar

1. Pobierz plugin w wersji pasującej do Twojej wersji Minecrafta (patrz sekcja wyżej). Pobrany plik ma rozszerzenie .jar.

2. Zaloguj się do panelu voxelhost, wybierz serwer z listy i otwórz zakładkę Pliki.

3. Wejdź do folderu plugins. Znajdziesz go w głównym katalogu serwera.

   

   Pliki pluginów i ich foldery po pierwszym uruchomieniu na serwerze testowym

4. Otwórz Więcej opcji i wybierz Prześlij pliki, a następnie wskaż pobrany plik .jar. Możesz też przeciągnąć go z eksploratora na stronę. Sprawdź limit widoczny podczas przesyłania. Jeśli plik go przekracza, skorzystaj z SFTP; nie dziel pliku .jar na części.

5. Kliknij Restart, aby serwer wczytał nowy plugin. Sam plik w folderze nie wystarczy, plugin uruchamia się dopiero po restarcie.

6. Sprawdź, czy plugin się wczytał. Otwórz zakładkę Konsola, w polu Wpisz komendę wpisz pl (lub plugins) i kliknij Wykonaj. Serwer wypisze listę wczytanych pluginów: nazwy na zielono działają, a nazwy na czerwono nie wczytały się poprawnie.

   

   Essentials i LuckPerms wczytane na testowym Paper. Wyniki Spark dotyczą pustego serwera, nie wydajności pod obciążeniem.

Komenda pl to skrót od plugins. Działa tylko na silnikach Bukkit (Paper, Spigot, Purpur), bo to one ją dodają. Na Vanilli jej nie ma, ale tam pluginy i tak nie działają.

Konfiguracja pluginu

Większość pluginów przy pierwszym uruchomieniu tworzy własny folder z ustawieniami, na przykład plugins/Essentials/ dla EssentialsX. Nazwa folderu nie zawsze odpowiada nazwie pliku .jar. Najczęściej znajduje się tam config.yml.

Aby edytować konfigurację, wróć do zakładki Pliki, wejdź do folderu pluginu i kliknij dwukrotnie plik config.yml, aby otworzyć edytor (pojedyncze kliknięcie tylko zaznacza plik). Po wprowadzeniu zmian kliknij Zapisz, a następnie zrestartuj serwer lub przeładuj plugin, aby ustawienia zaczęły obowiązywać.

Przykład: EssentialsX

EssentialsX dodaje podstawowe komendy, takie jak /home, /warp, /tpa, kity oraz ekonomia. Niektóre funkcje wymagają dodatkowych modułów, np. /spawn wymaga EssentialsX Spawn. Główny moduł zainstalujesz z katalogu albo ręcznie:

1. Na oficjalnej stronie EssentialsX wybierz wydanie zgodne z Twoją wersją Paper i Minecrafta. Pobierz główny moduł EssentialsX; dodatkowe moduły instaluj tylko wtedy, gdy potrzebujesz ich funkcji.
2. Wgraj plik do folderu plugins w zakładce Pliki i kliknij Restart.
3. W Konsoli wpisz pl i potwierdź, że Essentials widnieje na liście na zielono.

Ustawienia znajdziesz potem w pliku plugins/Essentials/config.yml. EssentialsX oficjalnie wspiera silnik Paper.

Najczęstsze problemy

• W logach pojawia się błąd o wersji, a plugin się nie wczytał. Najczęściej pobrałeś plugin zbudowany pod inną wersję Minecrafta niż Twój serwer. Pobierz wersję pluginu zgodną z wersją gry i wgraj ją ponownie.
• Wgrany plik w ogóle nie pojawia się na liście pl. Sprawdź, czy do folderu plugins nie trafił mod Forge albo Fabric. Mody nie są pluginami, nie wczytają się na silniku Bukkit i należą do folderu mods na odpowiednim silniku (zobacz Jak zainstalować mody na serwerze). Upewnij się też, że serwer działa na Paper, Spigot lub Purpur.
• Plugin zgłasza brak zależności (np. depend Vault). Niektóre pluginy potrzebują dodatkowego pluginu, aby ruszyć (popularne zależności to Vault czy ProtocolLib). Zainstaluj plugin wskazany w logach, a potem zrestartuj serwer.
• Plugin dalej nie działa. Otwórz Konsolę i przeczytaj logi z uruchomienia, to właśnie tam serwer wpisuje dokładny powód. Więcej w poradniku Serwer nie działa? Zacznij tutaj.

Powiązane artykuły

• FastLogin (logowanie premium)
• Simple Voice Chat (czat głosowy)
• Jak włączyć tryb non-premium
• Jak zainstalować mody na serwerze

---

Ostatnia aktualizacja: listopad 2026.