Docs | MineBuff

Nagrody za głosy (Votifier)

Gdy ktoś zagłosuje na Twój wpis, MineBuff może od razu powiadomić serwer Minecraft, żeby plugin nagród dał przedmioty, rangi lub klucze.

Gracz głosuje Otwiera stronę głosu MineBuff i wpisuje nick Minecraft.
Powiadamiamy Twój serwer MineBuff łączy się z portem Votifier i dostarcza głos.
Nagrody się odpalają NuVotifier / Classic Votifier / GAListener (lub podobny) obsługuje nagrodę.

Skonfiguruj w czterech krokach

Zainstaluj Votifier na serwerze Minecraft
Użyj Classic Votifier lub NuVotifier. Otwórz port 8192 (lub wybrany) w firewallu / panelu hosta, żeby internet mógł do niego dotrzeć.
Skopiuj klucz lub token
v1: wklej plugins/Votifier/rsa/public.key (lub NuVotifier rsa/public.key). v2: skopiuj token z NuVotifier config.yml (często default).
Włącz to na wpisie
Panel → edytuj serwer → Votifier. Włącz przekazywanie, ustaw host (puste = IP Java), port i protokół, wklej klucz/token i zapisz.
Wyślij testowy głos
Użyj „Wyślij testowy głos” w tym samym formularzu. Jeśli działa, prawdziwe głosy też będą.

Auto (zalecane)

Wybiera NuVotifier v2, gdy dostępne jest wyzwanie + token; w przeciwnym razie wraca do v1 RSA.

v1 — klucz RSA

Classic Votifier i NuVotifier RSA. Wymaga zawartości pliku klucza publicznego.

v2 — Token

Token HMAC NuVotifier z config.yml. Szybkie i proste, jeśli już używasz NuVotifier.

Pluginy nagród filtrujące po nazwie listy powinny zezwalać na nazwę usługi „MineBuff”. Jeśli dostawa się nie uda, głos na stronie i tak się liczy — sprawdź firewall i dane logowania.

Otwórz panel Jak dodać serwer

API sprawdzania głosów

Pytanie „czy to IP już dziś głosowało na mój serwer?”. Darmowe, publiczne, bez klucza API.

To nie oddaje głosu

Gracze nadal głosują na stronie głosu MineBuff. Te URL-e tylko odczytują, czy głos na dziś (UTC) już istnieje.

GET

Zwykły tekst

Najlepsze do prostych pluginów — cała odpowiedź to jeden znak.

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

1: Już głosowano dziś
0: Jeszcze nie głosowano (lub nieznany / nieopublikowany serwer)

Przykład curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"

GET

JSON

Ta sama odpowiedź, plus kiedy głosowano i ile do dziennego resetu.

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

Pole	Znaczenie
`vote`	„1” lub „0” (stringi) — czy głosowano dziś.
`voted_at`	Czas UTC dzisiejszego głosu albo null.
`reset_at_midnight`	Zawsze true — okno dziennego sprawdzania głosów resetuje się o 00:00 UTC (sumy rankingowe są osobne i resetują się mniej więcej miesięcznie).
`time_until_next_vote`	Sekundy do następnej północy UTC, jeśli już głosowano; w przeciwnym razie 0.

Przykład

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

Co wstawić w URL

W URL	Znaczenie
`{slug}`	Slug serwera z URL wpisu (np. /servers/your-slug).
`{ip}`	Adres IP gracza. Hashujemy go; jeden głos na serwer na IP na dzień UTC.

Działa też z przeglądarek (CORS). Nieznane serwery zwracają 0 w plain text albo HTTP 404 JSON z błędem server_not_found.

Zasady głosowania

Krótka checklista, żeby timing pluginu pasował do naszego.

Możesz głosować raz na serwer na IP każdego dnia UTC (00:00 UTC). Sumy głosów rankingowych są zerowane mniej więcej raz w miesiącu.
Jeden głos na opublikowany serwer na adres IP na dzień UTC.
Głosy wymagają nicku Minecraft w formularzu MineBuff (wymagane dla Votifier).
API sprawdzania nigdy nie tworzy głosu; tylko raportuje dzisiejszy status.

Pomoc

Częste problemy, gdy nagrody lub API nie działają jak trzeba.

Testowy głos nie działa albo nic nie przychodzi w grze

Upewnij się, że port 8192 (lub Twój) jest otwarty na internet, host to osiągalny adres, a klucz/token dokładnie pasuje do plików pluginu (bez zbędnych spacji).

Który protokół wybrać?

Zacznij od Auto. Użyj v2, jeśli masz tylko token NuVotifier. Użyj v1, jeśli masz tylko publiczny klucz RSA.

API zawsze zwraca 0

Sprawdź, czy wpis jest opublikowany, slug jest dokładny i przekazujesz prawdziwe IP gracza (nie 127.0.0.1, chyba że głosował z tej samej maszyny).

Czy nieudana dostawa Votifier anuluje głos?

Nie. Głos na MineBuff i tak się liczy. Napraw łączność i spróbuj ponownie testowego głosu w panelu.

Czy mogę oddawać głosy przez API?

Nie. Głosy oddaje się na publicznej stronie głosu. API jest tylko do odczytu dzisiejszego głosu.