Pluginy i mody do serwera Minecraft: co wybrać?

Plugin, mod czy datapack?

Paper nie uruchamia modów Fabric ani Forge. Loader modów nie uruchamia z kolei zwykłych pluginów Paper. Istnieją serwery hybrydowe obiecujące oba systemy naraz, ale dokumentacja Paper określa takie połączenia jako wadliwe i ich nie zaleca. Na pierwszy serwer wybierz jedną platformę.

Co wybrać? Najkrótsza odpowiedź

• Chcesz zwykły survival dla znajomych, ochronę świata i komendy administratora: wybierz Paper oraz kilka pluginów.
• Chcesz zachować możliwość wejścia czystym klientem, ale potrzebujesz usprawnień serwera: Paper jest najłatwiejszy; alternatywą są wyłącznie serwerowe mody Fabric.
• Chcesz nowe przedmioty, maszyny, biomy lub gotową paczkę: wybierz loader wskazany przez twórcę paczki, najczęściej Fabric, NeoForge lub Forge.
• Chcesz drobną zmianę receptur lub lootu bez instalatora: najpierw sprawdź, czy wystarczy datapack.

Pięć zgodności, które muszą się zgadzać

1. Edycja gry: poradnik dotyczy Minecraft: Java Edition.
2. Wersja Minecrafta: dodatek dla innego wydania może odmówić startu lub uszkodzić dane.
3. Platforma: Paper, Fabric, NeoForge i Forge to różne środowiska.
4. Zależności: część pluginów wymaga bibliotek, a wiele modów Fabric potrzebuje Fabric API.
5. Strona instalacji: mod może być serwerowy, kliencki albo wymagany po obu stronach.

Opis projektu powinien podawać wszystkie te informacje. Jeśli autor nie określa wersji, loadera i wymaganych zależności, nie testuj pliku na jedynej kopii świata.

Bezpieczeństwo: plik JAR to program

Pluginy i mody nie są biernymi skórkami. Uruchomiony plik JAR może czytać i zmieniać dane dostępne dla procesu serwera. Dokumentacja Paper wprost ostrzega, że plugin otrzymuje nieograniczony dostęp do serwera i maszyny w zakresie praw użytkownika procesu.

• Pobieraj z oficjalnej strony projektu, Hangar, Modrinth, CurseForge albo repozytorium wskazanego przez autora.
• Sprawdź nazwę autora, historię wydań, zależności i zgodność z twoją wersją.
• Unikaj stron kopiujących cudze pliki, skracaczy linków i „przepakowanych” paczek.
• Nie uruchamiaj dodatku jako root. Kontener z poprzedniej części zapisuje dane jako UID 1000, a instalacja systemowa używa osobnego konta minecraft.
• Przed każdą zmianą zachowaj kopię świata, konfiguracji oraz dotychczasowych plików JAR.

Rozsądny zestaw pluginów na początek

Nie instaluj kilkudziesięciu rozszerzeń „na zapas”. Zacznij od problemu, który naprawdę chcesz rozwiązać. Często wystarczy jeden plugin z każdej potrzebnej kategorii:

• LuckPerms — grupy i uprawnienia, gdy operator to za dużo.
• CoreProtect — historia zmian bloków i pomoc przy odwracaniu szkód.
• EssentialsX — popularne komendy administracyjne, domy i teleportacja; wybierz tylko potrzebne moduły.
• WorldEdit i WorldGuard — narzędzia budowania i ochrona regionów, jeśli serwer ich wymaga.

To przykłady, nie lista obowiązkowa. Przed pobraniem sprawdź na stronie projektu obsługiwaną wersję Minecrafta i Paper. Dublujące się pluginy od komend, uprawnień lub czatu częściej powodują konflikty niż dodatkową wygodę.

Jak zainstalować plugin na Paper?

1. Zrób kopię świata oraz katalogu plugins.
2. Pobierz wydanie przeznaczone dla Paper/Bukkit i sprawdź zależności.
3. Zatrzymaj serwer.
4. Umieść pojedynczy plik JAR bezpośrednio w katalogu plugins.
5. Uruchom serwer i przeczytaj początek logu, gdzie ładowane są rozszerzenia.
6. W konsoli lub grze wykonaj plugins. Nowy plugin powinien być aktywny; czerwony wpis oznacza błąd.

Dla instalacji systemowej z tej serii katalog znajduje się zwykle w /opt/minecraft/server/plugins. Przykład:

sudo systemctl stop minecraft
sudo install -o minecraft -g minecraft -m 0644 NazwaPluginu.jar /opt/minecraft/server/plugins/
sudo systemctl start minecraft
sudo journalctl -u minecraft -n 200 --no-pager

W Dockerze z aaPanel użyj /www/minecraft/data/plugins:

docker stop mc
cp NazwaPluginu.jar /www/minecraft/data/plugins/
chown 1000:1000 /www/minecraft/data/plugins/NazwaPluginu.jar
docker start mc
docker logs --tail 200 mc

Jak czytać błąd pluginu?

Kiedy przejść na Fabric albo NeoForge?

Jeżeli planowane rozszerzenie dodaje bloki, przedmioty, interfejsy lub mechaniki wymagające zmian klienta, plugin nie wystarczy. Wtedy przygotuj osobny serwer testowy z loaderem wskazanym przez autora:

• Fabric jest częstym wyborem dla lekkich zestawów i modów optymalizacyjnych. Wiele projektów wymaga dodatkowo Fabric API.
• NeoForge obsługuje rozbudowane mody i nowe paczki; dla części starszych wersji gry projekty nadal wymagają Forge.
• Forge wybierz wtedy, gdy wymaga go konkretny starszy mod lub modpack. Nie zastępuj go NeoForge bez potwierdzonej zgodności.

W kontenerze z poprzedniego poradnika platformę wybiera zmienna TYPE. Dla Fabric ustaw FABRIC, a dla NeoForge NEOFORGE. Zmienna VERSION musi wskazywać dokładne wydanie Minecrafta wymagane przez paczkę:

environment:
  EULA: "TRUE"
  TYPE: "FABRIC"       # albo "NEOFORGE"
  VERSION: "WERSJA_WYMAGANA_PRZEZ_PACZKE"
  MEMORY: "6G"

To szablon — tekst WERSJA_WYMAGANA_PRZEZ_PACZKE zastąp numerem z dokumentacji moda. Pliki modów trafiają do /www/minecraft/data/mods. Przy dużej paczce wygodniej użyć przygotowanego przez autora server packa niż ręcznie odtwarzać dziesiątki zależności.

Czy gracze też potrzebują modów?

Nie ma jednej odpowiedzi dla wszystkich modów:

• Mod wyłącznie serwerowy może działać bez zmian klienta. Autor powinien to wyraźnie napisać.
• Mod dodający zawartość zazwyczaj musi być po obu stronach: ten sam Minecraft, loader, wersja moda i zależności.
• Mod wyłącznie kliencki, na przykład część dodatków interfejsu, nie powinien trafiać na serwer.

Najmniej pomyłek daje gotowy profil lub modpack dla graczy. Nazwij wydanie paczki, nie podmieniaj plików bez zmiany numeru i zachowaj poprzednią wersję do czasu udanego testu.

Nie zmieniaj Paper w serwer modowany „w miejscu”

Zatrzymaj działający serwer, skopiuj cały katalog danych do osobnego katalogu testowego i uruchom loader na kopii. Świat po modach dodających bloki lub przedmioty nie powinien być później otwierany w Paper — nieznane dane mogą zostać utracone. Dokumentacja Paper zaleca znalezienie zamienników pluginowych zamiast używania serwera hybrydowego.

Jeżeli nie wiesz jeszcze, czy mody są potrzebne, zostań przy Paper. Przejście do modpacka warto potraktować jak migrację, a nie jak instalację kolejnego pluginu.

Bezpieczny schemat każdej zmiany

1. Zapisz wersje: Minecraft, Paper lub loader, Java oraz wszystkie dodatki.
2. Zrób kopię poza VPS-em. Kopia powinna obejmować świat, konfiguracje i pliki JAR.
3. Przetestuj kopię. Użyj innego katalogu i portu, aby nie dotknąć produkcyjnego świata.
4. Dodawaj pojedynczo. Po każdym dodatku wykonaj pełny restart i przeczytaj log od początku.
5. Sprawdź grę. Wejście, Nether i End, ekwipunek, uprawnienia, zapis świata oraz ponowny restart.
6. Aktualizuj świadomie. Najpierw przeczytaj notatki wydania; automatyczna podmiana wszystkich JAR-ów może unieruchomić serwer.

Gdy błąd pojawia się dopiero przy wielu dodatkach, wyłącz połowę podejrzanej grupy, zachowując wymagane zależności. Powtarzanie takiego podziału pozwala szybciej znaleźć winowajcę niż losowe usuwanie plików.

Źródła

• Paper: instalacja pluginów, źródła i rozwiązywanie błędów
• Paper: kopie oraz aktualizacja serwera i pluginów
• Paper: migracja, mody i serwery hybrydowe
• Fabric: instalacja i zgodność modów
• Fabric: jak wybierać zaufane źródła
• NeoForge: instalacja serwera, modów i modpacków
• itzg/docker-minecraft-server: różnica między modami i pluginami
• itzg/docker-minecraft-server: typy Paper, Fabric, Forge i NeoForge

Poradnik przygotowany z pomocą AI; zasady zgodności Paper, Fabric, NeoForge i obrazu Docker sprawdzono 29.10.2026. Wersje dodatków zmieniają się szybciej niż poradnik — przed pobraniem przeczytaj stronę konkretnego wydania. Zgłoś nieaktualny dodatek lub błąd.