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

L'interfaccia standard di Minecraft mostra la latenza di connessione dei giocatori nel menu dell'elenco di rete (tasto TAB) sotto forma di un'icona grafica composta da cinque barre verticali. Questo approccio non fornisce informazioni precise sulla stabilità della connessione, poiché la stessa icona può corrispondere a una latenza sia di 80 millisecondi sia di 140 millisecondi. Nel gioco competitivo, nelle battaglie PvP o durante l'amministrazione di grandi server di gioco, i valori precisi del ping sono di importanza critica. La modifica Better Ping Display [Fabric] risolve questo problema sostituendo le astratte barre grafiche con un valore numerico preciso della latenza in millisecondi direttamente nel menu dell'elenco dei giocatori.

Principio tecnico di funzionamento e limiti del rendering standard della latenza

Per trasmettere le informazioni sul ping, il server di Minecraft invia pacchetti di aggiornamento dell'elenco dei giocatori (nelle versioni moderne del gioco se ne occupa il pacchetto ClientboundPlayerInfoUpdatePacket). Ogni voce del pacchetto contiene un parametro intero di latenza (latency), espresso in millisecondi. La parte client del gioco riceve questi dati e li conserva in memoria come proprietà dell'oggetto PlayerInfo (noto nelle versioni precedenti come NetworkPlayerInfo).

Durante il rendering dell'elenco dei giocatori sullo schermo, la classe vanilla dell'interfaccia PlayerListHud (oppure PlayerTabOverlay nei mapping Yarn) scorre tutti gli utenti connessi e determina il livello di latenza. Della visualizzazione dell'icona si occupa il metodo interno renderLatencyIcon (oppure renderPingIcon). Questo metodo confronta il numero intero di millisecondi con soglie fisse:

·        Un valore inferiore a 0 mostra l'icona di assenza di connessione (croce rossa).

·        Un valore inferiore a 150 millisecondi corrisponde alle cinque barre massime.

·        L'intervallo da 150 a 299 millisecondi mostra quattro barre.

·        L'intervallo da 300 a 599 millisecondi mostra tre barre.

·        L'intervallo da 600 a 999 millisecondi mostra due barre.

·        Una latenza a partire da 1000 millisecondi mostra una barra.

In questo modo i valori numerici precisi vengono scartati immediatamente prima della visualizzazione sullo schermo e, al loro posto, viene disegnato lo sprite corrispondente dal file di texture icons.png.

Better Ping Display interviene in questo processo tramite il sistema Mixin. La classe di iniezione modifica il comportamento di PlayerListHud nel momento in cui viene disegnata la riga di ciascun giocatore. La modifica intercetta la chiamata che disegna le barre grafiche e ne blocca l'esecuzione (oppure la esegue in parallelo a seconda della configurazione). Al suo posto viene eseguita una chiamata per ottenere il valore preciso di latency tramite l'oggetto PlayerInfo. Successivamente la mod trasmette questo numero al renderer di testo del client Font, che disegna dinamicamente i caratteri sullo schermo tenendo conto dello stile configurato e del posizionamento degli elementi dell'interfaccia.

Funzioni principali: visualizzazione numerica, scala cromatica e barre grafiche

La mod amplia l'informatività dell'interfaccia delle statistiche di rete tramite le seguenti funzionalità:

·        Indicatore numerico in tempo reale: Mostra il valore esatto della latenza in millisecondi. Il giocatore vede lo stato effettivo della connessione di ciascun partecipante senza dover passare il cursore sopra o digitare comandi diagnostici in chat.

·        Colorazione automatica: Per impostazione predefinita la modifica colora il testo del ping in base alla qualità della connessione. Una latenza bassa (inferiore a 100 millisecondi) viene evidenziata in verde, una media (da 100 a 299 millisecondi) assume una tonalità gialla o arancione, mentre una latenza alta (da 300 millisecondi in su) viene colorata di rosso. Questo aiuta a individuare istantaneamente i giocatori con una connessione instabile.

·        Modalità di visualizzazione combinata: L'utente può attivare la visualizzazione simultanea dei valori numerici e delle barre originali vanilla del ping. In tal caso il testo viene disegnato a sinistra dell'icona grafica, mantenendo il consueto stile visivo di Minecraft.

·        Architettura lato client: La modifica funziona esclusivamente lato client. Non richiede l'installazione sul server e non gli invia richieste aggiuntive. La mod legge soltanto le informazioni sul traffico che il server di Minecraft trasmette per impostazione predefinita a tutti i client connessi. Grazie a ciò Better Ping Display funziona su qualsiasi server, inclusi i server ufficiali Realms e i server pubblici senza supporto alle modifiche.

Configurazione, compatibilità ed ecosistema

La configurazione dei parametri di visualizzazione avviene modificando il file betterpingdisplay.json, che viene creato automaticamente nella directory config dopo il primo avvio del gioco. Il file contiene le seguenti impostazioni:

·        autoColorPingText – flag booleano (true/false). Con il valore true il colore del ping cambia automaticamente dal verde al rosso a seconda della velocità di connessione. Se si indica false il colore diventa statico ed è determinato dal parametro successivo.

·        pingTextColor – campo di testo per impostare il codice colore esadecimale (ad esempio #A0A0A0 per il grigio chiaro). Questo colore viene utilizzato solo quando la colorazione automatica è disattivata.

·        renderPingBars – flag booleano che controlla il rendering delle barre di latenza standard vanilla accanto all'indicatore numerico.

·        pingTextFormatString – stringa di formattazione del testo. Per impostazione predefinita è impostato il valore %dms, dove il simbolo %d è un marcatore tecnico obbligatorio che durante il rendering viene sostituito con il numero corrente di millisecondi di latenza.

Nella versione 1.2.0 e successive della mod è comparso il supporto a un'interfaccia grafica delle impostazioni direttamente nel menu di gioco. Per accedere al menu di configurazione visuale nell'elenco delle modifiche è necessario installare due componenti ausiliari aggiuntivi: la libreria YetAnotherConfigLib (YACL) e la mod Mod Menu. In loro presenza compare nel gioco una comoda finestra con interruttori e cursori per modificare i parametri di Better Ping Display.

La modifica è compatibile con la maggior parte degli ottimizzatori client (come Sodium, Lithium, FerriteCore) e dei miglioramenti grafici (Iris Shaders). Non genera conflitti durante il gioco su server con plugin personalizzati per gli elenchi dei giocatori, poiché modifica solo la fase di rendering locale sul client senza influire sulla struttura dei pacchetti di rete.

Conclusione

Better Ping Display [Fabric] è una modifica lato client compatta ed efficiente che corregge un difetto sostanziale dell'elenco dei giocatori standard di Minecraft. A differenza di soluzioni analoghe come Numeral Ping o Ping Display, questa mod offre una semplice integrazione con la libreria YACL per regolare i parametri direttamente nel gioco e consente di mantenere le icone vanilla della latenza. Il limite principale è la dipendenza della frequenza di aggiornamento dei numeri dalle impostazioni del server stesso (per impostazione predefinita il server di Minecraft invia l'aggiornamento delle statistiche del ping una volta ogni pochi secondi, perciò le oscillazioni istantanee della latenza non verranno visualizzate immediatamente). La mod è ideale per i giocatori delle modalità in rete e per gli amministratori dei server che necessitano di un controllo chiaro dei parametri di rete senza un carico eccessivo sul sistema.