Vérification du serveur — Premiers pas

Comment ça marche

Liez d'abord le serveur avec /bench link (voir Liaison de compte).
Sur voxelbench.com, la page du serveur lié comporte une section Vérification du serveur. Saisissez-y l'adresse publique du serveur et générez un code (format : VOXEL-XXXXX). Le code est valable 10 minutes.
Vous exécutez la commande de vérification sur votre serveur.
Le plugin enregistre la tentative auprès de voxelbench.com, qui vérifie que le code a été généré pour ce serveur, et ajoute des données de vérification cachées à la réponse d'état de votre serveur (le ping de la liste des serveurs, qui contient la MOTD).
voxelbench.com pingue l'adresse, trouve ces données et marque le serveur comme vérifié.

Un serveur ne peut être vérifié que par un seul compte.

Guide étape par étape

1. Obtenir un code de vérification

Ouvrez votre tableau de bord VoxelBench, puis la page du serveur lié. Dans Vérification du serveur, saisissez l'adresse qu'utilisent les joueurs pour se connecter (le port est facultatif) et cliquez sur Générer le code. Vous recevez un code comme VOXEL-A1B2C, valable 10 minutes.

2. Exécuter la commande de vérification

Sur votre serveur, exécutez :

/bench verify VOXEL-A1B2C

Le plugin va :

Valider le format du code
Contacter le backend VoxelBench pour enregistrer la tentative de vérification ; le code ne fonctionne que sur le serveur dont la page l'a généré
Ajouter les données de vérification à la réponse au ping de la liste des serveurs, cachées sous les lignes visibles de la MOTD
Demander au backend toutes les 10 secondes si la vérification est terminée

3. Terminer la vérification sur le site

Retournez sur voxelbench.com : une fois que la page indique que le plugin est activé, cliquez sur Vérifier le serveur. Le site pingue votre serveur pour confirmer que vous en êtes le propriétaire.

4. Vérification terminée

Une fois le serveur confirmé par le site, les données de vérification sont retirées de la réponse au ping, et le joueur qui a lancé la vérification (ainsi que les joueurs connectés disposant de voxelbench.verify) reçoit un message de succès en jeu.

Commandes

Commande	Description
`/bench verify <CODE>`	Lancer la vérification avec le code donné
`/bench verify status`	Savoir si une vérification est active et le temps restant
`/bench verify cancel`	Annuler la vérification en cours

Délai et sécurité

Le code généré sur le site expire au bout de 10 minutes : le plugin doit l'enregistrer, et vous devez cliquer sur Vérifier le serveur, dans ce délai. Passé ce délai, générez un nouveau code.
Sur le serveur, les données de vérification restent dans la réponse au ping 15 minutes au plus, puis sont retirées automatiquement
Une seule vérification peut être active à la fois
Pour utiliser un autre code, annulez d'abord le code actuel avec /bench verify cancel

Mode hors-ligne

Si le backend VoxelBench est injoignable au moment où vous lancez la commande, le plugin ajoute quand même les données de vérification à la réponse au ping (« mode hors-ligne »). Le site, lui, ne vérifie qu'un serveur dont le plugin a enregistré le code : une fois la connexion rétablie (/bench ping aide à le diagnostiquer), lancez /bench verify cancel, puis de nouveau /bench verify <CODE> tant que le code est valable.

Dépannage

Erreur « Format invalide »

Le code doit respecter le format VOXEL-XXXXX (5 lettres ou chiffres). Vérifiez que vous l'avez correctement copié depuis le site.

Ce que le site a répondu

Quand voxelbench.com refuse le code, /bench verify dit pourquoi. Dans chacun de ces cas, rien n'est ajouté à la réponse au ping :

Message	Signification et marche à suivre
« Ce code de vérification a expiré. »	Les 10 minutes sont écoulées. Générez un nouveau code sur la page du serveur, puis relancez `/bench verify` avec lui
« Ce code a été généré pour un autre serveur. »	Le code appartient à un autre serveur de votre compte, reconnu par son identité (`plugins/VoxelBench/identity.yml`, voir Confidentialité). Lancez la commande sur le serveur dont la page l'a généré, ou générez un code sur la page de celui-ci
« Trop de tentatives de vérification. »	Le site limite les tentatives. Attendez quelques minutes avant de réessayer : retaper la commande tout de suite n'y change rien
« Code de vérification introuvable. »	Le site ne connaît pas ce code (faute de frappe, ou code remplacé par un plus récent). Générez un nouveau code
« Ce serveur est déjà vérifié sur voxelbench.com : rien à faire. »	Le serveur est déjà vérifié : rien n'est ajouté au ping, et il n'y a rien à cliquer sur le site

Un code que le site rejette comme mal formé affiche « Code de vérification invalide : … » ; une erreur du côté du site affiche « Erreur serveur (HTTP …) », suivi de « Veuillez réessayer plus tard. ».

La vérification ne se termine pas

Assurez-vous que le port de jeu de votre serveur est joignable depuis Internet à l'adresse saisie (derrière un proxy comme BungeeCord ou Velocity, le site doit atteindre la réponse d'état de ce serveur)
Vérifiez qu'aucun pare-feu ne bloque les connexions entrantes sur le port de jeu
Vérifiez que le code n'a pas expiré (10 minutes) : sinon, générez-en un nouveau
Annulez puis relancez la vérification avec /bench verify cancel suivi de /bench verify <CODE>

Erreur « Une autre vérification est en cours »

Une vérification précédente est encore active. Annulez-la d'abord :

/bench verify cancel

Puis lancez-en une nouvelle avec votre code.