Docs | MineBuff

Stembeloningen (Votifier)

Wanneer iemand op je vermelding stemt, kan MineBuff je Minecraft-server meteen informeren zodat je beloningsplugin items, rangen of keys geeft.

Speler stemt Ze openen je MineBuff-stempagina en voeren hun Minecraft-naam in.
Wij informeren je server MineBuff verbindt met je Votifier-poort en levert de stem af.
Beloningen gaan af NuVotifier / Classic Votifier / GAListener (of vergelijkbaar) handelt de beloning af.

Stel het in vier stappen in

Installeer Votifier op je Minecraft-server
Gebruik Classic Votifier of NuVotifier. Open poort 8192 (of je gekozen poort) in de firewall / hostpanel zodat het openbare internet hem bereikt.
Kopieer je sleutel of token
v1: plak plugins/Votifier/rsa/public.key (of NuVotifier rsa/public.key). v2: kopieer een token uit NuVotifier config.yml (vaak default).
Schakel het in op je vermelding
Dashboard → server bewerken → Votifier. Zet doorsturen aan, vul host in (laat leeg voor je Java-IP), poort en protocol, plak sleutel/token en sla op.
Stuur een teststem
Gebruik “Teststem versturen” op hetzelfde formulier. Als dat werkt, doen echte stemmen dat ook.

Auto (aanbevolen)

Kiest NuVotifier v2 wanneer challenge + token beschikbaar zijn; valt anders terug op v1 RSA.

v1 — RSA-sleutel

Classic Votifier en NuVotifier RSA. Heeft de inhoud van het publieke-sleutelbestand nodig.

v2 — Token

NuVotifier HMAC-token uit config.yml. Snel en eenvoudig als je al NuVotifier gebruikt.

Beloningsplugins die filteren op listsitenaam moeten de servicenaam “MineBuff” toestaan. Als aflevering mislukt, telt de sitestem nog steeds — check je firewall en credentials.

Dashboard openen Hoe voeg je een server toe

Vote-check-API

Vraag “heeft dit IP vandaag al op mijn server gestemd?” Gratis, openbaar, geen API-sleutel.

Dit brengt geen stem uit

Spelers stemmen nog steeds op de MineBuff-stempagina. Deze URL’s lezen alleen of er vandaag (UTC) al een stem bestaat.

GET

Platte tekst

Het beste voor eenvoudige plugins — het hele antwoord is één teken.

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

1: Vandaag al gestemd
0: Nog niet gestemd (of onbekende / ongepubliceerde server)

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

GET

JSON

Hetzelfde antwoord, plus wanneer ze stemden en hoe lang tot de dagelijkse reset.

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

Veld	Betekenis
`vote`	“1” of “0” (strings) — vandaag gestemd of niet.
`voted_at`	UTC-tijd van de stem van vandaag, of null.
`reset_at_midnight`	Altijd true — het dagelijkse vote-checkvenster reset om 00:00 UTC (rankingtotalen zijn apart en resetten ongeveer maandelijks).
`time_until_next_vote`	Seconden tot volgende middernacht UTC als ze al gestemd hebben; anders 0.

Voorbeeld

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

Wat je in de URL zet

In de URL	Betekenis
`{slug}`	De slug van je server uit de vermeldings-URL (bijv. /servers/your-slug).
`{ip}`	Het IP-adres van de speler. Wij hashen het; één stem per server per IP per UTC-dag.

Werkt ook vanuit browsers (CORS). Onbekende servers geven 0 in platte tekst, of HTTP 404 JSON met error server_not_found.

Stemregels

Een korte checklist zodat de timing van je plugin bij de onze past.

Je mag één keer per server per IP per UTC-dag stemmen (00:00 UTC). Rankingstemtotalen worden ongeveer eens per maand gewist.
Eén stem per gepubliceerde server per IP-adres per UTC-dag.
Stemmen vereisen een Minecraft-gebruikersnaam op het MineBuff-formulier (vereist voor Votifier).
De check-API maakt nooit een stem aan; hij rapporteert alleen de status van vandaag.

Help

Veelvoorkomende problemen als beloningen of de API niet meewerken.

Teststem mislukt of er komt niets in-game aan

Controleer of poort 8192 (of jouw poort) open staat naar het internet, de host een bereikbaar adres is, en sleutel/token exact overeenkomen met de pluginbestanden (geen extra spaties).

Welk protocol moet ik kiezen?

Begin met Auto. Gebruik v2 als je alleen een NuVotifier-token hebt. Gebruik v1 als je alleen de RSA publieke sleutel hebt.

De API geeft altijd 0 terug

Check of de vermelding gepubliceerd is, de slug exact klopt, en je het echte IP van de speler doorgeeft (niet 127.0.0.1 tenzij ze vanaf dezelfde machine stemden).

Annuleren mislukte Votifier-afleveringen de stem?

Nee. De MineBuff-stem telt nog steeds. Fix connectiviteit en probeer de dashboard-teststem opnieuw.

Kan ik via de API stemmen uitbrengen?

Nee. Stemmen worden uitgebracht op de openbare stempagina. De API is alleen-lezen om de stem van vandaag te checken.