Plugin de vote Minecraft

Quand un joueur vote pour ton serveur sur Servote, il reçoit sa récompense en jeu, sans que tu aies rien à faire : le plugin ServoteVote vérifie les votes et exécute les commandes que tu as choisies (objets, argent, permissions, clés de caisse…). Compatible Spigot, Paper, Purpur et dérivés, de la 1.13 à la 1.21+.

Ce qu'il te faut

Un serveur Minecraft Java sous Spigot, Paper ou Purpur (Folia n'est pas pris en charge). Le Java de ton serveur suffit.
Un serveur en marche (pas encore ? crée-le ici) et sa fiche approuvée sur Servote (Ajouter mon serveur).
L'option « Activer le plugin / l'API de vote » cochée dans la fiche (Dashboard → Modifier).
Un accès aux fichiers du serveur (FTP ou panneau de ton hébergeur) et à la console.
Que ton serveur puisse faire des requêtes HTTPS vers servote.fr (port 443) : c'est le cas chez presque tous les hébergeurs.

Première version

ServoteVote 1.0 a été vérifié par des tests automatisés contre l'API Servote (réclamation unique, mode automatique, erreurs réseau). Si tu rencontres un souci sur ton serveur, dis-le-nous via la page Contact avec la version de ton serveur.

Installation en 5 étapes

Récupère le token de vote de ton serveur

Sur ton dashboard, la carte de ton serveur affiche son token de vote : clique sur le bouton pour le copier.

Garde-le secret

Ce token permet de réclamer les votes de ton serveur. Ne le publie jamais (Discord, capture d'écran, dépôt GitHub). S'il fuite, contacte-nous pour le renouveler.

Télécharge le plugin

Plugin ServoteVote (Spigot / Paper / Purpur)

Version 1.0.0 · 23 Ko · ServoteVote-1.0.0.jar

Télécharger

SHA-256 : a9a5d7846799afd297b3b723cff81c2cb896e460800f42c8c68c3f6baa831153

Tu peux vérifier l'empreinte du fichier (facultatif) : Get-FileHash ServoteVote-1.0.0.jar sous Windows, sha256sum ServoteVote-1.0.0.jar sous Linux. Le code source lisible est aussi disponible :

Code source du plugin (Java)

Version 1.0.0 · 11 Ko · ServoteVote-1.0.0-sources.zip

Télécharger

SHA-256 : 5699fb35c9c242ff2cc61dcc938f02cfa5bf5899dc5fd9d90b724ac61eb1edc5

Installe-le et redémarre

Dépose ServoteVote-1.0.0.jar dans le dossier plugins/ de ton serveur, puis redémarre le serveur (évite /reload). Au premier démarrage, le plugin crée plugins/ServoteVote/config.yml et te prévient dans la console qu'il manque le token : c'est normal.

Configure le token et les récompenses

Ouvre plugins/ServoteVote/config.yml, colle ton token, indique le lien de ta page Servote et choisis tes récompenses :

plugins/ServoteVote/config.yml

server-token: "COLLE_TON_TOKEN_ICI"
vote-url: "https://servote.fr/servers/mon-serveur"

auto-claim:
  enabled: true
  interval-seconds: 60

rewards:
  commands:
    - "give {player} diamond 3"
    - "eco give {player} 500"
  broadcast: "&6{player} &7vient de voter pour le serveur !"

Enregistre, puis tape /servotevote reload (console ou opérateur). Dans les commandes, {player} est remplacé par le pseudo du joueur, et les messages acceptent les couleurs avec &.

Teste

/servotevote check : doit répondre « Connexion à Servote OK ». Sinon, regarde le dépannage.
/servotevote test : exécute tes commandes de récompense pour toi, sans consommer de vote. Vérifie que tu reçois bien ce que tu as prévu.
Vote pour ton serveur sur Servote en saisissant exactement ton pseudo Minecraft : la récompense arrive toute seule en moins d'une minute (ou tape /vote).

Comment ça marche

Le joueur vote sur la page de ton serveur en indiquant son pseudo. Un même joueur peut voter toutes les 2 heures pour un même serveur.
Mode automatique : toutes les 60 secondes, le plugin demande à Servote les votes de la dernière heure. Pour chaque joueur connecté qui a un vote non récupéré, il le « réclame » puis exécute tes commandes.
Commande /vote : même chose à la demande, jusqu'à 2 heures après le vote (utile si le joueur se connecte plus d'une heure après avoir voté).
Servote ne répond « réclamé » qu'une seule fois par vote : impossible de toucher deux fois la récompense, même avec plusieurs serveurs (réseau, lobby…) ou en spammant /vote.
Les commandes sont exécutées par la console avec le vrai pseudo du joueur connecté, jamais avec le texte saisi sur le site.
Le plugin fait environ 1 requête par minute (la limite est de 120 par minute).

Joueurs Bedrock (Geyser / Floodgate)

Le pseudo à saisir sur Servote est celui que voit ton serveur, préfixe compris (par exemple .Steve si tu utilises le préfixe .).

Exemples de récompenses

Toute commande valide en console peut servir de récompense. Mets-en autant que tu veux ; chacune est exécutée à chaque vote :

config.yml

rewards:
  commands:
    # Objet en jeu
    - "give {player} diamond 3"
    # Argent (EssentialsX / Vault)
    - "eco give {player} 500"
    # Permission temporaire d'une journée (LuckPerms)
    - "lp user {player} permission settemp vote.bonus true 1d"
    # Message privé en plus
    - "tellraw {player} {\"text\":\"Merci pour ton vote !\",\"color\":\"green\"}"

La syntaxe exacte dépend de tes plugins (économie, permissions, caisses) : teste toujours avec /servotevote test avant de mettre en production.

Commandes et permissions

Commande	Rôle	Permission
/vote (ou /voter)	Affiche le lien de vote et récupère la récompense	servotevote.vote (tous)
/servotevote reload	Recharge config.yml	servotevote.admin (opérateurs)
/servotevote check	Teste le token et la connexion
/servotevote test [joueur]	Exécute les récompenses sans consommer de vote

Dépannage

+« Refusé par Servote (401) : Token invalide »

Le token de config.yml est incorrect (espace en trop, guillemets manquants, ancien token). Recopie-le depuis ton dashboard, puis /servotevote reload.

+« Refusé par Servote (403) : L'API de vote est désactivée pour ce serveur »

Coche « Activer le plugin / l'API de vote » dans la fiche de ton serveur (Dashboard → Modifier), puis relance /servotevote check. Un message « Ce serveur est banni » signifie que la fiche a été suspendue : écris-nous via Contact.

+« Servote est injoignable »

Ton serveur ne parvient pas à joindre https://servote.fr. Vérifie que ton hébergeur n'interdit pas les connexions sortantes en HTTPS (port 443) et que l'heure du serveur est correcte. Depuis la machine, curl https://servote.fr/api/v1 doit répondre (même par une erreur 401).

+« Aucun vote récent trouvé pour le pseudo … »

Le pseudo saisi sur le site doit être le même que celui du joueur en jeu (les majuscules sont ignorées, pas l'orthographe).
Le vote a plus de 2 heures : il n'est plus récupérable.
Le joueur a voté pour un autre serveur que celui de ce token.

+Le joueur a voté mais ne reçoit rien

Le mode automatique ne récompense que les joueurs connectés et les votes de la dernière heure : sinon, /vote suffit (jusqu'à 2 h).
Vérifie que auto-claim.enabled vaut true et regarde la console : le plugin y écrit un avertissement à chaque problème.
Si ta commande de récompense est mal écrite, elle est bien « réclamée » mais ne fait rien : teste-la avec /servotevote test.

+J'ai un réseau (BungeeCord, Velocity, plusieurs serveurs)

Installe le plugin sur les serveurs où les récompenses doivent être données (le lobby, le survie…), avec le même token. Un vote n'est jamais récompensé deux fois : c'est le serveur où le joueur est connecté au moment de la vérification qui le récompense.

+Je veux seulement la commande /vote, sans mode automatique

Mets auto-claim.enabled: false dans config.yml puis /servotevote reload. Tu peux aussi changer la fréquence avec interval-seconds (30 secondes minimum).