Come configurare le ricompense per il voto (Votifier, VotingPlugin e altro)

Ogni plugin di ricompense ha bisogno di due cose da te: un modo per scoprire che è avvenuto un voto, e qualcosa da eseguire quando succede. Qui vediamo entrambe le cose - il plugin complementare pubblicato da questo sito, Votifier per la consegna istantanea, e cosa fare se usi già VotingPlugin, SuperVotes o un altro plugin di ricompense.

Opzione A: il plugin VoxelRank (consigliato)

Il plugin complementare comunica direttamente con l'API di questo sito. Votifier non è necessario - funziona interrogando a intervalli i voti non riscattati, quindi funziona anche dietro NAT e recupera tutto ciò che è stato perso mentre il server era offline. Votifier è comunque disponibile come componente opzionale per la consegna istantanea (vedi Opzione B).

1. Scarica il jar dal tuo Cruscotto (la scheda del tuo server ha un pulsante di download non appena esiste una build), oppure direttamente da /download/plugin.
2. Mettilo in plugins/ e avvia il server una volta. Questo genera plugins/VotingSite/config.yml.
3. Apri la pagina Modifica del tuo server → scheda Premi e votazioni e copia la Chiave API mostrata lì.
4. Incollala in site.api-key dentro config.yml (verifica che site.url punti a questo sito), poi esegui /votingsite reload.
5. Decidi come far arrivare i voti impostando mode in config.yml:
   • poll (predefinito) - il plugin recupera da solo i voti non riscattati. Non c'è altro da installare.
   • votifier - il sito invia ogni voto nel momento in cui viene espresso. Richiede NuVotifier o un altro listener Votifier (Opzione B più sotto).
   • both - invio Votifier con il polling come rete di sicurezza, senza duplicati grazie all'id del voto.
6. Compila rewards.commands (e, se vuoi, milestones e vote-party) con i comandi da console da eseguire a ogni voto.
7. Provalo: /votingsite testvote <player> simula un voto senza aspettarne uno vero. /votingsite status mostra la modalità, se la chiave API viene accettata e quanti voti sono stati consegnati finora.

I giocatori ottengono il link per votare e il conteggio dei voti con /voxelrank vote - non con /vote, che questo plugin evita deliberatamente di rivendicare (due plugin che si contendono lo stesso comando sono esattamente il modo in cui una ricompensa smette di funzionare in silenzio - vedi la nota dedicata in config.yml).

Opzione B: consegna istantanea con NuVotifier

Salta questa parte se la modalità poll funziona già abbastanza bene per te - non è obbligatoria. Aggiungila quando i pochi minuti di ritardo del polling contano davvero, o quando preferisci usare un plugin di ricompense dedicato invece di quello di questo sito.

NuVotifier è il fork mantenuto attivamente del Votifier originale - il progetto originale oggi è sostanzialmente non mantenuto, quindi "installare Votifier" in pratica significa installare NuVotifier (o un fork compatibile come VotifierPlus).

1. Metti il jar di NuVotifier in plugins/ e riavvia il server. Su un server Bukkit/Spigot/Paper mantiene il classico nome di cartella plugins/Votifier/ per compatibilità con il passato - è la cartella propria di NuVotifier, non un residuo del vecchio plugin - e al primo avvio genera al suo interno un config.yml e una coppia di chiavi in rsa/.
2. Recupera le credenziali da plugins/Votifier/config.yml: il token v2 (consigliato) viene generato automaticamente sotto la chiave default nella sezione tokens: - copialo così com'è. Se preferisci il metodo più vecchio, la chiave pubblica v1 si trova in plugins/Votifier/rsa/public.key; tieni la private.key corrispondente nella stessa cartella sul server e non condividerla mai.
3. Controlla la port su cui NuVotifier è in ascolto (8192 di default) e assicurati che sia aperta nel firewall o nel pannello dell'host - è una porta separata da quella normale di Minecraft, e la maggior parte degli host non la apre automaticamente.
4. Nella pagina Modifica del tuo server → scheda Premi e votazioni, inserisci l'host Votifier (l'indirizzo del tuo server) e quella porta, poi incolla il token v2 o la chiave v1 del passaggio 2. Se compili entrambi ne viene usato solo uno - vince il v2.
5. Clicca su Invia voto di prova direttamente in quella scheda. Questo invia un pacchetto Votifier reale verso host/porta/chiave/token attualmente presenti nel modulo - non serve salvare prima - e mostra subito se NuVotifier lo ha accettato. Se fallisce, il log di console di NuVotifier stesso (debug: true di default) mostra se la connessione è almeno arrivata al plugin, il che aiuta a distinguere rapidamente tra "chiave sbagliata" e "porta bloccata".
6. Salva, quindi esprimi un voto vero e conferma che la ricompensa arriva subito invece che al prossimo polling.

Sotto il cofano, questo sito invia un handshake VOTIFIER 2 standard con un payload JSON firmato con HMAC quando è impostato un token v2, e in caso contrario ricade su un classico blocco v1 cifrato con RSA - lo stesso protocollo già parlato da qualsiasi listener compatibile con Votifier, niente di specifico per questo sito.

Usi già VotingPlugin?

Se il tuo server usa già VotingPlugin, non devi installare il nostro - e non devi nemmeno aggiungere questo sito a mano, perché VotingPlugin ha un preset mantenuto apposta.

Esegui questo in gioco come operatore (o con il permesso VotingPlugin.Commands.AdminVote.VotePresets):

/av VotePresets

VotingPlugin scarica l'elenco aggiornato dei preset dal proprio repository VotingPlugin-Presets, ti lascia sceglierne uno - VoxelRank è incluso - e poi chiede i valori richiesti da quel preset: nome visualizzato, URL di voto del tuo annuncio, ritardo tra i voti e simili. Oppure vai dritto al punto con il tuo link di voto:

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

Includi https://; VotingPlugin abbina automaticamente il nome host al preset giusto, invece di farti cercare nell'elenco.

In entrambi i casi scrive o aggiorna la voce corrispondente sotto VoteSites: in VoteSites.yml - ServiceSite, VoteURL, ritardi predefiniti ragionevoli, e un oggetto segnaposto o un messaggio di ringraziamento se il sito non ne ha già uno - poi ricarica i vote site al posto tuo. Tutto il resto già presente nel file resta invariato. Fai prima un backup di VoteSites.yml se stai modificando una configurazione già esistente invece di aggiungerne una nuova, e controlla cosa è stato scritto - le ricompense in particolare, perché un preset è un punto di partenza, non una configurazione finita - prima di pubblicizzarlo ai giocatori.

VotingPlugin ha comunque bisogno di una propria connessione Votifier per ricevere davvero i voti - puntalo alla stessa configurazione NuVotifier dell'Opzione B qui sopra. Serve anche che il server riesca a raggiungere GitHub (raw.githubusercontent.com) per scaricare i preset; se /av VotePresets segnala che non ci sono preset disponibili, è un problema di rete o firewall sul server, non un preset mancante. /av gui, oppure modificare direttamente VoteSites.yml, funzionano comunque come ripiego - ServiceSite deve corrispondere esattamente a VoxelRank.com, cosa che puoi verificare con /av servicesites dopo un voto reale o un voto di prova da amministratore.

Altri plugin di ricompense

Usi qualcosa di più leggero di VotingPlugin? SuperVotes e SuperbVote sono entrambi listener Votifier leggeri, con propri sistemi di vote-party e comandi di ricompensa. Nessuno dei due tiene traccia di preset per sito come fa VotingPlugin - punta uno dei due allo stesso host, porta e token v2 (o chiave v1) Votifier dalla scheda Premi e votazioni qui sopra, e configura le sue ricompense come faresti per qualsiasi voto.

Risoluzione dei problemi

• Non succede nulla con /votingsite testvote. Controlla prima /votingsite status - se la chiave API non viene accettata, i voti (reali o di prova) non hanno dove andare. Ricopiala dalla pagina Modifica e assicurati che non ci siano spazi finali.
• L'invio Votifier non arriva mai ma il polling funziona. Di solito è la porta Votifier a essere bloccata, non l'API - la maggior parte degli host apre di default il traffico HTTP in uscita ma non una porta in entrata aggiuntiva qualsiasi. mode: both (oppure l'uso del listener di un altro plugin di ricompense) è un ripiego permanente ragionevole, invece di combattere con il firewall.
• La ricompensa scatta ma in gioco non succede nulla. I comandi di ricompensa girano dalla console, quindi un comando che funziona solo se digitato da un giocatore (senza permesso, senza op) fallirà silenziosamente. Prova prima il comando esatto dalla console.
• VotingPlugin registra "invalid service site" o non abbina mai il voto. Il valore ServiceSite deve corrispondere carattere per carattere, a parte maiuscole/minuscole. Verificalo con /av servicesites invece di indovinarlo dal nome di dominio di questo sito.
• /av VotePresets dice che non ci sono preset disponibili, oppure un URL non corrisponde a nulla. Scarica l'elenco dei preset da GitHub in tempo reale, quindi è quasi sempre la rete del server stesso - firewall, proxy, DNS o un'interruzione di GitHub - a bloccare raw.githubusercontent.com, non un segno che VoxelRank sia stato tolto dall'elenco. Anche l'abbinamento tramite URL richiede l'indirizzo completo, incluso https://; i soli nomi host non vengono riconosciuti.
• Le impostazioni nella scheda Premi e votazioni sembrano non salvarsi. Si applicano solo a un annuncio rivendicato - vedi il filtro Rivendicato nell'elenco dei server. Una voce importata e non rivendicata non ha ancora un proprietario per cui configurare le ricompense; rivendicala prima.

Risposte rapide

Mi serve comunque Votifier?

No. La modalità poll (predefinita per il plugin VoxelRank) funziona senza installare altro - Votifier si limita ad accorciare il ritardo tra voto e ricompensa, ed è l'unica via d'accesso se preferisci usare VotingPlugin, SuperVotes o SuperbVote.

Posso usare il nostro plugin e VotingPlugin insieme?

Non per la stessa ricompensa - scegline uno che esegua davvero i comandi di ricompensa, altrimenti un voto potrebbe essere pagato due volte. Votifier di per sé può notificare più di un listener, quindi è una regola del tipo "non configurare la stessa ricompensa due volte", non un limite tecnico.

Il mio host non mi permette di aprire porte extra per Votifier.

Usa la modalità poll con il plugin VoxelRank. Fa solo richieste in uscita, quindi non c'è nulla da aprire. VotingPlugin e plugin di ricompense simili non hanno un equivalente della modalità di polling - hanno bisogno di una porta Votifier in entrata.

Hai bisogno di aiuto?

Sei bloccato su uno dei passaggi qui sopra, oppure qualcosa non corrisponde a ciò che il tuo server invia davvero? Contattaci - lì trovi le vie più rapide per una domanda su voti/ricompense.