Docs □ MineBuff

Recompensas de voto (Votifier)

Quando alguém vota em sua lista, MineBuff pode dizer o seu servidor Minecraft imediatamente para que o seu plugin recompensa pode dar itens, fileiras, ou chaves.

Votos do jogador Eles abrem sua página de voto MineBuff e digitam seu nome Minecraft.
Notificamos o seu servidor O MineBuff conecta-se à sua porta Votifier e entrega a votação.
Recompensa o fogo NuVotifier / Votifier clássico / GAListener (ou similar) lida com a recompensa.

Monta-o em quatro passos

Instalar Votificador no seu servidor Minecraft
Use Votificador Clássico ou NuVotificador. Abra a porta 8192 (ou sua porta escolhida) no painel firewall / host para que a internet pública possa alcançá-lo.
Copie sua chave ou token
v1: colar plugins/Votifier/rsa/public.key (ou NuVotifier rsa/public.key). v2: copiar um token de NuVotifier config.yml (frequentemente padrão).
Activa- o na tua lista
Painel → servidor de edição → Votificador. Ligue o encaminhamento, defina o host (deixar em branco para usar seu IP Java), porta e protocolo, então cole a chave/token e salve.
Enviar um voto de teste
Use “Enviar voto de teste” no mesmo formulário. Se isso resultar, os votos verdadeiros também o farão.

Auto (recomendado)

Escolhe NuVotifier v2 quando um desafio + token estão disponíveis; caso contrário, cai para v1 RSA.

v1 — Chave RSA

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

v2 — Token

NuVotifier HMAC token from config.yml. Rápido e simples se você já usar NuVotifier.

Plugins de recompensa que filtram por site de lista devem permitir o nome de serviço “MineBuff”. Se a entrega falhar, a votação do site ainda conta — verifique seu firewall e credenciais.

Abrir painel Como adicionar um servidor

Verificação de votos API

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

Isto não faz voto.

Os jogadores ainda votam na página de votação MineBuff. Estas URLs apenas lêem se uma votação já existe para hoje (UTC).

GET

Texto simples

Melhor para plugins simples — toda a resposta é um único personagem.

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

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

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

GET

JSON

Mesma resposta, mais quando votaram e quanto tempo até o reset diário.

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

Campo	Significado
`vote`	“1” ou “0” (cordas) — votados hoje ou não.
`voted_at`	Tempo UTC da votação de hoje, ou nulo.
`reset_at_midnight`	Sempre verdadeiro — a janela diária de verificação de votação reinicia-se às 00:00 UTC (os totais de classificação são separados e reiniciados aproximadamente mensalmente).
`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 no URL

No URL	Significado
`{slug}`	O slug do seu servidor a partir da URL de listagem (por exemplo /servidores/seu-slug).
`{ip}`	O endereço IP do jogador. Nós o temos; um voto por servidor por IP por dia UTC.

Funciona a partir de navegadores também (CORS). Servidores desconhecidos retornam 0 em texto simples, ou HTTP 404 JSON com erro server not found.

Regras de votação

Uma lista de verificação curta para que o seu tempo plugin coincide com o nosso.

Você pode votar uma vez por servidor por IP cada dia UTC (00:00 UTC). Os totais de votos são apagados uma vez por mês.
Um voto por servidor publicado por endereço IP por dia UTC.
Os votos precisam de um nome de utilizador Minecraft no formulário MineBuff (necessário para Votifier).
A API de verificação nunca cria uma votação; ela só relata o status de hoje.

Ajuda

Problemas comuns quando recompensas ou a API não se comportam.

Teste de votação falha ou nada chega no jogo

Confirme que a porta 8192 (ou sua porta) está aberta para a internet, o host corresponde a um endereço acessível, e a chave / token corresponde exatamente aos ficheiros de plugin (sem espaços extras).

Que protocolo devo escolher?

Comece pelo Auto. Use v2 se você tiver apenas um token NuVotifier. Use v1 se você só tem a chave pública RSA.

A API sempre devolve 0

Verifique a listagem é publicada, a lesma é exata, e você está passando o verdadeiro IP do jogador (não 127.0.0.1 a menos que eles votaram da mesma máquina).

As entregas de Votifiers falhadas cancelam a votação?

Não. O voto MineBuff ainda conta. Corrija a conectividade e tente o voto do teste do painel novamente.

Posso fazer votos através da API?

Não. Os votos são expressos na página de votação pública. A API é somente leitura para verificar a votação de hoje.