Jak zainstalować Paper na serwerze Minecraft krok po kroku

Wybór silnika serwera a koszty hostingu i komfort rozgrywki

Uruchomienie serwera Minecraft dla grupy znajomych lub szerszej społeczności zawsze wiąże się z koniecznością podjęcia decyzji o zapleczu technicznym. W realiach, gdzie budżet na hosting rzadko bywa nieograniczony, kluczem do sukcesu jest optymalne wykorzystanie zasobów procesora i pamięci operacyjnej. Wybór oprogramowania serwerowego – potocznie nazywanego silnikiem – bezpośrednio wpływa na to, ile przyjdzie zapłacić za serwer i czy rozgrywka będzie płynna, wolna od uciążliwych opóźnień (lagów).

Wpływ oprogramowania serwerowego na zużycie pamięci RAM i obciążenie procesora

Domyślny silnik dostarczany przez studio Mojang (tzw. Vanilla) nie został zaprojektowany z myślą o wysokiej wydajności przy większej liczbie graczy. Każdy dodatkowy użytkownik generuje obciążenie poprzez ładowanie nowych fragmentów świata (chunków), generowanie i obliczanie fizyki bytów (entity), takich jak potwory, zwierzęta czy przedmioty leżące na ziemi, a także przetwarzanie mechanizmów czerwonego kamienia (redstone). W środowisku jednowątkowym, jakim w większości aspektów pozostaje Minecraft, oznacza to szybkie osiągnięcie limitu wydajności pojedynczego rdzenia procesora.

Silniki alternatywne modyfikują wewnętrzny kod gry, aby lepiej zarządzać zasobami sprzętowymi. Niektóre z nich minimalizują narzut na pamięć RAM, inne optymalizują obliczenia fizyki, dzięki czemu maszyna o gorszych parametrach może obsłużyć więcej graczy jednocześnie bez drastycznego spadku wskaźnika TPS (Ticks Per Second), który powinien wynosić stabilne 20.

Relacja między wyborem silnika a miesięcznym budżetem na serwer

Dla małych projektów oraz serwerów prywatnych budżet jest kluczowym kryterium wyboru. Decydując się na silnik bez optymalizacji, administrator staje przed koniecznością zakupu droższych pakietów hostingowych oferujących większą ilość pamięci RAM i silniejsze rdzenie procesorów (CPU). Przykładowo, serwer Vanilla z 10 aktywnymi graczami może wymagać nawet 6-8 GB pamięci RAM na nowoczesnych wersjach gry, aby uniknąć komunikatów o opóźnieniach systemu.

Zastosowanie zoptymalizowanego oprogramowania, takiego jak Paper, pozwala obniżyć te wymagania niemal o połowę. Stabilną rozgrywkę dla podobnej grupy osób można wówczas uzyskać na maszynie wyposażonej w 4 GB RAM-u. W perspektywie długofalowej oznacza to oszczędności rzędu kilkudziesięciu procent na miesięcznych opłatach u dostawcy hostingu, bez konieczności rezygnacji z płynności rozgrywki lub zasięgu rysowania świata.

Architektura Paper: asynchroniczne przetwarzanie chunków i optymalizacja pętli gry

Silnik Paper (będący bezpośrednim rozwinięciem i ulepszeniem silników Bukkit oraz Spigot) rewolucjonizuje sposób zarządzania zasobami dzięki asynchroniczności. W tradycyjnym silniku wczytywanie i generowanie terenu odbywa się na głównym wątku gry. Gdy gracz porusza się szybko, na przykład lecąc elytrami, serwer musi wstrzymać lub drastycznie spowolnić inne obliczenia, aby nadążyć z generowaniem świata. Objawia się to „zamrażaniem” gry oraz spadkami TPS.

Paper przenosi procesy zapisu, odczytu oraz generowania chunków na osobne, pomocnicze wątki procesora. Główny wątek odpowiada niemal wyłącznie za logikę gry, co bezpośrednio przekłada się na stałą płynność. Dodatkowo silnik ten wprowadza zaawansowane algorytmy kontrolujące częstotliwość aktualizacji sztucznej inteligencji stworzeń, zasięg ich aktywacji oraz sposób działania mechanizmów fizyki, eliminując zbędne kalkulacje poza zasięgiem wzroku gracza.

Kiedy Paper to najlepszy wybór, a kiedy warto wybrać inne rozwiązanie

Mimo ogromnych zalet optymalizacyjnych, Paper nie jest uniwersalnym panaceum dla każdego typu serwera. Każda ingerencja w podstawowy kod gry niesie za sobą pewne kompromisy, które należy przeanalizować przed podjęciem ostatecznej decyzji. Poniższa analiza ułatwi dopasowanie technologii do konkretnego scenariusza rozgrywki.

Sytuacje, w których Paper jest optymalny

Paper stanowi złoty standard dla serwerów publicznych typu Survival, Freebuild, Skyblock czy serwerów z minigrami. Doskonale sprawdza się wszędzie tam, gdzie kluczowe jest uruchomienie różnego rodzaju dodatków (pluginów) ułatwiających zarządzanie rozgrywką – takich jak systemy ekonomii, zabezpieczenia terenu (np. WorldGuard) czy logowanie graczy. Dzięki stabilnej strukturze API, Paper bez problemu obsługuje setki popularnych modyfikacji serwerowych, gwarantując jednocześnie, że serwer nie przeciąży się przy wzmożonym ruchu użytkowników na mapie.

Ograniczenia i kompromisy: zachowanie mechanik Vanilla

Aby uzyskać spektakularne wyniki wydajnościowe, twórcy silnika Paper musieli zmodyfikować niektóre domyślne zachowania gry. Zmiany te dotyczą m.in. sposobu, w jaki silnik grupuje leżące na ziemi przedmioty, jak oblicza zasięg działania urządzeń z czerwonego kamienia oraz jak zachowują się płyny i tory dla wagoników. Dla przeciętnego gracza różnice te są całkowicie niezauważalne.

Problem pojawia się jednak w społecznościach nastawionych na tzw. „technical Minecraft”. Skomplikowane, gigantyczne farmy surowców oparte na błędach silnika gry (np. powielanie piasku, specyficzny ticking tłoków) mogą na silniku Paper przestać działać lub funkcjonować z drastycznie obniżoną wydajnością. Jeśli priorytetem jest stuprocentowa zgodność z oryginalną fizyką gry stworzoną przez Mojang, Paper może wymagać bardzo głębokiej konfiguracji lub nie być optymalnym wyborem.

Alternatywy w ujęciu budżetowo-funkcjonalnym

Jeśli specyfika serwera wyklucza użycie silnika Paper, warto rozważyć alternatywne podejścia oparte o kryterium kosztów i celów:

• Fabric z modami Lithium, FerriteCore i Krypton: To potężne, bezpłatne rozwiązanie dla serwerów technicznych. Zachowuje pełną tożsamość mechaniczną gry Vanilla, jednocześnie oferując optymalizacje kodu na poziomie zbliżonym do Papera. Nie pozwala jednak na bezpośrednie uruchamianie pluginów napisanych pod Bukkita (wymaga stosowania specjalnych wrapperów lub odpowiedników w postaci modów Fabric).
• Spigot: Bezpośredni przodek Papera. Obecnie rzadko rekomendowany jako samodzielne rozwiązanie, ponieważ Paper posiada wszystkie jego funkcje, będąc od niego znacznie szybszym i stabilniejszym środowiskiem. Spigota warto rozważać wyłącznie przy testach bardzo starych, nieaktualizowanych pluginów, które wykazują błędy pod nowszą architekturą.
• Purpur: Rozwinięcie silnika Paper, które wprowadza dodatkowe opcje konfiguracyjne (np. możliwość ujeżdżania niemal każdego stworzenia) oraz zawiera dodatkowe mikro-optymalizacje. Jest świetnym wyborem dla administratorów, którzy chcą wycisnąć absolutne maksimum z dostępnego sprzętu i cenią sobie elastyczność ustawień.

Przygotowanie środowiska i wybór właściwej wersji oprogramowania

Przed przystąpieniem do właściwej instalacji niezbędne jest odpowiednie przygotowanie gruntu. Pominięcie tego etapu lub wybór niewłaściwych komponentów może skutkować problemami ze stabilnością serwera, brakiem możliwości uruchomienia usługi lub podatnością na zagrożenia bezpieczeństwa.

Sprawdzenie zgodności wersji środowiska Java z wersją Minecrafta

Minecraft jest aplikacją napisaną w języku Java, co oznacza, że do działania serwera niezbędne jest zainstalowanie odpowiedniej wersji środowiska uruchomieniowego Java Runtime Environment (JRE) lub Java Development Kit (JDK). Wersja Javy musi ściśle odpowiadać wymaganiom danej wersji gry. Niedopasowanie tych elementów uniemożliwi poprawny rozruch serwera. ^[1]

• Dla wersji Minecraft 1.12.2 i starszych wymagana jest zazwyczaj Java 8.
• Dla wersji od 1.17 do 1.17.1 niezbędna jest Java 16.
• Wersje od 1.18 do 1.20.4 wymagają środowiska Java 17.
• Najnowsze wydania od wersji 1.20.5 i nowszych wymagają do pracy minimum Java 21.

W przypadku korzystania z zewnętrznego VPS, instalację właściwej wersji Javy (np. OpenJDK 21) na systemie Debian lub Ubuntu realizuje się za pomocą menedżera pakietów przy użyciu następującego polecenia konsoli: ^[2]

sudo apt update && sudo apt install openjdk-21-jre-headless -y

Pobieranie oficjalnego pliku .jar bezpośrednio z repozytorium PaperMC

Ze względów bezpieczeństwa pliki wykonywalne serwera należy pobierać wyłącznie z oficjalnej strony projektu. Pobieranie silników z nieznanych forów dyskusyjnych, serwisów hostingowych czy paczek dystrybuowanych przez osoby trzecie niesie za sobą ogromne ryzyko zainfekowania serwera złośliwym oprogramowaniem (np. wirusami wykradającymi dane, backdoorami dającymi dostęp do konsoli).

Oficjalne kompilacje silnika Paper są dostępne na stronie papermc.io w sekcji „Downloads”. Strona ta udostępnia przejrzysty interfejs, na którym można wybrać docelową wersję gry oraz pobrać najnowszy stabilny build oznaczony konkretnym numerem. Każda nowa wersja (build) zawiera poprawki błędów oraz optymalizacje, dlatego zaleca się regularne aktualizowanie pliku do najnowszego stabilnego wydania dla wybranej wersji gry. ^[3]

Wybór optymalnego środowiska: VPS, hosting współdzielony czy lokalna maszyna

W zależności od zakładanego budżetu i umiejętności technicznych, instalacja może zostać przeprowadzona w jednym z trzech najpopularniejszych środowisk:

1. Dedykowany hosting Minecraft (współdzielony): Rozwiązanie najtańsze i najprostsze dla osób początkujących. Użytkownik otrzymuje dostęp do gotowego panelu zarządzania (np. Pterodactyl, Multicraft), gdzie większość procesów instalacyjnych jest zautomatyzowana. Minusem bywa ograniczenie dostępu do pełnej konfiguracji systemu oraz dzielenie zasobów maszyny fizycznej z innymi klientami.
2. Prywatny serwer VPS (Virtual Private Server): Opcja dająca pełną kontrolę nad systemem operacyjnym (najczęściej Linux). Pozwala na precyzyjne dostosowanie parametrów startowych Javy, instalację dowolnych narzędzi monitorujących i pełną swobodę konfiguracji. Wymaga jednak podstawowej znajomości obsługi terminala SSH i samodzielnego dbania o bezpieczeństwo systemu.
3. Środowisko lokalne (własny komputer): Idealne rozwiązanie do celów testowych, budowania mapy czy konfiguracji pluginów przed ich wdrożeniem na serwer produkcyjny. Uruchomienie serwera lokalnie jest całkowicie darmowe i pozwala na błyskawiczne diagnozowanie ewentualnych problemów.

Instalacja Paper krok po kroku na panelu hostingowym oraz VPS

Proces instalacji różni się w zależności od wybranego środowiska uruchomieniowego. Poniżej przedstawiono dwie szczegółowe ścieżki wdrożenia silnika: pierwszą dla użytkowników korzystających z tradycyjnych hostingów Minecraft wyposażonych w panel WWW, oraz drugą dla osób konfigurujących własny serwer VPS na systemie Linux.

Przy planowaniu kolejnych kroków pomocny może być tekst: Czy warto przechodzić z Spigot na Paper na serwerze z modami i pluginami.

Metoda 1: Instalacja przez panel WWW i menedżer plików (najszybsza ścieżka na hostingu współdzielonym)

Większość komercyjnych dostawców usług hostingowych dedykowanych grze Minecraft oferuje uproszczony schemat zarządzania plikami. Proces ręcznej instalacji silnika Paper w takim środowisku wygląda następująco:

Krok 1: Pobranie pliku i przygotowanie dostępu

Pobierz na swój dysk twardy właściwy plik .jar ze strony PaperMC. Dla ułatwienia dalszej pracy możesz zmienić jego nazwę na prostą i czytelną, na przykład server.jar lub paper.jar.

Krok 2: Połączenie z serwerem i wgranie pliku

Zaloguj się do panelu zarządzania swoim hostingiem. Przejdź do zakładki „Menedżer plików” (File Manager) lub skorzystaj z zewnętrznego klienta FTP/SFTP (np. darmowego programu FileZilla). Dane do logowania SFTP znajdziesz zazwyczaj w głównym oknie panelu hostingu. Po nawiązaniu połączenia prześlij pobrany wcześniej plik paper.jar do głównego katalogu serwera (zazwyczaj jest to katalog główny / lub folder o nazwie container).

Krok 3: Wybór pliku startowego w ustawieniach panelu

W panelu hostingu odszukaj sekcję konfiguracji parametrów startowych (często nazywaną „Ustawienia startowe”, „Startup” lub „Konfiguracja”). W polu przeznaczonym na nazwę pliku uruchomieniowego (Server Jar File) wpisz dokładną nazwę wgranego pliku, np. paper.jar. Zapisz zmiany.

Krok 4: Pierwsze uruchomienie i akceptacja licencji EULA

Przejdź do konsoli serwera i kliknij przycisk „Uruchom” (Start). Serwer rozpocznie proces inicjalizacji, wygeneruje podstawowe foldery konfiguracyjne, po czym automatycznie wyłączy się. Jest to całkowicie normalne zjawisko spowodowane koniecznością zaakceptowania umowy licencyjnej użytkownika końcowego (EULA).

Wróć do menedżera plików, odszukaj nowo powstały plik tekstowy o nazwie eula.txt i otwórz go do edycji. Zmień linijkę:

eula=false

na:

eula=true

Zapisz plik i ponownie uruchom serwer w konsoli. Proces generowania świata i pełnego rozruchu silnika Paper rozpocznie się automatycznie.

Metoda 2: Instalacja na serwerze VPS / dedykowanym przez terminal Linux

Ta metoda wymaga dostępu SSH oraz podstawowej swobody w pracy z terminalem, ale w zamian daje pełną kontrolę nad kosztami i konfiguracją. Po zalogowaniu się na VPS utwórz osobny katalog na serwer, przejdź do niego i pobierz plik Paper bezpośrednio z oficjalnego źródła. Przykładowy zestaw poleceń może wyglądać tak:

mkdir -p ~/minecraft-server && cd ~/minecraft-server
wget -O paper.jar https://api.papermc.io/v2/projects/paper/versions/WERSJA_MC/builds/NUMER_BUILD/downloads/paper-WERSJA_MC-NUMER_BUILD.jar

Zamiast ręcznie wpisywać długi adres, można skopiować link do pobrania ze strony PaperMC. Następnie uruchom plik poleceniem java -Xms1G -Xmx2G -jar paper.jar nogui, dostosowując wartości pamięci RAM do dostępnych zasobów. Na małym VPS lepiej zacząć od rozsądnego limitu niż przydzielać całą pamięć systemu — system operacyjny i usługi działające w tle również potrzebują zapasu. Po pierwszym uruchomieniu serwer wygeneruje plik eula.txt; zmień w nim wpis eula=false na eula=true, a następnie ponownie wykonaj komendę startową.

Do dłuższej pracy wygodnie jest uruchamiać serwer w sesji screen lub tmux, dzięki czemu proces nie zostanie zatrzymany po zamknięciu połączenia SSH. Przykładowo po instalacji narzędzia screen komendą sudo apt install screen -y można utworzyć sesję przez screen -S minecraft i uruchomić w niej serwer. Taki wariant jest prosty, darmowy i wystarczający na start; automatyczne uruchamianie po restarcie VPS można skonfigurować później za pomocą usługi systemd.

Po poprawnym rozruchu sprawdź konsolę pod kątem błędów, połącz się z serwerem z tej samej wersji Minecrafta i wykonaj kopię katalogu serwera przed instalacją pierwszych pluginów lub zmianą ustawień. Paper daje dobrą bazę do taniego, stabilnego serwera, o ile aktualizacje, kopie zapasowe i zmiany konfiguracji są wprowadzane spokojnie — najlepiej pojedynczo, z możliwością szybkiego cofnięcia błędnej modyfikacji.

Bezpieczna migracja ze Spigota lub serwera Vanilla na Paper

Decyzja o przeniesieniu istniejącego świata na nowy silnik nigdy nie powinna być podejmowana pod wpływem impulsu. Choć Paper charakteryzuje się wysokim poziomem wstecznej kompatybilności, przejście z czystej Vanilli (oficjalnego silnika Mojang) lub ze Spigota wiąże się ze znaczącymi zmianami w strukturze katalogów oraz w sposobie interpretacji mechanik gry. Aby uniknąć utraty postępów graczy czy uszkodzenia struktur, należy precyzyjnie ocenić ryzyko i przygotować plan migracji.

Kryteria decyzji: Czy migracja na Paper ma sens w Twoim przypadku?

Przed wykonaniem jakichkolwiek kroków technicznych, przeanalizuj poniższe zestawienie kontrastów, które ułatwi podjęcie bezpiecznej decyzji:

• Warto migrować, gdy: Twoi gracze zgłaszają odczuwalne spadki TPS (Ticks Per Second) przy kilkunastu osobach online, chcesz zabezpieczyć serwer przed popularnymi błędami typu duplikacja przedmiotów (dupe glitches), planujesz wdrożyć zaawansowane pluginy administracyjne (np. CoreProtect, WorldGuard) lub chcesz drastycznie zmniejszyć zużycie procesora przez pasywne i agresywne moby.
• Uważaj, gdy (lub zrezygnuj): Prowadzisz hermetyczny serwer techniczny, na którym gracze budują gigantyczne, skomplikowane maszyny redstone oparte na niszowych błędach gry (np. update-suppression, duplikacja tnt/piasku, asynchroniczne przetwarzanie chunków). Paper domyślnie naprawia te błędy, co dla społeczności technicznej oznacza zniszczenie ich wielomiesięcznej pracy. W takich sytuacjach lepszym wyborem może okazać się Fabric z modami optymalizacyjnymi (np. Lithium, Phosphor).

Krok po kroku: Konwersja struktury plików świata

Największa różnica techniczna między silnikiem Vanilla a silnikami z rodziny Bukkit (Spigot, Paper) tkwi w strukturze zapisu wymiarów gry (Nether oraz End):

• Vanilla: Przechowuje cały świat w jednym katalogu (domyślnie world). Wymiar Nether znajduje się w podfolderze world/DIM-1, a End w world/DIM1.
• Paper / Spigot: Rozdziela te trzy wymiary na osobne, niezależne katalogi: world (Overworld), world_nether (Nether) oraz world_the_end (End).

Podczas pierwszego uruchomienia Paper automatycznie wykrywa strukturę Vanilli i podejmuje próbę migracji, kopiując foldery DIM-1 i DIM1 do nowych, zewnętrznych katalogów. Aby proces ten przebiegł w pełni bezpiecznie, wykonaj następujące czynności:

1. Archiwizacja danych: Skopiuj cały dotychczasowy katalog serwera w bezpieczne miejsce na dysku lokalnym lub stwórz obraz zapasowy w panelu hostingu.
2. Oczyszczenie starych plików silnika: Jeśli migrujesz ze Spigota, usuń pliki spigot.jar oraz foldery generowane przez ten silnik, które mogą powodować konflikty (np. stare biblioteki w folderze bundler lub libraries). Pozostaw nienaruszone foldery world oraz plugins.
3. Wdrożenie pliku Paper: Umieść plik paper.jar w głównym katalogu i upewnij się, że nazwa pliku w skrypcie startowym lub panelu została zaktualizowana.
4. Pierwsza inicjalizacja migracji: Uruchom serwer. W konsoli zobaczysz komunikaty informujące o wykryciu starej struktury świata i automatycznym przenoszeniu wymiarów Nether i End do osobnych folderów. Nie przerywaj tego procesu.
5. Weryfikacja spójności: Po pełnym załadowaniu serwera, zaloguj się do gry i odwiedź Nether oraz End za pomocą portali. Upewnij się, że ekwipunki graczy, stan skrzyń (Ender Chest) oraz punkty zapisu (spawnpointy) działają prawidłowo.

W przypadku migracji ze Spigota, stare pluginy powinny działać bez przeszkód, ponieważ Paper zachowuje pełne wsparcie dla API Spigot oraz Bukkit. Warto jednak zweryfikować na stronach twórców, czy posiadane wtyczki nie wymagają aktualizacji do wersji dedykowanych bezpośrednio pod silnik Paper – wersje natywne działają asynchronicznie i znacznie mniej obciążają główny wątek gry.

Pierwsza konfiguracja po instalacji – kluczowe parametry os

Samo uruchomienie silnika Paper daje natychmiastowy wzrost wydajności, jednak pełnię jego możliwości osiąga się dopiero po dostrojeniu parametrów konfiguracyjnych. W nowoczesnych wersjach Paper (od wersji 1.19 wzwyż), tradycyjny plik paper.yml został zastąpiony strukturą folderów zlokalizowaną w katalogu config/. Znajdziesz tam dwa kluczowe pliki konfiguracyjne w formacie YAML: paper-global.yml (ustawienia globalne dla całej aplikacji) oraz paper-world-defaults.yml (domyślne ustawienia dla generowanych światów).

Jeśli chcesz pogłębić ten wątek, sprawdź też: Najważniejsze różnice w generowaniu świata między silnikami Spigot Paper i Purpur.

Koncepcja optymalizacji: Agresywne oszczędzanie zasobów vs. zachowanie klimatu Vanilla

Konfigurując serwer, musisz zdecydować, na jakim poziomie realizmu gry Ci zależy. Poniższa tabela przedstawia kryteria wyboru intensywności zmian parametrów operacyjnych (os) silnika:

Najważniejsze parametry operacyjne i oszczędzania zasobów do natychmiastowej zmiany

Otwórz plik config/paper-world-defaults.yml i zlokalizuj następujące sekcje, aby precyzyjnie dostosować działanie serwera:

1. Optymalizacja systemu fizyki i spowalniania nieaktywnych obszarów

Wyszukaj parametr redstone-implementation. Domyślnie Paper używa standardowego algorytmu Vanilli, który generuje ogromne obciążenie przy skomplikowanych obwodach. Zmiana tej wartości na:

redstone-implementation: ALTERNATE_CURRENT

aktywuje nowoczesny, wysoce zoptymalizowany algorytm obliczania sygnału redstone, który potrafi zredukować lagi wywołane przez mechanizmy nawet o kilkadziesiąt procent, nie psując przy tym standardowych konstrukcji.

2. Zarządzanie pamięcią podręczną chunków (Chunk-Unloads)

W sekcji chunks warto upewnić się, że serwer szybko zwalnia pamięć RAM po graczach, którzy opuścili dany obszar. Sprawdź i dostosuj parametry:

delay-chunk-unloads-by: 10s

Skrócenie tego czasu zapobiega utrzymywaniu pustych obszarów w pamięci RAM serwera, co jest kluczowe na maszynach o ograniczonych zasobach (np. VPS z 4 GB RAM).

3. Blokowanie ucieczki pamięci przez Watchdog

W pliku spigot.yml (który nadal współistnieje z Paper) znajduje się parametr timeout-time. Odpowiada on za automatyczny restart serwera, gdy ten przestanie odpowiadać na określony czas (np. podczas generowania bardzo dużej mapy). Podnieś tę wartość z domyślnych 60 do minimum 300 sekund:

timeout-time: 300

Dzięki temu zapobiegniesz pętli restartów serwera w momentach nagłego, przejściowego obciążenia procesora.

Checklista decyzji konfiguracyjnych przed otwarciem serwera

Przed wpuszczeniem pierwszych graczy na zoptymalizowany serwer Paper, przejdź przez poniższą listę kontrolną, aby upewnić się, że wybrane parametry odpowiadają profilowi Twojej społeczności:

• [ ] Czy dystans renderowania (view-distance) w server.properties jest spójny z dystansem symulacji? Zaleca się ustawienie view-distance na 6–8, a simulation-distance na 4–6. Daje to doskonały balans między ładnym widokiem a niskim obciążeniem procesora.
• [ ] Czy limit mobów (spawn-limits) w bukkit.yml nie jest zbyt drastyczny? Dla serwerów Survival optymalne wartości to: monsters: 50, animals: 10, water-animals: 3. Standardowe wartości Vanilli (np. potwory: 70) przy kilku graczach potrafią zaalokować całą moc obliczeniową CPU.
• [ ] Czy zablokowano asynchroniczne zapisywanie świata? W paper-global.yml upewnij się, że opcje zapisu dyskowego są aktywne. Paper realizuje zapisywanie chunków w osobnym wątku, co eliminuje mikroprzycięcia (lag spikes) podczas automatycznego zapisu stanu gry (autosave).

Weryfikacja stabilności po instalacji – jak interpretować parametry TPS i MSPT?

Sama instalacja i konfiguracja plików to dopiero połowa sukcesu. Aby upewnić się, że serwer działa optymalnie i nie psuje rozgrywki, musisz przeprowadzić diagnostykę pod realnym obciążeniem. Silnik Paper dostarcza zaawansowane, wbudowane narzędzia diagnostyczne, które pozwalają precyzyjnie określić, jak maszyna radzi sobie z przetwarzaniem świata gry.

Najważniejszym narzędziem diagnostycznym w nowoczesnych wersjach Paper jest zintegrowany profiler Spark. Zastąpił on starsze, mniej dokładne narzędzie Timings. Aby rozpocząć monitorowanie serwera, wystarczy wpisać w konsoli lub bezpośrednio w grze (posiadając uprawnienia administratora) komendę:

/spark profiler start

Po upływie około 10–15 minut intensywnej rozgrywki (najlepiej, gdy na serwerze przebywa kilku graczy eksplorujących świat i korzystających z mechanizmów) wygeneruj raport komendą /spark profiler stop. Otrzymasz unikalny link do interaktywnego panelu online, który wskaże Ci dwa kluczowe parametry wydajnościowe:

• TPS (Ticks Per Second): Tradycyjny wskaźnik płynności gry. Optymalna wartość to 20.0. Spadek poniżej 19.0 oznacza zauważalne opóźnienia, spowolnienie reakcji mobów i błędy w synchronizacji ruchu graczy.
• MSPT (Milliseconds Per Tick): Znacznie bardziej precyzyjny wskaźnik obciążenia procesora. Pokazuje, ile milisekund zajmuje serwerowi obliczenie jednego ticku gry (który powinien trwać maksymalnie 50 ms).
  • MSPT poniżej 40 ms: Serwer ma bezpieczny zapas mocy obliczeniowej (warto, gdy planujesz rozbudowę serwera lub instalację dodatkowych pluginów).
  • MSPT w przedziale 40–50 ms: Serwer działa płynnie, ale jest na granicy swoich możliwości obliczeniowych.
  • MSPT powyżej 50 ms: Serwer nie nadąża z obliczeniami, co bezpośrednio przekłada się na spadek wartości TPS i widoczne lagowanie rozgrywki.

Kryteria decyzji: Kiedy poluzować optymalizację, a kiedy ją zaostrzyć?

Analiza wyników ze Sparka pozwoli Ci podjąć racjonalną decyzję dotyczącą modyfikacji parametrów konfiguracyjnych. Nie zawsze dążenie do najniższego MSPT jest korzystne dla graczy. Użyj poniższych kryteriów do oceny sytuacji:

• Zwiększ limity i dystans (poluzuj optymalizację), gdy: Twój średni wskaźnik MSPT utrzymuje się na poziomie poniżej 25 ms, a gracze skarżą się na zbyt małą liczbę potworów w nocy, nienaturalne zachowanie fizyki wody lub znikające zbyt szybko przedmioty. Masz wystarczająco dużo wolnych zasobów procesora, aby przywrócić serwerowi bardziej klasyczny charakter Vanilla.
• Zmniejsz limity i dystans (zaostrz optymalizację), gdy: MSPT regularnie przekracza 45 ms, a wykres Sparka wskazuje, że głównym obciążeniem wątku głównego (tick loop) jest przetwarzanie bytów (Entities) lub fizyka Redstone. W takim przypadku powinieneś wdrożyć bardziej restrykcyjne ustawienia w pliku paper-world-defaults.yml, na przykład zmniejszając entity-activation-range lub skracając czas despawnu przedmiotów.

Zgodność pluginów z Paper – jak bezpiecznie dobierać dodatki i unikać pułapek?

Paper zachowuje pełną kompatybilność wsteczną z ekosystemem wtyczek Spigot oraz Bukkit. Należy jednak pamiętać, że Paper wprowadza zaawansowane mechanizmy asynchroniczności (wykonywanie zadań poza głównym wątkiem gry, np. asynchroniczne ładowanie chunków czy asynchroniczny zapis danych). Niektóre starsze lub nieprawidłowo napisane pluginy mogą ignorować te mechanizmy, co prowadzi do uszkodzenia plików świata lub nagłych awarii serwera (crash).

Aby uniknąć destabilizacji serwera, kieruj się prostym podziałem na wtyczki bezpieczne oraz te wymagające szczególnej ostrożności:

Praktyczny przykład weryfikacji kompatybilności: Po instalacji nowego pluginu, zawsze zrestartuj serwer i dokładnie przeanalizuj plik logs/latest.log. Jeśli zobaczysz ostrzeżenia typu [Paper] Plugin X scheduled a synchronous task... lub błędy typu Thread Check Failure, oznacza to, że dana wtyczka próbuje wykonywać niebezpieczne operacje na głównym wątku. W takiej sytuacji najbezpieczniejszym rozwiązaniem jest poszukiwanie alternatywnego, bardziej nowoczesnego odpowiednika lub kontakt z autorem wtyczki w celu zgłoszenia błędu.

Rekomendacja eksploatacyjna – jak utrzymać optymalny balans na dłuższą metę

Wdrożenie silnika Paper to inwestycja w stabilność, która wymaga jednak stałego nadzoru. Aby Twój serwer Minecraft działał bezawaryjnie przez wiele miesięcy, zaadoptuj następujący model zarządzania i podejmowania decyzji technicznych:

1. Zarządzanie aktualizacjami silnika: Zespół deweloperski Paper niezwykle szybko reaguje na błędy wykryte w oryginalnym kodzie gry Minecraft oraz na luki bezpieczeństwa. Nie aktualizuj jednak silnika „na ślepo” przy każdym nowym buildzie. Przyjmij zasadę: aktualizuj Paper natychmiast, gdy nowa wersja naprawia krytyczne luki bezpieczeństwa (exploity), natomiast rutynowe aktualizacje wydajnościowe przeprowadzaj raz na 2–3 tygodnie, uprzednio testując stabilność nowego buildu na kopii zapasowej serwera.
2. Dobór wersji stabilnych vs. eksperymentalnych: Tuż po wydaniu nowej, głównej wersji Minecrafta (np. przejście z 1.20 na 1.21), pierwsze wersje Paper mają status eksperymentalny. Jeśli prowadzisz serwer publiczny z dużą bazą graczy, zrezygnuj z natychmiastowej migracji. Poczekaj od 2 do 4 tygodni, aż silnik osiągnie status stabilny, a autorzy kluczowych pluginów zaktualizują swoje oprogramowanie. Koszt przestoju serwera i ryzyko utraty danych z powodu błędów wersji eksperymentalnej przewyższają korzyści z posiadania najnowszych bloków w grze od pierwszego dnia.
3. Utrzymanie balansu rozgrywki: Pamiętaj, że serwer tworzysz dla społeczności. Jeśli statystyki Sparka wskazują doskonałą wydajność, a gracze uskarżają się na zbyt uproszczoną rozgrywkę (brak skomplikowanych farm redstone, zbyt mały dystans renderowania), wycofaj część agresywnych optymalizacji. Optymalny serwer to taki, który działa płynnie (stabilne 20 TPS), ale jednocześnie nie odbiera graczom radości z odkrywania pełni możliwości mechanik Minecrafta.

Najczęściej zadawane pytania (FAQ)

Jaka wersja Javy jest potrzebna do uruchomienia Paper?

Wymagana wersja zależy od wersji Minecrafta. Minecraft 1.18–1.20.4 wymaga Java 17, a wersje od 1.20.5 wzwyż — minimum Java 21.

Skąd pobrać silnik Paper?

Plik serwera należy pobrać wyłącznie z oficjalnej strony projektu PaperMC, w sekcji „Downloads”.

Czy Paper obsługuje pluginy Bukkit i Spigot?

Tak. Paper obsługuje popularne pluginy przeznaczone dla ekosystemu Bukkit/Spigot, dlatego jest często wybierany do serwerów publicznych i serwerów z dodatkami.

Czy Paper zachowuje wszystkie mechaniki Vanilla?

Paper optymalizuje wybrane zachowania gry, dlatego niektóre mechanizmy redstone, farmy lub błędy wykorzystywane w technical Minecraft mogą działać inaczej albo przestać działać.

Kiedy zamiast Paper warto wybrać Fabric?

Fabric może być lepszym wyborem dla serwera technicznego, na którym najważniejsza jest zgodność z mechanikami Vanilla, szczególnie w przypadku rozbudowanych farm i mechanizmów redstone.

Kluczowe Wnioski

• Paper to zoptymalizowany silnik serwera Minecraft przeznaczony przede wszystkim do rozgrywki z pluginami Bukkit/Spigot.
• Przed instalacją trzeba dopasować wersję Javy do wersji Minecrafta, na przykład Java 17 dla wydań 1.18–1.20.4 i Java 21 dla wersji od 1.20.5.
• Plik serwera Paper należy pobierać wyłącznie z oficjalnej strony PaperMC.
• Paper może ograniczyć zużycie zasobów i poprawić stabilność serwera, ale nie gwarantuje pełnej zgodności ze wszystkimi mechanikami Vanilla.
• Fabric sprawdzi się lepiej na serwerach technicznych, a Forge lub NeoForge na serwerach wykorzystujących rozbudowane modyfikacje.

Źródła

• [1] PaperMC – Getting started — PaperMC Docs ↑
• [2] PaperMC – Installing or updating Java — PaperMC Docs ↑
• [3] PaperMC – Downloads — PaperMC ↑