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

A interface padrão do Minecraft exibe a latência de conexão dos jogadores no menu da lista de rede (tecla TAB) na forma de um ícone gráfico de cinco barras verticais. Essa abordagem não fornece informações precisas sobre a estabilidade da conexão, pois o mesmo ícone pode corresponder a uma latência tanto de 80 milissegundos quanto de 140 milissegundos. Na jogabilidade competitiva, em batalhas PvP ou durante a administração de grandes servidores de jogo, os valores precisos de ping são de importância crítica. A modificação Better Ping Display [Fabric] resolve esse problema substituindo as abstratas barras gráficas por um valor numérico preciso da latência em milissegundos diretamente no menu da lista de jogadores.

Princípio técnico de funcionamento e limitações da renderização padrão da latência

Para transmitir a informação sobre o ping, o servidor do Minecraft envia pacotes de atualização da lista de jogadores (nas versões modernas do jogo, é o pacote ClientboundPlayerInfoUpdatePacket que se encarrega disso). Cada registro no pacote contém um parâmetro inteiro de latência (latency), expresso em milissegundos. A parte cliente do jogo recebe esses dados e os armazena na memória como uma propriedade do objeto PlayerInfo (conhecido nas versões anteriores como NetworkPlayerInfo).

Durante a renderização da lista de jogadores na tela, a classe vanilla da interface PlayerListHud (ou PlayerTabOverlay nos mapeamentos Yarn) percorre todos os usuários conectados e determina o nível de latência. A exibição do ícone fica a cargo do método interno renderLatencyIcon (ou renderPingIcon). Esse método compara o número inteiro de milissegundos com limiares fixos:

·        Um valor menor que 0 exibe o ícone de ausência de conexão (cruz vermelha).

·        Um valor menor que 150 milissegundos corresponde às cinco barras máximas.

·        A faixa de 150 a 299 milissegundos exibe quatro barras.

·        A faixa de 300 a 599 milissegundos mostra três barras.

·        A faixa de 600 a 999 milissegundos exibe duas barras.

·        Uma latência a partir de 1000 milissegundos exibe uma barra.

Dessa forma, os valores numéricos precisos são descartados imediatamente antes da exibição na tela e, em seu lugar, é desenhado o sprite correspondente do arquivo de texturas icons.png.

O Better Ping Display introduz alterações nesse processo por meio do sistema Mixin. A classe de injeção modifica o comportamento do PlayerListHud no momento em que a linha de cada jogador é desenhada. A modificação intercepta a chamada que desenha as barras gráficas e bloqueia sua execução (ou a executa em paralelo dependendo da configuração). Em seu lugar, é executada uma chamada para obter o valor preciso de latency por meio do objeto PlayerInfo. Em seguida, o mod transmite esse número ao renderizador de texto do cliente Font, que desenha dinamicamente os caracteres na tela levando em conta o estilo configurado e o posicionamento dos elementos da interface.

Funções principais: exibição numérica, escala de cores e barras gráficas

O mod amplia o caráter informativo da interface de estatísticas de rede por meio das seguintes funcionalidades:

·        Indicador numérico em tempo real: Exibe o valor exato da latência em milissegundos. O jogador vê o estado real da conexão de cada participante sem precisar passar o cursor por cima nem digitar comandos de diagnóstico no chat.

·        Coloração automática: Por padrão, a modificação colore o texto do ping de acordo com a qualidade da conexão. Uma latência baixa (menos de 100 milissegundos) é destacada em verde, uma média (de 100 a 299 milissegundos) adquire uma tonalidade amarela ou laranja, e uma latência alta (a partir de 300 milissegundos) é colorida de vermelho. Isso ajuda a identificar instantaneamente os jogadores com conexão instável.

·        Modo de exibição combinado: O usuário pode ativar a exibição simultânea dos valores numéricos e das barras vanilla originais do ping. Nesse caso, o texto é desenhado à esquerda do ícone gráfico, mantendo o estilo visual habitual do Minecraft.

·        Arquitetura do lado do cliente: A modificação funciona exclusivamente do lado do cliente. Não requer instalação no servidor nem lhe envia solicitações adicionais. O mod lê apenas a informação sobre o tráfego que o servidor do Minecraft transmite por padrão a todos os clientes conectados. Graças a isso, o Better Ping Display funciona em qualquer servidor, incluindo os servidores oficiais Realms e os servidores públicos sem suporte a modificações.

Configuração, compatibilidade e ecossistema

A configuração dos parâmetros de exibição é feita editando o arquivo betterpingdisplay.json, que é criado automaticamente no diretório config após a primeira inicialização do jogo. O arquivo contém as seguintes configurações:

·        autoColorPingText – um sinalizador booleano (true/false). Com o valor true, a cor do ping muda automaticamente do verde para o vermelho conforme a velocidade da conexão. Se for indicado false, a cor torna-se estática e é determinada pelo parâmetro seguinte.

·        pingTextColor – um campo de texto para definir o código de cor hexadecimal (por exemplo, #A0A0A0 para cinza-claro). Essa cor é usada apenas quando a coloração automática está desativada.

·        renderPingBars – um sinalizador booleano que controla a renderização das barras de latência padrão vanilla ao lado do indicador numérico.

·        pingTextFormatString – uma string de formatação do texto. Por padrão, está definido o valor %dms, em que o símbolo %d é um marcador técnico obrigatório que, durante a renderização, é substituído pelo número atual de milissegundos de latência.

Na versão 1.2.0 do mod e posteriores, surgiu o suporte a uma interface gráfica de configurações diretamente no menu do jogo. Para acessar o menu visual de configuração na lista de modificações, é necessário instalar dois componentes auxiliares adicionais: a biblioteca YetAnotherConfigLib (YACL) e o mod Mod Menu. Com eles presentes, aparece no jogo uma cômoda janela com interruptores e controles deslizantes para alterar os parâmetros do Better Ping Display.

A modificação é compatível com a maioria dos otimizadores do cliente (como Sodium, Lithium, FerriteCore) e das melhorias gráficas (Iris Shaders). Ela não provoca conflitos ao jogar em servidores com plugins personalizados para as listas de jogadores, pois altera apenas a etapa de renderização local no cliente, sem afetar a estrutura dos pacotes de rede.

Conclusão

Better Ping Display [Fabric] é uma modificação do lado do cliente compacta e eficiente que corrige uma falha substancial da lista de jogadores padrão do Minecraft. Ao contrário de soluções análogas como Numeral Ping ou Ping Display, este mod oferece uma integração simples com a biblioteca YACL para ajustar os parâmetros diretamente no jogo e permite manter os ícones vanilla da latência. A principal limitação é a dependência da frequência de atualização dos números das configurações do próprio servidor (por padrão, o servidor do Minecraft envia a atualização das estatísticas de ping uma vez a cada poucos segundos, de modo que as oscilações instantâneas da latência não serão exibidas de imediato). O mod é ideal para jogadores dos modos em rede e para administradores de servidores que precisam de um controle claro dos parâmetros de rede sem sobrecarga adicional para o sistema.