Discord
Wiki - Serwery

Pluginy do serwera Minecraft

Kompletny przewodnik po pluginach serwerowych - od podstaw systemu Bukkit/Spigot, przez najważniejsze pluginy, po instalację i konfigurację.

Czas czytania: ~10 min Poziom: Średniozaawansowany

Czym są pluginy?

Pluginy (wtyczki) to rozszerzenia serwera Minecraft napisane w języku Java, które dodają nowe funkcje, modyfikują mechaniki gry lub wprowadzają systemy administracyjne. W odróżnieniu od modów klienckich, pluginy działają wyłącznie po stronie serwera - gracze nie muszą niczego instalować, aby korzystać z funkcji oferowanych przez pluginy.

System pluginów opiera się na Bukkit API - otwartym interfejsie programistycznym stworzonym specjalnie dla serwerów Minecraft. Bukkit API jest wspierany przez wszystkie popularne oprogramowania serwerowe: Spigot, Paper i Purpur. Oznacza to, że plugin napisany pod Bukkit API zadziała na każdym z nich (z nielicznymi wyjątkami).

Co mogą pluginy?

Możliwości pluginów są praktycznie nieograniczone. Oto kilka przykładowych zastosowań:

  • Ochrona terenu - systemy claimów, regiony z flagami, ochrona spawnu
  • Ekonomia - waluta wirtualna, sklepy, aukcje, handel między graczami
  • Rangi i uprawnienia - hierarchia rang z różnymi uprawnieniami
  • Teleportacja - komendy /home, /warp, /tpa, /spawn
  • Minigry - BedWars, SkyWars, KitPvP, parkour
  • Anty-cheat - wykrywanie i blokowanie hacków i exploitów
  • Chat - formatowanie, prefiksy rang, filtry wulgaryzmów
  • Logowanie - śledzenie działań graczy, rollback zmian

Ważne: Pluginy to nie mody! Mody (Forge, Fabric) zmieniają kod klienta i serwera, dodając nowe bloki, moby czy mechaniki. Pluginy działają w ramach istniejących mechanik Minecrafta i nie wymagają modyfikacji klienta gracza. Serwer Minecraft wymaga zainstalowanej Javy.

Najpopularniejsze pluginy

Poniżej przedstawiamy pluginy, które stanowią fundament większości polskich serwerów Minecraft. Są sprawdzone, regularnie aktualizowane i posiadają szeroką dokumentację.

EssentialsX - podstawowy zestaw narzędzi

EssentialsX Narzędzia podstawowe

EssentialsX to jeden z najważniejszych pluginów dla każdego serwera. Dostarcza ponad 100 komend i funkcji, w tym: /home, /warp, /tpa, /spawn, /nick, /kit, system ekonomii, maile między graczami, AFK detection i wiele więcej. To plugin typu "must-have" - bez niego prowadzenie serwera byłoby znacznie trudniejsze.

EssentialsX oferuje również moduły dodatkowe: EssentialsX Chat (formatowanie chatu), EssentialsX Spawn (zarządzanie spawnem) i EssentialsX AntiBuild (ograniczenia budowania per grupa).

WorldEdit - edycja terenu

WorldEdit Narzędzia budowlane

WorldEdit to zaawansowane narzędzie do masowej edycji bloków. Pozwala zaznaczać regiony (za pomocą drewnianej siekiery lub komend //pos1 i //pos2) i wykonywać na nich operacje: wypełnianie (//set), zamiana (//replace), kopiowanie (//copy), wklejanie (//paste), obracanie i lustrzane odbicie. Niezbędny do szybkiego budowania, terraformingu i naprawy zniszczeń.

WorldEdit wspiera również tzw. schematics - pliki z zapisanymi strukturami, które można wklejać w dowolne miejsce świata. Przydatne do stawiania gotowych budowli (lobby, areny, sklepy).

WorldGuard - ochrona regionów

WorldGuard Ochrona

WorldGuard to system ochrony regionów ściśle zintegrowany z WorldEdit. Pozwala definiować regiony i ustawiać na nich flagi: zakaz budowania, zakaz PvP, zakaz eksplozji, ochrona przed ogniem, zakaz wejścia i dziesiątki innych. Regiony mogą mieć właścicieli i członków z różnymi uprawnieniami.

Komendy bazowe: //wand (siekiera do zaznaczania), /rg define NazwaRegionu (tworzenie regionu), /rg flag NazwaRegionu pvp deny (ustawianie flag). WorldGuard chroni również przed griefingiem na poziomie globalnym - można wyłączyć eksplozje creeperów, rozprzestrzenianie się ognia czy interakcję z endermanami.

Vault - API ekonomii i uprawnień

Vault API / Integracja

Vault to plugin-pośrednik (API), który łączy ze sobą pluginy ekonomii, uprawnień i chatu. Sam z siebie nie dodaje żadnych funkcji widocznych dla gracza, ale jest wymagany przez dziesiątki innych pluginów. Np. plugin sklepu używa Vault, aby pobrać saldo gracza z pluginu ekonomii, niezależnie od tego, czy to EssentialsX Economy, czy CMI.

Vault jest jednym z najczęściej wymaganych zależności. Zainstaluj go zawsze, gdy jakikolwiek plugin wymaga "Vault" w swoich zależnościach.

LuckPerms - system uprawnień

LuckPerms Uprawnienia / Rangi

LuckPerms to nowoczesny, potężny system uprawnień (permissions). Pozwala tworzyć grupy (rangi), przypisywać im uprawnienia (permissions nodes) i zarządzać hierarchią rang. Zastąpił starsze rozwiązania jak PermissionsEx czy GroupManager, oferując interfejs webowy, edytor w przeglądarce i zaawansowane funkcje jak rangi czasowe, konteksty i dziedziczenie.

Podstawowe komendy: /lp editor (otwiera edytor webowy), /lp group VIP permission set essentials.fly true (nadaje uprawnienie), /lp user Gracz parent set VIP (przypisuje rangę). Edytor webowy to ogromna zaleta - pozwala wizualnie zarządzać rangami bez wpisywania komend.

GriefPrevention - ochrona przed griefingiem

GriefPrevention Ochrona

GriefPrevention to system claimów (roszczeń terytorialnych) pozwalający graczom chronić swoje budowle. Gracz zaznacza teren złotą łopatą i automatycznie otrzymuje ochronę - inni gracze nie mogą niszczyć, budować ani otwierać skrzyń w chronionym regionie. System jest intuicyjny i nie wymaga interwencji administracji.

Plugin automatycznie przydziela bloki claimów na podstawie czasu gry - im dłużej gracz gra, tym więcej terenu może zabezpieczyć. Administratorzy mogą dostosować tempo przydzielania bloków i maksymalne limity. Obsługuje również "trust levels" - gracz może dać znajomemu dostęp do budowania (/trust Gracz) lub otwierania skrzyń (/containertrust Gracz).

Inne ważne pluginy

CoreProtect - loguje wszystkie interakcje graczy z blokami. Pozwala sprawdzić kto zniszczył blok (/co inspect) i cofnąć zmiany (/co rollback). Niezbędny na każdym publicznym serwerze.
Multiverse-Core - zarządzanie wieloma światami na jednym serwerze. Tworzenie, usuwanie, importowanie i teleportacja między światami.
PlaceholderAPI (PAPI) - system zmiennych dynamicznych (placeholderów) używanych przez tablice wyników, chat, hologramy i dziesiątki innych pluginów.
Citizens - tworzenie NPC (postaci niezależnych) z dialogami, zadaniami i interakcjami. Podstawa serwerów RPG.
TAB - zaawansowana personalizacja listy graczy (Tab List) z rangami, prefiksami, statystykami i animacjami.
Dynmap - interaktywna mapa świata dostępna z poziomu przeglądarki. Renderuje świat serwera w czasie rzeczywistym z zaznaczonymi graczami i regionami.
ProtocolLib - biblioteka wymagana przez wiele pluginów do modyfikacji pakietów sieciowych. Zainstaluj, jeśli jakikolwiek plugin jej wymaga.

Instalacja pluginów

Instalacja pluginów na serwerze Minecraft jest prosta i składa się z kilku kroków. Pamiętaj, że pluginy działają tylko na serwerach Spigot, Paper, Purpur i innych platformach opartych na Bukkit API. Serwer Vanilla nie obsługuje pluginów. Jeśli chcesz mody zamiast pluginów, rozważ Fabric.

  1. Pobierz plugin - pobierz plik .jar pluginu z oficjalnego źródła (SpigotMC, Modrinth, Hangar, Bukkit Dev lub strona autora). Upewnij się, że wersja pluginu jest kompatybilna z wersją Twojego serwera.
  2. Umieść w folderze plugins - skopiuj pobrany plik .jar do folderu plugins/ w katalogu serwera. Jeśli folder nie istnieje, utwórz go ręcznie.
  3. Zrestartuj serwer - zatrzymaj serwer komendą stop w konsoli i uruchom go ponownie. Plugin załaduje się automatycznie podczas startu.
  4. Sprawdź status - po uruchomieniu wpisz /plugins w konsoli lub w grze. Pluginy wyświetlone na zielono działają poprawnie, na czerwono - wystąpił błąd.

Uwaga: Unikaj komendy /reload do przeładowywania pluginów. Może powodować wycieki pamięci, błędy i niestabilność serwera. Zawsze restartuj serwer po dodaniu lub aktualizacji pluginów.

Zależności (dependencies)

Wiele pluginów wymaga innych pluginów do działania - tzw. zależności (dependencies). Np. WorldGuard wymaga WorldEdit, a większość pluginów ekonomicznych wymaga Vault. Informacja o zależnościach znajduje się na stronie pluginu. Jeśli brakuje zależności, plugin nie załaduje się i wyświetli błąd w logach (logs/latest.log).

Sprawdzaj logi serwera po każdym dodaniu pluginu. Szukaj linii [WARN] lub [ERROR] - często wskazują brakujące zależności lub problemy z konfiguracją.

Konfiguracja pluginów

Po pierwszym uruchomieniu plugin tworzy swój folder konfiguracyjny w plugins/NazwaPluginu/. Najważniejszy plik to zazwyczaj config.yml - główny plik konfiguracyjny w formacie YAML.

Podstawy formatu YAML

YAML (Yet Another Markup Language) to format konfiguracyjny używany przez prawie wszystkie pluginy Minecraft. Oto kilka zasad:

  • Wcięcia mają znaczenie - YAML używa spacji (nie tabulatorów!) do definiowania hierarchii. Zwykle 2 spacje na poziom.
  • Klucz: wartość - każda opcja to para klucz-wartość oddzielona dwukropkiem i spacją.
  • Listy - elementy listy zaczynają się od myślnika i spacji (- element).
  • Komentarze - linie zaczynające się od # są ignorowane.
# Przykład config.yml settings: max-homes: 3 teleport-delay: 5 economy: enabled: true starting-balance: 1000.0 disabled-commands: - /fly - /god

Uwaga: Jeden błąd w YAML (np. tabulator zamiast spacji, brakujący dwukropek) może uniemożliwić załadowanie całej konfiguracji. Przed zapisaniem sprawdź plik walidatorem YAML online (np. yamllint.com).

Przeładowywanie konfiguracji

Po zmianie pliku konfiguracyjnego musisz przeładować plugin. Większość pluginów oferuje komendę przeładowania (np. /essentials reload, /lp reload). Jest to bezpieczniejsze niż restart serwera i działa natychmiastowo. Sprawdź dokumentację pluginu, aby znaleźć właściwą komendę.

Skąd pobierać pluginy?

Bezpieczeństwo jest kluczowe przy pobieraniu pluginów. Złośliwy plugin może zniszczyć świat, wykraść dane lub przejąć kontrolę nad serwerem. Korzystaj wyłącznie z zaufanych źródeł:

SpigotMC Resources - największa baza pluginów z systemem recenzji i aktualizacji. Ponad 100 000 zasobów.
Modrinth - nowoczesna platforma z otwartym kodem źródłowym. Rosnąca popularność, dobra moderacja.
Hangar (PaperMC) - oficjalna platforma PaperMC do dystrybucji pluginów. Zintegrowana z ekosystemem Paper.
Bukkit Dev - starsza, ale wciąż aktywna platforma (należy do CurseForge).
GitHub - wielu autorów publikuje kod źródłowy i buildów pluginów na GitHubie. Sprawdź sekcję Releases.

Nigdy nie pobieraj pluginów z: przypadkowych forów, "wersji cracked/nulled" płatnych pluginów, linków z niezaufanych serwerów Discord. Zmodyfikowane pluginy mogą zawierać backdoory, keyloggery lub cryptominery. Oszczędność kilkudziesięciu złotych nie jest warta ryzyka utraty serwera.

Najczęstsze problemy

Oto najczęściej spotykane problemy z pluginami i sposoby ich rozwiązania:

Plugin wyświetla się na czerwono w /plugins

Sprawdź logi serwera (logs/latest.log) - szukaj wiadomości o brakujących zależnościach, niekompatybilnej wersji lub błędach w konfiguracji. Upewnij się, że masz zainstalowane wszystkie wymagane zależności.

Komendy pluginu nie działają

Upewnij się, że gracz ma odpowiednie uprawnienia (permissions). Użyj LuckPerms do sprawdzenia i przypisania uprawnień. Sprawdź też, czy plugin jest załadowany (/plugins).

Serwer laguje po dodaniu pluginu

Użyj narzędzia Spark (/spark profiler) lub Timings (/timings report) do identyfikacji pluginu powodującego lagi. Niektóre pluginy mogą być źle zoptymalizowane lub mieć konflikty z innymi.

Konflikty między pluginami

Pluginy mogą kolidować, rejestrując te same komendy lub modyfikując te same mechaniki. Sprawdź, czy nie masz duplikatów funkcjonalności (np. dwa pluginy ekonomii). Użyj komendy /help NazwaKomendy aby zobaczyć, który plugin ją obsługuje.

Plugin nie działa po aktualizacji serwera

Po aktualizacji wersji Minecraft sprawdź, czy wszystkie pluginy mają wydane aktualizacje kompatybilne z nową wersją. Testuj aktualizacje na kopii serwera przed wdrożeniem na produkcji.

Co dalej?

Pluginy to fundament każdego serwera Minecraft - wybierz mądrze i nie przesadzaj z ich ilością. Lepiej mieć 15 dobrze skonfigurowanych pluginów niż 50 przypadkowych. Oto kolejne kroki:

Komentarze