Plugin Oficial Minecraft Server Hub

Minecraft Server Hub Plugin

O plugin oficial de servidor Minecraft para o Minecraft Server Hub.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 Minecraft Server Hub 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 Minecraft Server Hub.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 Minecraft. 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 Minecraft Server HubPlugin.jar e coloque na pasta mods/ do seu servidor.

Passo 2

Reinicie Seu Servidor

Um arquivo de config será criado em mods/Minecraft Server Hub/Minecraft Server HubPlugin.json.

Passo 3

Configure no Minecraft Server Hub.gg

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

Passo 4

Reinicie e Publique

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

Configuração

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

mods/MinecraftServerHub/MinecraftServerHubPlugin.json
{
  "ServerId": "your-server-uuid-from-minecraft-server-hub",
  "ApiBaseUrl": "https://minecraftserverhub.com",
  "StatusPingEnabled": true,
  "HyQueryEnabled": true,
  "HyQueryPort": 5520,
  "ServerName": "My Server",
  "ServerPort": 5520,
  "MaxPlayers": 100,
  "ServerMotd": "A Minecraft Server",
  "ServerVersion": "1.0",
  "ListenPort": 5520,
  "SharedSecret": "your-shared-secret-from-minecraft-server-hub",
  "VoteUrl": "https://minecraftserverhub.com/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 Minecraft Server Hub.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 Minecraft Server Hub.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.