Najbezpieczniejsza aktualizacja serwera Paper jest powtarzalną procedurą: najpierw kopia, potem zgodność pluginów, zatrzymanie procesu, podmiana właściwego JAR-a i kontrola logów po uruchomieniu. Pominięcie jednego z tych etapów może zamienić prosty update w długi powrót do poprzedniej wersji.
Najważniejsze konkrety
- Najpierw kopia
- Pełny backup świata i konfiguracji wykonaj przed pierwszym uruchomieniem nowego JAR-a.
- Skok wersji
- Sprawdź wymaganą Javę, changelog Paper oraz zgodność każdego krytycznego pluginu.
- Próba
- Uruchom kopię na osobnym katalogu i przetestuj logowanie, światy, ekwipunki, teleporty oraz ekonomię.
- Wycofanie
- Nie uruchamiaj starej wersji na świecie zapisanym przez nową; rollback oznacza przywrócenie pełnej kopii.
1. Określ, co aktualizujesz
„Aktualizacja serwera” może oznaczać nowy build Paper w tej samej wersji Minecrafta, przejście na nową wersję gry albo zmianę pluginów. Zapisz obecną wersję Paper, Javy, pluginów i świata. Dzięki temu po błędzie będziesz wiedzieć, do czego wrócić.
Przy dużej zmianie nie zakładaj, że plugin działający na starej wersji zadziała po restarcie. Sprawdź stronę autora każdego kluczowego dodatku, wymagane zależności i informacje o migracji. Jeśli plugin nie ma potwierdzonej zgodności, przetestuj go na kopii serwera przed oknem aktualizacyjnym.
2. Zrób backup przed zmianą
Wykonaj pełną kopię świata, konfiguracji, folderu plugins i plików startowych. Zachowaj także stary JAR Paper, aby nie szukać go dopiero po nieudanym starcie. Nie nadpisuj jedynej działającej kopii - backup przed aktualizacją powinien być łatwy do wskazania po dacie.
PaperMC opisuje backup jako pierwszy krok aktualizacji (otwiera w nowej karcie) i zaleca kopie z wielu momentów. Jeśli korzystasz z hostingu, sprawdź również jego procedurę snapshotów, bo panel może mieć własny sposób zatrzymywania i przywracania instancji.
3. Zaktualizuj pluginy w kontrolowany sposób
Pobieraj pluginy z oficjalnej strony projektu lub zaufanego repozytorium. Nie wrzucaj kilku nieznanych plików JAR naraz, bo po błędzie nie będzie wiadomo, który dodatek go wywołał. Przeczytaj logi po każdym większym zestawie zmian i usuń stare, zdublowane wersje.
Paper ma folder plugins/update. Według dokumentacji aktualizacji Paper (otwiera w nowej karcie) można umieścić w nim nowe pliki pluginów i zastosować je przy restarcie. Nadal sprawdź zależności i zgodność - mechanizm podmienia pliki, ale nie naprawia konfliktów między dodatkami.
4. Podmień Paper dopiero po zatrzymaniu procesu
Zatrzymaj serwer komendą /stop albo przyciskiem panelu i poczekaj na pełne zakończenie procesu. Następnie pobierz właściwy JAR, nazwij go tak, jak oczekuje skrypt startowy, i dopiero wtedy zastąp poprzedni plik. Nie podmieniaj JAR-a Paper ani pluginów w działającym serwerze.
Po zmianie uruchom instancję z tym samym katalogiem roboczym. PaperMC zaleca obserwowanie logu startowego (otwiera w nowej karcie), bo właśnie tam pojawią się informacje o niezgodnej wersji, brakującej zależności albo pluginie, który nie został załadowany.
5. Zrób test techniczny i test gracza
Nie kończ aktualizacji na komunikacie „serwer działa”. Przeszukaj logs/latest.log pod kątem ERROR, WARN, wyjątków i komunikatów o wyłączonych pluginach. Potem wejdź na serwer jako zwykły gracz i sprawdź spawn, komendy, teleporty, ochronę, ekonomię, generowanie chunków i zapis ekwipunku.
Jeśli projekt obsługuje Bedrock przez dodatkową warstwę, przetestuj również adres i port Bedrock. Aktualizacja Java nie musi psuć crossplay, ale nie warto zakładać, że wszystkie elementy stosu zachowają się tak samo.
6. Przygotuj rollback przed rozpoczęciem
Rollback nie polega na pochopnym wklejeniu starego JAR-a do działającego serwera. Zatrzymaj proces, zachowaj logi z nieudanego startu, przywróć kopię danych odpowiadającą starej wersji i uruchom poprzednią konfigurację. Jeśli świat został zapisany przez nowszą wersję, nie eksperymentuj na jedynej kopii - użyj osobnej instancji testowej.
Przy dużej aktualizacji zaplanuj komunikat dla graczy: czas prac, numer wersji, możliwy rollback i miejsce zgłaszania problemów. Jasna informacja jest częścią stabilności projektu, nie tylko dodatkiem promocyjnym.
Nie próbuj obniżać wersji świata tylko dlatego, że nowy build ma błąd. Dokumentacja Paper ostrzega, że świat zapisany przez nowszą wersję może nie być bezpiecznie otwierany przez starszą. Najpierw testuj migrację na kopii, a produkcyjny rollback wykonuj wyłącznie z pełnego punktu przywracania.
Nie pomijaj żadnego kroku
- zapisz obecną wersję Paper, Javy i pluginów;
- wykonaj i nazwij pełny backup;
- sprawdź kompatybilność pluginów i zależności;
- zatrzymaj serwer przed podmianą plików;
- uruchom nowy JAR i obserwuj logi;
- wykonaj test administratora oraz zwykłego gracza;
- zachowaj plan powrotu do poprzedniego stanu.
Jeśli dopiero tworzysz projekt, przeczytaj także poradnik jak założyć serwer Minecraft Paper, a po stabilnym uruchomieniu dodaj aktualny profil do listy serwerów Java.
Plan działania krok po kroku
- 1
Zapisz obecną wersję Paper, Java i wszystkich pluginów, a następnie przeczytaj informacje o wydaniu docelowym.
- 2
Wykonaj pełny backup i skopiuj go poza katalog aktualizowanego serwera.
- 3
Na kopii testowej podmień Paper, uruchom właściwą Javę i sprawdź konsolę oraz scenariusze kluczowych funkcji.
- 4
Zapowiedz okno techniczne, zatrzymaj produkcję, wykonaj świeżą kopię, wdroż zweryfikowane pliki i monitoruj logi po otwarciu.
