Guia de Configuração do Plugin One Query
Aprenda a configurar o plugin One Query para exibir contagem de jogadores em tempo real, jogadores online e informações do servidor na sua listagem do Hylist.
Supported Plugins
Hylist supports two query plugins. Install one of them (not both - they are mutually exclusive):
One Query
The recommended plugin with full feature support including plugin version and status info.
Hyvote
Alternative plugin with configurable exports. Lets you toggle exactly what data to expose.
Important: These plugins are mutually exclusive. Only install one of them - do not install both on the same server.
O que é One Query?
These plugins enable server status queries using UDP. They share your game server port, so no additional ports or firewall configuration is needed. This allows Hylist to fetch real-time data about your server, including:
- Contagem atual de jogadores e máximo de jogadores
- Lista de jogadores online com seus nomes e UUIDs
- Versão do servidor e MOTD
- Lista de plugins instalados
Passo 1: Instalar o Plugin
Download and install either One Query or Hyvote on your Hytale server:
- Baixe o JAR mais recente da página de releases do GitHub
- Coloque o arquivo JAR no diretório de plugins do seu servidor
- Reinicie seu servidor
Nenhuma configuração adicional necessária! O plugin funciona automaticamente usando a porta do seu servidor de jogo (5520).
Passo 2: Adicionar Porta de Consulta no Hylist
Configure sua porta de consulta no painel do Hylist:
- Vá para a página de edição do seu servidor no painel do Hylist
- Role até a seção "Portas de Consulta"
- Clique em "Adicionar Porta de Consulta"
- Digite a porta 5520 (ou a porta do seu servidor se for diferente)
- Opcionalmente selecione uma tag para associar esta porta a um modo de jogo
- Salve suas alterações
Múltiplos Modos de Jogo (Redes Proxy)
Se você executa múltiplos servidores backend, pode adicionar múltiplas portas de consulta - uma para cada modo de jogo:
Port 5520 -> No tag (Lobby) Port 5521 -> PvP Port 5522 -> Survival Cada servidor backend precisa de sua própria instância do plugin One Query. A tag ajuda os visitantes a entender a qual modo de jogo cada lista de jogadores pertence.
Verificando Sua Configuração
Após configurar tudo, verifique sua instalação:
- Certifique-se de que seu servidor está online com o plugin One Query em execução
- Aguarde alguns minutos para o Hylist consultar seu servidor
- Visite a página do seu servidor no Hylist
- Você deve ver contagem de jogadores, jogadores online, versão e informações de plugins
Se tudo estiver funcionando, você verá um distintivo verde "Online" e informações de jogadores em tempo real na página do seu servidor!
Solução de Problemas
Sem dados no Hylist?
- Verifique se o JAR do plugin One Query está na pasta de plugins
- Verifique os logs do servidor por erros do plugin
- Certifique-se de que o número da porta no Hylist corresponde à porta do servidor (padrão: 5520)
- Aguarde 5-10 minutos para o Hylist atualizar os dados do servidor
Contagem de jogadores ou informações erradas?
- Certifique-se de que a porta de consulta aponta para o servidor correto
- Se usar vários servidores, certifique-se de que cada um tem sua própria porta configurada
Why Server Query Matters for Your Listing
Adding server query to your Hytale server listing significantly improves your visibility and credibility on Hylist. Here's how real-time server data impacts your server's performance on the platform.
Higher Search Ranking
Servers with active query data appear higher in filtered searches. When players filter by "online only" or sort by player count, your server will only appear if query data is available. Without it, you're invisible to a significant portion of potential players.
Player Trust
Displaying real-time player counts and server status builds trust with potential players. A server showing "42 players online" is far more compelling than one with no data. Players are more likely to join and vote for servers they can verify are active.
Analytics Insights
Query data feeds into your server's analytics dashboard, showing player count trends over time. You can identify peak hours, track growth, and measure the impact of promotional campaigns or content updates.
Discord Integration
The Hylist Discord bot uses query data to display live player counts and server status in your Discord server. Without query configured, these stat channels will show limited information.