Jak zainstalować pluginy (wtyczki) na serwerze Minecraft: Paper, Spigot i Purpur

Wtyczki i mody to nie to samo

Wtyczka to plik z rozszerzeniem .jar, który działa tylko na serwerze. Obsługują ją serwery z rodziny Bukkit: Paper, Spigot i Purpur. Gracze wchodzą na serwer zwykłym klientem Minecrafta i przy prawie wszystkich wtyczkach niczego nie instalują.

Mod to dodatek innego rodzaju. Wymaga serwera z loaderem modów (Fabric, Quilt, Forge lub NeoForge), a zwykle trzeba go zainstalować także na komputerze każdego gracza.

Jedno nie zastąpi drugiego. Wtyczka nie wczyta się na serwerze Fabric ani Forge, a mod nie wczyta się na Paperze. Oficjalny (vanilla) serwer nie przyjmuje ani jednego, ani drugiego. Na stronie pobierania obok pliku podane są obsługiwane loadery: „Paper”, „Spigot” lub „Bukkit” oznacza wtyczkę; „Fabric”, „Quilt”, „Forge” lub „NeoForge” oznacza mod. Jak wybrać typ serwera, opisaliśmy w osobnym artykule.

Najpierw upewnij się, że serwer obsługuje wtyczki

Potrzebny jest serwer typu Paper, Purpur lub Spigot. Zwykle wybiera się Papera: jest szybszy od oficjalnego serwera, uruchamia wtyczki napisane dla Spigota i Bukkita, a gra się na nim prawie tak samo jak w zwykłym Minecrafcie. Purpur to Paper z dodatkowymi ustawieniami. Spigot to starsza baza, z której wyrósł Paper.

Nowe serwery w zuboku mają domyślnie typ Vanilla, więc najpierw go przełącz:

1. 1Zatrzymaj serwer i zrób kopię zapasową w zakładce Backups. Typ można zmienić tylko wtedy, gdy serwer jest wyłączony.
2. 2Otwórz zakładkę Software i wybierz Papera z listy typów serwera.
3. 3Wersję zostaw bez zmian albo wybierz tę, na której grają twoi znajomi (starszą tylko wtedy, gdy świata nie otwierano jeszcze na nowszej wersji). Jeśli masz już na oku konkretne wtyczki, najpierw sprawdź, jakie wersje obsługują: wtyczki dostosowują się do nowej wersji Minecrafta z niewielkim opóźnieniem.
4. 4Zastosuj zmianę i potwierdź ją. Świat zostanie zachowany.
5. 5Uruchom serwer. Pierwszy start potrwa trochę dłużej: serwer pobiera nowe pliki.

Skąd pobierać wtyczki, a skąd nie warto

Wtyczka to program, który działa na twoim serwerze z pełnym dostępem do niego. Zła wtyczka może skasować świat, wykraść dane albo nadać obcym uprawnienia operatora. Dlatego źródło jest ważniejsze niż nazwa wtyczki.

Największym zaufaniem cieszą się Hangar (repozytorium wtyczek projektu Paper), Modrinth oraz strona autora lub jego GitHub. Ale i tam sprawdzaj, kto stworzył wtyczkę, ile osób ją pobrało i kiedy ostatnio ją aktualizowano. W zuboku katalog w zakładce Plugins pobiera wtyczki z Modrinth.

Trzymaj się z daleka od:

• stron, które oferują „darmowe wtyczki premium” albo „pirackie” kopie płatnych: to klasyczny sposób, żeby złapać wirusa ukrytego w pliku .jar;
• plików przysłanych w prywatnych wiadomościach, nawet przez przyjaciela: konta znajomych też bywają przejmowane, więc bierz wtyczkę z jej własnej strony;
• wszystkiego, co nie jest plikiem .jar ani archiwum .zip z plikiem .jar w środku. Wtyczka nigdy nie jest instalatorem (.exe, .msi, .bat).

Więcej o ryzyku związanym z cudzymi plikami znajdziesz w liście kontrolnej bezpieczeństwa.

Sprawdź wersję przed pobraniem

Wtyczki powstają pod konkretne wersje Minecrafta. Na stronie wtyczki wymienione są obsługiwane wersje, na przykład 1.21.11 lub 26.3 (od 2026 roku wersje Minecrafta numeruje się według roku wydania). Pobieraj plik, który pasuje do twojego serwera: wtyczka zrobiona pod inną wersję może się nie wczytać albo coś zepsuć.

Zaraz po wyjściu nowej wersji Minecrafta wiele wtyczek jeszcze jej nie obsługuje. Jeśli potrzebna wtyczka nie jest gotowa, poczekaj albo wybierz dla serwera starszą wersję w zakładce Software, ale tylko wtedy, gdy świat nigdy nie był otwierany na wersji nowszej od wybranej: starszy serwer takiego świata nie otworzy. Najpierw zrób kopię zapasową.

Niektóre wtyczki potrzebują do działania innych wtyczek. Nazywa się je zależnościami, a ich lista znajduje się na stronie wtyczki. Na przykład WorldGuard potrzebuje wtyczki WorldEdit, a wiele wtyczek wymaga wtyczki Vault lub PlaceholderAPI (albo po prostu lepiej z nimi działa). Jeśli wtyczka wymaga innej wtyczki, a jej nie ma, nie uruchomi się.

Sposób 1. Jednym kliknięciem w zuboku

Zakładka Plugins pojawia się w menu serwera, gdy tylko typ serwera to Paper, Purpur lub Spigot.

1. 1Otwórz zakładkę Plugins. W zakładce „Katalog” widać popularne wtyczki pasujące do wersji twojego serwera.
2. 2Wyszukaj wtyczkę po nazwie albo wybierz kategorię: „Zarządzanie”, „Narzędzia”, „Ekonomia”, „Społeczność”, „Mechanika gry”, „Minigry” lub „Optymalizacja”.
3. 3Naciśnij „Zainstaluj” przy wtyczce. Zostanie pobrana z Modrinth razem z wtyczkami, których potrzebuje, a zakładka powie, które dodano.
4. 4Zrestartuj serwer, aby zmiany zaczęły działać. Zakładka proponuje „Zrestartuj teraz”; jeśli serwer jest wyłączony, wtyczka wczyta się przy następnym starcie.
5. 5Sprawdź wynik w zakładce „Zainstalowane”. Jeśli wtyczka nie może działać bez innej, zakładka to zaznaczy, a przycisk „Znajdź” zaprowadzi cię do brakującej wtyczki.

Aby usunąć wtyczkę, naciśnij „Usuń” w zakładce „Zainstalowane”. W oknie potwierdzenia jest pole wyboru, które pozwala od razu skasować ustawienia i dane wtyczki, ale skasowanych danych nie da się przywrócić, więc nie zaznaczaj go, jeśli chcesz tylko zainstalować wtyczkę ponownie lub ją zaktualizować. Działający serwer przestanie używać wtyczki po następnym restarcie.

Katalog pokazuje tylko wtyczki, które pasują do twojego serwera i są opublikowane na Modrinth. Jeśli potrzebnej wtyczki tam nie ma, to albo nie obsługuje ona twojej wersji Minecrafta, albo leży gdzie indziej. W drugim przypadku skorzystaj ze sposobu 2.

Sposób 2. Ręcznie (na dowolnym hostingu lub na własnym komputerze)

1. 1Pobierz wtyczkę jako plik .jar z zaufanego miejsca. Jeśli wtyczka jest spakowana w pliku .zip, rozpakuj archiwum i weź .jar.
2. 2Zatrzymaj serwer.
3. 3Wrzuć plik do folderu plugins w głównym folderze serwera. W zuboku otwórz zakładkę Files, wejdź do folderu plugins i wgraj plik tam.
4. 4Uruchom serwer. Większość wtyczek przy pierwszym starcie tworzy w plugins własny folder z plikiem ustawień (najczęściej config.yml).
5. 5Sprawdź, czy wtyczka się wczytała: wpisz w konsoli plugins. Odpowiedź pojawi się w zakładce Log, a twoja wtyczka powinna być na liście.
6. 6Po zmianie ustawień zrestartuj serwer, aby wtyczka wczytała je ponownie.

Polecenie /reload wydaje się wygodne, ale nie jest obsługiwane i może zepsuć wtyczki, więc lepiej zrestartować serwer.

Jakie wtyczki instaluje się najpierw

Serwer nie potrzebuje ich wiele. Oto te, które prawie zawsze są na początku listy; wszystkie działają na Paperze:

• EssentialsX: codzienne polecenia, czyli domy, prośby o teleport między graczami, warpy i zestawy (kity).
• LuckPerms: rangi i uprawnienia, czyli kto może używać których poleceń. Pomaga nie nadawać wszystkim uprawnień operatora.
• WorldEdit: narzędzie budowniczego do kopiowania, wypełniania i zamieniania dużych obszarów bloków.
• WorldGuard: chroni obszary mapy przed budowaniem, wybuchami i ogniem. Wymaga wtyczki WorldEdit.
• CoreProtect: zapisuje, kto co zniszczył lub postawił, i potrafi cofać zmiany. Główna obrona przed grieferami.
• Chunky: generuje świat z wyprzedzeniem, żeby serwer nie przycinał, gdy ktoś doleci do niezbadanych ziem. Wybieraj mały promień: duży obszar zajmuje dużo czasu i miejsca na dysku. Zostań na serwerze, dopóki trwa generowanie: pusty serwer w zuboku wyłącza się sam.
• ViaVersion: pozwala wchodzić na serwer graczom z nowszą wersją gry.

Dodawaj wtyczki po jednej i zaglądaj do logu po każdej: gdy coś pójdzie nie tak, znacznie łatwiej znaleźć winowajcę.

Jeśli wtyczka potrzebuje własnego portu sieciowego (tak jest z mapami w przeglądarce i czatem głosowym), nie połączysz się z nią w zuboku: do twojego serwera dociera tylko połączenie Minecrafta.

Jeśli wtyczka się nie wczytuje

Najpierw zajrzyj do logu (logs/latest.log; w zuboku to zakładka Log). Pierwsza linia z błędem obok nazwy wtyczki zwykle podpowiada, o co chodzi. Typowe przypadki:

• „Unsupported API version”: wtyczka została zrobiona pod nowszą wersję Minecrafta, niż działa na serwerze. Pobierz starszą wersję wtyczki albo zaktualizuj serwer.
• „Unknown/missing dependency plugins” (na Spigocie: „Unknown dependency”): nie jest zainstalowana inna wtyczka, której ta potrzebuje. Zainstaluj ją i uruchom serwer ponownie.
• „does not contain a paper-plugin.yml or plugin.yml” (na Spigocie: „Jar does not contain plugin.yml”): plik nie jest wtyczką. To może być mod albo archiwum z kodem źródłowym. Uszkodzony lub nie do końca pobrany plik zwykle daje zamiast tego błąd zip: pobierz go jeszcze raz.
• „Unsupported class file major version” lub „has been compiled by a more recent version of the Java Runtime”: wtyczka została zbudowana pod nowszą Javę, niż używa serwer. Weź starszą wersję wtyczki albo przenieś serwer na nowszą wersję Minecrafta.
• Serwer zatrzymuje się przy starcie zaraz po dodaniu wtyczki: najpierw przeczytaj log, potem usuń plik nowej wtyczki i uruchom serwer ponownie.
• W folderze są dwie kopie tej samej wtyczki, stara i nowa: usuń starą.

Aktualizacja i usuwanie

Aby zaktualizować wtyczkę, zatrzymaj serwer, zastąp jej plik nową wersją (nigdy nie trzymaj obu w folderze) i uruchom serwer ponownie. Ustawienia w folderze wtyczki zostają, ale przeczytaj notatki autora: po dużej aktualizacji plik ustawień czasem się zmienia. W zuboku otwórz listę „Wersje” wtyczki w zakładce Plugins i zainstaluj potrzebną: stary plik zostanie zastąpiony.

Aby usunąć wtyczkę, zatrzymaj serwer, skasuj jej plik z folderu plugins i uruchom serwer ponownie (albo naciśnij „Usuń” w zakładce Plugins). Folder z ustawieniami i danymi zostaje, dopóki nie skasujesz także jego. Skasuj go tylko wtedy, gdy nie planujesz wracać do wtyczki: danych z niego nie da się odzyskać.

Wskazówki, żeby serwer był szybki i bezpieczny

• Instaluj tylko to, czego naprawdę użyjesz. Każda wtyczka zajmuje pamięć i czas procesora, a garść małych może kosztować więcej niż jedna duża.
• Aktualizuj wtyczki: aktualizacje naprawiają błędy i luki w zabezpieczeniach.
• Rób kopię zapasową przed instalacją, aktualizacją lub usunięciem wtyczki oraz przed dużymi operacjami w WorldEdit. W zakładce Backups robi się to jednym kliknięciem.
• Nie nadawaj uprawnień operatora tylko dlatego, że wtyczka o nie prosi. Dawaj graczom tylko potrzebne uprawnienia: LuckPerms powstał właśnie do tego.

Najczęstsze pytania

Czy moi znajomi też muszą instalować wtyczki?

Prawie nigdy. Większość wtyczek działa tylko na serwerze, więc graczom wystarczy zwykła gra. Niektóre wymagają też małego moda na komputerze każdego gracza: informacja o tym jest na stronie wtyczki. Z modami jest inaczej: zwykle musi je zainstalować każdy.

Czy można używać wtyczek i modów razem?

Nie da się tego zrobić porządnie. Paper, Spigot i Purpur nie wczytują modów, a serwery Fabric i Forge nie wczytują wtyczek. Są serwery hybrydowe, które próbują robić jedno i drugie, ale rzadko są stabilne i ich nie polecamy. Wybierz jedną drogę.

Czy świat przetrwa przejście z typu Vanilla na typ Paper?

Zwykle tak: panel zachowuje świat, a Paper sam przekształca świat stworzony na typie Vanilla. Kopia zapasowa to jedno kliknięcie, więc zrób ją na wszelki wypadek. Późniejszy powrót do typu Vanilla albo przejście na typ z modami, na przykład Fabric, wymaga trochę ręcznej pracy na plikach świata. Świata, w którym grano na nowszej wersji Minecrafta, nie da się otworzyć na starszej.

Czy wtyczki są darmowe?

Większość popularnych jest darmowa. Niektórzy autorzy sprzedają wtyczki premium na własnych stronach lub na znanych platformach, takich jak SpigotMC, Polymart czy BuiltByBit: płać tylko tam, nigdy na stronach sprzedających „pirackie” kopie.

Dlaczego nie widzę wtyczki w katalogu?

Katalog pokazuje tylko wtyczki, które pasują do typu i wersji twojego serwera i są opublikowane na Modrinth. Wszystko inne pobierz samodzielnie (sposób 2) albo wybierz inną wersję w zakładce Software (starszą tylko wtedy, gdy świat nie był jeszcze otwierany na nowszej wersji).

Co dalej

Serwerem z wtyczkami łatwiej się opiekować, jeśli jest zabezpieczony od początku: przejdź przez listę kontrolną bezpieczeństwa. Jeśli dopiero wybierasz, od jakiego serwera zacząć, przeczytaj, jaki typ serwera wybrać.