Jak używać Spark do diagnozy lagów w Minecraft?

Spark to profiler, który pomaga znaleźć przyczynę lagów na serwerze Minecraft Java. Zamiast zgadywać, czy problem powoduje plugin, generowanie chunków, encje albo garbage collector, możesz zebrać raport z pracy serwera i sprawdzić, które zadania zajmują najwięcej czasu.

Narzędzie jest szczególnie przydatne na serwerach Paper. Od wersji 1.21 Paper zawiera Spark, więc w wielu przypadkach nie trzeba instalować osobnego pluginu. Jeżeli dopiero konfigurujesz serwer, sprawdź hosting Minecraft Java Vorlantix oraz dostęp do konsoli i plików w panelu klienta.

Co można sprawdzić za pomocą Spark?

Spark zbiera informacje o czasie wykonywania zadań i pozwala przeanalizować między innymi:

• które pluginy zużywają najwięcej czasu procesora,
• czy problem występuje w głównym wątku serwera,
• jak długo trwają ticki i kiedy pojawiają się skoki MSPT,
• czy obciążenie wynika z generowania lub ładowania chunków,
• jak często działa garbage collector i ile pamięci jest używane,
• czy problem występuje stale, czy tylko podczas określonej aktywności.

Profiler nie naprawia konfiguracji automatycznie. Jego zadaniem jest dostarczenie danych, na podstawie których możesz zmienić ustawienia, wyłączyć wadliwy plugin albo ograniczyć obciążający mechanizm.

Przygotowanie do diagnozy

Profilowanie ma sens tylko wtedy, gdy problem rzeczywiście występuje. Jeśli gracze zgłaszają lagi przy eksploracji, uruchom raport podczas generowania nowych terenów. Jeśli spadki TPS pojawiają się w pobliżu farmy, rozpocznij pomiar przed wejściem w ten obszar.

Przed zmianami wykonaj kopię zapasową świata, konfiguracji i pluginów. Zapisz również:

• wersję Minecraft i Paper,
• liczbę graczy w czasie problemu,
• miejsce występowania lagów,
• wyniki komend /tps i /mspt,
• godzinę rozpoczęcia i zakończenia pomiaru.

Takie informacje ułatwiają porównanie raportów przed i po optymalizacji. W poradniku Jak sprawdzić TPS i MSPT serwera Minecraft? znajdziesz dodatkowe wyjaśnienia dotyczące interpretacji tych wskaźników.

Czy trzeba instalować Spark?

Na współczesnym Paper Spark jest dostępny w pakiecie serwera. Sprawdź jego obecność, wpisując w konsoli:

spark

W grze operator może użyć:

/spark help

Jeśli komenda nie działa, sprawdź log startowy oraz wersję silnika. Możesz też zainstalować samodzielny plugin Spark, pobrany z zaufanego źródła, do katalogu plugins. Nie używaj jednocześnie przypadkowych kopii i nie zostawiaj kilku wersji tego samego narzędzia bez sprawdzenia dokumentacji.

Jeżeli Paper ma korzystać z osobnego pluginu Spark zamiast wersji wbudowanej, może być wymagane ustawienie właściwości paper.preferSparkPlugin. Zmieniaj to tylko wtedy, gdy potrzebujesz funkcji nowszej wersji i wiesz, jak uruchamiany jest serwer.

Jak uruchomić podstawowy profiler?

Najczęściej używana komenda tworzy profil przez dziesięć minut:

/spark profiler start --timeout 600

Jeśli wykonujesz ją w konsoli, zwykle wpisujesz polecenie bez początkowego ukośnika:

spark profiler start --timeout 600

Podczas profilowania odtwórz sytuację, która powoduje lagi. Nie restartuj serwera i nie zatrzymuj profilera przed zakończeniem, chyba że raport jest już wystarczający. Po upływie czasu Spark zwróci adres raportu. Zapisz go i nie zmieniaj konfiguracji przed przeanalizowaniem wyników.

Profilowanie tylko długich ticków

Jeżeli problemem są krótkie, ale wyraźne przycięcia, skup profilowanie na tickach przekraczających wybrany próg. Przykład dla ticków dłuższych niż 100 ms:

/spark profiler start --only-ticks-over 100 --timeout 300

Profil będzie działał przez pięć minut i spróbuje wskazać momenty, w których tick trwał dłużej niż 100 ms. Dobierz czas do sytuacji. Krótki raport jest wystarczający, jeśli problem występuje często, ale przy rzadkich lagach może być potrzebny dłuższy pomiar.

Jak czytać raport Spark?

Raport przedstawia strukturę wykonywanych zadań. Zacznij od najwyższych poziomów i sprawdź, gdzie serwer spędza najwięcej czasu. Nie traktuj pojedynczej nazwy metody jako dowodu winy — plugin może pojawiać się w raporcie dlatego, że wywołuje operacje świata wykonywane dalej przez silnik.

Plugin zajmuje dużo czasu

Jeżeli raport regularnie pokazuje ten sam plugin, porównaj wynik z jego konfiguracją i dokumentacją. Sprawdź, czy nie wykonuje zadań zbyt często, nie skanuje dużego obszaru świata albo nie zapisuje danych w głównym wątku. Zaktualizuj plugin dopiero po wykonaniu kopii i sprawdzeniu zgodności wersji.

Najwięcej czasu zajmują chunki

Może to oznaczać generowanie nowych terenów, ładowanie odległych obszarów albo zbyt dużą wartość view-distance lub simulation-distance. W takim przypadku rozważ pregenerowanie mapy, ograniczenie granicy świata i obniżenie odległości aktywnej symulacji.

Dużo czasu zajmują encje

Sprawdź farmy, villagerów, zwierzęta, przedmioty leżące na ziemi, minecarty i mechanizmy redstone. Usuń lub ogranicz obciążające elementy dopiero po potwierdzeniu problemu. Raport Spark powinien pomóc wskazać obszar, ale decyzję dotyczącą świata podejmuj z kopią zapasową.

Widoczne są zadania garbage collectora

Dłuższe pauzy garbage collectora mogą wskazywać na presję pamięci, dużą liczbę obiektów albo nieoptymalne ustawienia uruchamiania Java. Nie kopiuj przypadkowych flag JVM z internetu. Sprawdź zużycie RAM w panelu oraz logi i dopiero wtedy oceń, czy potrzebny jest większy plan lub zmiana konfiguracji.

Raport a problem sieciowy

Spark analizuje pracę serwera, ale nie mierzy jakości domowego Wi-Fi gracza. Jeśli raport pokazuje prawidłowe ticki, a problem dotyczy jednej osoby, przyczyną może być ping, utrata pakietów, trasa operatora albo komputer gracza. Jeżeli wszyscy gracze widzą opóźnienia i jednocześnie rośnie MSPT, bardziej prawdopodobne jest przeciążenie serwera.

Wynik profilu porównaj z czasem zgłoszenia problemu. Raport wykonany po ustąpieniu lagów może wyglądać prawidłowo, mimo że wcześniej serwer był przeciążony.

Jak bezpiecznie działać po diagnozie?

1. Zapisz link do raportu oraz wynik TPS/MSPT.
2. Wybierz jedną prawdopodobną przyczynę.
3. Wykonaj kopię odpowiednich plików.
4. Zmień jedno ustawienie albo zaktualizuj jeden plugin.
5. Zrestartuj serwer i ponownie odtwórz problem.
6. Porównaj nowy pomiar z poprzednim.

Nie zmieniaj jednocześnie konfiguracji Paper, kilku pluginów, RAM i odległości renderowania. Jeśli wydajność się poprawi, nie będziesz wiedzieć, która zmiana pomogła. Z kolei jeśli pojawi się nowy błąd, trudniej będzie go cofnąć.

Szerszy plan działań znajdziesz w artykule Optymalizacja serwera Minecraft – TPS, lagi, RAM i CPU. Gdy będziesz analizować konfigurację konkretnego silnika, przydatny będzie także przyszły poradnik Jak zoptymalizować Paper?.

Najczęstsze błędy

Profilowanie przy pustym serwerze

Raport wykonany bez graczy i bez aktywności świata może nie pokazać przyczyny problemu. Uruchom profil w czasie rzeczywistego obciążenia, ale poinformuj graczy, że trwa diagnostyka.

Wybór tylko jednego najdłuższego wpisu

Najdłuższy wpis nie zawsze oznacza wadliwy plugin. Sprawdź hierarchię zadań, częstotliwość wywołań i kontekst. Plugin może jedynie uruchamiać funkcję, która wykonuje kosztowną operację świata.

Udostępnianie raportu bez sprawdzenia

Raport może zawierać nazwy pluginów, wersję serwera i dane techniczne instancji. Przed udostępnieniem go publicznie sprawdź zawartość i przekazuj go tylko zaufanym osobom lub oficjalnym kanałom wsparcia.

Podsumowanie

Spark pomaga przejść od zgadywania do konkretnej diagnozy. Uruchom profiler wtedy, gdy występują lagi, odtwórz problem, przeanalizuj ticki i sprawdź pluginy, chunki, encje oraz pamięć. Następnie wprowadź jedną zmianę, wykonaj restart i porównaj wyniki. Połączenie raportu Spark z pomiarami TPS/MSPT daje znacznie pewniejszą podstawę do optymalizacji serwera Minecraft.