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

Minecraftin vakiokäyttöliittymä näyttää pelaajien yhteysviiveen pelaajaluettelon valikossa (TAB-näppäin) graafisena kuvakkeena, joka koostuu viidestä pystypalkista. Tämä lähestymistapa ei tarjoa tarkkaa tietoa yhteyden vakaudesta, sillä sama kuvake voi vastata sekä 80 millisekunnin että 140 millisekunnin viivettä. Kilpailullisessa pelaamisessa, PvP-taisteluissa tai suuria pelipalvelimia hallinnoitaessa tarkat ping-arvot ovat ratkaisevan tärkeitä. Better Ping Display [Fabric] -modifikaatio ratkaisee tämän ongelman korvaamalla abstraktit graafiset palkit tarkalla numeerisella viivearvolla millisekunteina suoraan pelaajaluettelon valikossa.

Tekninen toimintaperiaate ja viiveen vakiorenderöinnin rajoitukset

Välittääkseen tietoa pingistä Minecraft-palvelin lähettää pelaajaluettelon päivityspaketteja (pelin nykyaikaisissa versioissa tästä vastaa paketti ClientboundPlayerInfoUpdatePacket). Jokainen paketin merkintä sisältää kokonaisluvun muodossa olevan viiveparametrin (latency), joka ilmaistaan millisekunteina. Pelin asiakaspuoli vastaanottaa nämä tiedot ja tallentaa ne muistiin objektin PlayerInfo ominaisuutena (aiemmissa versioissa nimellä NetworkPlayerInfo).

Renderöitäessä pelaajaluetteloa näytölle vanilla-käyttöliittymäluokka PlayerListHud (tai PlayerTabOverlay Yarn-kartoituksissa) käy läpi kaikki yhdistetyt käyttäjät ja määrittää viivetason. Kuvakkeen näyttämisestä vastaa sisäinen metodi renderLatencyIcon (tai renderPingIcon). Tämä metodi vertaa millisekuntien kokonaislukua kiinteisiin kynnysarvoihin:

·        Alle 0 oleva arvo näyttää yhteyden puuttumisen kuvakkeen (punainen rasti).

·        Alle 150 millisekunnin arvo vastaa enimmäismäärää eli viittä palkkia.

·        Väli 150–299 millisekuntia näyttää neljä palkkia.

·        Väli 300–599 millisekuntia näyttää kolme palkkia.

·        Väli 600–999 millisekuntia näyttää kaksi palkkia.

·        1000 millisekunnista alkava viive näyttää yhden palkin.

Näin tarkat numeeriset arvot hylätään juuri ennen näytölle tulostamista, ja niiden sijaan piirretään vastaava sprite tekstuuritiedostosta icons.png.

Better Ping Display tekee muutoksia tähän prosessiin Mixin-järjestelmän avulla. Injektioluokka muuttaa luokan PlayerListHud toimintaa sillä hetkellä, kun kunkin pelaajan rivi piirretään. Modifikaatio sieppaa graafisten palkkien piirtokutsun ja estää sen suorittamisen (tai suorittaa sen rinnakkain konfiguraation mukaan). Sen sijaan suoritetaan kutsu, joka hakee tarkan latency-arvon objektin PlayerInfo kautta. Tämän jälkeen modi välittää tämän luvun asiakkaan tekstinrenderöijälle Font, joka piirtää merkit dynaamisesti näytölle ottaen huomioon määritetyn tyylin ja käyttöliittymäelementtien sijoittelun.

Päätoiminnot: numeerinen näyttö, väriasteikko ja graafiset palkit

Modi laajentaa verkkotilastojen käyttöliittymän informatiivisuutta seuraavilla toiminnallisilla ominaisuuksilla:

·        Reaaliaikainen numeerinen mittari: Näyttää tarkan viiveen millisekunteina. Pelaaja näkee kunkin osallistujan todellisen yhteystilan ilman, että hänen tarvitsee viedä kohdistinta päälle tai syöttää diagnostisia komentoja chattiin.

·        Automaattinen värimerkintä: Modifikaatio värittää oletusarvoisesti ping-tekstin yhteyden laadun mukaan. Matala viive (alle 100 millisekuntia) korostetaan vihreällä, keskitaso (100–299 millisekuntia) saa keltaisen tai oranssin sävyn, ja korkea viive (300 millisekunnista ylöspäin) väritetään punaiseksi. Tämä auttaa havaitsemaan välittömästi pelaajat, joiden yhteys on epävakaa.

·        Yhdistetty näyttötila: Käyttäjä voi ottaa käyttöön numeeristen arvojen ja alkuperäisten vanilla-ping-palkkien samanaikaisen näyttämisen. Tällöin teksti piirretään graafisen kuvakkeen vasemmalle puolelle, jolloin Minecraftin tuttu visuaalinen tyyli säilyy.

·        Asiakaspuolen arkkitehtuuri: Modifikaatio toimii puhtaasti asiakaspuolella. Se ei vaadi asentamista palvelimelle eikä lähetä palvelimelle lisäpyyntöjä. Modi lukee vain sitä liikennetietoa, jonka Minecraft-palvelin oletusarvoisesti välittää kaikille yhdistetyille asiakkaille. Tämän ansiosta Better Ping Display toimii millä tahansa palvelimella, mukaan lukien viralliset Realms-palvelimet ja julkiset palvelimet ilman modien tukea.

Asetukset, yhteensopivuus ja ekosysteemi

Näyttöparametrien määrittäminen tapahtuu muokkaamalla tiedostoa betterpingdisplay.json, joka luodaan automaattisesti hakemistoon config pelin ensimmäisen käynnistyksen jälkeen. Tiedosto sisältää seuraavat asetukset:

·        autoColorPingText – looginen lippu (true/false). Arvolla true ping-väri muuttuu automaattisesti vihreästä punaiseen yhteysnopeuden mukaan. Jos arvoksi annetaan false, väri muuttuu staattiseksi ja sen määrittää seuraava parametri.

·        pingTextColor – tekstikenttä heksadesimaalisen värikoodin asettamista varten (esimerkiksi #A0A0A0 vaaleanharmaalle). Tätä väriä käytetään vain silloin, kun automaattinen värimerkintä on poistettu käytöstä.

·        renderPingBars – looginen lippu, joka ohjaa vakiomuotoisten vanilla-viivepalkkien renderöintiä numeerisen mittarin vieressä.

·        pingTextFormatString – tekstin muotoilumerkkijono. Oletusarvoksi on asetettu %dms, jossa merkki %d on pakollinen tekninen merkintä, joka korvataan renderöinnin aikana viiveen nykyisellä millisekuntimäärällä.

Modin versiossa 1.2.0 ja uudemmissa ilmestyi tuki graafiselle asetuskäyttöliittymälle suoraan pelin valikossa. Päästäksesi visuaaliseen konfigurointivalikkoon modien luettelossa on asennettava kaksi lisäaputyökalua: kirjasto YetAnotherConfigLib (YACL) ja modi Mod Menu. Kun ne ovat käytössä, peliin ilmestyy kätevä ikkuna, jossa on kytkimet ja liukusäätimet Better Ping Display -parametrien muuttamiseen.

Modifikaatio on yhteensopiva useimpien asiakaspuolen optimoijien (kuten Sodium, Lithium, FerriteCore) ja graafisten parannusten (Iris Shaders) kanssa. Se ei aiheuta ristiriitoja pelattaessa palvelimilla, joilla on mukautettuja pelaajaluetteloiden lisäosia, koska se muuttaa vain paikallista renderöintivaihetta asiakkaalla vaikuttamatta verkkopakettien rakenteeseen.

Johtopäätös

Better Ping Display [Fabric] on kompakti ja tehokas asiakaspuolen modifikaatio, joka korjaa Minecraftin vakiopelaajaluettelon merkittävän puutteen. Toisin kuin vastaavat ratkaisut, kuten Numeral Ping tai Ping Display, tällä modilla on yksinkertainen integraatio YACL-kirjaston kanssa parametrien säätämiseksi suoraan pelissä, ja se mahdollistaa vanilla-viivekuvakkeiden säilyttämisen. Pääasiallinen rajoitus on, että numeroiden päivitystiheys riippuu itse palvelimen asetuksista (oletusarvoisesti Minecraft-palvelin lähettää ping-tilastojen päivityksiä kerran muutamassa sekunnissa, joten viiveen hetkelliset vaihtelut eivät näy välittömästi). Modi sopii ihanteellisesti verkkotilojen pelaajille ja palvelinten ylläpitäjille, jotka tarvitsevat selkeää hallintaa verkkoparametreista ilman tarpeetonta järjestelmäkuormitusta.