Better Ping Display [Fabric] — Minecraft Java Edition 1.15.2 - 1.21.11+

Standardowy interfejs Minecrafta wyświetla opóźnienie połączenia graczy w menu listy graczy (klawisz TAB) w postaci graficznej ikony złożonej z pięciu pionowych słupków. Takie podejście nie dostarcza dokładnych informacji o stabilności połączenia, ponieważ ta sama ikona może odpowiadać opóźnieniu zarówno 80 milisekund, jak i 140 milisekund. W rozgrywce rywalizacyjnej, walkach PvP czy podczas administrowania dużymi serwerami gry dokładne wartości pingu mają kluczowe znaczenie. Modyfikacja Better Ping Display [Fabric] rozwiązuje ten problem, zastępując abstrakcyjne graficzne słupki dokładną liczbową wartością opóźnienia w milisekundach bezpośrednio w menu listy graczy.

Techniczna zasada działania i ograniczenia standardowego renderowania opóźnienia

Aby przekazać informacje o pingu, serwer Minecraft wysyła pakiety aktualizacji listy graczy (we współczesnych wersjach gry odpowiada za to pakiet ClientboundPlayerInfoUpdatePacket). Każdy wpis w pakiecie zawiera całkowitoliczbowy parametr opóźnienia (latency) wyrażony w milisekundach. Część kliencka gry odbiera te dane i przechowuje je w pamięci jako właściwość obiektu PlayerInfo (we wcześniejszych wersjach znanego jako NetworkPlayerInfo).

Podczas renderowania listy graczy na ekranie waniliowa klasa interfejsu PlayerListHud (lub PlayerTabOverlay w mapowaniach Yarn) przechodzi przez wszystkich podłączonych użytkowników i ustala poziom opóźnienia. Za wyświetlanie ikony odpowiada wewnętrzna metoda renderLatencyIcon (lub renderPingIcon). Metoda ta porównuje liczbę całkowitą milisekund ze stałymi progami:

·        Wartość mniejsza od 0 wyświetla ikonę braku połączenia (czerwony krzyżyk).

·        Wartość mniejsza niż 150 milisekund odpowiada maksymalnym pięciu słupkom.

·        Zakres od 150 do 299 milisekund wyświetla cztery słupki.

·        Zakres od 300 do 599 milisekund pokazuje trzy słupki.

·        Zakres od 600 do 999 milisekund wyświetla dwa słupki.

·        Opóźnienie od 1000 milisekund wyświetla jeden słupek.

W ten sposób dokładne wartości liczbowe są odrzucane tuż przed wyświetleniem na ekranie, a zamiast nich rysowany jest odpowiedni sprite z pliku tekstur icons.png.

Better Ping Display wprowadza zmiany w tym procesie za pomocą systemu Mixin. Klasa iniekcji modyfikuje zachowanie PlayerListHud w momencie rysowania wiersza każdego gracza. Modyfikacja przechwytuje wywołanie rysowania graficznych słupków i blokuje jego wykonanie (lub wykonuje je równolegle w zależności od konfiguracji). Zamiast tego wykonywane jest wywołanie pobrania dokładnej wartości latency poprzez obiekt PlayerInfo. Następnie mod przekazuje tę liczbę do renderera tekstu klienta Font, który dynamicznie rysuje znaki na ekranie z uwzględnieniem skonfigurowanego stylu i rozmieszczenia elementów interfejsu.

Główne funkcje: wyświetlanie cyfrowe, skala kolorów i graficzne słupki

Mod rozszerza informacyjność interfejsu statystyk sieciowych dzięki następującym możliwościom funkcjonalnym:

·        Wskaźnik liczbowy w czasie rzeczywistym: Wyświetla dokładną wartość opóźnienia w milisekundach. Gracz widzi rzeczywisty stan połączenia każdego uczestnika bez konieczności najeżdżania kursorem czy wpisywania poleceń diagnostycznych na czacie.

·        Automatyczne oznaczanie kolorem: Modyfikacja domyślnie koloruje tekst pingu w zależności od jakości połączenia. Niskie opóźnienie (mniej niż 100 milisekund) jest podświetlane na zielono, średnie (od 100 do 299 milisekund) przybiera barwę żółtą lub pomarańczową, a wysokie opóźnienie (od 300 milisekund i więcej) jest oznaczane na czerwono. Pomaga to natychmiast wykryć graczy z niestabilnym połączeniem.

·        Tryb łączonego wyświetlania: Użytkownik może włączyć jednoczesne wyświetlanie wartości liczbowych i oryginalnych waniliowych słupków pingu. W takim przypadku tekst jest rysowany na lewo od graficznej ikony, zachowując znajomy styl wizualny Minecrafta.

·        Architektura kliencka: Modyfikacja działa wyłącznie po stronie klienta. Nie wymaga instalacji na serwerze i nie wysyła do serwera dodatkowych zapytań. Mod odczytuje jedynie te informacje o ruchu, które serwer Minecraft domyślnie przekazuje wszystkim podłączonym klientom. Dzięki temu Better Ping Display działa na dowolnych serwerach, w tym na oficjalnych serwerach Realms oraz publicznych serwerach bez obsługi modyfikacji.

Ustawienia, kompatybilność i ekosystem

Konfigurowanie parametrów wyświetlania odbywa się poprzez edycję pliku betterpingdisplay.json, który jest automatycznie tworzony w katalogu config po pierwszym uruchomieniu gry. Plik zawiera następujące ustawienia:

·        autoColorPingText – flaga logiczna (true/false). W przypadku wartości true kolor pingu zmienia się automatycznie od zielonego do czerwonego w zależności od szybkości połączenia. Jeśli podano false, kolor staje się statyczny i jest określany przez następny parametr.

·        pingTextColor – pole tekstowe do ustawienia szesnastkowego kodu koloru (na przykład #A0A0A0 dla jasnoszarego). Ten kolor jest używany tylko wtedy, gdy automatyczne oznaczanie kolorem jest wyłączone.

·        renderPingBars – flaga logiczna sterująca renderowaniem standardowych waniliowych słupków opóźnienia obok wskaźnika liczbowego.

·        pingTextFormatString – ciąg formatowania tekstu. Domyślnie ustawiona jest wartość %dms, gdzie znak %d jest obowiązkowym znacznikiem technicznym, który podczas renderowania jest zastępowany aktualną liczbą milisekund opóźnienia.

W wersji moda 1.2.0 i nowszych pojawiła się obsługa graficznego interfejsu ustawień bezpośrednio w menu gry. Aby uzyskać dostęp do wizualnego menu konfiguracji na liście modyfikacji, należy zainstalować dwa dodatkowe komponenty pomocnicze: bibliotekę YetAnotherConfigLib (YACL) oraz mod Mod Menu. Gdy są obecne, w grze pojawia się wygodne okno z przełącznikami i suwakami do zmiany parametrów Better Ping Display.

Modyfikacja jest kompatybilna z większością optymalizatorów klienta (takich jak Sodium, Lithium, FerriteCore) oraz ulepszeń graficznych (Iris Shaders). Nie powoduje konfliktów podczas gry na serwerach z niestandardowymi pluginami do list graczy, ponieważ zmienia jedynie etap lokalnego renderowania na kliencie, nie wpływając na strukturę pakietów sieciowych.

Podsumowanie

Better Ping Display [Fabric] to kompaktowa i skuteczna modyfikacja kliencka, która naprawia istotną wadę standardowej listy graczy Minecrafta. W odróżnieniu od podobnych rozwiązań w rodzaju Numeral Ping czy Ping Display ten mod ma prostą integrację z biblioteką YACL do dostosowywania parametrów bezpośrednio w grze i pozwala zachować waniliowe ikony opóźnienia. Głównym ograniczeniem jest zależność częstotliwości aktualizacji liczb od ustawień samego serwera (domyślnie serwer Minecraft wysyła aktualizacje statystyk pingu raz na kilka sekund, więc chwilowe wahania opóźnienia nie będą wyświetlane natychmiast). Mod idealnie nadaje się dla graczy trybów sieciowych oraz administratorów serwerów, którzy potrzebują wyraźnej kontroli parametrów sieciowych bez zbędnego obciążania systemu.