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

De standaardinterface van Minecraft toont de verbindingsvertraging van spelers in het spelerslijstmenu (de toets TAB) als een grafisch pictogram bestaande uit vijf verticale balken. Deze aanpak biedt geen nauwkeurige informatie over de stabiliteit van de verbinding, omdat hetzelfde pictogram kan corresponderen met een vertraging van zowel 80 milliseconden als 140 milliseconden. In competitieve gameplay, PvP-gevechten of tijdens het beheer van grote gameservers zijn nauwkeurige pingwaarden van cruciaal belang. De modificatie Better Ping Display [Fabric] lost dit probleem op door de abstracte grafische balken te vervangen door een nauwkeurige numerieke vertragingswaarde in milliseconden, rechtstreeks in de spelerslijst.

Technisch werkingsprincipe en beperkingen van de standaardweergave van vertraging

Om informatie over de ping door te geven, verzendt de Minecraft-server pakketten met een update van de spelerslijst (in moderne versies van het spel is hiervoor het pakket ClientboundPlayerInfoUpdatePacket verantwoordelijk). Elke vermelding in het pakket bevat een gehele parameter voor de vertraging (latency), uitgedrukt in milliseconden. Het clientgedeelte van het spel ontvangt deze gegevens en slaat ze in het geheugen op als een eigenschap van het object PlayerInfo (in eerdere versies bekend als NetworkPlayerInfo).

Tijdens het weergeven van de spelerslijst op het scherm doorloopt de vanilla-interfaceklasse PlayerListHud (of PlayerTabOverlay in de Yarn-mappings) alle verbonden gebruikers en bepaalt het vertragingsniveau. De weergave van het pictogram wordt verzorgd door de interne methode renderLatencyIcon (of renderPingIcon). Deze methode vergelijkt het gehele getal aan milliseconden met vaste drempelwaarden:

·        Een waarde lager dan 0 toont het pictogram voor geen verbinding (een rood kruisje).

·        Een waarde lager dan 150 milliseconden komt overeen met de maximale vijf balken.

·        Het bereik van 150 tot 299 milliseconden toont vier balken.

·        Het bereik van 300 tot 599 milliseconden toont drie balken.

·        Het bereik van 600 tot 999 milliseconden toont twee balken.

·        Een vertraging vanaf 1000 milliseconden toont één balk.

Op deze manier worden de nauwkeurige numerieke waarden weggegooid vlak voordat ze op het scherm worden weergegeven, en in plaats daarvan wordt de bijbehorende sprite uit het textuurbestand icons.png getekend.

Better Ping Display brengt wijzigingen aan in dit proces met behulp van het Mixin-systeem. De injectieklasse wijzigt het gedrag van PlayerListHud op het moment dat de regel van elke speler wordt getekend. De modificatie onderschept de aanroep die de grafische balken tekent en blokkeert de uitvoering ervan (of voert deze parallel uit, afhankelijk van de configuratie). In plaats daarvan wordt een aanroep uitgevoerd om de exacte latency-waarde op te halen via het object PlayerInfo. Vervolgens geeft de mod dit getal door aan de tekstrenderer van de client Font, die de tekens dynamisch op het scherm tekent, rekening houdend met de geconfigureerde stijl en plaatsing van de interface-elementen.

Belangrijkste functies: numerieke weergave, kleurenschaal en grafische balken

De mod breidt de informatieve waarde van de netwerkstatistiekeninterface uit via de volgende functionele mogelijkheden:

·        Numerieke indicator in realtime: Toont de exacte vertraging in milliseconden. De speler ziet de werkelijke verbindingstoestand van elke deelnemer zonder de cursor te hoeven bewegen of diagnostische commando's in de chat in te voeren.

·        Automatische kleurmarkering: De modificatie kleurt de pingtekst standaard afhankelijk van de kwaliteit van de verbinding. Een lage vertraging (minder dan 100 milliseconden) wordt groen gemarkeerd, een gemiddelde (van 100 tot 299 milliseconden) krijgt een gele of oranje kleur, en een hoge vertraging (vanaf 300 milliseconden en hoger) wordt rood gekleurd. Dit helpt om direct spelers met een instabiele verbinding te herkennen.

·        Gecombineerde weergavemodus: De gebruiker kan de gelijktijdige weergave van numerieke waarden en de oorspronkelijke vanilla-pingbalken inschakelen. In dat geval wordt de tekst links van het grafische pictogram getekend, waarbij de vertrouwde visuele stijl van Minecraft behouden blijft.

·        Clientarchitectuur: De modificatie werkt uitsluitend aan de clientzijde. Ze vereist geen installatie op de server en verstuurt geen aanvullende verzoeken naar de server. De mod leest alleen de verkeersinformatie die de Minecraft-server standaard naar alle verbonden clients verzendt. Hierdoor werkt Better Ping Display op alle servers, waaronder officiële Realms-servers en openbare servers zonder modondersteuning.

Instellingen, compatibiliteit en ecosysteem

Het configureren van de weergaveparameters gebeurt door het bestand betterpingdisplay.json te bewerken, dat automatisch wordt aangemaakt in de map config na de eerste start van het spel. Het bestand bevat de volgende instellingen:

·        autoColorPingText – een booleaanse vlag (true/false). Bij de waarde true verandert de pingkleur automatisch van groen naar rood, afhankelijk van de verbindingssnelheid. Als false is opgegeven, wordt de kleur statisch en bepaald door de volgende parameter.

·        pingTextColor – een tekstveld voor het instellen van de hexadecimale kleurcode (bijvoorbeeld #A0A0A0 voor lichtgrijs). Deze kleur wordt alleen gebruikt wanneer de automatische kleurmarkering is uitgeschakeld.

·        renderPingBars – een booleaanse vlag die het weergeven van de standaard vanilla-vertragingsbalken naast de numerieke indicator regelt.

·        pingTextFormatString – een tekstopmaakreeks. Standaard is de waarde ingesteld op %dms, waarbij het teken %d een verplichte technische markering is die tijdens het weergeven wordt vervangen door het huidige aantal milliseconden vertraging.

In modversie 1.2.0 en nieuwer is ondersteuning toegevoegd voor een grafische instellingeninterface rechtstreeks in het spelmenu. Om toegang te krijgen tot het visuele configuratiemenu in de modlijst, moeten twee aanvullende hulpcomponenten worden geïnstalleerd: de bibliotheek YetAnotherConfigLib (YACL) en de mod Mod Menu. Wanneer deze aanwezig zijn, verschijnt er in het spel een handig venster met schakelaars en schuifregelaars om de parameters van Better Ping Display te wijzigen.

De modificatie is compatibel met de meeste clientoptimalisaties (zoals Sodium, Lithium, FerriteCore) en grafische verbeteringen (Iris Shaders). Ze veroorzaakt geen conflicten tijdens het spelen op servers met aangepaste plug-ins voor spelerslijsten, omdat ze alleen de lokale weergavefase op de client wijzigt zonder de structuur van de netwerkpakketten te beïnvloeden.

Conclusie

Better Ping Display [Fabric] is een compacte en effectieve clientmodificatie die een aanzienlijk gebrek van de standaardspelerslijst van Minecraft verhelpt. In tegenstelling tot vergelijkbare oplossingen zoals Numeral Ping of Ping Display heeft deze mod een eenvoudige integratie met de YACL-bibliotheek om parameters rechtstreeks in het spel aan te passen en maakt hij het mogelijk de vanilla-vertragingspictogrammen te behouden. De belangrijkste beperking is de afhankelijkheid van de vernieuwingsfrequentie van de getallen van de instellingen van de server zelf (standaard verzendt de Minecraft-server eens in de paar seconden een update van de pingstatistieken, waardoor momentane schommelingen in de vertraging niet onmiddellijk worden weergegeven). De mod is ideaal voor spelers van netwerkmodi en serverbeheerders die duidelijke controle over de netwerkparameters nodig hebben zonder onnodige belasting van het systeem.