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

La interfaz estándar de Minecraft muestra la latencia de conexión de los jugadores en el menú de la lista de red (tecla TAB) en forma de un icono gráfico de cinco barras verticales. Este enfoque no aporta información precisa sobre la estabilidad de la conexión, ya que un mismo icono puede corresponder a una latencia tanto de 80 milisegundos como de 140 milisegundos. En el juego competitivo, en las batallas PvP o durante la administración de grandes servidores de juego, los valores precisos del ping son de importancia crítica. La modificación Better Ping Display [Fabric] resuelve este problema sustituyendo las abstractas barras gráficas por un valor numérico preciso de la latencia en milisegundos directamente en el menú de la lista de jugadores.

Principio técnico de funcionamiento y limitaciones del renderizado estándar de la latencia

Para transmitir la información sobre el ping, el servidor de Minecraft envía paquetes de actualización de la lista de jugadores (en las versiones modernas del juego se encarga de ello el paquete ClientboundPlayerInfoUpdatePacket). Cada entrada del paquete contiene un parámetro entero de latencia (latency), expresado en milisegundos. La parte cliente del juego recibe estos datos y los almacena en memoria como una propiedad del objeto PlayerInfo (conocido en las versiones anteriores como NetworkPlayerInfo).

Durante el renderizado de la lista de jugadores en pantalla, la clase vanilla de la interfaz PlayerListHud (o PlayerTabOverlay en los mapeos Yarn) recorre todos los usuarios conectados y determina el nivel de latencia. De mostrar el icono se encarga el método interno renderLatencyIcon (o renderPingIcon). Este método compara el número entero de milisegundos con umbrales fijos:

·        Un valor menor que 0 muestra el icono de ausencia de conexión (cruz roja).

·        Un valor menor que 150 milisegundos corresponde a las cinco barras máximas.

·        El rango de 150 a 299 milisegundos muestra cuatro barras.

·        El rango de 300 a 599 milisegundos muestra tres barras.

·        El rango de 600 a 999 milisegundos muestra dos barras.

·        Una latencia a partir de 1000 milisegundos muestra una barra.

De este modo, los valores numéricos precisos se descartan justo antes de mostrarse en pantalla y, en su lugar, se dibuja el sprite correspondiente del archivo de texturas icons.png.

Better Ping Display introduce cambios en este proceso mediante el sistema Mixin. La clase de inyección modifica el comportamiento de PlayerListHud en el momento en que se dibuja la fila de cada jugador. La modificación intercepta la llamada que dibuja las barras gráficas y bloquea su ejecución (o la ejecuta en paralelo según la configuración). En su lugar se ejecuta una llamada para obtener el valor preciso de latency a través del objeto PlayerInfo. A continuación, el mod transmite ese número al renderizador de texto del cliente Font, que dibuja dinámicamente los caracteres en pantalla teniendo en cuenta el estilo configurado y la posición de los elementos de la interfaz.

Funciones principales: visualización numérica, escala de colores y barras gráficas

El mod amplía el carácter informativo de la interfaz de estadísticas de red mediante las siguientes funcionalidades:

·        Indicador numérico en tiempo real: Muestra el valor exacto de la latencia en milisegundos. El jugador ve el estado real de la conexión de cada participante sin necesidad de pasar el cursor por encima ni introducir comandos de diagnóstico en el chat.

·        Coloreado automático: Por defecto, la modificación colorea el texto del ping en función de la calidad de la conexión. Una latencia baja (menos de 100 milisegundos) se resalta en verde, una media (de 100 a 299 milisegundos) adquiere un tono amarillo o naranja, y una latencia alta (a partir de 300 milisegundos) se colorea de rojo. Esto ayuda a detectar al instante a los jugadores con una conexión inestable.

·        Modo de visualización combinado: El usuario puede activar la visualización simultánea de los valores numéricos y de las barras originales vanilla del ping. En ese caso el texto se dibuja a la izquierda del icono gráfico, conservando el estilo visual habitual de Minecraft.

·        Arquitectura del lado del cliente: La modificación funciona exclusivamente en el lado del cliente. No requiere instalación en el servidor ni le envía solicitudes adicionales. El mod lee únicamente la información sobre el tráfico que el servidor de Minecraft transmite por defecto a todos los clientes conectados. Gracias a ello, Better Ping Display funciona en cualquier servidor, incluidos los servidores oficiales Realms y los servidores públicos sin soporte para modificaciones.

Configuración, compatibilidad y ecosistema

La configuración de los parámetros de visualización se realiza editando el archivo betterpingdisplay.json, que se crea automáticamente en el directorio config tras el primer arranque del juego. El archivo contiene los siguientes ajustes:

·        autoColorPingText – bandera booleana (true/false). Con el valor true el color del ping cambia automáticamente del verde al rojo según la velocidad de la conexión. Si se indica false el color se vuelve estático y queda determinado por el siguiente parámetro.

·        pingTextColor – campo de texto para establecer el código de color hexadecimal (por ejemplo, #A0A0A0 para gris claro). Este color solo se utiliza cuando el coloreado automático está desactivado.

·        renderPingBars – bandera booleana que controla el renderizado de las barras de latencia estándar vanilla junto al indicador numérico.

·        pingTextFormatString – cadena de formato del texto. Por defecto tiene el valor %dms, donde el símbolo %d es un marcador técnico obligatorio que durante el renderizado se sustituye por el número actual de milisegundos de latencia.

En la versión 1.2.0 del mod y posteriores apareció la compatibilidad con una interfaz gráfica de ajustes directamente en el menú del juego. Para acceder al menú visual de configuración en la lista de modificaciones es necesario instalar dos componentes auxiliares adicionales: la biblioteca YetAnotherConfigLib (YACL) y el mod Mod Menu. Con ellos presentes, en el juego aparece una cómoda ventana con interruptores y deslizadores para cambiar los parámetros de Better Ping Display.

La modificación es compatible con la mayoría de los optimizadores del cliente (como Sodium, Lithium, FerriteCore) y de las mejoras gráficas (Iris Shaders). No provoca conflictos al jugar en servidores con plugins personalizados para las listas de jugadores, ya que solo modifica la etapa de renderizado local en el cliente, sin afectar a la estructura de los paquetes de red.

Conclusión

Better Ping Display [Fabric] es una modificación del lado del cliente compacta y eficiente que corrige un defecto sustancial de la lista de jugadores estándar de Minecraft. A diferencia de soluciones análogas como Numeral Ping o Ping Display, este mod ofrece una sencilla integración con la biblioteca YACL para ajustar los parámetros directamente en el juego y permite conservar los iconos vanilla de la latencia. Su principal limitación es que la frecuencia de actualización de los números depende de los ajustes del propio servidor (por defecto el servidor de Minecraft envía la actualización de las estadísticas del ping una vez cada varios segundos, por lo que las fluctuaciones instantáneas de la latencia no se mostrarán de inmediato). El mod es ideal para los jugadores de los modos en red y para los administradores de servidores que necesitan un control claro de los parámetros de red sin una carga adicional para el sistema.