Poradnik

Jak zainstalować plugin do Minecrafta

Zaktualizowano: 18 października 2026

Instalacja pluginu zajmuje minutę: wrzucasz plik .jar do folderu plugins/ serwera i restartujesz. Większość problemów bierze się z kroków wokół tego: serwer, który nie obsługuje pluginów, plugin zrobiony pod inną wersję albo brakująca zależność. Ten poradnik omawia je wszystkie.

Najpierw wypróbuj go na serwerze testowym, potem zainstaluj plik .jar.

Wygeneruj to w Codexe

Krok po kroku

  1. 1.Sprawdź, czy twój serwer obsługuje pluginy

    Pluginy wymagają silnika serwera opartego na Bukkit: Paper, Spigot, Purpur lub Folia dla serwerów gry, BungeeCord lub Velocity dla proxy. Serwer vanilla, a także serwer Fabric lub Forge, nie ładuje pluginów.

  2. 2.Sprawdź wersję pluginu

    Strona pluginu lub plik podaje, które wersje Minecrafta obsługuje. Plugin zbudowany pod nowszą wersję niż twój serwer zwykle odmawia załadowania.

  3. 3.Zatrzymaj serwer i skopiuj plik .jar

    Wrzuć plik .jar do folderu plugins/ obok pliku .jar serwera. W panelu hostingu prześlij go menedżerem plików lub przez SFTP. Nie rozpakowuj go.

  4. 4.Zainstaluj jego zależności

    Jeśli plugin potrzebuje innych pluginów (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), ich pliki .jar też wrzuć do plugins/.

  5. 5.Uruchom serwer i przeczytaj konsolę

    Poszukaj nazwy pluginu w logu startowym. „Enabling <Plugin>” bez błędu po nim oznacza, że się załadował.

  6. 6.Sprawdź go w grze i skonfiguruj

    Wpisz /plugins: załadowane pluginy są zielone, a te, które nie zdołały się włączyć, czerwone. Jego ustawienia pojawiają się w plugins/<PluginName>/config.yml; zmień je i zrestartuj serwer.

Gdzie trafiają pliki

Typowy folder serwera po pierwszym starcie z pluginem wygląda tak:

  • paper.jar (lub spigot.jar): sam serwer.
  • plugins/MyPlugin.jar: plugin, który dodałeś.
  • plugins/MyPlugin/: folder tworzony przez plugin, z config.yml, wiadomościami i zapisanymi danymi.
  • logs/latest.log: log bieżącego uruchomienia, w którym zapisywane są błędy ładowania.

Restartuj, nie używaj /reload

/reload wyładowuje i ponownie ładuje każdy plugin bez restartu serwera. Wiele pluginów tego nie obsługuje: listenery rejestrują się dwa razy, dane giną albo wycieka pamięć. Zawsze restartuj serwer po dodaniu, usunięciu lub aktualizacji pluginu. Niektóre pluginy mają własną komendę przeładowania (na przykład /myplugin reload) tylko dla swojej konfiguracji: tej można bezpiecznie używać.

Zanim zainstalujesz na serwerze produkcyjnym

  • Zrób kopię zapasową folderu serwera, a przynajmniej plugins/ i światów.
  • Najpierw wypróbuj na kopii: ten sam silnik, wersja i inne pluginy co na prawdziwym serwerze. Zobacz jak przetestować plugin.
  • Jeden plugin naraz: jeśli coś się zepsuje, wiesz, który to zrobił.
  • Pobieraj ze strony autora (SpigotMC, Hangar, Modrinth, GitHub), a nie z ponownie wrzuconych kopii.

Pluginy zrobione w Codexe

Plugin zrobiony w Codexe przychodzi jako zbudowany plik .jar nazwany tak jak projekt, sprawdzony, zanim go dostaniesz: musi zawierać skompilowane klasy i plugin.yml. Możesz wypróbować go na prywatnym serwerze testowym, zanim gdziekolwiek go zainstalujesz, za darmo w każdym planie; serwer testowy instaluje za ciebie pluginy wymienione jako zależności. Pobranie pliku .jar na własny serwer wymaga planu lub pakietu pobrań.

Pytania

Czy mogę instalować pluginy na serwerze vanilla?

Nie. Podmień plik .jar serwera na Paper (lub Spigot) w tej samej wersji Minecrafta; twój świat dalej działa. Dla serwerów vanilla alternatywą jest datapack.

Czy mogę instalować pluginy w trybie jednoosobowym?

Nie, pluginy działają tylko na serwerach. Możesz uruchomić lokalny serwer Paper na swoim komputerze i wejść na niego przez localhost.

Czy gracze muszą coś instalować?

Nie. Pluginy działają tylko na serwerze: gracze wchodzą na zwykłej grze. Tylko pluginy, które używają paczki zasobów, proszą graczy o jej zaakceptowanie.

Dlaczego mój plugin jest czerwony w /plugins?

Został znaleziony, ale nie zdołał się włączyć. Powód jest w konsoli tuż wcześniej: zobacz jak naprawić błędy pluginów.

Zrób plugin, który zainstalujesz jeszcze dziś

Ten prompt otworzy się gotowy do wysłania:

“Plugin na Paper 1.21.4 o nazwie JoinMessages: własne wiadomości o wejściu i wyjściu z nazwą gracza i liczbą graczy online, inna wiadomość przy pierwszym wejściu, tytuł powitalny, a wszystkie wiadomości i dźwięki w config.yml.”

Wygeneruj to w Codexe
Jak zainstalować plugin do Minecrafta na serwerze | Codexe