Przejdź do głównej treści

Jak zainstalować pluginy na serwerze Minecraft

Pluginy to to, co z serwera robi Twój serwer. Wgranie jednego to sześć kroków, a pierwszy większość pomija: tylko 3 z 7 rodzajów oprogramowania serwera u nas w ogóle potrafi wczytać plugin.

Krótka odpowiedź

  1. Uruchom Paper, Purpur albo Spigot

    Plugin potrzebuje Bukkit API. Na Fabric, Forge, NeoForge albo Vanilli plik jar nic nie zrobi.

  2. Jar do folderu plugins, potem restart

    Pobieraj z SpigotMC, Modrinth, Hangar albo z GitHuba autora, nigdzie indziej.

  3. Przeczytaj log startowy

    Jedna linijka na każdy załadowany plugin. Błąd wersji Javy to tam najczęstsza awaria, a naprawisz go w zakładce startu.

Kroki i tabela błędów poniżej to te trzy linijki w całości.

Krok 1: czy w ogóle działa właściwe oprogramowanie serwera?

Plugin potrzebuje pod sobą interfejsu Bukkit, a ten zależy od oprogramowania serwera, a nie od Minecrafta. Paper, Purpur, Spigot go mają. Fabric, Forge, NeoForge, Vanilla go nie mają, a plik pluginu, który trafi na jedno z nich, nie robi zupełnie nic.

Jeśli nie wiesz, na czym działasz, zakładka startu w panelu podaje plik. Paper to to, co stawiamy domyślnie: to Spigot z długą listą ulepszeń na wierzchu, i przyjmuje te same pluginy.

Ta sama lista, którą widzisz przy zamówieniu w menu wyboru oprogramowania.
Oprogramowanie serweraWczytuje pluginyCo wczytuje zamiast tego
PaperTo, co stawiamy domyślnieTak, przez interfejs BukkitKażdy plugin dla Bukkit, Spigot albo Paper
PurpurTak, przez interfejs BukkitKażdy plugin dla Bukkit, Spigot albo Paper
FabricNieMody dla Fabric
ForgeNieMody dla Forge
NeoForgeNieMody dla NeoForge
SpigotTak, przez interfejs BukkitKażdy plugin dla Bukkit, Spigot albo Paper
VanillaNieNic. Vanilla nie ma ani jednego, ani drugiego
Okno terminala, w którym uruchamia się oficjalny plik jar serwera Minecraft i zgłasza Done
Start serwera vanilla. Nie ładuje się tu żaden folder plugins, bo vanilla nie ma Bukkit API; Paper wypisuje ten sam log z jedną linijką na każdy załadowany plugin. Obraz: Server.jar CLI.png z minecraft.wiki, CC BY-NC-SA 3.0.

Kroki 2 do 6: znajdź, wgraj, uruchom ponownie, sprawdź

  1. Znajdź swój plugin

    SpigotMC to najstarsza i największa kolekcja, Modrinth jest nowszy i bliższy oprogramowaniu open source, a Hangar to katalog samego Papera. Te trzy i wydania autora na GitHubie to cała lista. Plik z czatu albo z hostingu plików może dać komuś uprawnienia operatora na Twoim serwerze, usunąć Twój świat albo użyć maszyny do atakowania innych, a przy tym wygląda dokładnie jak prawdziwy plugin.

  2. Pobierz plik

    Na stronie pluginu stoją wersje, które obsługuje. Plugin dla innej dużej wersji zwykle odmawia startu, a czasem startuje i psuje się w połowie drogi. Jeśli plugin przychodzi jako archiwum z kilkoma plikami, jego strona mówi, który z nich należy na serwer.

  3. Wgraj do folderu /plugins

    W menedżerze plików w głównym folderze serwera leżą world, logs i plugins. Plik trafia luzem do plugins, a nie do osobnego podfolderu. Przeciągnięcie i upuszczenie w oknie przeglądarki też działa.

    /plugins/TwojPlugin.jar
  4. Uruchom serwer ponownie, i nigdy /reload

    To kuszące, bo nikt nie wylatuje, ale reload zostawia stare klasy w pamięci i stare nasłuchiwacze zdarzeń zarejestrowane, a błędy, które z tego wynikają, są prawie nie do znalezienia. Zatrzymaj serwer porządnie i pozwól panelowi go ponownie uruchomić.

    stop
  5. Sprawdź i ustaw

    Plugin, który się wczytał, mówi to swoją nazwą. Czerwony tekst ze stack trace pod spodem w pierwszych dwóch liniach prawie zawsze podaje brakującą zależność albo wersję, która nie pasuje. Po pierwszym udanym starcie plugin zapisuje własną konfigurację, a zmiany w niej znowu wymagają restartu albo własnej komendy reload tego pluginu.

    /plugins/TwojPlugin/config.yml
Wyniki wyszukiwania na stronie z pluginami Bukkit z zaznaczonym polem wyszukiwania i kolumną pobierania
Szukanie w repozytorium pluginów. Trzymaj się SpigotMC, Modrinth, Hangar albo GitHuba samego autora; plik jar z innego miejsca wygląda identycznie, a może komuś oddać Twój serwer. Obraz: Searching for plugins.png z minecraft.wiki, CC BY-NC-SA 3.0.
Strona pluginu na stronie Bukkit z zaznaczonym przyciskiem Download
Przycisk pobierania na stronie pluginu. Weź plik pasujący do Twojej wersji Minecrafta, wgraj jar do folderu plugins i zrestartuj serwer. Obraz: Downloading Bukkit Plugin.png z minecraft.wiki, CC BY-NC-SA 3.0.

Co psuje się najczęściej

Dwie rzeczy psują się częściej niż wszystko inne razem. Pierwsza to Java. UnsupportedClassVersionError w konsoli zawsze oznacza to samo: plik zbudowano dla nowszej Javy niż ta, z którą startuje serwer. Z 16 wersji Minecrafta, które oferujemy, 9 chce Javy 21, a 7 czegoś starszego, i ustawia się to w zakładce startu.

Druga to brakująca zależność. Pluginy opierają się na sobie nawzajem: większość pluginów ekonomii chce Vault jako mostu do Twojego pluginu uprawnień, a wszystko, co sięga do pakietów, chce ProtocolLib. Na stronie pluginu stoi, czego potrzebuje, a konsola podaje to w linii nad stack trace.

Lista wersji z naszego menu zamówień, z granicą Javy, którą Mojang dla nich ustawił.
Wersja MinecraftaWymagana Java
LatestTo, co dostaje nowy serwer, jeśli nie wybierzesz niczego innegoJava 21
26.2Java 21
26.1.2Java 21
26.1.1Java 21
1.21.11Java 21
1.21.8Java 21
1.21.4Java 21
1.21.1Java 21
1.20.6Java 21
1.20.4Java 17
1.20.1Java 17
1.19.4Java 17
1.18.2Java 17
1.16.5Java 8
1.12.2Java 8
1.8.9Java 8

Pięć pluginów na początek

Te pięć daje działający serwer. Dodawaj dwa albo trzy naraz i uruchamiaj ponownie pomiędzy: dwadzieścia plików jednocześnie nie powie Ci nic o tym, który zepsuł start. Rangi i uprawnienia wchodzą głębiej w drugi z tej listy.

Pięć, od których zaczyna prawie każdy serwer, i dlaczego stoją w tej kolejności.
PluginCo Ci daje
EssentialsXKomendy, których ludzie się spodziewają: /home, /warp, /tpa, zestawy i prosta ekonomia.
LuckPermsRangi i uprawnienia, i to, do czego podłącza się prawie wszystko inne.
VaultMost między pluginem ekonomii a pluginem uprawnień. Sam z siebie nic nie robi.
WorldGuardOchrona obszarów, żeby spawn przetrwał pierwszego griefera.
WorldEditZaznaczenia i pędzle do budowli i terenu, a WorldGuard od niego zależy.

Które oprogramowanie serwera wczytuje pluginy i jakiej wersji Javy wymaga każda wersja Minecrafta, jest przy budowaniu tej strony czytane z tej samej listy, z której wybierasz przy zamówieniu.

Ekran Linki serwera w Java Edition z przyciskami takimi jak Zgłoś błąd, Zasady społeczności i Wsparcie
Linki serwera w menu pauzy, zwykła funkcja Javy od wersji 1.21. To coś, co plugin startowy uzupełnia za Ciebie: zasady, Discord, sklep. Obraz: Server Links.png z minecraft.wiki, CC BY-NC-SA 3.0.

Pytania, które pojawiają się przy instalacji

Czy mogę używać pluginów i modów na tym samym serwerze?

Nie na jednym oprogramowaniu. Pluginy potrzebują interfejsu Bukkit, mody potrzebują loadera, i żadna ze stron nie zna drugiej. Istnieje oprogramowanie mieszane, ale często się psuje. Jeśli potrzebujesz jednego i drugiego, uruchom dwa serwery za proxy.

Ile pluginów zniesie serwer?

Problemem nie jest liczba, tylko praca. Pięćdziesiąt małych pluginów, które tylko czekają na komendy, kosztuje mniej niż trzy, które w każdym ticku coś sprawdzają. Co naprawdę spowalnia, zobaczysz dopiero na własnym serwerze.

Dlaczego konsola pokazuje UnsupportedClassVersionError?

Bo plik został zbudowany dla nowszej Javy niż ta, z którą startuje Twój serwer. Zmień Javę w zakładce startu albo weź wersję pluginu, która pasuje do Twojej wersji Minecrafta.

Gdzie znajdę ustawienia pluginu?

Po pierwszym udanym starcie każdy plugin tworzy własny folder w /plugins, z plikiem config.yml w środku. Jeśli go zmienisz, potrzebny jest restart albo komenda reload tego pluginu, żeby zmiana zadziałała.

Jak czysto usunąć plugin?

Zatrzymaj serwer, usuń plik z /plugins, a potem zdecyduj, czy folder z ustawieniami ma zostać. Jeśli go zostawisz, plugin odnajdzie swoje stare ustawienia, gdy wgrasz go później ponownie.

Ile na tick kosztuje dwadzieścia pluginów

Każdy dodany plugin dostaje swoją kolejkę w każdym ticku, a kilka z nich zapisuje na dysk, podczas gdy świat dalej działa. Dwadzieścia porządnie napisanych pluginów kosztuje niewiele; jeden, który co jakiś czas skanuje chunki, już nie. Na linii Performance ta praca trafia na AMD Ryzen 9 5900X w Niemczech albo AMD Ryzen 9 7950X z pamięcią RAM DDR5 w Polsce z własnym kawałkiem NVMe, więc zapis nie zatrzymuje już ticku, który po nim następuje.

Napisane i sprawdzone przez zespół Astroworld Hosting. Ostatnio sprawdzone 6 września 2026.

Dostawa: większość serwerów przekazujemy od razu i działają w kilka sekund po płatności, pozostałe w ciągu 60 minut w dzień i w ciągu 12 godzin w nocy.