Docs | MineBuff

Ricompense voto (Votifier)

Quando qualcuno vota sulla tua scheda, MineBuff può avvisare subito il tuo server Minecraft così il plugin delle ricompense può dare oggetti, rank o chiavi.

Il giocatore vota Apre la pagina di voto di MineBuff e inserisce il suo nome Minecraft.
Notifichiamo il tuo server MineBuff si connette alla tua porta Votifier e consegna il voto.
Partono le ricompense NuVotifier / Classic Votifier / GAListener (o simili) gestisce la ricompensa.

Configuralo in quattro passaggi

Installa Votifier sul tuo server Minecraft
Usa Classic Votifier o NuVotifier. Apri la porta 8192 (o la porta scelta) nel firewall / pannello host così internet pubblico può raggiungerla.
Copia la chiave o il token
v1: incolla plugins/Votifier/rsa/public.key (o NuVotifier rsa/public.key). v2: copia un token da NuVotifier config.yml (spesso default).
Attivalo sulla tua scheda
Dashboard → modifica server → Votifier. Attiva l’inoltro, imposta host (lascia vuoto per usare l’IP Java), porta e protocollo, poi incolla chiave/token e salva.
Invia un voto di prova
Usa “Invia voto di prova” sullo stesso modulo. Se funziona, funzioneranno anche i voti reali.

Auto (consigliato)

Sceglie NuVotifier v2 quando sono disponibili challenge + token; altrimenti torna a v1 RSA.

v1 — Chiave RSA

Classic Votifier e NuVotifier RSA. Serve il contenuto del file della chiave pubblica.

v2 — Token

Token HMAC NuVotifier da config.yml. Veloce e semplice se usi già NuVotifier.

I plugin di ricompensa che filtrano per sito della lista dovrebbero consentire il nome servizio “MineBuff”. Se la consegna fallisce, il voto sul sito conta comunque — controlla firewall e credenziali.

Apri la dashboard Come aggiungere un server

API controllo voto

Chiedi “questo IP ha già votato per il mio server oggi?” Gratuita, pubblica, senza API key.

Questo non invia un voto

I giocatori votano ancora sulla pagina di voto di MineBuff. Questi URL leggono solo se esiste già un voto per oggi (UTC).

GET

Testo semplice

Ideale per plugin semplici — l’intera risposta è un solo carattere.

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

1: Ha già votato oggi
0: Non ha ancora votato (oppure server sconosciuto / non pubblicato)

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

GET

JSON

Stessa risposta, più quando ha votato e quanto manca al reset giornaliero.

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

Campo	Significato
`vote`	“1” o “0” (stringhe) — ha votato oggi oppure no.
`voted_at`	Orario UTC del voto di oggi, oppure null.
`reset_at_midnight`	Sempre true — la finestra giornaliera di controllo voto si resetta alle 00:00 UTC (i totali di classifica sono separati e si azzerano circa mensilmente).
`time_until_next_vote`	Secondi fino alla prossima mezzanotte UTC se ha già votato; altrimenti 0.

Esempio

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

Cosa mettere nell’URL

Nell’URL	Significato
`{slug}`	Lo slug del tuo server dall’URL della scheda (es. /servers/your-slug).
`{ip}`	L’indirizzo IP del giocatore. Lo hashiamo; un voto per server per IP per giorno UTC.

Funziona anche dai browser (CORS). I server sconosciuti restituiscono 0 in testo semplice, oppure HTTP 404 JSON con errore server_not_found.

Regole di voto

Una checklist breve così i tempi del tuo plugin coincidono con i nostri.

Puoi votare una volta per server per IP ogni giorno UTC (00:00 UTC). I totali dei voti di classifica vengono azzerati circa una volta al mese.
Un voto per server pubblicato per indirizzo IP per giorno UTC.
I voti richiedono un nome utente Minecraft nel modulo di MineBuff (necessario per Votifier).
L’API di controllo non crea mai un voto; riporta solo lo stato di oggi.

Aiuto

Problemi comuni quando le ricompense o l’API non si comportano come previsto.

Il voto di prova fallisce o non arriva nulla in-game

Verifica che la porta 8192 (o la tua porta) sia aperta a internet, che l’host sia un indirizzo raggiungibile e che chiave/token corrispondano esattamente ai file del plugin (senza spazi extra).

Quale protocollo dovrei scegliere?

Inizia con Auto. Usa v2 se hai solo un token NuVotifier. Usa v1 se hai solo la chiave pubblica RSA.

L’API restituisce sempre 0

Controlla che la scheda sia pubblicata, che lo slug sia esatto e che stai passando l’IP reale del giocatore (non 127.0.0.1 a meno che non abbia votato dalla stessa macchina).

Le consegne Votifier fallite annullano il voto?

No. Il voto su MineBuff conta comunque. Sistema la connettività e riprova il voto di prova dalla dashboard.

Posso inviare voti tramite l’API?

No. I voti si esprimono sulla pagina pubblica di voto. L'API è in sola lettura per verificare il voto di oggi.