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

Standardní rozhraní Minecraftu zobrazuje zpoždění připojení hráčů v menu seznamu hráčů (klávesa TAB) v podobě grafické ikony složené z pěti svislých sloupců. Tento přístup neposkytuje přesné informace o stabilitě připojení, protože stejná ikona může odpovídat zpoždění jak 80 milisekund, tak 140 milisekund. V soutěžním hraní, PvP soubojích či při správě velkých herních serverů jsou přesné hodnoty pingu kriticky důležité. Modifikace Better Ping Display [Fabric] tento problém řeší tím, že nahrazuje abstraktní grafické sloupce přesnou číselnou hodnotou zpoždění v milisekundách přímo v menu seznamu hráčů.

Technický princip fungování a omezení standardního vykreslování zpoždění

Pro předání informací o pingu server Minecraftu odesílá pakety s aktualizací seznamu hráčů (v moderních verzích hry za to odpovídá paket ClientboundPlayerInfoUpdatePacket). Každý záznam v paketu obsahuje celočíselný parametr zpoždění (latency) vyjádřený v milisekundách. Klientská část hry tato data přijímá a ukládá je do paměti jako vlastnost objektu PlayerInfo (v dřívějších verzích známého jako NetworkPlayerInfo).

Během vykreslování seznamu hráčů na obrazovce vanilla třída rozhraní PlayerListHud (nebo PlayerTabOverlay v mapováních Yarn) prochází všechny připojené uživatele a určuje úroveň zpoždění. Za zobrazení ikony odpovídá vnitřní metoda renderLatencyIcon (nebo renderPingIcon). Tato metoda porovnává celé číslo milisekund s pevnými prahy:

·        Hodnota nižší než 0 zobrazuje ikonu chybějícího připojení (červený křížek).

·        Hodnota nižší než 150 milisekund odpovídá maximálním pěti sloupcům.

·        Rozsah od 150 do 299 milisekund zobrazuje čtyři sloupce.

·        Rozsah od 300 do 599 milisekund ukazuje tři sloupce.

·        Rozsah od 600 do 999 milisekund vykresluje dva sloupce.

·        Zpoždění od 1000 milisekund zobrazuje jeden sloupec.

Tímto způsobem se přesné číselné hodnoty zahazují těsně před vykreslením na obrazovku a místo nich se vykreslí odpovídající sprite ze souboru textur icons.png.

Better Ping Display do tohoto procesu zasahuje pomocí systému Mixin. Injektážní třída upravuje chování PlayerListHud v okamžiku vykreslování řádku každého hráče. Modifikace zachytí volání vykreslení grafických sloupců a zablokuje jeho provedení (nebo jej provede paralelně v závislosti na konfiguraci). Místo toho se provede volání pro získání přesné hodnoty latency prostřednictvím objektu PlayerInfo. Dále mod předá toto číslo textovému rendereru klienta Font, který dynamicky vykresluje znaky na obrazovce s ohledem na nastavený styl a umístění prvků rozhraní.

Hlavní funkce: číselné zobrazení, barevná škála a grafické sloupce

Mod rozšiřuje informativnost rozhraní síťové statistiky o následující funkční možnosti:

·        Číselný ukazatel v reálném čase: Zobrazuje přesnou hodnotu zpoždění v milisekundách. Hráč vidí skutečný stav připojení každého účastníka, aniž by musel najíždět kurzorem nebo zadávat diagnostické příkazy do chatu.

·        Automatické barevné označení: Modifikace ve výchozím nastavení obarvuje text pingu podle kvality připojení. Nízké zpoždění (méně než 100 milisekund) je zvýrazněno zeleně, střední (od 100 do 299 milisekund) nabývá žluté nebo oranžové barvy a vysoké zpoždění (od 300 milisekund a více) je obarveno červeně. To pomáhá okamžitě odhalit hráče s nestabilním připojením.

·        Kombinovaný režim zobrazení: Uživatel může zapnout současné zobrazení číselných hodnot a původních vanilla sloupců pingu. V tomto případě se text vykresluje vlevo od grafické ikony a zachovává tak obvyklý vizuální styl Minecraftu.

·        Klientská architektura: Modifikace funguje výhradně na straně klienta. Nevyžaduje instalaci na server a neodesílá serveru žádné další požadavky. Mod čte pouze ty informace o provozu, které server Minecraftu ve výchozím nastavení předává všem připojeným klientům. Díky tomu Better Ping Display funguje na libovolných serverech, včetně oficiálních serverů Realms a veřejných serverů bez podpory modifikací.

Nastavení, kompatibilita a ekosystém

Konfigurace parametrů zobrazení se provádí úpravou souboru betterpingdisplay.json, který se automaticky vytvoří v adresáři config po prvním spuštění hry. Soubor obsahuje následující nastavení:

·        autoColorPingText – logický příznak (true/false). Při hodnotě true se barva pingu mění automaticky od zelené po červenou v závislosti na rychlosti připojení. Pokud je zadáno false, barva se stane statickou a je určena následujícím parametrem.

·        pingTextColor – textové pole pro nastavení šestnáctkového kódu barvy (například #A0A0A0 pro světle šedou). Tato barva se používá pouze tehdy, když je automatické barevné označení vypnuté.

·        renderPingBars – logický příznak řídící vykreslování standardních vanilla sloupců zpoždění vedle číselného ukazatele.

·        pingTextFormatString – řetězec formátování textu. Ve výchozím nastavení je nastavena hodnota %dms, kde znak %d je povinná technická značka, která se během vykreslování nahradí aktuálním počtem milisekund zpoždění.

Ve verzi modu 1.2.0 a novějších se objevila podpora grafického rozhraní nastavení přímo v herním menu. Pro přístup k vizuálnímu konfiguračnímu menu v seznamu modifikací je nutné nainstalovat dvě další pomocné součásti: knihovnu YetAnotherConfigLib (YACL) a mod Mod Menu. Pokud jsou přítomny, objeví se ve hře pohodlné okno s přepínači a posuvníky pro změnu parametrů Better Ping Display.

Modifikace je kompatibilní s většinou klientských optimalizátorů (jako jsou Sodium, Lithium, FerriteCore) a grafických vylepšení (Iris Shaders). Nezpůsobuje konflikty při hraní na serverech s vlastními pluginy pro seznamy hráčů, protože mění pouze fázi lokálního vykreslování na klientovi, aniž by ovlivňovala strukturu síťových paketů.

Závěr

Better Ping Display [Fabric] je kompaktní a efektivní klientská modifikace, která napravuje podstatný nedostatek standardního seznamu hráčů Minecraftu. Na rozdíl od podobných řešení typu Numeral Ping či Ping Display má tento mod jednoduchou integraci s knihovnou YACL pro nastavení parametrů přímo ve hře a umožňuje zachovat vanilla ikony zpoždění. Hlavním omezením je závislost frekvence aktualizace čísel na nastavení samotného serveru (ve výchozím nastavení server Minecraftu odesílá aktualizace statistik pingu jednou za několik sekund, takže okamžité výkyvy zpoždění se nebudou zobrazovat okamžitě). Mod je ideální pro hráče síťových režimů a administrátory serverů, kteří potřebují jasnou kontrolu nad síťovými parametry bez zbytečné zátěže systému.