Migrer ses votes depuis un autre annuaire vers Huby

L’annuaire de Huby récompense les votes comme les autres annuaires : ton serveur demande si un joueur a voté, puis marque la récompense donnée. L’API est volontairement la même que celle de minecraftpocket-servers.com et de minecraft-mp.com, pour qu’un greffon déjà réglé marche sans réécriture. Voici les trois étapes, puis les autres façons de recevoir les votes.

1. Réclame ta fiche

Chaque serveur de l’annuaire a une fiche, sous hubyy.fr/serveurs/<nom>/. Si la tienne n’existe pas, ajoute ton serveur en te connectant avec Discord : tu en es le propriétaire tout de suite. Si elle existe déjà (une fiche créée par l’équipe porte la mention « fiche non réclamée »), clique « Réclamer ce serveur » en bas de la fiche. Deux preuves possibles :

• Un enregistrement DNS, si ton serveur a un nom de domaine. La page de réclamation te donne un code ; ajoute chez ton registraire un enregistrement TXT sur le sous-domaine hubyy de ton adresse, puis relance la vérification. La fiche est à toi dès que l’enregistrement est visible.

hubyy.play.monserveur.fr.   TXT   "huby-verification=<code donné par la page>"

L’enregistrement peut aussi être posé sur un domaine parent (hubyy.monserveur.fr pour play.monserveur.fr). La propagation prend de quelques minutes à quelques heures selon le registraire.

• Le Discord, si ton serveur n’a qu’une adresse IP, ou si tu ne touches pas au DNS : dis-le sur le Discord Huby et l’équipe t’attribue la fiche.

2. Crée ta clé d’API

Sur ta fiche (hubyy.fr/annuaire/fiche/<nom>/), le bloc « Clé d’API » crée ta clé. Elle n’est montrée qu’une fois : copie-la dans le réglage de ton greffon. Tu peux la renouveler à tout moment ; l’ancienne cesse alors de marcher. Huby ne garde qu’une empreinte de la clé, jamais la clé elle-même.

3. Change l’adresse dans ton greffon

Un greffon écrit pour minecraftpocket-servers.com ou minecraft-mp.com appelle https://minecraftpocket-servers.com/api/ (ou https://minecraft-mp.com/api/). Remplace cette adresse par celle de Huby, et rien d’autre :

https://hubyy.fr/api/

Les paramètres et les réponses sont les mêmes. Savoir si un joueur a voté :

GET https://hubyy.fr/api/?object=votes&element=claim&key=<ta clé>&username=<pseudo>

La réponse est un chiffre seul : 0 le joueur n’a pas voté, 1 il a voté et attend sa récompense, 2 il a voté et a déjà été récompensé. Marquer la récompense donnée :

POST https://hubyy.fr/api/?action=post&object=votes&element=claim&key=<ta clé>&username=<pseudo>

Réponse 1 si la récompense vient d’être marquée, 0 sinon (pas de vote en attente, ou déjà marquée). Une clé inconnue répond Error: server key not found ; un pseudo vide ou trop long, Error: invalid username.

Pour vérifier depuis un terminal, vote d’abord pour ton serveur depuis sa page de vote (hubyy.fr/annuaire/voter/<nom>/), puis :

curl "https://hubyy.fr/api/?object=votes&element=claim&key=<ta clé>&username=<ton pseudo>"

Votifier et NuVotifier

Si ton serveur reçoit déjà ses votes par Votifier, Huby peut les pousser directement, sans greffon d’annuaire. Sur ta fiche, le bloc « Votifier » prend :

• l’hôte et le port de ton Votifier (8192 par défaut) ; une adresse de réseau privé est refusée ;
• la clé publique de ton Votifier v1 (le contenu de rsa/public.key, en base64 ou en PEM) ou, pour NuVotifier v2, le jeton de la section tokens de son config.yml.

Le bouton « Envoyer un vote d’essai » envoie un vote au pseudo HubyTest. En v2, le serveur confirme la réception et la fiche l’affiche. En v1, Votifier ne confirme rien : regarde la console du serveur. Le vote arrive avec le nom de service Huby ; l’adresse du votant n’est jamais transmise.

Pour qu’un vote soit récompensé, ton greffon de votes doit accepter le service Huby : la plupart l’acceptent par défaut, sinon ajoute-le à sa liste de services.

L’API Huby

Si tu écris ton propre greffon, l’API de Huby est plus simple à lire. La clé passe dans l’en-tête Authorization, le pseudo dans l’adresse :

GET https://hubyy.fr/api/v1/votes/<pseudo>
Authorization: Bearer <ta clé>

{ "pseudo": "Steve", "aVote": true, "recompense": false }

Pour marquer la récompense donnée :

POST https://hubyy.fr/api/v1/votes/<pseudo>/recompense
Authorization: Bearer <ta clé>

{ "pseudo": "Steve", "recompense": true }

recompense vaut true la première fois, false ensuite ou sans vote en attente. Sans clé ou avec une clé inconnue, la réponse est 401 avec { "erreur": "cle" } ; un pseudo invalide, 400 avec { "erreur": "pseudo" }.

Ce qu’il faut savoir sur les votes

• Un joueur vote une fois par serveur toutes les 24 heures, avec son gamertag et une vérification anti-robot. Un pseudo Geyser peut commencer par un point : l’API le reçoit tel quel.
• Un vote est gardé 40 jours, puis effacé ; seuls les totaux restent. Ton greffon a donc le temps de le récompenser, même après un redémarrage.
• La page de vote de ta fiche se règle depuis ta fiche : la récompense annoncée, un message, un remerciement.
• Dis-le à tes joueurs : le lien de vote est hubyy.fr/annuaire/voter/<nom>/, et chaque vote compte dans le classement du mois.