Jak nastavit odměny za hlasování (Votifier, VotingPlugin a další)

Každý odměňovací plugin od tebe potřebuje dvě věci: způsob, jak zjistit, že někdo hlasoval, a co má spustit, když se to stane. Projdeme si obojí - doprovodný plugin tohoto webu, Votifier pro okamžité doručení, a co dělat, pokud už používáš VotingPlugin, SuperVotes nebo jiný odměňovací plugin.

Možnost A: plugin VoxelRank (doporučeno)

Doprovodný plugin komunikuje přímo s API tohoto webu. Votifier není potřeba - funguje tak, že v pravidelném intervalu zjišťuje nevyzvednuté hlasy, takže funguje i za NAT a dožene vše, co se propáslo, když byl server vypnutý. Votifier je k dispozici také, jako volitelné doplnění pro okamžité doručení (viz Možnost B).

1. Stáhni si jar ze svého Dashboardu (karta tvého serveru má tlačítko Download, jakmile existuje sestavení), nebo přímo z /download/plugin.
2. Vlož ho do plugins/ a jednou spusť server. Tím se vygeneruje plugins/VotingSite/config.yml.
3. Otevři stránku Upravit svého serveru → záložku Odměny a hlasování a zkopíruj zobrazený API klíč.
4. Vlož ho do site.api-key v config.yml (zkontroluj, že site.url ukazuje na tento web), pak spusť /votingsite reload.
5. Rozhodni, jak k tobě mají hlasy doputovat - nastav mode v config.yml:
   • poll (výchozí) - plugin si sám stahuje nevyzvednuté hlasy. Nic dalšího instalovat netřeba.
   • votifier - web pošle každý hlas v okamžiku, kdy je odevzdán. Vyžaduje NuVotifier nebo jiný Votifier listener (Možnost B níže).
   • both - Votifier push spolu s dotazováním jako záložka, hlasy se nezdvojují podle jejich id.
6. Vyplň rewards.commands (a pokud chceš, i milestones a vote-party) příkazy pro konzoli, které se mají spustit při hlasování.
7. Otestuj to: /votingsite testvote <hráč> nasimuluje hlas bez čekání na skutečný. /votingsite status ukáže režim, zda je API klíč přijímán a kolik hlasů už bylo doručeno.

Hráči získají odkaz na hlasování a svůj počet hlasů příkazem /voxelrank vote - ne /vote, který si tento plugin schválně nikdy nenárokuje (dva pluginy soupeřící o stejný příkaz jsou přesně způsob, jak odměna tiše přestane fungovat - viz vlastní poznámka v config.yml).

Možnost B: okamžité doručení přes NuVotifier

Tuto část přeskoč, pokud ti režim poll funguje dostatečně dobře - není povinný. Přidej ji, pokud ti záleží na těch pár minutách zpoždění dotazování, nebo pokud chceš raději provozovat samostatný odměňovací plugin místo pluginu tohoto webu.

NuVotifier je aktivně udržovaný fork původního Votifieru - původní projekt je dnes v podstatě neudržovaný, takže "instalace Votifieru" v praxi znamená NuVotifier (nebo kompatibilní fork jako VotifierPlus).

1. Vlož jar NuVotifieru do plugins/ a restartuj server. Na serveru typu Bukkit/Spigot/Paper si kvůli zpětné kompatibilitě ponechává klasický název složky plugins/Votifier/ - je to vlastní složka NuVotifieru, ne pozůstatek starého pluginu - a při prvním spuštění v ní vygeneruje config.yml a pár klíčů ve složce rsa/.
2. Přihlašovací údaje najdeš v plugins/Votifier/config.yml: v2 token (doporučeno) se automaticky vygeneruje pod klíčem default v sekci tokens: - zkopíruj ho tak, jak je. Pokud chceš raději starší metodu, v1 veřejný klíč je v plugins/Votifier/rsa/public.key; odpovídající private.key nech ve stejné složce na serveru a nikdy ho nikam nesdílej.
3. Zkontroluj port, na kterém NuVotifier poslouchá (výchozí 8192), a ověř, že je otevřený ve firewallu nebo v panelu hostingu - je to jiný port než běžný port Minecraftu a většina hostingů ho automaticky neotevírá.
4. Na stránce Upravit svého serveru → záložka Odměny a hlasování vyplň host Votifieru (adresu tvého serveru) a ten port, pak vlož v2 token nebo v1 klíč z kroku 2. Pokud vyplníš oboje, použije se jen jedno - v2 má přednost.
5. Klikni přímo na záložce na Odeslat testovací hlas. Odešle skutečný Votifier paket na host/port/klíč/token, které jsou právě ve formuláři - nic se nejdřív nemusí ukládat - a rovnou zobrazí, jestli ho NuVotifier přijal. Pokud selže, vlastní konzolový log NuVotifieru (debug: true je výchozí) ukáže, jestli spojení vůbec dorazilo k pluginu, což rychle odliší "špatný klíč" od "zablokovaného portu".
6. Ulož a odevzdej skutečný hlas - ověř, že odměna dorazí hned, ne až při dalším dotazování.

Pod kapotou tento web posílá standardní handshake VOTIFIER 2 s HMAC-podepsaným JSON payloadem, pokud je nastaven v2 token, a jinak spadne zpátky na klasický RSA šifrovaný v1 blok - stejný protokol, jaký už mluví jakýkoli Votifier-kompatibilní listener, nic specifického pro tento web.

Už používáš VotingPlugin?

Pokud tvůj server už běží na VotingPlugin, náš plugin instalovat nemusíš - a nemusíš tento web ani ručně přidávat do VotingPluginu, protože pro něj existuje udržované přednastavení.

Spusť ve hře jako operátor (nebo s oprávněním VotingPlugin.Commands.AdminVote.VotePresets):

/av VotePresets

VotingPlugin stáhne aktuální seznam přednastavení z vlastního repozitáře VotingPlugin-Presets, necháš si jedno vybrat - VoxelRank mezi nimi je - a pak se zeptá na hodnoty, které dané přednastavení potřebuje: zobrazované jméno, adresu pro hlasování tvého inzerátu, prodlevu mezi hlasy a podobně. Nebo rovnou přeskoč na vlastní odkaz pro hlasování:

/av VotePresets https://voxelrank.com/server/tvuj-slug/vote

Včetně https:// - VotingPlugin podle domény sám najde odpovídající přednastavení, místo abys ho hledal v seznamu.

Tak či onak zapíše nebo aktualizuje odpovídající záznam pod VoteSites: v VoteSites.yml - ServiceSite, VoteURL, rozumné výchozí prodlevy a základní zobrazovací předmět nebo poděkování, pokud je web ještě nemá - a rovnou hlasovací weby znovu načte. Cokoliv dalšího v souboru nechá beze změny. Pokud upravuješ zavedené nastavení, ne čerstvě přidávaný web, nejdřív si VoteSites.yml zálohuj, a než odměnu nabídneš hráčům, zkontroluj, co se zapsalo - hlavně odměny, protože přednastavení je výchozí bod, ne hotová konfigurace.

VotingPlugin pořád potřebuje vlastní Votifier připojení, aby hlasy skutečně přijímal - nasměruj ho na stejné nastavení NuVotifieru z Možnosti B výše. Zároveň potřebuje, aby se server dostal na GitHub (raw.githubusercontent.com) - jinak přednastavení vůbec nestáhne; pokud /av VotePresets hlásí, že žádná přednastavení nejsou k dispozici, jde o problém se sítí nebo firewallem na serveru, ne o chybějící přednastavení. Jako záloha pořád funguje /av gui, nebo přímá úprava VoteSites.yml - ServiceSite musí znít přesně VoxelRank.com, což ověříš příkazem /av servicesites po skutečném nebo administrátorském testovacím hlasu.

Další odměňovací pluginy

Provozuješ něco menšího než VotingPlugin? SuperVotes a SuperbVote jsou oba odlehčené Votifier listenery s vlastním systémem vote party a odměňovacích příkazů. Ani jeden nesleduje přednastavení jednotlivých webů tak jako VotingPlugin - nasměruj kterýkoli z nich na stejný Votifier host, port a v2 token (nebo v1 klíč) ze záložky Odměny a hlasování výše a nastav jeho odměny stejně jako u jakéhokoli jiného hlasování.

Řešení problémů

• Na /votingsite testvote se nic neděje. Nejdřív zkontroluj /votingsite status - pokud API klíč není přijímán, hlasy (skutečné i testovací) nemají kam jít. Zkopíruj ho znovu ze stránky Upravit a ověř, že za ním není mezera navíc.
• Votifier push nikdy nedorazí, ale dotazování funguje. Obvykle bývá blokovaný právě port Votifieru, ne API - většina hostingů má ve výchozím stavu otevřený odchozí HTTP, ale ne libovolný další příchozí port. mode: both (nebo provoz samostatného listeneru jiného odměňovacího pluginu) je rozumná trvalá záloha, místo aby ses s firewallem pral.
• Odměna se spustí, ale ve hře se nic neobjeví. Odměňovací příkazy běží na konzoli, takže příkaz, který funguje jen když ho napíše hráč (bez oprávnění, bez op), tiše selže. Nejdřív ho otestuj přesně tak, jak by běžel z konzole.
• VotingPlugin hlásí „invalid service site" nebo hlas nikdy nespáruje. Hodnota ServiceSite musí souhlasit znak po znaku (na velikosti písmen nezáleží). Ověř ji příkazem /av servicesites, místo abys ji odhadoval podle domény tohoto webu.
• /av VotePresets hlásí, že žádná přednastavení nejsou k dispozici, nebo adresa nikam nepasuje. Seznam přednastavení stahuje za běhu z GitHubu, takže za tím skoro vždy stojí síť samotného serveru - firewall, proxy, DNS nebo výpadek GitHubu - která blokuje raw.githubusercontent.com, ne že by VoxelRank ze seznamu zmizel. Shoda podle adresy navíc potřebuje celou adresu včetně https://; holé názvy domén nerozpozná.
• Nastavení na záložce Odměny a hlasování se jako by neukládala. Platí jen pro potvrzený (claimed) inzerát - viz filtr Claimed v seznamu serverů. Importovaný, nepotvrzený záznam ještě nemá vlastníka, který by mu mohl odměny nastavit; nejdřív si ho potvrď.

Rychlé odpovědi

Potřebuju Votifier vůbec?

Ne. Režim poll (výchozí pro plugin VoxelRank) funguje bez čehokoli dalšího nainstalovaného - Votifier jen zkracuje prodlevu mezi hlasem a odměnou, a je to jediná cesta dovnitř, pokud chceš místo něj provozovat VotingPlugin, SuperVotes nebo SuperbVote.

Můžu používat náš plugin a VotingPlugin zároveň?

Ne pro stejnou odměnu - vyber si jeden, který má odměňovací příkazy skutečně spouštět, jinak se hlas může vyplatit dvakrát. Samotný Votifier umí upozornit víc než jeden listener, takže jde o pravidlo „nenastavuj stejnou odměnu dvakrát", ne o technické omezení.

Můj hosting mi nedovolí otevřít další port pro Votifier.

Použij režim poll s pluginem VoxelRank. Ten dělá jen odchozí požadavky, takže není co otevírat. VotingPlugin a podobné odměňovací pluginy obdobu poll režimu nemají - potřebují příchozí port pro Votifier.

Potřebuješ pomoc?

Zasekl ses u některého kroku výše, nebo něco neodpovídá tomu, co tvůj server doopravdy posílá? Kontaktuj nás - nejrychlejší cesty pro dotaz ohledně hlasů a odměn jsou uvedené přímo tam.