Aller au contenu
CubeVote

Récompenser vos votants

CubeVote utilise Votifier, le protocole standard des annuaires Minecraft. Concrètement : à chaque vote, le site dépose l'information directement sur votre serveur, et le plugin de récompense que vous utilisez déjà fait le reste.

Rien à installer si vous avez déjà voté ailleurs. Si votre serveur est référencé sur un autre annuaire, NuVotifier et vos récompenses sont déjà en place. Il vous reste à coller un jeton : comptez deux minutes.

Mise en place

  1. 1

    Installer NuVotifier, si ce n'est pas déjà fait

    Téléchargez NuVotifier depuis SpigotMC, déposez le fichier dans plugins/, puis redémarrez le serveur. Il fonctionne sur Bukkit, Spigot, Paper, Purpur et leurs dérivés, de Minecraft 1.8 aux versions actuelles.

    Au premier démarrage, il génère plugins/Votifier/config.yml et choisit le port 8192.

  2. 2

    Ouvrir le port Votifier

    Le port 8192 doit être joignable depuis l'extérieur, au même titre que le port de jeu. Chez un hébergeur Minecraft, cette ouverture se demande en général depuis le panneau, ou au support.

    Vous pouvez vérifier depuis n'importe quelle machine : telnet votre-serveur.fr 8192 doit afficher une ligne commençant par VOTIFIER.

  3. 3

    Récupérer votre jeton

    Ouvrez plugins/Votifier/config.yml et copiez la valeur située sous tokens :

    tokens:
  default: 'VOTRE_JETON_ICI'

    Vous pouvez aussi créer un jeton dédié à CubeVote, ce qui permet de le révoquer sans toucher aux autres annuaires :

    tokens:
  default: '…'
  cubevote.net: 'UN_AUTRE_JETON'
  4. 4

    Coller le jeton sur CubeVote

    Rendez-vous sur la page de gestion de votre serveur, section Votifier. Renseignez l'adresse, le port et le jeton, puis enregistrez.

    Un vote de test est envoyé immédiatement : le résultat s'affiche à l'écran, et votre console de serveur doit mentionner le vote reçu. Si quelque chose cloche, le message d'erreur vous dit quoi corriger.

    Ouvrir mon tableau de bord
  5. 5

    Configurer les récompenses

    C'est le rôle de votre plugin de récompense, pas de CubeVote. Les plus répandus :

    • VotingPlugin, le plus complet : caisses, séries de votes, fêtes du vote, classements.
    • SuperbVote, léger et simple à configurer, idéal pour de simples commandes.
    • VoteRoulette, récompenses aléatoires et paliers de fidélité.

    Ils réagissent tous à l'événement Votifier : vos récompenses existantes fonctionneront avec CubeVote sans modification. Seul le menu /vote demande une déclaration de plus, à l'étape suivante.

  6. 6

    Faire apparaître CubeVote dans /vote

    Le menu /vote que vos joueurs ouvrent en jeu ne liste que les sites déclarés, sous le nom de service exact que chaque site envoie. Celui de CubeVote est cubevote.net. Avec VotingPlugin, dans plugins/VotingPlugin/VoteSites.yml :

    VoteSites:
  CubeVote:
    Enabled: true
    Name: 'CubeVote'
    ServiceSite: 'cubevote.net'
    VoteURL: 'VOTRE_PAGE_DE_VOTE'
    VoteDelay: 3

    Après un vote de test, /av servicesites liste les noms reçus : CubeVote doit y figurer sous ce nom. La section Votre /vote de votre tableau de bord donne le bloc prêt à coller, avec votre page de vote déjà remplie, pour VotingPlugin, zEssentials et SuperbVote.

    Récupérer mon bloc tout prêt

Protocoles gérés

CubeVote détecte automatiquement la version utilisée par votre serveur.

NuVotifier (protocole v2), recommandé
Authentification par jeton partagé et signature HMAC-SHA256. Le serveur confirme la bonne réception, ce qui permet d'afficher un vrai diagnostic.
Votifier d'origine (protocole v1)
Chiffrement RSA avec la clé publique du serveur, à copier depuis plugins/Votifier/rsa/public.key. Pris en charge pour les serveurs qui n'ont pas migré.

Sans Votifier : l'API de vote

Si vous ne pouvez pas ouvrir de port, votre serveur peut interroger CubeVote à intervalle régulier plutôt que d'être contacté. C'est plus souple derrière un NAT, et tout aussi fiable.

Voir l'API de vote

Questions fréquentes

Dois-je installer un plugin CubeVote ?
Non. CubeVote parle le protocole Votifier, le standard utilisé par tous les annuaires Minecraft. Si votre serveur a déjà NuVotifier et un plugin de récompense, il n'y a rien de plus à installer : un jeton à coller, et c'est terminé.
Quels plugins de récompense fonctionnent ?
Tous ceux qui écoutent l'événement Votifier : VotingPlugin, SuperbVote, VoteRoulette, VoteParty, VotingPlugin-Addons, et la plupart des systèmes de caisses. Vos récompenses déjà configurées pour d'autres annuaires fonctionnent immédiatement avec CubeVote.
Et si je ne peux pas ouvrir le port 8192 ?
Utilisez l'API de vote : votre serveur interroge CubeVote au lieu d'être contacté. Cela fonctionne derrière une box ou un hébergeur qui ne permet pas d'ouvrir de port.
Le joueur était déconnecté au moment du vote, que se passe-t-il ?
C'est votre plugin de récompense qui décide. VotingPlugin et SuperbVote mettent la récompense en file d'attente et la remettent à la prochaine connexion du joueur ; c'est le comportement par défaut de la plupart d'entre eux.