Documentation | MineBuff

Récompenses de vote (votant)

Quand quelqu’un vote pour votre fiche, MineBuff peut informer votre serveur Minecraft immédiatement pour que votre plugin de récompenses distribue objets, grades ou clés.

Votes des joueurs Il ouvre votre page de vote MineBuff et saisit son pseudo Minecraft.
Nous informons votre serveur MineBuff se connecte à votre port Votifier et transmet le vote.
Feu de récompense NuVotifier / Classic Votifier / GAListener (ou similaire) gère la récompense.

Configurez-le en quatre étapes

Installez Votifier sur votre serveur Minecraft
Utilisez Classic Votifier ou NuVotifier. Ouvrez le port 8192 (ou le port choisi) dans le panneau pare-feu / hôte pour que le public puisse y accéder.
Copier votre clé ou jeton
v1: collez des plugins/Votifier/rsa/public.key (ou NuVotifier rsa/public.key). v2: copiez un jeton de NuVotifier config.yml (souvent par défaut).
Activez-le sur votre liste
Tableau de bord → modifier le serveur → Votifier. Activez la redirection, définissez l'hôte (leave blank pour utiliser votre IP Java), le port et le protocole, puis collez la clé / jeton et enregistrez.
Envoyer un vote test
Utilisez le vote d'essai d'Envoyer sur le même formulaire. Si ça marche, de vrais votes aussi.

Automatique (recommandée)

Picks NuVotifier v2 quand un défi + jeton sont disponibles; sinon revient à v1 RSA.

v1 — Clé RSA

Classic Votifier et NuVotifier RSA. Besoin du contenu du fichier à clé publique.

v2 — Jeton

NuVotifier HMAC jeton de config.yml. Rapide et simple si vous utilisez déjà NuVotifier.

Les plugins de récompenses qui filtrent par site de liste doivent autoriser le nom de service « MineBuff ». Si la livraison échoue, le vote sur le site compte quand même — vérifiez pare-feu et identifiants.

Ouvrir le tableau de bord Comment ajouter un serveur

Vérification du vote API

Demandez à ce que cette IP ait déjà voté pour mon serveur aujourd'hui ? Gratuit, public, pas de clé API.

Ceci ne vote pas

Les joueurs votent toujours sur la page de vote MineBuff. Ces URL indiquent seulement si un vote existe déjà pour aujourd’hui (UTC).

GET

Texte simple

Meilleur pour les plugins simples — toute la réponse est un seul caractère.

https://minebuff.com/api/vote/{slug}/{ip}

1: Déjà voté aujourd'hui
0: Pas encore voté (ou serveur inconnu / inédit)

Exemple curl -s "https://minebuff.com/api/vote/your-server/203.0.113.10"

GET

JSON

Même réponse, plus quand ils ont voté et combien de temps jusqu'à la réinitialisation quotidienne.

https://minebuff.com/api/vote/{slug}/{ip}/json

Champ	Signification
`vote`	— voté aujourd'hui ou non.
`voted_at`	L'heure UTC d'aujourd'hui vote, ou null.
`reset_at_midnight`	Toujours vrai — la fenêtre de vote-vérification quotidienne réinitialise à 00:00 UTC (les totaux de classement sont séparés et réinitialisent environ tous les mois).
`time_until_next_vote`	Deuxième jusqu'à minuit UTC suivant s'ils ont déjà voté; sinon 0.

Exemple

{
  "vote": "1",
  "voted_at": "2026-09-12T14:32:01Z",
  "reset_at_midnight": true,
  "time_until_next_vote": 34199
}

Que mettre dans l'URL

Dans l'URL	Signification
`{slug}`	Votre serveur slug depuis l'URL de listing (par exemple /servers/votre-slug).
`{ip}`	L'adresse IP du lecteur. Nous le hachage; une voix par serveur par IP par jour UTC.

Fonctionne aussi à partir de navigateurs (CORS). Les serveurs inconnus retournent 0 en texte simple, ou HTTP 404 JSON avec erreur server not found.

Règles de vote

Une courte liste de contrôle pour que le timing de votre plugin corresponde à la nôtre.

Vous pouvez voter une fois par serveur par IP chaque jour UTC (00:00 UTC). Les totaux des votes sont effacés environ une fois par mois.
Un vote par serveur publié par adresse IP par jour UTC.
Les votes exigent un pseudo Minecraft sur le formulaire MineBuff (requis pour Votifier).
L'API de vérification ne crée jamais de vote; elle ne rapporte que le statut d'aujourd'hui.

Aide

Snags communs lorsque les récompenses ou l'API ne se comportent pas.

Le vote d'essai échoue ou rien n'arrive en jeu

Confirmez que le port 8192 (ou votre port) est ouvert à Internet, que l'hôte correspond à une adresse accessible, et que la clé / jeton correspond exactement aux fichiers du plugin (pas d'espace supplémentaire).

Quel protocole dois-je choisir ?

Commencez par Auto. Utilisez v2 si vous n'avez qu'un jeton NuVotifier. Utilisez v1 si vous n'avez que la clé publique RSA.

L'API retourne toujours 0

Vérifiez que le listing est publié, que la limace est exacte, et vous passez la vraie IP du joueur (pas 127.0.0.1 à moins qu'ils aient voté de la même machine).

Les livraisons de Votifier ont-elles échoué à annuler le vote ?

Non. Le vote MineBuff compte quand même. Corrigez la connectivité et retestez le vote depuis le tableau de bord.

Puis-je voter dans l'API ?

C'est pas vrai. Les votes sont exprimés sur la page publique des votes. L'API est en lecture seule pour vérifier le vote d'aujourd'hui.