Zo stelt u stembeloningen in (Votifier, VotingPlugin en meer)

Elke beloningsplugin heeft twee dingen van u nodig: een manier om te weten dat er is gestemd, en iets om uit te voeren wanneer dat gebeurt. Dit artikel behandelt beide - de bijbehorende plugin die deze site aanbiedt, Votifier voor directe levering, en wat u moet doen als u al VotingPlugin, SuperVotes of een andere beloningsplugin gebruikt.

Optie A: de VoxelRank-plugin (aanbevolen)

De bijbehorende plugin communiceert rechtstreeks met de API van deze site. Votifier is niet vereist - de plugin vraagt met regelmatige tussenpozen niet-opgehaalde stemmen op, werkt dus ook achter NAT en haalt alles in wat is gemist terwijl de server offline was. Votifier is ook beschikbaar als optionele aanvulling voor directe levering (zie Optie B).

1. Download de jar via uw Dashboard (de kaart van uw server heeft een downloadknop zodra er een build bestaat), of rechtstreeks via /download/plugin.
2. Plaats hem in plugins/ en start de server één keer. Daardoor wordt plugins/VotingSite/config.yml aangemaakt.
3. Open de pagina Bewerken van uw server → tabblad Beloningen en stemmen en kopieer de daar getoonde API-sleutel.
4. Plak deze bij site.api-key in config.yml (controleer ook of site.url naar deze site wijst), en voer daarna /votingsite reload uit.
5. Bepaal hoe stemmen bij u terecht moeten komen door mode in config.yml in te stellen:
   • poll (standaard) - de plugin haalt zelf niet-opgehaalde stemmen op. Er hoeft verder niets geïnstalleerd te worden.
   • votifier - de site stuurt elke stem op het moment dat er wordt gestemd. Vereist NuVotifier of een andere Votifier-listener (Optie B hieronder).
   • both - Votifier-push met polling als vangnet, zonder dubbele stemmen dankzij het stem-id.
6. Vul rewards.commands in (en eventueel milestones en vote-party) met de consolecommando's die bij een stem moeten worden uitgevoerd.
7. Test het: /votingsite testvote <player> simuleert een stem zonder op een echte te wachten. /votingsite status toont de modus, of de API-sleutel wordt geaccepteerd en hoeveel stemmen er tot nu toe zijn afgeleverd.

Spelers krijgen hun stemlink en aantal stemmen via /voxelrank vote - niet via /vote, dat deze plugin bewust nooit claimt (twee plugins die om hetzelfde commando strijden is precies de manier waarop een beloning stilletjes stopt met werken - zie de bijbehorende opmerking in config.yml).

Optie B: directe levering met NuVotifier

Sla dit over als de poll-modus al goed genoeg voor u werkt - het is niet verplicht. Voeg het toe wanneer de paar minuten vertraging van het pollen ertoe doen, of wanneer u liever een aparte beloningsplugin gebruikt dan die van deze site.

NuVotifier is de actief onderhouden fork van de oorspronkelijke Votifier - het oorspronkelijke project wordt tegenwoordig vrijwel niet meer onderhouden, dus "Votifier installeren" betekent in de praktijk NuVotifier (of een compatibele fork zoals VotifierPlus).

1. Plaats de jar van NuVotifier in plugins/ en herstart de server. Op een Bukkit-/Spigot-/Paper-server behoudt hij vanwege achterwaartse compatibiliteit de klassieke mapnaam plugins/Votifier/ - dat is de eigen map van NuVotifier, geen restant van de oude plugin - en genereert daarin bij de eerste start een config.yml plus een sleutelpaar in rsa/.
2. Haal uw gegevens op uit plugins/Votifier/config.yml: het v2-token (aanbevolen) wordt automatisch gegenereerd onder de sleutel default in de sectie tokens: - kopieer het ongewijzigd. Geeft u de voorkeur aan de oudere methode, dan staat de v1-publieke sleutel in plugins/Votifier/rsa/public.key; bewaar de bijbehorende private.key in dezelfde map op de server en deel deze nooit.
3. Controleer de port waarop NuVotifier luistert (standaard 8192) en zorg dat deze openstaat in uw firewall of hostingpaneel - het is een andere poort dan de gewone Minecraft-poort, en de meeste hosts openen deze niet automatisch.
4. Vul op de pagina Bewerken van uw server → tabblad Beloningen en stemmen de Votifier-host (het adres van uw server) en die poort in, en plak vervolgens het v2-token of de v1-sleutel uit stap 2. Zijn beide ingevuld, dan wordt er maar één gebruikt - v2 heeft voorrang.
5. Klik direct in dat tabblad op Teststem verzenden. Dit stuurt een echt Votifier-pakket naar het host/poort/sleutel/token dat op dat moment in het formulier staat - er hoeft niets eerst te worden opgeslagen - en meldt meteen of NuVotifier het heeft geaccepteerd. Mislukt dit, dan laat het eigen consolelogboek van NuVotifier (standaard debug: true) zien of de verbinding de plugin überhaupt heeft bereikt, waardoor snel onderscheid te maken is tussen een "verkeerde sleutel" en een "geblokkeerde poort".
6. Sla op, breng vervolgens een echte stem uit en controleer of de beloning meteen aankomt in plaats van pas bij de volgende poll.

Onder de motorkap stuurt deze site een standaard VOTIFIER 2-handshake met een HMAC-ondertekende JSON-payload wanneer er een v2-token is ingesteld, en valt anders terug op een klassiek, RSA-versleuteld v1-blok - hetzelfde protocol dat elke Votifier-compatibele listener al spreekt, niets sitespecifieks.

Gebruikt u al VotingPlugin?

Draait op uw server al VotingPlugin, dan hoeft u de onze niet te installeren - en u hoeft deze site er ook niet handmatig aan toe te voegen, want VotingPlugin heeft er een onderhouden preset voor.

Voer dit in het spel uit als operator (of met de permissie VotingPlugin.Commands.AdminVote.VotePresets):

/av VotePresets

VotingPlugin downloadt de actuele presetlijst uit zijn eigen repository VotingPlugin-Presets, laat u er een kiezen - VoxelRank is daarbij inbegrepen - en vraagt vervolgens om de waarden die die preset nodig heeft: weergavenaam, de stem-URL van uw vermelding, vertraging tussen stemmen, en dergelijke. Of ga er direct naartoe met uw eigen stemlink:

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

Voeg https:// toe; VotingPlugin koppelt de hostnaam automatisch aan de juiste preset, in plaats van dat u hem in een lijst moet opzoeken.

Hoe dan ook schrijft of werkt hij het bijbehorende item bij onder VoteSites: in VoteSites.yml - ServiceSite, VoteURL, redelijke standaardvertragingen, en een tijdelijk weergaveobject of bedankbericht als de site er nog geen heeft - en herlaadt daarna de vote sites voor u. Al het andere dat al in het bestand staat, blijft ongewijzigd. Maak eerst een back-up van VoteSites.yml als u een bestaande configuratie wijzigt in plaats van een nieuwe toe te voegen, en controleer wat er is geschreven - vooral de beloningen, want een preset is een startpunt, geen afgeronde configuratie - voordat u dit aan spelers aanbeveelt.

VotingPlugin heeft nog steeds een eigen Votifier-verbinding nodig om stemmen daadwerkelijk te ontvangen - wijs het naar dezelfde NuVotifier-configuratie uit Optie B hierboven. Ook moet de server GitHub (raw.githubusercontent.com) kunnen bereiken om presets op te halen; meldt /av VotePresets dat er geen presets beschikbaar zijn, dan is dat een netwerk- of firewallprobleem op de server, geen ontbrekende preset. /av gui, of VoteSites.yml rechtstreeks bewerken, werkt nog steeds als alternatief - ServiceSite moet precies VoxelRank.com zijn, wat u kunt bevestigen met /av servicesites na een echte of administratieve teststem.

Andere beloningsplugins

Gebruikt u iets lichters dan VotingPlugin? SuperVotes en SuperbVote zijn beide lichtgewicht Votifier-listeners met hun eigen vote-party- en beloningscommandosystemen. Geen van beide houdt per-site presets bij zoals VotingPlugin dat doet - wijs een van beide naar dezelfde Votifier-host, -poort en het v2-token (of de v1-sleutel) van het tabblad Beloningen en stemmen hierboven, en stel de beloningen op dezelfde manier in als bij elke andere stem.

Problemen oplossen

• Er gebeurt niets bij /votingsite testvote. Controleer eerst /votingsite status - wordt de API-sleutel niet geaccepteerd, dan hebben stemmen (echt of test) nergens heen te gaan. Kopieer hem opnieuw vanaf de pagina Bewerken en zorg dat er geen spatie aan het einde staat.
• Votifier-push komt nooit aan, maar pollen werkt wel. Meestal is de Votifier-poort geblokkeerd, niet de API - de meeste hosts openen standaard uitgaand HTTP-verkeer, maar niet een willekeurige extra inkomende poort. mode: both (of het draaien van de listener van een andere beloningsplugin) is een redelijk permanent alternatief in plaats van te blijven vechten met de firewall.
• De beloning wordt geactiveerd, maar er verschijnt niets in het spel. Beloningscommando's draaien via de console, dus een commando dat alleen werkt wanneer een speler het typt (geen permissie, geen op) mislukt stilletjes. Test het exacte commando eerst vanaf de console.
• VotingPlugin logt "invalid service site" of matcht de stem nooit. De waarde van ServiceSite moet tekstueel exact overeenkomen, hoofdlettergebruik daargelaten. Controleer dit met /av servicesites in plaats van het te raden aan de hand van de domeinnaam van deze site.
• /av VotePresets meldt dat er geen presets beschikbaar zijn, of een URL komt nergens mee overeen. De presetlijst wordt tijdens gebruik van GitHub gedownload, dus dit is bijna altijd het eigen netwerk van de server - firewall, proxy, DNS of een GitHub-storing - die raw.githubusercontent.com blokkeert, geen teken dat VoxelRank van de lijst is gehaald. Een URL-match vereist ook het volledige adres inclusief https://; kale hostnamen worden niet herkend.
• Instellingen op het tabblad Beloningen en stemmen lijken niet opgeslagen te worden. Ze gelden alleen voor een geclaimde vermelding - zie het filter Geclaimd in de serverlijst. Een geïmporteerde, niet-geclaimde vermelding heeft nog geen eigenaar om beloningen voor in te stellen; claim deze eerst.

Snelle antwoorden

Heb ik Votifier überhaupt nodig?

Nee. De poll-modus (de standaard voor de VoxelRank-plugin) werkt zonder verder iets te installeren - Votifier verkort alleen de vertraging tussen een stem en de beloning, en is de enige route naar binnen als u liever VotingPlugin, SuperVotes of SuperbVote gebruikt.

Kan ik onze plugin en VotingPlugin tegelijk gebruiken?

Niet voor dezelfde beloning - kies er één die de beloningscommando's daadwerkelijk uitvoert, anders zou een stem twee keer kunnen uitbetalen. Votifier zelf kan meerdere listeners tegelijk op de hoogte stellen, dus dit is een regel van "configureer dezelfde beloning niet twee keer", geen technische beperking.

Mijn host laat mij geen extra poorten openen voor Votifier.

Gebruik de poll-modus met de VoxelRank-plugin. Deze doet alleen uitgaande verzoeken, dus er hoeft niets geopend te worden. VotingPlugin en soortgelijke beloningsplugins hebben geen equivalent van de pollmodus - zij hebben een inkomende Votifier-poort nodig.

Hulp nodig?

Loopt u vast bij een van bovenstaande stappen, of komt iets niet overeen met wat uw server daadwerkelijk verstuurt? Neem contact met ons op - de snelste routes voor een vraag over stemmen/beloningen staan daar vermeld.