Premiare i voti dei tuoi giocatori

Questa guida spiega passo passo come dare una ricompensa in gioco a ogni giocatore che vota il tuo server su MineRadar.

Quale metodo scegliere?

• Plugin MineRadar: il più semplice. Un file da inserire, un comando da digitare. Niente porte né Votifier.
• Votifier: il metodo più diffuso. Il tuo server ha NuVotifier (o può installarlo) e una porta aperta.
• API di MineRadar: il tuo hosting blocca le porte, oppure hai un plugin o un sito personalizzati.
• Discord, in più: ogni voto annunciato in un canale del tuo server Discord.

Metodo 1: il plugin MineRadar (il più semplice)

1. Scarica MineRadar.jar (Spigot o Paper, dalla 1.7 all’ultima versione) e mettilo nella cartella plugins/ del server. Riavvia.
2. Su MineRadar: profilo → il tuo server → scheda Ricompense → Genera il mio comando.
3. Copia il comando /mineradar setup … e digitalo nella console del server. Il plugin conferma l’installazione.
4. Per scegliere la ricompensa, modifica rewards in plugins/MineRadar/config.yml (un comando per riga, %player% = il giocatore) poi digita /mineradar reload. /mineradar status mostra lo stato.

rewards:
  - "give %player% diamond 1"
  - "eco give %player% 100"

Metodo 1: Votifier

1. Scarica NuVotifier e metti il file .jar nella cartella plugins/ del server. Riavvia.
2. Apri plugins/NuVotifier/config.yml (o plugins/Votifier/). Annota la port (8192 di default) e il token in tokens → default. Dettagli: guida ufficiale di NuVotifier.
3. Verifica che questa porta sia aperta verso l’esterno. Con un hosting, spesso va aggiunta nel pannello («Porte» o «Allocations»).
4. Su MineRadar: profilo → il tuo server → scheda Ricompense. Incolla porta e token e salva.
5. Clicca Prova la connessione, poi invia un voto di prova con il tuo nome. Resta da configurare il plugin che dà la ricompensa: vedi sotto.

Configurare VotingPlugin (o un altro plugin di ricompense)

NuVotifier riceve il voto, ma è un altro plugin a dare la ricompensa. Il più usato è VotingPlugin. Premia un voto solo se il nome del servizio corrisponde: per MineRadar è MineRadar (maiuscole indifferenti).

1. Installa VotingPlugin come NuVotifier, poi riavvia.
2. Apri plugins/VotingPlugin/VoteSites.yml e aggiungi il blocco qui sotto (la tua scheda Ricompense lo fornisce già compilato con il tuo link di voto).
3. Cambia la ricompensa (Commands, Messages…) poi digita /av reload.
4. Invia un voto di prova da MineRadar. La console deve mostrare «Received a vote from service site 'MineRadar'» e /av servicesites deve elencare MineRadar. Approfondimento: documentazione VotingPlugin sui nomi dei servizi.

VoteSites:
  MineRadar:
    Enabled: true
    ServiceSite: 'MineRadar'
    VoteURL: 'https://it.mineradar.games/vote/votre-serveur'
    VoteDelay: 12
    Rewards:
      Messages:
        Player: '&aMerci pour ton vote sur MineRadar !'
      Commands:
      - 'give %player% diamond 1'

Un altro plugin (SuperbVote, GAListener…)? Il principio è lo stesso: se chiede un nome del servizio, indica MineRadar.

Metodo 2: l’API di MineRadar

Qui non viene inviato nulla al tuo server: è lui a chiedere a MineRadar chi ha votato. Nessuna porta da aprire.

1. Scheda Ricompense → Genera una chiave API. Copiala: viene mostrata una sola volta.
2. Dalla al tuo plugin o al tuo sviluppatore, solo lato server (mai in una pagina web).
3. Quando un giocatore si connette o digita /vote, il plugin chiama claim con il suo nome. Se la risposta dice "reclame": true, dà la ricompensa. Un voto si riscatta una sola volta.
4. Extra: classement restituisce i tuoi migliori votanti (mese, 30 giorni o stagione) e serveur il tuo stato e la tua posizione, da mostrare sul sito o su Discord.

GET  https://it.mineradar.games/api/v1/votes/check?pseudo=Steve
POST https://it.mineradar.games/api/v1/votes/claim?pseudo=Steve
GET  https://it.mineradar.games/api/v1/votes/classement?periode=mois&limite=10
GET  https://it.mineradar.games/api/v1/serveur
Authorization: Bearer mr_…

In più: annunciare i voti su Discord

1. Su Discord: Impostazioni server → Integrazioni → Webhook → Nuovo webhook. Serve il permesso «Gestire i webhook». Guida ufficiale di Discord.
2. Scegli il canale, poi clicca Copia URL webhook.
3. Incolla l’URL nella scheda Ricompense, parte Discord, e salva.
4. Clicca Invia un messaggio di prova: deve comparire nel canale.

Condividere il tuo link di voto

La tua scheda Ricompense fornisce il link di voto. Aggiungi ?pseudo= seguito dal nome del giocatore per compilarlo: comodo in un comando /vote che invia un link personale.

Non funziona?

• «Nessuna risposta Votifier»: il plugin non è avviato, oppure la porta non è aperta presso l’hosting o nel firewall.
• «Token rifiutato»: ricopia il token da config.yml, senza spazi prima o dopo.
• Il voto arriva ma la ricompensa no: il nome del servizio non è MineRadar nel tuo plugin di ricompense.
• «Indirizzo non ancora risolto»: MineRadar non ha ancora misurato il tuo server. Riprova qualche minuto dopo.
• Doppia ricompensa: non usare Votifier e l’API per la stessa ricompensa.

Torna alla mia scheda Ricompense