Jak zainstalować pluginy na serwer Minecraft: pełny poradnik

Pluginy to podstawa każdego publicznego serwera Minecraft. Bez nich masz czysty waniliowy serwer, na którym nie można ani uprawnień skonfigurować, ani od grieferów się zabezpieczyć, ani ekonomii zrobić. Jeśli dopiero postawiłeś swój pierwszy serwer na Spigocie albo Paperze i nie wiesz, z której strony podejść do pluginów - ten poradnik jest dla ciebie.

Pluginy vs mody: jaka różnica

Początkujący często mylą pluginy z modami, chociaż to różne rzeczy.

Mody (Forge, Fabric, NeoForge) zmieniają sam klient i serwer. Dodają nowe bloki, moby, mechaniki. Żeby wejść na zmodyfikowany serwer, gracz musi zainstalować te same mody u siebie na kliencie.

Pluginy (Bukkit, Spigot, Paper) działają tylko po stronie serwera. Używają API serwera do dodania funkcjonalności: komendy, uprawnienia, teleporty, ekonomia. Graczowi nie trzeba niczego instalować - wchodzi zwykłym klientem.

Format pluginów - pliki .jar, które kładzie się do folderu plugins/ na serwerze. Tyle.

Jaki serwer jest potrzebny dla pluginów

Waniliowy server.jar od Mojanga nie obsługuje pluginów. Potrzebny ci jeden z serwerowych jąder ze wsparciem Bukkit API:

• Paper - rekomendowany wybór. Fork Spigota z mnóstwem optymalizacji i patchów. Większość pluginów jest pisana i testowana właśnie pod Papera.
• Spigot - klasyka. Działa, ale Paper jest szybszy i stabilniejszy.
• Purpur - fork Papera z dodatkowymi ustawieniami. Dla zaawansowanych.
• Folia - dla serwerów wielordzeniowych. Nie wszystkie pluginy są kompatybilne.

Jeśli jeszcze nie wybrałeś core'a - stawiaj Paper. Pobrać można z papermc.io.

Skąd pobierać pluginy

Zasada numer jeden: nigdy nie pobieraj pluginów z losowych stron. Pliki .jar wykonują dowolny kod na twoim serwerze, i złośliwy plugin może usunąć wszystkie pliki, ukraść dane albo dać napastnikowi pełny dostęp.

Sprawdzone platformy:

• Modrinth - nowoczesna platforma, dobra moderacja, szybkie wyszukiwanie
• Hangar - oficjalna platforma od PaperMC
• SpigotMC - największa baza pluginów, ale moderacja słabsza
• GitHub - wielu deweloperów publikuje release'y bezpośrednio na GitHubie

Przed pobraniem sprawdź: datę ostatniej aktualizacji, kompatybilność z twoją wersją MC, liczbę pobrań i opinie.

Instalacja: proces krok po kroku

1. Pobierz plugin

Pobierz plik .jar wybranego pluginu. Na przykład EssentialsX:

wget https://ci.ender.zone/job/EssentialsX/lastSuccessfulBuild/artifact/jars/EssentialsX-2.20.1.jar

2. Wrzuć do folderu plugins

# Struktura serwera
/home/minecraft/server/
├── server.jar
├── server.properties
├── plugins/           <-- tutaj kładziemy pliki .jar
│   ├── EssentialsX-2.20.1.jar
│   └── LuckPerms-Bukkit-5.4.131.jar
├── world/
└── logs/

cp EssentialsX-2.20.1.jar /home/minecraft/server/plugins/

3. Zrestartuj serwer

# Jeśli serwer jest odpalony w screen/tmux
screen -r minecraft
> stop

# Odpal od nowa
java -Xms2G -Xmx4G -jar server.jar nogui

Przy starcie zobaczysz coś w stylu:

[15:23:41 INFO]: [EssentialsX] Loading EssentialsX v2.20.1
[15:23:41 INFO]: [EssentialsX] Enabling EssentialsX v2.20.1
[15:23:42 INFO]: [EssentialsX] Successfully loaded.

4. Sprawdź pracę

Wejdź na serwer i wpisz komendę:

/plugins

Zobaczysz listę załadowanych pluginów. Zielone - działają, czerwone - coś poszło nie tak.

Plugins (3): EssentialsX, LuckPerms, WorldGuard

Konfiguracja pluginów

Po pierwszym starcie każdy plugin tworzy swój folder wewnątrz plugins/:

/home/minecraft/server/plugins/
├── EssentialsX-2.20.1.jar
├── Essentials/
│   ├── config.yml          <-- główny config
│   ├── messages.properties
│   └── userdata/
├── LuckPerms-Bukkit-5.4.131.jar
└── LuckPerms/
    └── config.yml

Configi - zwykle pliki config.yml w formacie YAML. Edytuj je dowolnym edytorem tekstowym:

nano /home/minecraft/server/plugins/Essentials/config.yml

Po zmianie configu większość pluginów można przeładować bez restartu serwera:

/essentials reload

Ale niektóre pluginy wymagają pełnego restartu. Czytaj dokumentację konkretnego pluginu.

Zależności pluginów

Niektóre pluginy wymagają innych pluginów do pracy. Na przykład:

• WorldEdit jest potrzebny dla WorldGuard
• Vault jest potrzebny dla pluginów ekonomii
• ProtocolLib jest potrzebny dla wielu pluginów pracujących z pakietami

Jeśli zależności brakuje, zobaczysz błąd przy starcie:

[15:23:41 ERROR]: Could not load 'plugins/WorldGuard-7.0.9.jar'
org.bukkit.plugin.UnknownDependencyException: Unknown dependency WorldEdit.
Please download and install WorldEdit to run this plugin.

Rozwiązanie proste - pobierz i zainstaluj brakujący plugin.

Częste błędy i ich rozwiązanie

Zła wersja Minecraft

[15:23:41 ERROR]: Could not load 'plugins/SomePlugin-1.0.jar'
org.bukkit.plugin.InvalidPluginException: Plugin requires Minecraft 1.20+

Plugin zbudowany pod inną wersję MC. Pobierz wersję pluginu kompatybilną z twoją wersją serwera.

Przestarzałe API

[15:23:41 WARN]: Plugin SomePlugin v1.0 uses deprecated API methods.
This plugin may not work correctly on future versions.

Plugin używa starych metod API. Zwykle będzie dalej działał, ale lepiej poszukać aktualizacji albo alternatywy.

Konflikt pluginów

[15:23:42 ERROR]: Error occurred while enabling SomePlugin v2.0
java.lang.NoClassDefFoundError: com/sk89q/worldedit/WorldEdit

Zwykle to problem zależności albo konflikt między dwoma pluginami robiącymi to samo. Nie stawiaj dwóch pluginów do jednego zadania.

Błąd w config.yml

[15:23:41 ERROR]: Cannot load plugins/MyPlugin/config.yml
org.yaml.snakeyaml.scanner.ScannerException: mapping values are not allowed here

Błąd składni YAML. Sprawdź wcięcia (tylko spacje, nie taby!) i cudzysłowy. Przepuść plik przez yamllint.com.

Aktualizacja pluginów

Aktualizować pluginy jest ważne - to poprawki bugów, nowe funkcje i zamykanie podatności.

# 1. Zatrzymaj serwer
# 2. Zrób backup
cp -r plugins/ plugins_backup_$(date +%Y%m%d)/

# 3. Podmień plik .jar
rm plugins/EssentialsX-2.20.0.jar
cp EssentialsX-2.20.1.jar plugins/

# 4. Odpal serwer

Nie aktualizuj wszystkich pluginów naraz. Aktualizuj po jednym i sprawdzaj, że nic się nie zepsuło.

Przydatne pluginy na start

Minimalny zestaw dla nowego serwera:

Plugin	Po co
EssentialsX	Podstawowe komendy: /home, /spawn, /tpa, /warp, moderacja
LuckPerms	System uprawnień i grup. Najlepsze rozwiązanie na rynku
WorldGuard	Ochrona regionów przed grieferami (wymaga WorldEdit)
Vault	API do ekonomii i uprawnień. Potrzebny wielu pluginom
CoreProtect	Logowanie zmian bloków. Niezastąpiony przy śledztwie griefingu

Ochrona przed DDoS

Kiedy serwer zbiera audytorium, staje się celem ataków DDoS. Pluginy wewnątrz serwera nie mogą ochronić przed atakami sieciowymi - do tego potrzebna jest zewnętrzna ochrona na poziomie ruchu.

MineGuard działa jako proxy przed twoim serwerem, filtrując złośliwy ruch, zanim dotrze do core'a gry. Plugin MineGuard dla Paper/Spigot pozwala serwerowi otrzymywać prawdziwe adresy IP graczy przez zabezpieczony kanał - bez niego wszyscy gracze będą widoczni z jednego adresu IP proxy.

Instalacja pluginu MineGuard jest taka sama jak każdego innego - pobierz .jar z panelu klienta i wrzuć do plugins/. Config wygeneruje się automatycznie przy pierwszym starcie.

Podsumowanie

Instalacja pluginów to podstawowa umiejętność dla każdego admina serwera Minecraft. Proces prosty: pobrałeś .jar, wrzuciłeś do plugins/, zrestartowałeś serwer. Trudności zaczynają się z konfiguracją i kompatybilnością, ale prawie każdy błąd rozwiązuje się przez czytanie logów.

Zacznij od EssentialsX + LuckPerms + Vault, skonfiguruj podstawowe rzeczy, a dopiero potem dodawaj pluginy w miarę potrzeby. Nie stawiaj 50 pluginów naraz - to droga do problemów z wydajnością i konfliktów.