Migracja z vanilla na Paper bez psucia świata
Przejście z vanilla na Paper to w gruncie rzeczy jedna czynność: zatrzymujesz serwer, podmieniasz plik jar serwera i uruchamiasz go ponownie. Świata nie trzeba konwertować, bo Paper czyta i zapisuje dokładnie ten sam format świata co serwer vanilla od Mojanga. Zmienia się natomiast konfiguracja: po pierwszym starcie czekają na ciebie cztery nowe pliki (bukkit.yml, spigot.yml, config/paper-global.yml i config/paper-world-defaults.yml), a domyślne wartości w nich mogą sprawić, że timingi redstone, spawn mobów i istniejące farmy zaczną działać inaczej, niż jesteś przyzwyczajony.
Dlaczego twój świat po prostu działa dalej?
Paper jest forkiem Spigota, który z kolei jest forkiem serwera vanilla. Wszystkie trzy zapisują te same pliki regionów w world/region, a do tego identyczne level.dat, playerdata i foldery z encjami. Nie ma między nimi żadnego kroku konwersji, żadnego importu ani ekranu migracji.
W praktyce oznacza to, że budowle, skrzynie z zawartością, ekwipunki graczy, advancementy, wioski i twój seed zostają takie, jakie były, a server.properties, ops.json i whitelist.json przechodzą bez zmian. To, co dokłada Paper, ląduje obok, a nie w środku: zestaw plików konfiguracyjnych i folder plugins.
Jak przeprowadzić migrację krok po kroku?
- Zatrzymaj serwer po dobroci. Użyj
/stopalbo przycisku stop w panelu, nigdy twardego ubicia procesu. Tylko wtedy wszystkie wczytane chunki (fragmenty świata) i dane graczy zostaną w całości zapisane na dysk. - Zrób kopię zapasową całego folderu serwera. Czyli nie tylko
world, ale teżworld_nether,world_the_endi pojedyncze pliki json. W MC-Node automatyczne kopie zapasowe działają standardowo, ale tuż przed migracją zawsze zrób jeszcze ręczną: ta sprzed pięciu minut jest warta więcej niż ta z nocy. - Weź build Paper dokładnie pod swoją wersję. Jeśli grasz na 1.21 "Tricky Trials", wciąż najczęściej granej wersji na holenderskich serwerach, pobierz build 1.21 i nie przeskakuj od razu na 26.1 czy 26.2. Zmiana wersji i zmiana oprogramowania naraz niepotrzebnie utrudniają szukanie błędów.
- Podmień jar. Wgraj jar Paper i wskaż go w komendzie startowej; w panelu Pterodactyl zrobisz to w zakładce Startup. Stary jar vanilla zostaw spokojnie na miejscu, to twoja najszybsza droga powrotna.
- Sprawdź wersję Javy. Minecraft 1.21 i nowszy działa na Java 21. Środowisko, które siedzi jeszcze na Java 17, w ogóle nie uruchomi serwera.
- Uruchom serwer i śledź konsolę. Ten pierwszy start trwa dłużej niż zwykle, bo tworzone są wszystkie pliki konfiguracyjne.
- Sprawdź wszystko w samym świecie. Wejdź na serwer, wpisz
/version, żeby potwierdzić, że działasz na Paper, i obejdź najważniejsze budowle, farmy oraz portale. Potem zostaw serwer na pół godziny, zanim wpuścisz z powrotem wszystkich, żeby zobaczyć, czy TPS (liczba ticków na sekundę, czyli miara płynności serwera) trzyma się stabilnie.
Jakie pliki konfiguracyjne pojawiają się po pierwszym starcie?
Vanilla zna tylko server.properties, czyli podstawowy plik ustawień serwera. Paper dokłada do tego cztery warstwy, każdą o innym rodowodzie.
| Plik | Skąd pochodzi | Czego dotyczy |
|---|---|---|
bukkit.yml | Bukkit | Limity spawnu dla każdej kategorii mobów, częstotliwość spawnu, interwał autozapisu, sprzątanie chunków |
spigot.yml | Spigot | Entity activation range, mob-spawn-range, łączenie itemów, timingi lejków, view-distance (zasięg widzenia liczony w chunkach) |
config/paper-global.yml | Paper | Ustawienia dla całego serwera: wczytywanie chunków, sieć i logowanie, obsługa proxy |
config/paper-world-defaults.yml | Paper | Ustawienia per świat: implementacja redstone, spawn mobów liczony na gracza, dystanse despawnu, tickrate |
paper-world-defaults.yml obowiązuje jako domyślne ustawienie dla wszystkich twoich światów. Jeśli chcesz jeden świat ustawić inaczej, tworzysz paper-world.yml w folderze tego świata; to, co tam wpiszesz, wygrywa z domyślnymi wartościami. W dniu samej migracji najlepiej nie zmieniaj nic.
Które mechaniki vanilla mogą zacząć działać inaczej?
Paper wyciąga swój zysk głównie z tego, że rzadziej albo mniej dokładnie symuluje rzeczy, które i tak rzadko mają znaczenie. Na większości serwerów nikt tego nie zauważy. Jeśli jednak twój świat opiera się na dokładnym zachowaniu vanilla, zapiecze w czterech miejscach.
Redstone. Paper pozwala ci przez misc.redstone-implementation w paper-world-defaults.yml wybrać między implementacją vanilla a dwiema szybszymi alternatywami (Eigencraft i Alternate Current). Te alternatywy są tańsze obliczeniowo, ale nie w każdym skrajnym przypadku identyczne. Układy, które opierają się na dokładnej kolejności aktualizacji, jak instant repeatery, niektóre sztuczki z tłokami i konstrukcje 0-tick, mogą przez to zacinać się albo zupełnie stawać.
Spawn mobów. Paper potrafi rozdzielać mobcap, czyli limit mobów, na poszczególnych graczy zamiast liczyć go dla całego serwera. Na zatłoczonym serwerze jest to uczciwsze, ale zmienia wydajność farmy mobów. Do tego dochodzą limity spawnu w bukkit.yml i mob-spawn-range w spigot.yml.
Entity activation range. Encje, które stoją wystarczająco daleko od gracza, dostają mniej ticków, czyli pojedynczych kroków symulacji. Moby w farmie wyglądają wtedy, jakby zamarzły, wieśniacy przestają pracować, a linie transportowe zostają w tyle, gdy tylko się oddalisz. To stąd w praktyce bierze się większość zgłoszeń w stylu "moja farma się zepsuła".
Itemy i spawnery. Luźne itemy i kule doświadczenia są łączone z większej odległości niż w vanilla: miłe dla wydajności, uciążliwe dla farm, które liczą itemy sztuka po sztuce. A jeśli nerf-spawner-mobs jest włączone, moby ze spawnera nie mają już żadnego AI.
Jak przywrócić zachowanie vanilla?
Prawie wszystko sprowadza się do jednej linijki w konfiguracji. Załatwiaj po jednej rzeczy naraz, restartuj i testuj.
| Co zauważasz | Plik | Gdzie szukać |
|---|---|---|
| Redstone reaguje inaczej albo się zacina | config/paper-world-defaults.yml | misc.redstone-implementation ustawione na vanilla |
| Farma mobów daje mniejsze plony | bukkit.yml i paper-world-defaults.yml | Limity spawnu i spawn mobów liczony na gracza |
| Moby i wieśniacy stoją w miejscu, gdy się oddalisz | spigot.yml | entity-activation-range |
| Itemy zlepiają się albo znikają za szybko | spigot.yml | merge-radius i ustawienia despawnu |
| Farma na spawnerze przestała cokolwiek robić | spigot.yml | nerf-spawner-mobs |
| Lejki wyraźnie zostają w tyle | spigot.yml | Wartości hopper-transfer i hopper-check |
Każdy kawałek zachowania vanilla, który przywracasz, kosztuje cię część zysku na wydajności. Przy garstce graczy to żaden problem, na zatłoczonym serwerze survival już tak. Zmierz efekt pluginem spark, zamiast zgadywać; jakie jeszcze pokrętła masz do dyspozycji, opisujemy w artykule o optymalizacji serwera Minecraft.
Czy da się później wrócić na vanilla?
Technicznie tak, i to zwykle bezproblemowo. Zatrzymujesz serwer, wstawiasz z powrotem jar vanilla i startujesz; świat wczytuje się normalnie, bo format pozostał ten sam. Droga powrotna nie jest jednak symetryczna.
Tracisz pluginy i wszystko, co one przechowywały. Rangi w LuckPerms, homes z EssentialsX, claimy GriefPrevention i historia rollbacków z CoreProtect nadal leżą na dysku jako pliki albo baza danych, ale przestają cokolwiek robić, gdy tylko odpali vanilla. Chronione regiony po prostu nie są już chronione, a na publicznym serwerze widać to w ciągu jednego dnia. Do tego przepadają dane specyficzne dla Paper: dodatkowe informacje, które pluginy doczepiły do itemów, encji albo bloków, oraz konfiguracja z plików paper. Vanilla nie zna tych pól i ich nie zapisuje.
Jeśli używałeś plugina generującego teren, możesz dodatkowo zobaczyć widoczne szwy między starymi a nowymi chunkami. Zrób więc kopię zapasową także tuż przed krokiem wstecz.
Dlaczego warto najpierw przetestować na kopii?
Bo migracja rzadko wykłada się na samym jarze, a znacznie częściej na czymś, co zauważasz dopiero po kilku dniach: ta jedna farma żelaza, która stanęła, zegar, który nie chce się domknąć, plugin, który jednak nie dogaduje się z twoją wersją.
Najtańszy wariant to pobrać kopię folderu ze światem i postawić na niej lokalnie serwer Paper. Jeśli chcesz być bliżej prawdziwej sytuacji, razem z siecią i pluginami, stawiasz tymczasowo drugi serwer. Serwer testowy z 2 GB kosztuje w linii budżetowej, którą znajdziesz w ofercie hostingu Minecraft w MC-Node, 9,50 zł miesięcznie, czyli 4,75 zł za GB, a potem po prostu z niego rezygnujesz. Jeśli przy okazji instalujesz pluginy, zrób to również najpierw tam; które i do czego są potrzebne, znajdziesz w naszym zestawieniu najlepszych pluginów do Minecrafta.
Kiedy Paper nie jest właściwym wyborem?
Dla większości serwerów Paper to wybór domyślny, ale nie dla wszystkich. Jeśli chcesz naprawdę nowych bloków, itemów, mobów albo wymiarów, potrzebujesz modów, a nie pluginów. Pluginy działają wyłącznie po stronie serwera, na w pełni vanillowych mechanikach; mody ładuje Forge, NeoForge, Fabric albo Quilt i muszą siedzieć w tej samej wersji na serwerze i na kliencie. To zupełnie inna droga, którą tłumaczymy w artykule o modpackach.
Jeśli prowadzisz serwer techniczny, na którym farmy muszą pozostać vanillowe co do jednego ticka, uczciwiej jest zostać na vanilla niż instalować Paper i potem odkręcać połowę ustawień. Nie zerkaj też za szybko dalej, na forki. Purpur dokłada dodatkowe opcje konfiguracji i opcjonalne funkcje, jak dosiadanie mobów czy regulowane AI mobów, w pełni zgodne z pluginami Paper, ale to krok już po Paper; Pufferfish celuje gdzieś pomiędzy. A Folia, eksperymentalny wielowątkowy Paper, ma sens tylko przy bardzo dużej liczbie graczy rozproszonych po mapie i psuje większość istniejących pluginów.
Najczęściej zadawane pytania
Czy przy przejściu na Paper muszę konwertować świat? Nie. Paper używa tego samego formatu świata co serwer vanilla, więc pliki regionów, level.dat i playerdata pozostają w pełni używalne; podmieniasz tylko jar. Wcześniej zrób jednak ręczną kopię zapasową całego folderu serwera.
Czy moje maszyny redstone będą działać po przesiadce? Najczęściej tak, ale układy opierające się na dokładnej kolejności aktualizacji z vanilla mogą zachowywać się inaczej. Paper pozwala przez misc.redstone-implementation w config/paper-world-defaults.yml wybrać między implementacją vanilla a dwiema szybszymi alternatywami. Ustaw ją na vanilla, jeśli twój zegar albo farma przestały działać.
Czy mogę wrócić z Paper na vanilla? Tak, zwykle bez problemu: wstawiasz z powrotem jar i uruchamiasz serwer, a świat wczytuje się normalnie. Tracisz jednak wszystkie pluginy i ich funkcje, więc rangi LuckPerms, homes z EssentialsX, claimy GriefPrevention i historia rollbacków z CoreProtect przestają cokolwiek robić. Dane specyficzne dla Paper, które pluginy doczepiły do itemów albo encji, już nie wrócą.
Którą wersję Minecrafta wybrać przy migracji? Tę samą, na której działasz teraz. 1.21 "Tricky Trials" z Trial Chambers, Vaults i Mace wciąż jest najczęściej graną wersją na holenderskich serwerach; potem pojawiły się 26.1 "Tiny Takeover" i 26.2 "Chaos Cubed", a 26.3 siedzi jeszcze w snapshotach. Przeskakuj dalej dopiero wtedy, gdy Paper działa stabilnie.
Czy Paper potrzebuje więcej RAM-u niż vanilla? Nie, serwer Paper z pluginami nie wymaga więcej pamięci niż ten sam świat na vanilla. Naprawdę ciężko robi się dopiero przy modpackach: All the Mods 10 wymaga minimum 10 GB, 12 GB dla małej grupy i 14 do 16 GB przy pięciu lub więcej graczach.