Docs | MineBuff

Vote-Belohnungen (Votifier)

Wenn jemand auf deinem Eintrag abstimmt, kann MineBuff deinen Minecraft-Server sofort benachrichtigen, damit dein Reward-Plugin Items, Ränge oder Keys vergibt.

Spieler stimmt ab Er öffnet deine MineBuff-Vote-Seite und gibt seinen Minecraft-Namen ein.
Wir benachrichtigen deinen Server MineBuff verbindet sich mit deinem Votifier-Port und liefert die Stimme.
Belohnungen feuern NuVotifier / Classic Votifier / GAListener (oder Ähnliches) übernimmt die Belohnung.

In vier Schritten einrichten

Votifier auf deinem Minecraft-Server installieren
Nutze Classic Votifier oder NuVotifier. Öffne Port 8192 (oder deinen gewählten Port) in Firewall / Host-Panel, damit das öffentliche Internet ihn erreicht.
Schlüssel oder Token kopieren
v1: plugins/Votifier/rsa/public.key einfügen (oder NuVotifier rsa/public.key). v2: Token aus NuVotifier config.yml kopieren (oft default).
Auf deinem Eintrag aktivieren
Dashboard → Server bearbeiten → Votifier. Weiterleitung einschalten, Host setzen (leer lassen für Java-IP), Port und Protokoll, dann Schlüssel/Token einfügen und speichern.
Teststimme senden
Nutze „Teststimme senden“ im selben Formular. Wenn das funktioniert, funktionieren echte Stimmen auch.

Auto (empfohlen)

Wählt NuVotifier v2, wenn Challenge + Token verfügbar sind; sonst Fallback auf v1 RSA.

v1 — RSA-Schlüssel

Classic Votifier und NuVotifier RSA. Braucht den Inhalt der Public-Key-Datei.

v2 — Token

NuVotifier-HMAC-Token aus config.yml. Schnell und einfach, wenn du NuVotifier schon nutzt.

Reward-Plugins, die nach Listenseite filtern, sollten den Service-Namen „MineBuff“ erlauben. Schlägt die Zustellung fehl, zählt die Site-Stimme trotzdem — prüfe Firewall und Credentials.

Dashboard öffnen So fügst du einen Server hinzu

Vote-Check-API

Frage „Hat diese IP heute schon für meinen Server abgestimmt?“ Kostenlos, öffentlich, kein API-Key.

Das gibt keine Stimme ab

Spieler stimmen weiterhin auf der MineBuff-Vote-Seite ab. Diese URLs lesen nur, ob für heute (UTC) schon eine Stimme existiert.

GET

Klartext

Am besten für einfache Plugins — die ganze Antwort ist ein einzelnes Zeichen.

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

1: Heute bereits abgestimmt
0: Noch nicht abgestimmt (oder unbekannter / unveröffentlichter Server)

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

GET

JSON

Dieselbe Antwort, plus wann abgestimmt wurde und wie lange bis zum täglichen Reset.

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

Feld	Bedeutung
`vote`	„1“ oder „0“ (Strings) — heute abgestimmt oder nicht.
`voted_at`	UTC-Zeit der heutigen Stimme, oder null.
`reset_at_midnight`	Immer true — das tägliche Vote-Check-Fenster resettet um 00:00 UTC (Ranking-Summen sind getrennt und werden etwa monatlich zurückgesetzt).
`time_until_next_vote`	Sekunden bis zur nächsten UTC-Mitternacht, wenn bereits abgestimmt; sonst 0.

Beispiel

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

Was in die URL gehört

In der URL	Bedeutung
`{slug}`	Der Slug deines Servers aus der Listing-URL (z. B. /servers/dein-slug).
`{ip}`	Die IP-Adresse des Spielers. Wir hashen sie; eine Stimme pro Server und IP und UTC-Tag.

Funktioniert auch aus Browsern (CORS). Unbekannte Server geben 0 im Klartext zurück, oder HTTP 404 JSON mit error server_not_found.

Vote-Regeln

Eine kurze Checkliste, damit dein Plugin-Timing zu uns passt.

Du kannst einmal pro Server und IP und UTC-Tag abstimmen (00:00 UTC). Ranking-Stimmen-Summen werden etwa einmal im Monat gelöscht.
Eine Stimme pro veröffentlichtem Server und IP-Adresse und UTC-Tag.
Stimmen brauchen einen Minecraft-Benutzernamen im MineBuff-Formular (für Votifier erforderlich).
Die Check-API erstellt nie eine Stimme; sie meldet nur den heutigen Status.

Hilfe

Häufige Stolpersteine, wenn Belohnungen oder die API nicht passen.

Teststimme schlägt fehl oder kommt nichts ingame an

Bestätige, dass Port 8192 (oder dein Port) zum Internet offen ist, der Host eine erreichbare Adresse ist und Schlüssel/Token exakt zu den Plugin-Dateien passen (keine Extra-Leerzeichen).

Welches Protokoll soll ich wählen?

Starte mit Auto. Nutze v2, wenn du nur einen NuVotifier-Token hast. Nutze v1, wenn du nur den RSA-Public-Key hast.

Die API gibt immer 0 zurück

Prüfe, ob der Eintrag veröffentlicht ist, der Slug exakt ist und du die echte Spieler-IP übergibst (nicht 127.0.0.1, außer sie haben von derselben Maschine abgestimmt).

Brechen fehlgeschlagene Votifier-Zustellungen die Stimme ab?

Nein. Die MineBuff-Stimme zählt trotzdem. Fixe die Konnektivität und probiere die Dashboard-Teststimme erneut.

Kann ich Stimmen über die API abgeben?

Nein. Stimmen werden auf der öffentlichen Vote-Seite abgegeben. Die API ist nur lesend für den heutigen Vote-Status.