Jak zainstalować plugin na serwerze Minecraft?

Pluginy dodają funkcje do serwera bez instalowania czegokolwiek przez graczy: ochronę, ekonomię, uprawnienia, minigry, formatowanie czatu. Działają na Paper, Purpur i Spigot (nie na vanilla, Fabric ani Forge; tam używa się modów). Instalacja to dwa kroki: umieścić plik .jar w folderze plugins i zrestartować.

Krok 1: sprawdź oprogramowanie serwera

Wpisz about w konsoli; odpowiedź powinna wymieniać Paper, Purpur lub Spigot. Jeśli pokazuje vanilla, najpierw przełącz się na Paper przez wybór wersji w panelu. Świat utworzony na vanilla działa na Paper bez zmian. Co wybrać, wyjaśnia nasz artykuł mody kontra pluginy.

Opcja A: Plugin installer w panelu

1. Wejdź do panelu gier i kliknij swój serwer.
2. Otwórz stronę Plugin installer.
3. Wyszukaj plugin po nazwie, wybierz wersję pasującą do twojej wersji Minecrafta i kliknij Zainstaluj.
4. Zrestartuj serwer.

Instalator pobiera plik prosto z oficjalnych źródeł do twojego folderu plugins, więc nie trafisz na niewłaściwy ani szkodliwy plik.

Opcja B: wgraj plik .jar samodzielnie

1. Pobierz plugin z zaufanego źródła: Hangar (własna strona Paper), SpigotMC, Modrinth albo GitHub autora. Sprawdź, czy wersja obsługuje twoją wersję Minecrafta.
2. Otwórz Menedżer plików w panelu i przejdź do folderu plugins.
3. Kliknij Prześlij i wybierz plik .jar. Niczego nie rozpakowuj; jar trafia tam w takiej postaci, w jakiej jest.
4. Zrestartuj serwer. Duże pliki szybciej wgrasz przez SFTP.

Krok 3: sprawdź, czy się załadował

Wpisz plugins w konsoli. Załadowane pluginy są zielone; czerwona nazwa oznacza niepowodzenie. Przy pierwszym starcie plugin tworzy folder plugins/NazwaPluginu/ z plikiem config.yml, w którym dostosowujesz ustawienia. Po edycji konfiguracji zrestartuj serwer albo użyj polecenia przeładowania danego pluginu; unikaj ogólnego /reload, które często powoduje błędy.

Zależności

Niektóre pluginy potrzebują innego pluginu do działania: wiele wymaga Vault (ekonomia i uprawnienia), ProtocolLib lub PlaceholderAPI. Konsola informuje o tym przy starcie: Could not load 'X': Unknown dependency: Vault. Zainstaluj brakujący plugin w ten sam sposób.

Plugin się nie ładuje

• "Unsupported API version": plugin jest za nowy dla twojej wersji serwera albo odwrotnie. Wybierz pasującą wersję.
• "UnsupportedClassVersionError": plugin potrzebuje nowszej Javy; zobacz zmianę wersji Javy.
• Błąd w config.yml: YAML jest wybredny co do wcięć i dwukropków. Wklej plik do walidatora YAML online, by znaleźć linię.
• Dwa pluginy się gryzą: usuwaj je po jednym, by znaleźć winowajcę.
• Nic się nie zmienia: plik trafił do złego folderu albo ma rozszerzenie .zip. Musi to być .jar w plugins.

Od czego zacząć

Polecane na niemal każdy serwer: EssentialsX (domy, warpy, kity), LuckPerms (uprawnienia), WorldGuard (ochrona), CoreProtect (cofanie zmian) i Vault. Nasz artykuł o pluginach do moderacji wymienia więcej. Utknąłeś? Otwórz ticket i dołącz błąd z konsoli.