Wydajność serwera Minecraft: lagi, parametry, zasięg widzenia, Chunky i spark

Serwer, który „laguje”, zwykle nie cierpi na brak sprzętu. Częściej ma jedną konkretną przyczynę: za duży zasięg symulacji, generowanie nowego terenu, przepełnioną farmę albo źle napisany plugin. Pokażemy, jak zmierzyć lagi, znaleźć ich przyczynę i ją usunąć – od szybkich poprawek po ustawienia Papera i profilowanie.

Jak rozpoznać, co laguje#

Serwer Minecraft prowadzi grę w tickach. Powinien przejść ich 20 na sekundę, co daje mu 50 milisekund na tick. Dwie liczby, które musisz znać:

MSPT to dokładniejszy wskaźnik: serwer z MSPT 45 ms ma jeszcze 20 TPS, ale żadnego zapasu. Gdy MSPT przekroczy 50 ms, TPS zaczyna spadać.

Wartości sprawdzisz w Konsoli (polecenia wpisuj bez ukośnika):

tps
mspt
spark tps

• tps – średnie TPS z ostatnich 1, 5 i 15 minut (Paper, Purpur).
• mspt – średni, najkrótszy i najdłuższy czas ticka (Paper, Purpur).
• spark tps – TPS, MSPT (minimum, mediana, 95. percentyl, maksimum) i obciążenie procesora. Działa wszędzie, gdzie jest zainstalowany spark (Paper ma go wbudowanego).

Gdy serwer dłużej nie nadąża, konsola pokazuje:

Can't keep up! Is the server overloaded? Running 2500ms or 50 ticks behind

Serwer mówi, że ma 2,5 sekundy (50 ticków) opóźnienia i te ticki pominie. Pojedynczy komunikat przy starcie albo podczas generowania terenu jest w porządku. Jeśli powtarza się co kilka minut, czytaj dalej.

Lag serwera czy coś innego?#

Szybkie wygrane#

Posortowane od największego efektu do najmniejszego. Większość zrobisz w mniej niż dziesięć minut.

Parametry startowe i pamięć#

Parametry (flagi) to argumenty, z którymi uruchamia się Java. Ustawiają rozmiar pamięci dla gry (sterty), limity pamięci poza stertą i zachowanie garbage collectora, który czyści z pamięci niepotrzebne dane. W strefie klienta znajdziesz je w zakładce Uruchamianie, w sekcji Parametry startowe.

Strefa klienta sama oblicza stertę i limity według rozmiaru pakietu, typu serwera, wersji Javy i liczby pluginów lub modów. Przelicza je przy tworzeniu serwera, po zmianie pakietu, po zmianie typu lub wersji oraz przed startem ze strefy klienta, jeśli od ostatniego razu coś z tego się zmieniło. Nie nadpisuje polecenia startowego, które ręcznie edytowałeś w panelu albo ustawiłeś jako własne. Jeśli takie polecenie ma stertę większą, niż zniesie mniejszy pakiet, po zmianie pakietu serwera nie uruchomimy (od razu by padł) i wyślemy Ci e-mail.

Wszystkie presety mają te same zabezpieczenia: limity buforów sieciowych, skompilowanego kodu i wczytanych klas, MALLOC_ARENA_MAX=2 (mniej aren pamięci alokatora) i od Javy 17 -XX:TrimNativeHeapInterval (oddaje nieużywaną pamięć systemowi). Purpur dostaje dodatkowo automatycznie --add-modules=jdk.incubator.vector (szybsze obliczenia, z których Purpur może korzystać).

Przyciski w tej sekcji:

• Zapisz – ustawienia zostaną użyte przy następnym starcie.
• Zapisz i uruchom ponownie – serwer uruchomi się ponownie od razu. Jeśli z nowymi parametrami nie wystartuje, strefa klienta je cofnie i zobaczysz komunikat Parametry nie są zgodne, przywrócono poprzednie ustawienia.
• Przywróć poprzednie – przywraca ostatnie działające ustawienia.
• Użyj zalecanych – pojawia się, gdy sterta jest za duża na Twój pakiet albo polecenie startowe nie ma limitów pamięci. Ustawia zalecane polecenie.
• Przelicz teraz – przelicza parametry od razu, abyś nie musiał czekać na następny start ze strefy klienta.

W części Podział pamięci widzisz, ile idzie na stertę, a ile zostaje na całą resztę. Po automatycznym przeliczeniu strefa klienta pokaże na przykład Polecenie startowe dostosowaliśmy do nowego rozmiaru RAM: sterta 8,2 → 9,6 GB.

Prowadzisz serwer poza StormHost? Generator skryptu startowego utworzy skrypt startowy z tym samym obliczeniem dla Dockera, Linuksa i Windowsa.

Dlaczego sterta to nie cała RAM#

Sterta (-Xmx) nigdy nie urośnie ponad swój limit. Rośnie pamięć poza stertą: bufory sieciowe, wczytane klasy pluginów i modów, skompilowany kod, wątki i systemowy alokator. Najbardziej rosną bufory sieciowe – bez limitu mogą osiągnąć rozmiar sterty, więc serwer ze stertą 6 GB może skończyć na 12 GB.

Kontener serwera ma twardy limit o 5 % wyższy niż pakiet (przy pakietach do 4 GB o 10 %, do 2 GB o 15 %) i nie ma swapu. Gdy proces przekroczy limit, system go zabije. Konsola pokaże Out of memory: true, a w logu serwera nie ma żadnego błędu.

Dlatego każda duża część poza stertą ma limit, wszystko razem z zapasem mieści się poniżej rozmiaru pakietu, a sterta dostaje resztę. Gdy któraś część osiągnie swój limit, serwer zapisze do logu błąd (OutOfMemoryError: Direct buffer memory lub Metaspace) zamiast cicho paść, a ten błąd wskaże winowajcę.

Sterta ma ten sam rozmiar minimalny i maksymalny (-Xms = -Xmx) i jest przydzielana od razu przy starcie. Dlatego wykres pamięci w panelu pokazuje wysoką liczbę od początku. Panel wlicza też pamięć podręczną plików świata, którą system w razie potrzeby zwalnia. Liczba bliska limitowi sama w sobie nie oznacza awarii.

Dokumentacja Papera zaleca co najmniej 6–⁠10 GB sterty niezależnie od liczby graczy i ostrzega, że od pewnego momentu więcej pamięci nie poprawia wydajności.

Zasięg widzenia i symulacji#

Świat jest podzielony na chunki (kolumny 16 × 16 bloków). Serwer trzyma wczytane chunki w określonym promieniu wokół każdego gracza:

• view-distance – ile chunków wokół gracza serwer wysyła do gry (co gracz widzi). Wpływa głównie na pamięć i sieć.
• simulation-distance – promień, w którym chunki „żyją”: moby się poruszają, uprawy rosną, redstone i farmy działają. Wpływa głównie na procesor, a więc na TPS.

Liczba chunków rośnie z kwadratem odległości. Przy view-distance=10 serwer trzyma wokół każdego gracza 441 chunków, przy 8 tylko 289 (o jedną trzecią mniej). Przy symulacji efekt jest taki sam.

Ustawisz je w zakładce Ustawienia serwera w grupie Świat (wszystkie ustawienia). Zasięgu symulacji poniżej 5 nie zalecamy – większe farmy przestają wtedy działać, bo część farmy jest poza symulowanym obszarem.

Ustawienia Papera#

Paper i Purpur mają własną konfigurację w folderze config:

Zawsze edytuj paper-world-defaults.yml. Otwórz plik w edytorze w zakładce Pliki, znajdź istniejącą sekcję (na przykład chunks:) i zmień wartość w niej. Nie dodawaj tej samej sekcji drugi raz – przy zduplikowanym kluczu serwer albo odmówi wczytania pliku, albo użyje tylko jednego z nich, a Twoja zmiana nie zadziała.

Wybrane ustawienia o największym wpływie na wydajność:

Tak wyglądają zmiany w pliku (tylko zmienione części; pozostałe linie pliku zostaw bez zmian):

chunks:
  entity-per-chunk-save-limit:
    arrow: 16
    experience_orb: 16
    snowball: 8
    ender_pearl: 8
  prevent-moving-into-unloaded-chunks: true
collisions:
  max-entity-collisions: 2
entities:
  spawning:
    despawn-ranges:
      monster:
        hard: 72
        soft: 30
environment:
  optimize-explosions: true
misc:
  redstone-implementation: ALTERNATE_CURRENT
tick-rates:
  grass-spread: 4
  mob-spawner: 2

spigot.yml i bukkit.yml#

Paper czyta też starsze pliki konfiguracyjne spigot.yml i bukkit.yml w głównym folderze serwera.

spigot.yml#

Wszystkie ustawienia są w sekcji world-settings › default.

bukkit.yml#

Pregenerowanie świata Chunky#

Gdy gracz dotrze tam, gdzie jeszcze nikt nie był, serwer musi wygenerować teren. To najbardziej wymagająca operacja ze wszystkich: jeden gracz na elytrze potrafi obniżyć TPS całego serwera. Rozwiązaniem jest wygenerować teren z wyprzedzeniem i ustawić granicę świata, aby gracze nie mogli wyjść poza przygotowany obszar.

Plugin Chunky generuje teren w tle, stopniowo, i można go wstrzymać. Istnieje dla Papera, Purpura i Folii, a jako mod dla Fabric, Forge i NeoForge.

1. Zainstaluj Chunky w zakładce Pluginy (dla modów Mody) › Przeglądaj: wyszukaj Chunky i kliknij Zainstaluj. Potem uruchom serwer ponownie (poradnik o pluginach).

2. W Konsoli ustaw środek granicy świata:

   worldborder center 0 0

   • worldborder center – ustawia środek granicy świata.
   • 0 0 – współrzędne X i Z środka. Zwykle środek świata albo współrzędne spawnu.

3. Ustaw rozmiar granicy:

   worldborder set 10000

   • worldborder set – ustawia rozmiar granicy.
   • 10000 – średnica w blokach. Świat będzie miał 10 000 × 10 000 bloków, czyli 5000 bloków od środka w każdym kierunku.

4. Przekaż granicę do Chunky:

   chunky worldborder

   Chunky ustawi sobie środek i promień według granicy świata.

5. Uruchom generowanie:

   chunky start

   Konsola regularnie pokazuje postęp w procentach, liczbę wygenerowanych chunków i szacowany pozostały czas.

Inne polecenia:

Nether i End#

Nether jest osiem razy mniejszy niż Overworld (1 blok w Netherze = 8 bloków w Overworldzie). Dla granicy o średnicy 10 000 bloków w Overworldzie (promień 5000) w Netherze wystarczy promień 625 bloków. Połącz się z grą, przejdź do Netheru i wpisz na czacie:

/chunky world
/chunky center 0 0
/chunky radius 625
/chunky start

• /chunky world – bez nazwy wybiera świat, w którym właśnie jesteś (Nether).
• /chunky center 0 0 – środek generowania.
• /chunky radius 625 – promień w blokach.
• /chunky start – uruchamia generowanie.

Granicę świata w Netherze (/worldborder set 1250 wpisane w Netherze) ustawiaj tylko na Paperze i Purpurze, a od wersji 1.21.9 także gdzie indziej – dopiero od tej wersji każdy wymiar ma własną granicę. W starszych wersjach Vanilli, Fabric i NeoForge polecenie zmieniłoby granicę także w Overworldzie.

End możesz wygenerować mniejszy (na przykład promień 2000–⁠3000 bloków); gracze poruszają się tam głównie po wyspach.

Po restarcie serwera generowanie samo się nie wznowi. Kontynuuj poleceniem chunky continue (albo ustaw continue-on-restart: true w plugins/Chunky/config.yml).

Diagnostyka sparkiem#

spark to profiler: podczas działania serwera zapisuje, co serwer robi, i pokazuje wynik jako przejrzyste drzewo z procentami. Paper ma go wbudowanego od wersji 1.21 (Purpur też); na Fabricu i NeoForge zainstaluj mod spark z Modrinth. Na proxy Velocity polecenie to sparkv.

Szybki przegląd#

Profilowanie krok po kroku#

1. Poczekaj, aż serwer zacznie lagować (albo aż będzie miał zwykłą liczbę graczy). Profil pustego serwera nic nie pokaże.

2. W Konsoli uruchom profiler na 10 minut:

   spark profiler start --timeout 600

   • spark profiler start – uruchamia profiler.
   • --timeout 600 – automatycznie go zatrzyma po 600 sekundach (10 minutach) i prześle wynik.

3. Poczekaj 10 minut. W konsoli pojawi się link do profilu (spark.lucko.me/…).

4. Wklej link do Analizatora profili spark. Pokaże, co spowalnia serwer i co zmienić.

Profilu nie musisz przesyłać: z opcją --save-to-file (na przykład spark profiler start --timeout 600 --save-to-file) spark zapisze go jako plik .sparkprofile w folderze plugins/spark (na Fabricu i NeoForge config/spark). Pobierz go w zakładce Pliki i wgraj do analizatora.

Aby zatrzymać profiler wcześniej, wpisz spark profiler stop. Przy krótkich skokach (serwer od czasu do czasu na sekundę „zamarza”) użyj:

spark profiler start --only-ticks-over 100

• --only-ticks-over 100 – zapisuje tylko ticki dłuższe niż 100 ms. Odfiltrowuje zwykłe działanie i zostawia tylko „lagujące” ticki. Wybierz wartość między 50 a 100.

Jak czytać wynik#

Jeśli chcesz przejrzeć drzewo sam, otwórz link do profilu w przeglądarce:

1. Na liście wątków rozwiń Server thread – główny wątek gry. Problemy w innych wątkach (wczytywanie chunków, sieć) są rzadsze.
2. Klikając, rozwijaj węzły i obserwuj procenty. Zawsze idź ścieżką z największym udziałem.
3. Czas spędzony w Thread.sleep() lub w stanie „parked” jest w porządku – serwer czeka na kolejny tick, bo ma zapas.
4. Typowe znaleziska:

5. W górnym pasku przełącz widok na Sources – pokazuje osobne drzewo dla każdego pluginu lub moda, więc od razu widzisz, który obciąża najbardziej.

Link do profilu możesz wysłać autorowi pluginu albo naszej pomocy technicznej. Nie zawiera haseł ani plików serwera.

Ile bytów jest na serwerze#

Na Paperze polecenie paper entity list wypisuje liczby bytów według typu. W konsoli trzeba podać też świat:

paper entity list * minecraft:overworld
paper entity list minecraft:villager minecraft:overworld

• paper entity list – wypisuje byty.
• * – bez filtra; wypisze wszystkie typy bytów z liczbami (pierwsza liczba to byty tickujące, druga nietickujące).
• minecraft:villager – filtr na jeden typ. Wynik pokaże wtedy współrzędne chunków z największą liczbą tych bytów.
• minecraft:overworld – świat (minecraft:the_nether, minecraft:the_end dla pozostałych wymiarów). W grze świata nie musisz podawać; użyty zostanie ten, w którym stoisz.

Potem idź w grze w to miejsce i zmniejsz farmę lub zagrodę.

Mody na wydajność (Fabric i NeoForge)#

Fabric i NeoForge nie mają optymalizacji Papera, ale istnieją mody serwerowe o tym samym celu. Wszystkie znajdziesz na Modrinth (w zakładce Mody › Przeglądaj):

Zawsze wybieraj mod dla swojej dokładnej wersji Minecrafta i loadera. Szczegóły w artykule Mody i modpacki.

Kiedy czas na upgrade#

Upgrade pakietu ma sens, gdy:

• spark pokazuje, że obciążenie jest rozłożone równomiernie (nie dominuje jeden plugin ani farma), a MSPT przy zwykłej liczbie graczy utrzymuje się powyżej 40 ms,
• spark health pokazuje pamięć stale na limicie, a garbage collector nie nadąża,
• dodajesz duży modpack albo planujesz dużo więcej graczy.

Jeśli większość czasu zabiera jeden plugin lub farma, więcej wydajności tego nie naprawi – trzeba usunąć przyczynę.

Sprawdzenie, czy działa#

1. Po zmianach uruchom serwer ponownie i pozwól mu działać z graczami co najmniej 15 minut.
2. Wpisz spark tps. MSPT (mediana) powinno być poniżej 50 ms, najlepiej poniżej 35 ms, a TPS 20.
3. Komunikat Can't keep up! nie powinien się już powtarzać.
4. Jeśli nie masz pewności, uruchom kolejny 10-⁠minutowy profil i porównaj go z poprzednim.

Rozwiązywanie problemów#

Serwer nie startuje po zmianie konfiguracji#

Najczęściej to błąd YAML (tabulator, złe wcięcie, zduplikowana sekcja). Poszukaj w konsoli linii z nazwą pliku i numerem linii. Popraw ją albo usuń plik – Paper przy starcie utworzy go ponownie z wartościami domyślnymi (Twoje zmiany przepadną). Ewentualnie przywróć kopię zapasową.

Parametry nie są zgodne, przywrócono poprzednie ustawienia.#

Serwer nie wystartował z nowymi parametrami i strefa klienta je cofnęła. Sprawdź własne parametry (literówka, parametr dla innej wersji Javy) i spróbuj presetu bez własnych parametrów.

Serwer nagle się wyłącza bez błędu w logu#

Typowy objaw przekroczenia limitu pamięci. Konsola pokazuje linie Exit code: 137 i Out of memory: true, a strefa klienta pokazuje nad konsolą Serwerowi zabrakło pamięci i system go zakończył. Panel uruchomi serwer jeszcze raz; jeśli w ciągu minuty znów padnie, zostawi go wyłączonego.

1. W zakładce Uruchamianie sprawdź ostrzeżenia przy parametrach startowych. Jeśli sterta jest za duża na Twój pakiet albo polecenie nie ma limitów pamięci, kliknij Użyj zalecanych.
2. Strefa klienta nie nadpisuje polecenia startowego, które edytowałeś ręcznie albo ustawiłeś jako własne. Użyj zalecanego presetu albo ustaw stertę według tabeli w sekcji Dlaczego sterta to nie cała RAM.
3. Poszukaj w logu OutOfMemoryError: Direct buffer memory lub OutOfMemoryError: Metaspace. Wskazują na plugin lub mod, który zapełnia bufory sieciowe albo wciąż na nowo wczytuje klasy.
4. Jeśli awarie trwają nawet przy zalecanych ustawieniach, szukaj wycieku pamięci: spark heapsummary pokaże, co zajmuje stertę, a spark profiler start --alloc --timeout 300, co przydziela najwięcej pamięci. Link wklej do Analizatora profili spark albo wyślij naszej pomocy technicznej.

java.lang.OutOfMemoryError: Java heap space#

Sterta jest pełna. Albo na serwerze jest więcej, niż mieści się w pamięci (modpack, duża liczba graczy), albo plugin lub mod „gubi” pamięć (wyciek pamięci). Pomoże upgrade albo znalezienie wycieku poleceniem spark heapsummary. Więcej błędów znajdziesz w artykule Najczęstsze błędy serwera Minecraft.

Chunky zgłasza nieprawidłowy świat#

Nazwa świata nie istnieje. W grze użyj /chunky world bez nazwy (wybierze świat, w którym stoisz), a w konsoli podaj nazwę głównego świata z level-name (domyślnie world).

Po włączeniu ALTERNATE_CURRENT nie działa budowla z redstone'em#

Niektóre układy polegają na kolejności aktualizacji z Vanilli. Ustaw misc.redstone-implementation z powrotem na VANILLA i uruchom serwer ponownie.

Dalsza lektura#

• Profilowanie w dokumentacji Papera (otwiera się w nowym oknie)
• Konfiguracja świata w Paperze (otwiera się w nowym oknie)
• Konfiguracja spigot.yml (otwiera się w nowym oknie)
• Konfiguracja bukkit.yml (otwiera się w nowym oknie)
• Flagi Aikara w dokumentacji Papera (otwiera się w nowym oknie)
• Polecenia spark (otwiera się w nowym oknie)
• Polecenia Chunky (otwiera się w nowym oknie)