Docs MineBuff

Stemmebelønninger (Votifier)

Når noen stemmer på oppføringen din, kan MineBuff fortelle serveren din umiddelbart slik at belønningstillegget kan gi elementer, ranger eller nøkler.

Spiller stemmer De åpner stemmesiden din på MineBuff og skriver inn Minecraft-navnet sitt.
Vi varsler serveren din MineBuff forbinder seg til Votifier havnen og gir stemmen.
Belønner brann NuVotifier / Klassisk Votifier / GAListener (eller lignende) håndterer belønningen.

Sett den opp i fire trinn

Installer Votifier på din Minecraft server
Bruk klassisk Votifier eller NuVotifier. Åpne port 8192 (eller din valgte port) i brannmuren / vertspanelet slik at det offentlige Internett kan nå det.
Kopier nøkkelen eller token
v1: lim inn plugins/Votifier/rsa/public.key (eller NuVotifier rsa/public.key). v2: kopiere et symbol fra NuVotifier config.yml (ofte standard).
Aktiver det på oppføringen
Dashboard → rediger server → Votifier. Slå på videresending, angi vert (lat tom for å bruke Java], port og protokoll, og lim deretter inn tasten/token og lagre.
Send en prøveavstemning
Bruk \"Send test voice\" på samme form. Hvis det virker, vil ekte stemmer også.

Auto (anbefalt)

Velger NuVotifier v2 når en utfordring + token er tilgjengelig; ellers faller tilbake til v1 RSA.

v1 — RSA-nøkkel

Klassisk Votifier og NuVotifier RSA. Trenger offentlig nøkkelfilinnhold.

v2 — Token

NuVotifier HMAC-token fra config.yml. Rask og enkel hvis du allerede bruker NuVotifier.

Reward-plugins som filtrerer etter listeområde bør tillate tjenestenavnet «MineBuff». Hvis levering mislykkes, teller nettstedet fortsatt - sjekk brannmur og legitimasjon.

Åpne dashboard Hvordan legge til en server

API

Spør \"Har dette IP allerede stemt på min server i dag?\" Fri, offentlig, ingen API nøkkel.

Dette gir ingen stemme

Spillerne stemmer fortsatt på MineBuff stemmesiden. Disse URL-ene leser kun om det allerede eksisterer en stemme for i dag (UTC).

GET

Klartekst

Best for enkle plugins - hele svaret er en enkelt karakter.

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

1: Har allerede stemt i dag
0: Ikke stemt enda (eller ukjent / upublisert server)

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

GET

JSON

Samme svar, i tillegg til når de stemte og hvor lenge til den daglige tilbakestillingen.

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

Felt	Betydning
`vote`	\"1\" eller \"0\" (strenger) - stemte i dag eller ikke.
`voted_at`	UTC Tid for dagens stemme, eller null.
`reset_at_midnight`	Alltid sant — det daglige stemmesjekk-vinduet tilbakestilles til 00:00 UTC (rangering totalt er separat og tilbakestilles om måneden).
`time_until_next_vote`	Sekunder til neste midnatt hvis de allerede stemte, ellers 0.

Eksempel

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

Hva å legge i URLen

I URLen	Betydning
`{slug}`	Serverens slim fra oppføringsadressen (f.eks. /servere/din-slug).
`{ip}`	Spillerens adresse. Vi haster det; én stemme per server per IP per UTC dag.

Fungerer også fra nettlesere (CORS). Ukjente servere returnerer 0 i vanlig tekst, eller [HTTP 404 JSON med feilserver not found.

Stemmeregler

En kort sjekkliste, slik at din plugin-tid samsvarer med vår.

Du kan stemme én gang per server per IP hver UTC dag (00:00 UTC]. Rangering av stemmer er slettet omtrent én gang i måneden.
En stemme per publisert server per IP adresse per UTC dag.
Stemmer krever et Minecraft-brukernavn på MineBuff-skjemaet (påkrevd for Votifier).
Sjekkingen skaper aldri en stemme; den rapporterer bare dagens status.

Hjelp

Vanlige slanker når belønninger eller API ikke oppfører seg.

Testavstemning mislykkes eller ingenting kommer i spillet

Bekreft port 8192 (eller porten din) er åpen for Internett, verten matcher en tilgjengelig adresse, og nøkkelen/token matcher plugin-filene nøyaktig (ingen ekstra mellomrom).

Hvilken protokoll bør jeg velge?

Start med Auto. Bruk v2 hvis du bare har et tegn. Bruk v1 hvis du bare har RSA offentlige nøkkelen.

API gir alltid 0

Sjekk listen er publisert, slim er nøyaktig, og du passerer spillerens ekte IP (ikke 177.0.0.1 med mindre de stemte fra samme maskin).

Er det feil Votifier å avlyse avstemningen?

Nei. Stemmen på MineBuff teller fortsatt. Fiks tilkoblingen og prøv dashboard-teststemmen på nytt.

Kan jeg stemme gjennom API?

Nei. Stemningene spilles på den offentlige stemmesiden. API er skrivebeskyttet for å sjekke dagens stemme.