Récompenser les votes de vos joueurs

Ce guide explique, étape par étape, comment donner une récompense en jeu à chaque joueur qui vote pour votre serveur sur MineRadar.

Quelle méthode choisir ?

• Plugin MineRadar : le plus simple. Un fichier à déposer, une commande à taper. Pas de port ni de Votifier.
• Votifier : la méthode la plus courante. Votre serveur a NuVotifier (ou peut l’installer) et un port ouvert.
• API MineRadar : votre hébergeur bloque les ports, ou vous avez un plugin ou un site maison.
• Discord, en plus : chaque vote annoncé dans un salon de votre serveur Discord.

Méthode 1 : le plugin MineRadar (le plus simple)

1. Téléchargez MineRadar.jar (Spigot ou Paper, de la 1.7 à la dernière version) et placez-le dans le dossier plugins/ du serveur. Redémarrez.
2. Sur MineRadar : profil → votre serveur → onglet Récompenses → Générer ma commande.
3. Copiez la commande /mineradar setup … et tapez-la dans la console du serveur. Le plugin répond « C’est installé ! ».
4. Pour choisir la récompense, modifiez rewards dans plugins/MineRadar/config.yml (une commande par ligne, %player% = le joueur) puis tapez /mineradar reload. /mineradar status affiche l’état.

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

Méthode 1 : Votifier

1. Téléchargez NuVotifier et placez le fichier .jar dans le dossier plugins/ de votre serveur. Redémarrez.
2. Ouvrez plugins/NuVotifier/config.yml (ou plugins/Votifier/). Notez le port (8192 par défaut) et le token sous tokens → default. Détails : guide officiel de NuVotifier.
3. Vérifiez que ce port est ouvert vers l’extérieur. Chez un hébergeur, il faut souvent l’ajouter dans le panel (rubrique « Ports » ou « Allocations »).
4. Sur MineRadar : profil → votre serveur → onglet Récompenses. Collez le port et le token, enregistrez.
5. Cliquez sur Tester la connexion, puis envoyez un vote de test avec votre pseudo. Il reste à régler le plugin qui donne la récompense : voir ci-dessous.

Régler VotingPlugin (ou un autre plugin de récompense)

NuVotifier reçoit le vote, mais c’est un autre plugin qui donne la récompense. Le plus utilisé est VotingPlugin. Il ne récompense un vote que si le nom du service correspond : pour MineRadar, c’est MineRadar (majuscules indifférentes).

1. Installez VotingPlugin comme NuVotifier, puis redémarrez.
2. Ouvrez plugins/VotingPlugin/VoteSites.yml et ajoutez le bloc ci-dessous (votre onglet Récompenses le donne déjà rempli avec votre lien de vote).
3. Changez la récompense (Commands, Messages…) puis tapez /av reload.
4. Envoyez un vote de test depuis MineRadar. La console doit afficher « Received a vote from service site 'MineRadar' », et /av servicesites doit lister MineRadar. Explications : doc VotingPlugin sur les noms de service.

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

Un autre plugin (SuperbVote, GAListener…) ? Le principe est le même : s’il demande un nom de service, indiquez MineRadar.

Méthode 2 : l’API MineRadar

Ici, rien n’est envoyé à votre serveur : c’est lui qui demande à MineRadar qui a voté. Aucun port à ouvrir.

1. Onglet Récompenses → Générer une clé API. Copiez-la : elle ne s’affiche qu’une fois.
2. Donnez-la à votre plugin ou à votre développeur, côté serveur uniquement (jamais dans une page web).
3. Quand un joueur se connecte ou tape /vote, le plugin appelle claim avec son pseudo. Si la réponse dit "reclame": true, il donne la récompense. Un vote ne se réclame qu’une fois.
4. Bonus : classement donne vos meilleurs voteurs (mois, 30 jours ou saison) et serveur votre état et votre rang, pour les afficher sur votre site ou votre Discord.

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

En plus : annoncer les votes sur Discord

1. Sur Discord : Paramètres du serveur → Intégrations → Webhooks → Nouveau webhook. Il faut la permission « Gérer les webhooks ». Aide officielle de Discord.
2. Choisissez le salon, puis cliquez sur Copier l’URL du webhook.
3. Collez l’URL dans l’onglet Récompenses, partie Discord, et enregistrez.
4. Cliquez sur Envoyer un message de test : il doit apparaître dans le salon.

Partager votre lien de vote

Votre onglet Récompenses donne votre lien de vote. Ajoutez ?pseudo= suivi du pseudo du joueur pour qu’il soit déjà rempli : pratique dans une commande /vote qui envoie un lien personnalisé.

Ça ne marche pas ?

• « Aucune réponse Votifier » : le plugin n’est pas lancé, ou le port n’est pas ouvert chez votre hébergeur ou dans le pare-feu.
• « Token refusé » : recopiez le token de config.yml sans espace avant ni après.
• Le vote arrive mais pas la récompense : le nom de service n’est pas MineRadar dans votre plugin de récompense.
• « Adresse pas encore résolue » : MineRadar n’a pas encore mesuré votre serveur. Réessayez quelques minutes plus tard.
• Double récompense : n’utilisez pas Votifier et l’API pour la même récompense.

Retour à mon onglet Récompenses