Recompenses per votar a Minecraft amb VotingPlugin

Com un vot es converteix en recompensa

Hi treballen tres peces juntes. Un jugador vota en una llista de servidors. La llista envia un missatge de vot a Votifier al teu servidor, juntament amb el nom del jugador i un nom de servei que identifica la llista. VotingPlugin escolta aquests missatges, busca el lloc de votació el ServiceSite del qual coincideix amb el nom de servei i n’executa les recompenses.

Així que VotingPlugin no rep vots per si mateix. Primer necessites un Votifier que funcioni, normalment NuVotifier. Si encara no el tens, segueix la guia per configurar NuVotifier i torna aquí.

• Votifier rep el vot i el comprova (token a v2, clau RSA a v1).
• VotingPlugin compara el nom de servei i dona les recompenses.
• BestMCServerList envia el nom de servei BestMCServerList.

Pas 1: instal·lar VotingPlugin

1. Comprova que NuVotifier funciona i és accessible. Un vot de prova des de la teva pàgina de Votifier hauria d’aparèixer a la consola.
2. Posa el JAR de VotingPlugin a la carpeta plugins del teu servidor Spigot o Paper i reinicia una vegada.
3. VotingPlugin crea els seus fitxers, entre ells plugins/VotingPlugin/VoteSites.yml per als llocs de votació i Config.yml per a la configuració general.

En una xarxa amb proxy, els vots solen arribar al proxy i les recompenses s’executen als servidors backend. Mantén el mateix VoteSites.yml a tots els backends.

Pas 2: afegir BestMCServerList a VoteSites.yml

Cada llista on siguis té la seva pròpia entrada sota VoteSites. La clau és un nom intern: curt, sense espais i sense punts. La línia important és 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 és necessari; el valor per defecte és false.
• ServiceSite ha de coincidir amb el nom de servei que envia la llista. VotingPlugin no distingeix majúscules i minúscules, però per la resta el text ha de ser idèntic. En el nostre cas és BestMCServerList.
• VoteURL és l’enllaç que reben els jugadors amb /vote. Copia el teu enllaç de vot des de la pàgina del teu servidor; your-server representa el teu propi slug.
• DisplayItem és obligatori a cada lloc, perquè es mostra als menús de VotingPlugin.
• Les comandes s’executen des de la consola, i %player% se substitueix pel nom de qui vota. eco give necessita un plugin d’economia; fes servir les comandes que tingui el teu servidor.

Desa el fitxer i executa /av reload.

Pas 3: vote delay i el reinici diari

A BestMCServerList cada nom de Minecraft pot votar una vegada per servidor i dia natural, i el dia segueix la zona horària Europe/Berlin. Es pot tornar a votar just després de la mitjanit de Berlín, no 24 hores després de l’últim vot.

• VoteDelay: 24h es fa servir per a /vote next, el compte enrere que veuen els jugadors. No bloqueja vots.
• VoteDelayDaily: true reinicia el delay una vegada al dia, cosa que encaixa amb llistes que es reinicien diàriament com la nostra. VoteDelayDailyHour fixa l’hora en hora del servidor (1–24). Si el rellotge del teu servidor no va amb l’hora de Berlín, tingues en compte la diferència quan el configuris.
• WaitUntilVoteDelay: true rebutjaria els vots que arriben abans que s’acabi el delay. Deixa’l a false: nosaltres ja apliquem un vot per nom i dia, i un delay mal configurat faria perdre recompenses als jugadors.

Pas 4: provar les recompenses

1. Executa /av vote <player> BestMCServerList. Això executa les recompenses d’aquest lloc per a un jugador i demostra que la teva configuració de recompenses funciona. No prova Votifier.
2. Obre la teva pàgina de Votifier a BestMCServerList i prem Envia un vot de prova. Enviem un vot per al nom TestVote, que no compta per al rànquing. El registre d’entregues mostra si el teu servidor l’ha acceptat.
3. Busca a la consola una línia com [VotingPlugin] Received a vote from service site 'BestMCServerList' by player 'TestVote'!.
4. Executa /av servicesites per veure els noms de servei que VotingPlugin ha rebut fins ara.

Si el vot de prova arriba però VotingPlugin informa d’un lloc de servei desconegut, el problema és a la línia ServiceSite. Amb AutoCreateVoteSites: true a Config.yml (el valor per defecte), VotingPlugin també pot crear una entrada nova pel seu compte; tot i així necessita Enabled: true i les teves recompenses.

Jugadors de Bedrock i vots sense connexió

Els jugadors de Bedrock que entren amb Geyser i Floodgate tenen un prefix al nom, per defecte un punt: .Steve. Voten amb aquest nom complet, i nosaltres el passem a Votifier sense canvis. A VotingPlugin, posa el mateix prefix a Config.yml. En una xarxa fes servir el mateix valor al proxy i a cada backend:

BedrockPlayerPrefix: '.'

.Steve i Steve són jugadors diferents. No treguis mai el prefix perquè un nom encaixi.

Els jugadors no han d’estar connectats quan voten. Les recompenses tenen un RewardType de ONLINE, OFFLINE o BOTH (el valor per defecte). Prova també els vots sense connexió, perquè les comandes que necessiten un jugador connectat es comporten d’una altra manera.

Vote parties, fites i ratxes

Quan les recompenses bàsiques funcionin, SpecialRewards.yml afegeix objectius que mantenen els jugadors votant: una VoteParty que s’activa quan tot el servidor arriba a un cert nombre de vots, VoteMilestones per a totals personals i VoteStreaks per votar diversos dies seguits. Fes que les recompenses siguin útils però justes; les que trenquen la teva economia fan que votar sembli obligatori.

Vols una insígnia de rang per a qui més vota? La guia de prefixos de LuckPerms explica com donar als jugadors un prefix amb imatge mitjançant una comanda, que pots executar com a recompensa.

Errors freqüents