Ricompense per i voti in Minecraft con VotingPlugin

Come un voto diventa una ricompensa

Tre parti lavorano insieme. Un giocatore vota su una lista server. La lista invia un messaggio di voto a Votifier sul tuo server, insieme al nome del giocatore e a un service name che identifica la lista. VotingPlugin resta in ascolto di questi messaggi, cerca il sito di voto il cui ServiceSite corrisponde al service name ed esegue le ricompense di quel sito.

Quindi VotingPlugin non riceve i voti da solo. Prima ti serve un Votifier funzionante, di solito NuVotifier. Se non l’hai ancora configurato, segui la guida alla configurazione di NuVotifier e poi torna qui.

• Votifier riceve il voto e lo controlla (token per v2, chiave RSA per v1).
• VotingPlugin abbina il service name e dà le ricompense.
• BestMCServerList invia il service name BestMCServerList.

Passo 1: installa VotingPlugin

1. Assicurati che NuVotifier sia attivo e raggiungibile. Un voto di prova dalla tua pagina Votifier deve comparire in console.
2. Metti il JAR di VotingPlugin nella cartella plugins del tuo server Spigot o Paper e riavvia una volta.
3. VotingPlugin crea i suoi file, tra cui plugins/VotingPlugin/VoteSites.yml per i siti di voto e Config.yml per le impostazioni generali.

In un network con proxy, di solito i voti arrivano al proxy e le ricompense vengono eseguite sui server backend. Tieni VoteSites.yml uguale su ogni backend.

Passo 2: aggiungi BestMCServerList a VoteSites.yml

Ogni lista in cui sei presente ha una voce sua sotto VoteSites. La chiave è un nome interno: tienilo corto, senza spazi e senza punti. La riga importante è ServiceSite.

VoteSites:
  BestMCServerList:
    Enabled: true
    Name: 'BestMCServerList'
    Priority: 5
    ServiceSite: 'BestMCServerList'
    VoteURL: 'https://bestmcserverlist.net/server/your-server/vote'
    VoteDelay: 24h
    WaitUntilVoteDelay: false
    VoteDelayDaily: true
    ForceOffline: false
    DisplayItem:
      Material: 'DIAMOND'
      Amount: 1
    Rewards:
      Commands:
      - 'eco give %player% 250'
      - 'give %player% diamond 2'
      Messages:
        Player: '&aThanks for voting on BestMCServerList!'

• Enabled: true è necessario, il valore predefinito è false.
• ServiceSite deve corrispondere al service name inviato dalla lista. VotingPlugin lo confronta senza distinguere maiuscole e minuscole, ma per il resto il testo deve essere identico. Per noi è BestMCServerList.
• VoteURL è il link che i giocatori ricevono con /vote. Copia il tuo link di voto dalla pagina del tuo server; your-server sta per il tuo slug.
• DisplayItem è obbligatorio per ogni sito, perché viene mostrato nei menu di VotingPlugin.
• I comandi vengono eseguiti dalla console, e %player% diventa il nome di chi ha votato. eco give richiede un plugin di economia; usa i comandi che ha il tuo server.

Salva il file ed esegui /av reload.

Passo 3: attesa tra i voti e azzeramento giornaliero

Su BestMCServerList ogni nome Minecraft può votare una volta per server e giorno di calendario, e il giorno segue il fuso orario Europe/Berlin. Si può votare di nuovo subito dopo la mezzanotte di Berlino, non 24 ore dopo l’ultimo voto.

• VoteDelay: 24h viene usato per /vote next, il conto alla rovescia che vedono i giocatori. Non blocca i voti.
• VoteDelayDaily: true invece azzera l’attesa una volta al giorno, ed è adatto alle liste con azzeramento giornaliero come la nostra. VoteDelayDailyHour imposta l’ora in orario del server (1–24). Se l’orologio del tuo server non va con l’ora di Berlino, tieni conto della differenza quando lo imposti.
• WaitUntilVoteDelay: true rifiuterebbe i voti arrivati prima della fine dell’attesa. Lascialo su false: imponiamo già un voto per nome al giorno, e un’impostazione sbagliata dell’attesa farebbe perdere le ricompense ai giocatori.

Passo 4: prova le ricompense

1. Esegui /av vote <player> BestMCServerList. Esegue le ricompense di quel sito per un giocatore e ti mostra che la config delle ricompense funziona. Non prova Votifier.
2. Apri la tua pagina Votifier su BestMCServerList e premi Invia voto di prova. Inviamo un voto per il nome TestVote, che non conta per la classifica. Il registro consegne mostra se il tuo server l’ha accettato.
3. Cerca in console una riga come [VotingPlugin] Received a vote from service site 'BestMCServerList' by player 'TestVote'!.
4. Esegui /av servicesites per elencare i service name ricevuti finora da VotingPlugin.

Se il voto di prova arriva ma VotingPlugin segnala un service site sconosciuto, il problema è la riga ServiceSite. Con AutoCreateVoteSites: true in Config.yml (il valore predefinito), VotingPlugin può anche creare da solo una nuova voce; le servono comunque Enabled: true e le tue ricompense.

Giocatori Bedrock e voti offline

I giocatori Bedrock che entrano tramite Geyser e Floodgate hanno un prefisso nel nome, di default un punto: .Steve. Votano con il nome completo, e noi lo passiamo a Votifier invariato. In VotingPlugin imposta lo stesso prefisso in Config.yml. In un network usa lo stesso valore sul proxy e su ogni backend:

BedrockPlayerPrefix: '.'

.Steve e Steve sono giocatori diversi. Non togliere mai il prefisso per far tornare un nome.

I giocatori non devono essere online quando votano. Le ricompense hanno un RewardType che può essere ONLINE, OFFLINE o BOTH (il predefinito). Prova anche i voti offline, perché i comandi che richiedono un giocatore online si comportano diversamente.

Vote party, traguardi e serie

Quando le ricompense base funzionano, SpecialRewards.yml aggiunge obiettivi che fanno continuare a votare: una VoteParty che scatta quando l’intero server raggiunge un certo numero di voti, VoteMilestones per i totali personali e VoteStreaks per chi vota più giorni di fila. Tieni le ricompense utili ma giuste; ricompense che rompono la tua economia fanno sembrare il voto un obbligo.

Vuoi un badge del rank per chi vota di più? La guida ai prefissi LuckPerms mostra come dare ai giocatori un prefisso in immagine con un comando, che puoi eseguire come ricompensa.

Errori comuni