Navigace Seznam serverů Hledat Přidat server Premium O nás Docs
Účet Přihlásit se Registrace

Majitelé a tvůrci pluginů

Docs

Odměň hráče za hlas a zjisti, zda už dnes hlasovali — bez zbytečného žargonu.

Odměny za hlasy (Votifier)

Když někdo hlasuje u tvého záznamu, MineBuff může ihned říct tvému Minecraft serveru, aby reward plugin dal itemy, ranky nebo klíče.

  1. Hráč hlasuje Otevře hlasovací stránku MineBuff a zadá Minecraft jméno.
  2. Upozorníme tvůj server MineBuff se připojí na Votifier port a doručí hlas.
  3. Odměny se spustí NuVotifier / Classic Votifier / GAListener (nebo podobné) zpracuje odměnu.

Nastav to ve čtyřech krocích

  1. Nainstaluj Votifier na Minecraft server

    Použij Classic Votifier nebo NuVotifier. Otevři port 8192 (nebo zvolený port) ve firewallu / host panelu, aby na něj dosáhl veřejný internet.

  2. Zkopíruj klíč nebo token

    v1: vlož plugins/Votifier/rsa/public.key (nebo NuVotifier rsa/public.key). v2: zkopíruj token z NuVotifier config.yml (často default).

  3. Zapni to u záznamu

    Dashboard → upravit server → Votifier. Zapni přeposílání, nastav hostitele (nech prázdné pro Java IP), port a protokol, vlož klíč/token a ulož.

  4. Odesli testovací hlas

    Použij „Odeslat testovací hlas“ na stejném formuláři. Pokud to funguje, reálné hlasy taky.

Auto (doporučeno)

Zvolí NuVotifier v2, když je dostupný challenge + token; jinak spadne na v1 RSA.

v1 — RSA klíč

Classic Votifier a NuVotifier RSA. Potřebuje obsah souboru veřejného klíče.

v2 — Token

NuVotifier HMAC token z config.yml. Rychlé a jednoduché, pokud už NuVotifier používáš.

Reward pluginy, které filtrují podle list site, by měly povolit jméno služby „MineBuff“. Pokud doručení selže, hlas na webu stále platí — zkontroluj firewall a přihlašovací údaje.

Otevřít přehled Jak přidat server

API kontroly hlasů

Zeptej se „hlasovala už tato IP dnes pro můj server?“ Zdarma, veřejné, bez API klíče.

Toto neodešle hlas

Hráči stále hlasují na hlasovací stránce MineBuff. Tyto URL jen čtou, zda už dnes (UTC) hlas existuje.

GET

Prostý text

Nejlepší pro jednoduché pluginy — celá odpověď je jeden znak.

https://minebuff.com/api/vote/{slug}/{ip}
1
Dnes už hlasoval
0
Ještě nehlasoval (nebo neznámý / nepublikovaný server)
Příklad curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"
GET

JSON

Stejná odpověď plus kdy hlasoval a jak dlouho do denního resetu.

https://minebuff.com/api/vote/{slug}/{ip}/json
Pole Význam
vote „1“ nebo „0“ (řetězce) — hlasoval dnes, nebo ne.
voted_at UTC čas dnešního hlasu, nebo null.
reset_at_midnight Vždy true — denní okno kontroly hlasů se resetuje v 00:00 UTC (součty žebříčku jsou oddělené a resetují se zhruba měsíčně).
time_until_next_vote Sekundy do další půlnoci UTC, pokud už hlasoval; jinak 0.
Příklad 
{
  "vote": "1",
  "voted_at": "2026-09-12T14:32:01Z",
  "reset_at_midnight": true,
  "time_until_next_vote": 34199
}

Co dát do URL

V URL Význam
{slug} Slug tvého serveru z URL záznamu (např. /servers/your-slug).
{ip} IP adresa hráče. Hashujeme ji; jeden hlas na server a IP za UTC den.

Funguje i z prohlížečů (CORS). Neznámé servery vrátí 0 v plain textu, nebo HTTP 404 JSON s chybou server_not_found.

Pravidla hlasování

Krátký checklist, aby timing tvého pluginu seděl s naším.

Nápověda

Běžné zádrhely, když odměny nebo API nefungují.

Testovací hlas selže nebo nic nedorazí do hry

Potvrď, že port 8192 (nebo tvůj port) je otevřený do internetu, hostitel je dosažitelná adresa a klíč/token přesně sedí se soubory pluginu (bez mezer navíc).

Který protokol mám zvolit?

Začni s Auto. Použij v2, pokud máš jen NuVotifier token. Použij v1, pokud máš jen RSA veřejný klíč.

API vždy vrací 0

Zkontroluj, že je záznam publikovaný, slug je přesný a předáváš skutečnou IP hráče (ne 127.0.0.1, pokud nehlasovali ze stejného stroje).

Zruší neúspěšné doručení Votifier hlas?

Ne. Hlas na MineBuff stále platí. Oprav konektivitu a zkus znovu testovací hlas v dashboardu.

Mohu odesílat hlasy přes API?

Ne. Hlasy se odesílají na veřejné hlasovací stránce. API je jen pro čtení dnešního hlasu.