Como mostrar a contagem de jogadores online na lista de servidores Hytale

Quando um jogador navega pela lista de servidores Hytale, um numero decide se ele clica em "Entrar" ou continua rolando: a contagem de jogadores. Um servidor mostrando 47/100 jogadores parece vivo. Um servidor que nao mostra nada — ou apenas "Offline" — parece uma cidade fantasma mesmo que esteja funcionando perfeitamente. HytaleCharts oferece tres formas de exibir a contagem de jogadores em tempo real e o status online do seu servidor Hytale. Cada metodo tem diferentes compromissos em precisao, esforco de configuracao e funcionalidades. Este guia explica os tres para que voce possa escolher o certo para sua configuracao. Os tres metodos em um relance MetodoContagem de jogadoresVelocidade de atualizacaoEsforco de configuracaoMelhor para Plugin HeartbeatContagem exata + lista de jogadoresA cada 60 segundosInstalar pluginServidores auto-hospedados Consulta externaContagem exataA cada 5 minutosDefinir uma URLNitrado / hosts gerenciados Ping UDPApenas online/offlinePeriodicoNenhum (automatico)Status basico de fallback Metodo 1: Plugin Heartbeat HytaleCharts (Recomendado) O plugin heartbeat e a melhor forma de mostrar sua contagem de jogadores na lista de servidores Hytale. Ele roda no seu servidor Hytale e envia um sinal heartbeat ao HytaleCharts a cada 60 segundos, incluindo o numero exato de jogadores online e seus nomes de usuario. O que ele reporta Contagem de jogadores — o numero atual de jogadores conectados Jogadores maximos — o limite de jogadores do seu servidor Lista de jogadores — nomes de usuario individuais e UUIDs dos jogadores conectados Versao do plugin — para que o HytaleCharts possa avisar sobre atualizacoes Como funciona internamente O plugin envia uma requisicao POST para /api/heartbeat a cada 60 segundos A requisicao inclui a chave secreta do seu servidor (uma string hexadecimal de 64 caracteres) O HytaleCharts valida o segredo, atualiza a contagem de jogadores e o status do seu servidor Se nenhum heartbeat for recebido por 5 minutos, o servidor e marcado como offline Dados historicos sao armazenados para analises e graficos de contagem de jogadores Passos de configuracao Gere um segredo heartbeat — no HytaleCharts, va em Editar Servidor e clique em "Gerar Segredo Heartbeat" na secao Plugin Heartbeat Copie o segredo — voce so o vera uma vez (pode regenerar se perder) Instale o plugin HytaleCharts no seu servidor Hytale colocando-o no diretorio mods/ do seu servidor Configure o plugin — crie ou edite config.json no diretorio de dados do plugin: { "secret": "YOUR_64_CHARACTER_SECRET_HERE", "debug": false } Reinicie seu servidor — o plugin comecara a enviar heartbeats imediatamente Verifique no HytaleCharts — seu servidor deve aparecer como online com uma contagem de jogadores em 60 segundos Suporte multi-instancia Se voce executa multiplas instancias de servidor (por exemplo, um servidor lobby e um servidor survival), o sistema heartbeat agrega automaticamente as contagens de jogadores. Todas as instancias compartilhando a mesma chave secreta terao seus jogadores unicos mesclados e os totais somados. Isso significa que sua entrada na lista de servidores Hytale mostra o total correto em toda sua rede. O sistema identifica instancias unicas por endereco IP e nome do mundo, pega o ultimo heartbeat de cada fonte e mescla jogadores por UUID para evitar contagem dupla de qualquer pessoa conectada a multiplas instancias. Atualizacoes do plugin O HytaleCharts rastreia a versao do seu plugin. Se uma versao mais recente estiver disponivel, sua pagina de Editar Servidor mostrara um aviso de "Atualizacao disponivel". Manter o plugin atualizado garante compatibilidade com quaisquer mudancas na API e lhe da as ultimas correcoes de bugs. Metodo 2: Endpoint de consulta externa (Nitrado e hosts gerenciados) Nem todos os operadores de servidores Hytale tem acesso para instalar plugins personalizados. Se voce usa Nitrado, um host baseado em containers ou qualquer provedor que exponha um endpoint de consulta, o sistema de consulta externa e sua solucao. Como funciona Voce fornece ao HytaleCharts uma URL que retorna a contagem de jogadores do seu servidor como JSON O HytaleCharts consulta essa URL a cada 5 minutos A resposta e analisada e sua contagem de jogadores e atualizada na lista de servidores Se o endpoint se tornar inacessivel, o status do seu servidor reflete a mudanca em 10 minutos Formatos de resposta suportados O HytaleCharts detecta automaticamente multiplos formatos JSON, entao funciona com a maioria dos endpoints de consulta sem configuracao adicional: Formato Nitrado { "Universe": { "CurrentPlayers": 15 }, "Server": { "MaxPlayers": 100 } } Formato padrao { "player_count": 15, "max_players": 100 } Tambem suporta variantes camelCase (playerCount, maxPlayers) e abreviadas (online, max). Passos de configuracao Encontre ou configure um endpoint de consulta no seu provedor de hospedagem (Nitrado fornece um por padrao) No HytaleCharts, va em Editar Servidor → Consulta externa Insira a URL completa do seu endpoint de consulta Clique em "Testar endpoint" para verificar se a resposta e analisavel Salve — o HytaleCharts comeca a consultar imediatamente O metodo de consulta externa atualiza com menos frequencia que o plugin heartbeat (a cada 5 minutos vs. a cada 60 segundos), mas nao requer nenhuma modificacao no servidor. Metodo 3: Ping UDP (Fallback automatico) Se voce nao configurou nem o plugin heartbeat nem um endpoint de consulta externa, o HytaleCharts tentara verificar o status do seu servidor via ping UDP. Este e um sistema passivo que nao requer nenhuma configuracao da sua parte. Como funciona O HytaleCharts envia uma sonda minima do protocolo QUIC para a porta publica do seu servidor (padrao: 5520) Se qualquer resposta for recebida, o servidor e marcado como online Se nao houver resposta apos varias tentativas, o servidor e marcado como offline Limitacoes Sem contagem de jogadores — o ping UDP so pode determinar online vs. offline, nao quantos jogadores estao conectados Sem lista de jogadores — nenhum dado individual de jogador esta disponivel Temporizacao menos precisa — as atualizacoes de status dependem do cronograma de consulta em vez de heartbeats em tempo real O ping UDP e util como base, mas servidores que buscam subir nos rankings da lista de servidores Hytale devem instalar o plugin heartbeat ou configurar uma consulta externa para contagens precisas de jogadores. Como o HytaleCharts determina o status do seu servidor Quando multiplos metodos estao disponiveis, o HytaleCharts usa um sistema de prioridade para decidir em qual fonte de dados confiar: Consulta externa (maior prioridade, se habilitada) — online se a ultima consulta bem-sucedida foi nos ultimos 10 minutos Plugin Heartbeat (se configurado) — online se o ultimo heartbeat foi nos ultimos 5 minutos Ping UDP (fallback) — usa o resultado online/offline armazenado da ultima verificacao Isso significa que se voce tem tanto o plugin heartbeat quanto uma consulta externa configurados, a consulta externa tem precedencia. A maioria dos operadores usara um ou outro, nao ambos. O que os jogadores veem Na lista de servidores Hytale, o status do seu servidor aparece como um emblema colorido: Emblema verde com contagem de jogadores (ex., "Online — 47 jogadores") — quando online e jogadores sao detectados Emblema verde ("Online") — quando online mas sem jogadores ou contagem indisponivel Emblema vermelho ("Offline") — quando nao ha heartbeat, consulta ou resposta de ping recente Servidores com contagens de jogadores visiveis atraem consistentemente mais cliques. Um servidor mostrando "Online — 23 jogadores" e muito mais atraente do que um que diz apenas "Online" sem contagem. E por isso que o plugin heartbeat ou a consulta externa e importante para os melhores servidores Hytale. Solucao de problemas ProblemaCausa provavelSolucao Servidor mostra "Offline" apesar de estar rodandoFirewall bloqueando heartbeat ou pingCertifique-se de que seu servidor pode fazer requisicoes HTTPS de saida para hytalecharts.com Contagem de jogadores presa em 0Plugin nao rastreia eventos de jogadoresVerifique se o plugin carregou (confira os logs do servidor) e reinicie Heartbeat para apos um tempoPlugin travou ou foi descarregadoVerifique os logs do servidor em busca de erros, reinstale o plugin se necessario Consulta externa mostra contagem erradaEndpoint retornando dados desatualizadosVerifique a resposta JSON diretamente em um navegador Contagem multi-instancia muito baixaInstancias usando segredos diferentesTodas as instancias devem compartilhar o mesmo segredo heartbeat Aviso "Atualizacao disponivel"Plugin desatualizadoBaixe a ultima versao do plugin no HytaleCharts Melhores praticas Operadores de melhores servidores Hytale seguem estes padroes: Use o plugin heartbeat sempre que possivel — e a opcao mais precisa e responsiva Defina uma contagem maxima de jogadores realista — limites inflados (ex., 999) parecem desonestos e reduzem a confianca Monitore seu status heartbeat — verifique periodicamente a pagina de Editar Servidor em busca de erros Mantenha o plugin atualizado — plugins desatualizados podem parar de funcionar apos mudancas na API Use a consulta externa como backup — se seu plugin falhar, um endpoint externo funcional mantem seu status preciso Certifique-se de que seu dominio esta correto — o fallback de ping UDP usa seu dominio configurado, entao mantenha-o preciso mesmo que use principalmente o heartbeat Primeiros passos Exibir sua contagem de jogadores leva menos de cinco minutos com o plugin heartbeat. Gere um segredo, instale o plugin, adicione seu segredo a configuracao e reinicie. Seu servidor Hytale aparecera na lista de servidores Hytale com uma contagem de jogadores ao vivo em menos de um minuto. Para provedores de hospedagem gerenciada como Nitrado, a consulta externa e ainda mais simples — basta colar uma URL e o HytaleCharts cuida do resto. De qualquer forma, mostrar uma contagem real de jogadores e uma das coisas mais faceis que voce pode fazer para aumentar a visibilidade do seu servidor e atrair novos jogadores. Servidores que mostram contagens ativas de jogadores na lista de servidores Hytale superam consistentemente aqueles que nao mostram.