Docs | MineBuff

Afstemning belønninger (Votifier)

Når nogen stemmer på din liste, kan MineBuff fortælle din Minecraft server med det samme, så din belønning plugin kan give elementer, rækker, eller nøgler.

Spillerstemmer De åbner din MineBuff stemme side og indtaste deres Minecraft navn.
Vi underretter din server MineBuff forbinder til din Votifier port og leverer afstemningen.
Belønning af brand NuVotifier / Classic Votifier / GAListener (eller lignende) håndterer belønningen.

Sæt det op i fire trin

Installer Votifier på din Minecraft-server
Brug Classic Votifier eller NuVotifier. Åbn port 8192 (eller din valgte port) i firewall / host panel, så det offentlige internet kan nå det.
Kopiér din nøgle eller token
v1: paste plugins / Votifier / rsa / public.key (eller NuVotifier rsa / public.key). v2: kopiere en token fra NuVotifier config.yml (ofte standard).
Aktivér det på din liste
Dashboard → rediger server → Votifier. Tænd videresendelse, sæt vært (lad blank for at bruge din Java IP), port og protokol, og indsæt derefter nøglen / token og gem.
Send en testafstemning
Brug "Send testafstemning" på samme formular. Hvis det virker, vil ægte stemmer også.

Auto (anbefales)

Picks NuVotifier v2 når en udfordring + token er tilgængelig; ellers falder tilbage til v1 RSA.

v1-RSA-nøgle

Classic Votifier og NuVotifier RSA. Har brug for den offentlige nøgle fil indhold.

v2-Token

NuVotifier HMAC token fra config.yml. Hurtig og enkel hvis du allerede bruger NuVotifier.

Belønningsplugins, der filtrerer efter listested, bør tillade servicenavnet "MineBuff". Hvis leveringen mislykkes, tæller afstemningen på webstedet stadig-tjek din firewall og legitimation.

Åben instrumentbræt Sådan tilføjes en server

Afstemning check API

Spørg "har denne IP allerede stemt på min server i dag?" Fri, offentlig, ingen API nøgle.

Afstemningen finder sted i næste afstemningstid.

Spillere stadig stemme på MineBuff stemme side. Disse URL 'er kan kun læses, om der allerede er en afstemning i dag (UTC).

GET

Almindelig tekst

Bedste for simple plugins-hele svaret er en enkelt karakter.

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

1: Allerede vedtaget i dag
0: Endnu ikke stemt (eller ukendt / ikke offentliggjort server)

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

GET

JSON

Samme svar, plus når de stemte og hvor længe indtil den daglige nulstilling.

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

Felt	Betydning
`vote`	"1" eller "0" (strenge)-stemte i dag eller ej.
`voted_at`	UTC tid af dagens afstemning, eller null.
`reset_at_midnight`	Altid sandt-det daglige valg-check vindue nulstilles kl 00: 00 UTC (ranking totaler er separate og nulstilles om måneden).
`time_until_next_vote`	Sekunder indtil næste UTC midnat, 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
}

Hvad skal du sætte i URL 'en

I URL 'en	Betydning
`{slug}`	Din servers kugle fra listen URL (fx / servere / your-slug).
`{ip}`	Spillerens IP adresse. Vi hash det; en stemme pr. server per IP per UTC dag.

Arbejder også fra browsere (CORS). Ukendt servere returnerer 0 i almindelig tekst, eller HTTP 404 JSON med fejlserver _ not _ found.

Afstemning

En kort tjekliste, så din plugin timing matcher vores.

Du kan stemme én gang pr. server per IP hver UTC dag (00: 00 UTC). De samlede stemmetal bliver udslettet en gang om måneden.
One vote per published server per IP adresse per UTC dag.
Afstemning skal bruge et Minecraft brugernavn på MineBuff formularen (kræves for Votifier).
Checken API skaber aldrig en afstemning; det kun rapporterer dagens status.

Hjælp

Fælles snags, når belønninger eller API ikke opfører sig.

Test afstemning mislykkes eller intet ankommer i-spil

Bekræft port 8192 (eller din port) er åben for internettet, værten matcher en tilgængelig adresse, og nøglen / token matcher plugin-filer nøjagtigt (ingen ekstra mellemrum).

Hvilken protokol skal jeg vælge?

Start med Auto. Brug v2 hvis du kun har en NuVotifier token. Brug v1, hvis du kun har RSA offentlige nøgle.

API giver altid 0

Tjek listen er offentliggjort, sneglen er præcis, og du passerer spillerens reelle IP (ikke 127.0.0.1 medmindre de stemte fra den samme maskine).

Har mislykkede Votifier leverancer annullere afstemningen?

Nej. MineBuff-afstemningen tæller stadig. Fix forbindelse og prøve instrumentbrættets testafstemning igen.

Kan jeg afgive stemmer gennem API?

Nej. Afstemningen finder sted på den offentlige afstemningsside. API er kun klar til at kontrollere dagens afstemning.