Docs | MineBuff

Röstbelöningar (Votifier)

När någon röstar på din listning kan MineBuff meddela din Minecraft-server direkt så att ditt belöningsplugin kan ge items, ranks eller keys.

Spelaren röstar De öppnar din MineBuff-röstsida och anger sitt Minecraft-namn.
Vi meddelar din server MineBuff ansluter till din Votifier-port och levererar rösten.
Belöningar utlöses NuVotifier / Classic Votifier / GAListener (eller liknande) hanterar belöningen.

Sätt upp det i fyra steg

Installera Votifier på din Minecraft-server
Använd Classic Votifier eller NuVotifier. Öppna port 8192 (eller din valda port) i brandväggen / hostpanelen så att det publika internetet når den.
Kopiera din nyckel eller token
v1: klistra in plugins/Votifier/rsa/public.key (eller NuVotifier rsa/public.key). v2: kopiera en token från NuVotifier config.yml (ofta default).
Aktivera det på din listning
Dashboard → redigera server → Votifier. Slå på vidarebefordran, ange host (lämna tomt för att använda din Java-IP), port och protokoll, klistra sedan in nyckel/token och spara.
Skicka en teströst
Använd ”Skicka teströst” i samma formulär. Om det fungerar gör riktiga röster det också.

Auto (rekommenderas)

Väljer NuVotifier v2 när en challenge + token finns; annars faller tillbaka till v1 RSA.

v1 — RSA-nyckel

Classic Votifier och NuVotifier RSA. Behöver den publika nyckelfilens innehåll.

v2 — Token

NuVotifier HMAC-token från config.yml. Snabbt och enkelt om du redan använder NuVotifier.

Belöningsplugins som filtrerar efter listningssajt bör tillåta tjänstnamnet ”MineBuff”. Om leveransen misslyckas räknas sajtrösten ändå — kolla brandvägg och uppgifter.

Öppna dashboard Hur du lägger till en server

Vote check API

Fråga ”har den här IP-adressen redan röstat på min server idag?” Gratis, publikt, ingen API-nyckel.

Detta lägger inte en röst

Spelare röstar fortfarande på röstsidan på MineBuff. Dessa URLer läser bara om en röst redan finns för idag (UTC).

GET

Ren text

Bäst för enkla plugins — hela svaret är ett enda tecken.

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

1: Har redan röstat idag
0: Har inte röstat ännu (eller okänd / opublicerad server)

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

GET

JSON

Samma svar, plus när de röstade och hur länge till den dagliga reseten.

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

Fält	Betydelse
`vote`	”1” eller ”0” (strängar) — röstat idag eller inte.
`voted_at`	UTC-tid för dagens röst, eller null.
`reset_at_midnight`	Alltid true — det dagliga röstkontrollfönstret nollställs kl. 00:00 UTC (rankningstotaler är separata och nollställs ungefär månadsvis).
`time_until_next_vote`	Sekunder till nästa UTC-midnatt om de redan röstat; annars 0.

Exempel

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

Vad du ska lägga i URLen

I URLen	Betydelse
`{slug}`	Din servers slug från listnings-URLen (t.ex. /servers/your-slug).
`{ip}`	Spelarens IP-adress. Vi hashar den; en röst per server per IP per UTC-dygn.

Fungerar från webbläsare också (CORS). Okända servrar returnerar 0 i ren text, eller HTTP 404 JSON med error server_not_found.

Röstregler

En kort checklista så att din plugin-timing matchar vår.

Du kan rösta en gång per server per IP varje UTC-dygn (00:00 UTC). Rankningsrösttotaler nollställs ungefär en gång i månaden.
En röst per publicerad server per IP-adress per UTC-dygn.
Röster kräver ett Minecraft-användarnamn i MineBuff-formuläret (krävs för Votifier).
Check-APIt skapar aldrig en röst; det rapporterar bara dagens status.

Hjälp

Vanliga problem när belöningar eller APIt inte beter sig.

Teströsten misslyckas eller inget kommer fram i spelet

Bekräfta att port 8192 (eller din port) är öppen mot internet, att hosten matchar en nåbar adress och att nyckel/token matchar plugin-filerna exakt (inga extra mellanslag).

Vilket protokoll ska jag välja?

Börja med Auto. Använd v2 om du bara har en NuVotifier-token. Använd v1 om du bara har RSA-publiknyckeln.

APIt returnerar alltid 0

Kontrollera att listningen är publicerad, att sluggen är exakt och att du skickar spelarens riktiga IP (inte 127.0.0.1 om de inte röstade från samma maskin).

Avbryter misslyckade Votifier-leveranser rösten?

Nej. MineBuff-rösten räknas ändå. Fixa anslutningen och prova dashboard-teströsten igen.

Kan jag lägga röster via APIt?

Nej. Röster läggs på den publika röstsidan. APIt är skrivskyddat för att kolla dagens röst.