Docs | MineBuff

Recompensas de voto (Votifier)

Quando alguém vota no seu anúncio, o MineBuff pode avisar seu servidor de Minecraft na hora para o plugin de recompensa dar itens, ranks ou keys.

O jogador vota Eles abrem sua página de voto no MineBuff e digitam o nick do Minecraft.
Avisamos seu servidor O MineBuff conecta à porta do Votifier e entrega o voto.
As recompensas disparam NuVotifier / Classic Votifier / GAListener (ou similar) cuida da recompensa.

Configure em quatro passos

Instale o Votifier no seu servidor de Minecraft
Use Classic Votifier ou NuVotifier. Abra a porta 8192 (ou a que escolher) no firewall / painel do host para a internet pública alcançar.
Copie sua chave ou token
v1: cole plugins/Votifier/rsa/public.key (ou NuVotifier rsa/public.key). v2: copie um token do NuVotifier config.yml (geralmente default).
Ative no seu anúncio
Painel → editar servidor → Votifier. Ative o encaminhamento, defina host (deixe em branco para usar o IP Java), porta e protocolo, cole a chave/token e salve.
Envie um voto de teste
Use “Enviar voto de teste” no mesmo formulário. Se funcionar, votos reais também funcionam.

Auto (recomendado)

Escolhe NuVotifier v2 quando há challenge + token; caso contrário, usa v1 RSA.

v1 — chave RSA

Classic Votifier e NuVotifier RSA. Precisa do conteúdo do arquivo de chave pública.

v2 — Token

Token HMAC do NuVotifier em config.yml. Rápido e simples se você já usa NuVotifier.

Plugins de recompensa que filtram por site de lista devem permitir o nome de serviço “MineBuff”. Se a entrega falhar, o voto no site ainda conta — confira firewall e credenciais.

Abrir painel Como adicionar um servidor

API de verificação de voto

Pergunte “este IP já votou no meu servidor hoje?” Grátis, público, sem chave de API.

Isso não registra um voto

Os jogadores ainda votam na página de voto do MineBuff. Estas URLs só leem se já existe um voto hoje (UTC).

GET

Texto simples

Ideal para plugins simples — a resposta inteira é um único caractere.

https://minebuff.com/api/vote/{slug}/{ip}

1: Já votou hoje
0: Ainda não votou (ou servidor desconhecido / não publicado)

Exemplo curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"

GET

JSON

A mesma resposta, mais quando votaram e quanto falta para o reset diário.

https://minebuff.com/api/vote/{slug}/{ip}/json

Campo	Significado
`vote`	“1” ou “0” (strings) — votou hoje ou não.
`voted_at`	Horário UTC do voto de hoje, ou null.
`reset_at_midnight`	Sempre true — a janela diária de verificação de voto reinicia às 00:00 UTC (totais do ranking são separados e zeram cerca de uma vez por mês).
`time_until_next_vote`	Segundos até a próxima meia-noite UTC se já votaram; caso contrário, 0.

Exemplo

{
  "vote": "1",
  "voted_at": "2026-09-12T14:32:01Z",
  "reset_at_midnight": true,
  "time_until_next_vote": 34199
}

O que colocar na URL

Na URL	Significado
`{slug}`	O slug do seu servidor na URL do anúncio (ex.: /servers/seu-slug).
`{ip}`	O IP do jogador. Fazemos hash; um voto por servidor por IP por dia UTC.

Funciona também em navegadores (CORS). Servidores desconhecidos retornam 0 em texto simples, ou JSON HTTP 404 com erro server_not_found.

Regras de voto

Um checklist curto para o timing do seu plugin bater com o nosso.

Você pode votar uma vez por servidor por IP a cada dia UTC (00:00 UTC). Os totais do ranking são zerados cerca de uma vez por mês.
Um voto por servidor publicado por endereço IP por dia UTC.
Os votos precisam de um nick de Minecraft no formulário do MineBuff (obrigatório para Votifier).
A API de verificação nunca cria um voto; só informa o status de hoje.

Ajuda

Problemas comuns quando as recompensas ou a API não funcionam.

O voto de teste falha ou nada chega no jogo

Confirme que a porta 8192 (ou a sua) está aberta para a internet, o host é um endereço alcançável e a chave/token bate exatamente com os arquivos do plugin (sem espaços extras).

Qual protocolo devo escolher?

Comece com Auto. Use v2 se só tiver um token NuVotifier. Use v1 se só tiver a chave pública RSA.

A API sempre retorna 0

Confira se o anúncio está publicado, o slug está exato e você está passando o IP real do jogador (não 127.0.0.1, a menos que tenha votado na mesma máquina).

Entregas falhas do Votifier cancelam o voto?

Não. O voto no MineBuff ainda conta. Corrija a conectividade e tente o voto de teste no painel de novo.

Posso registrar votos pela API?

Não. Os votos são feitos na página pública de voto. A API é somente leitura para verificar o voto de hoje.