Plugin Oficial HyServers

HyServers Plugin

O plugin oficial de servidor Hytale para o HyServers.gg. Relatório automático de status, recompensas de voto, placar de líderes e mais - tudo sem complicação de configuração.

Tudo o que Você Precisa

Um plugin substitui várias ferramentas e simplifica a listagem do seu servidor.

Pings de Status Automáticos

O status do seu servidor é enviado ao HyServers a cada 5 minutos via HTTP. Além disso, o responder HyQuery integrado substitui completamente plugins de query independentes.

  • Substitui os plugins HyQuery e OneQuery
  • Pings HTTP + responder HyQuery UDP
  • Autenticado com HMAC-SHA256

Recompensas de Voto e Avaliação

Jogadores votam no HyServers.gg e seu servidor é notificado instantaneamente via TCP seguro. Execute comandos de recompensa automaticamente.

  • Notificações TCP instantâneas
  • Fila de recompensas offline (7 dias)
  • Anúncios de voto para todo o servidor
  • Comando /vote com link clicável

Escolha Suas Recompensas

Deixe jogadores escolherem sua recompensa ao votar. Configure as opções de recompensa pelo site ou no config do plugin.

  • Recompensas de itens com quantidade
  • Comandos personalizados (ranks, kits, moedas)
  • Cards de recompensa coloridos na página de voto
  • Dois modos de config: site ou plugin

Redes Multi-Servidor

Funciona com Numdrassl, Lineage e outras soluções de proxy Hytale. Instale no seu servidor hub e os votos são encaminhados para todos os backends.

  • Encaminhamento automático de votos
  • Execução de recompensa por backend
  • Autenticação por shared secret

Placar de Votos

Acompanhe os maiores votantes mensais e de todos os tempos. Donos de servidores podem ver os maiores votantes pelo painel.

  • Acompanhamento mensal e total
  • Card na barra lateral do painel
  • Futuro: comando /vote top no jogo

Seguro por Padrão

Toda comunicação é autenticada usando HMAC-SHA256 com um shared secret. Sem tokens de API para gerenciar ou rotacionar.

  • Assinaturas HMAC-SHA256
  • Proteção contra replay por timestamp
  • Sem credenciais em texto puro

Veja em Ação

Configure recompensas pelo seu painel e os jogadores escolhem na hora de votar.

Configuração de recompensas de voto na página de edição do servidor

Configure itens de recompensa e comandos personalizados pelo painel do seu servidor

Página de voto mostrando cards de seleção de recompensa

Jogadores escolhem sua recompensa ao votar

Início Rápido

Configure e comece a usar em menos de 5 minutos.

Passo 1

Baixe o Plugin

Baixe o HyServersPlugin.jar e coloque na pasta mods/ do seu servidor.

Passo 2

Reinicie Seu Servidor

Um arquivo de config será criado em mods/HyServers/HyServersPlugin.json.

Passo 3

Configure no HyServers.gg

Vá até a página de edição do seu servidor, abra a seção de Votação e ative o HyServers Plugin. Copie o trecho de config.

Passo 4

Reinicie e Publique

Cole o config, defina o tipo de query como "HyServers Plugin" e reinicie. Pronto!

Configuração

Exemplo completo de config com todas as opções disponíveis.

mods/HyServers/HyServersPlugin.json
{
  "ServerId": "your-server-uuid-from-hyservers-gg",
  "ApiBaseUrl": "https://hyservers.gg",
  "StatusPingEnabled": true,
  "HyQueryEnabled": true,
  "HyQueryPort": 5520,
  "ServerName": "My Server",
  "ServerPort": 5520,
  "MaxPlayers": 100,
  "ServerMotd": "A Hytale Server",
  "ServerVersion": "1.0",
  "ListenPort": 5520,
  "SharedSecret": "your-shared-secret-from-hyservers-gg",
  "VoteUrl": "https://hyservers.gg/servers/your-server/vote",
  "VoteCommands": [
    "give {player} Rock_Gem_Diamond 5",
    "msg {player} Thanks for voting!"
  ],
  "ReviewCommands": [
    "give {player} Rock_Gem_Emerald 10"
  ],
  "BroadcastVotes": true,
  "BroadcastMessage": "{player} just voted! Use /vote to support the server!"
}

ServerIdO UUID do seu servidor no HyServers.gg (encontrado na sua página de edição).

SharedSecretGerado na página de edição do seu servidor. Deve ser igual em ambos os lados.

HyQueryEnabledAtiva o responder HyQuery UDP integrado (substitui o plugin HyQuery independente).

StatusPingEnabledEnvia o status do servidor para o HyServers.gg a cada 5 minutos via HTTP.

VoteCommandsComandos executados quando um jogador vota. {player} é substituído.

VoteBroadcastMensagem transmitida para todos os jogadores quando alguém vota.

Pronto para Começar?

Baixe o plugin, configure seu servidor e comece a receber votos e pings de status em minutos.