Liaison de serveur — Compte

La liaison en bref

Sur le serveur, lancez /bench link, dans la console ou en jeu (la permission voxelbench.link est nécessaire). Le plugin affiche un code de 8 caractères et un lien, valables 10 minutes.
Ouvrez le lien, ou allez dans Tableau de bord → Serveurs → Lier un serveur, et connectez-vous. L'adresse email de votre compte doit être vérifiée.
Sur la page Lier votre serveur, le code est déjà rempli si vous êtes passé par le lien ; sinon, saisissez-le dans Code de liaison. Donnez un nom au serveur si vous le souhaitez (Nom du serveur (optionnel)), puis cliquez sur Lier ce serveur.
Le plugin vérifie toutes les 5 secondes pendant 5 minutes, reçoit le jeton de liaison du serveur et l'enregistre dans sa configuration. Si vous confirmez plus tard, relancez /bench link.

Le côté serveur, avec les messages qu'affiche le plugin et que faire quand la liaison échoue, se trouve dans Liaison de compte. Un script ou un agent peut aussi confirmer un code pour vous par l'API (voir API et jetons).

Ce que la liaison apporte

	Serveur non lié	Serveur lié
Rapports de benchmark	Anonymes : toute personne qui a le lien peut l'ouvrir, et le rapport expire au bout de 30 minutes	Dans votre compte, privés par défaut, conservés 30 jours avec l'offre gratuite et 1 an avec Pro (voir Plans et limites) ; vous pouvez rendre chacun non répertorié ou public
Résultats de tests unitaires (`/bench test`)	Non envoyés	Envoyés quand `reports.backend.unit-tests` vaut `true` dans le plugin, et conservés dans votre compte (voir Tests unitaires)
Runs de profils personnalisés	Refusés	Conservés dans votre compte, sans score, jamais publics
Profils et rapports mémoire	Impossible à envoyer	`/bench profile upload` et `/bench memory upload` les envoient dans votre compte
Monitoring et alertes	Indisponibles	Disponibles avec une offre qui comprend le monitoring (voir Vue d'ensemble du monitoring)
Vérification et auto-bench	Indisponibles	Vous pouvez vérifier le serveur, puis y faire tourner l'auto-bench (voir L'auto-bench sur le site)

La liaison elle-même est gratuite, quelle que soit l'offre. La durée de conservation des envois, et ce qu'ajoutent les offres payantes, sont détaillées dans Plans et limites.

Gérer vos serveurs

La page Serveurs

Tableau de bord → Serveurs liste tous les serveurs liés à votre compte, avec leurs badges (Vérifié ou Non vérifié, Public, Monitoring). Vous pouvez y :

lier un autre serveur avec Lier un serveur ;
ranger les serveurs en groupes avec Nouveau groupe, puis Déplacer vers un groupe dans le menu d'un serveur. Les groupes ne servent qu'à organiser cette liste ;
ouvrir les paramètres d'un serveur avec Gérer.

Paramètres du serveur

La page des paramètres d'un serveur compte cinq onglets :

Onglet	Ce que vous y faites
Général	Renommer le serveur (Nom du serveur), choisir s'il apparaît sur votre profil public et définir son icône et sa bannière, et ouvrir son Historique des benchmarks : tous les rapports et tests unitaires qu'il a envoyés
Connexion	Vérification du serveur : prouver que vous contrôlez le serveur à son adresse publique et obtenir le badge Vérifié (voir Vérification du serveur). Connexion du plugin : la version du plugin, son dernier contact, une empreinte de l'adresse d'où il se connecte, et Révoquer le jeton du plugin
Monitoring	Activer ou couper le monitoring de ce serveur et suivre sa mise en place, ouvrir une Page de statut publique et sonde externe, et consulter ses profils de performance (voir Dashboard de monitoring)
Notifications	Notifier à chaque nouveau rapport (voir Avis de nouveau rapport), et une fois cette case activée, Email de notification. URL du webhook Discord s'affiche toujours, que Notifier à chaque nouveau rapport soit activé ou non : les alertes métriques et les alertes d'événements de ce serveur publient sur ce webhook, pour les règles dont le canal Discord est actif
Zone de danger	Délier le serveur

Avis de nouveau rapport

Dans l'onglet Notifications du serveur, activez Notifier à chaque nouveau rapport. Dès lors, chaque rapport de benchmark que le serveur envoie à votre compte (un run lancé avec /bench) déclenche :

un courriel avec le nom du serveur, le mode, le score et le rang (ou la raison de leur absence) et un lien vers le rapport. Il part à l'adresse de votre compte, ou à l'Email de notification que vous saisissez — une fois que son titulaire a cliqué sur le lien de confirmation que nous lui envoyons. D'ici là, il part à l'adresse de votre compte ;
un message Discord sur le webhook du serveur, s'il est renseigné dans le même onglet.

Les runs d'auto-bench ne sont pas concernés (ils sont signalés dans le panneau Auto-bench), ni les tests unitaires. Courriels et messages Discord passent par la même file d'envoi que les alertes de monitoring, avec réessais. Chaque courriel contient un lien pour désactiver ces courriels ; vous pouvez les réactiver dans Compte > Notifications > Nouveaux rapports de vos serveurs.

Relier, révoquer, délier

Relier. Sur le serveur, /bench link force demande un nouveau code alors que le serveur a déjà un jeton. Le confirmer depuis votre tableau de bord donne un nouveau jeton au serveur, lui retire sa vérification et son adresse vérifiée, et vous prévient par email. Vérifiez de nouveau le serveur ensuite. L'API et le connecteur Claude refusent de relier un serveur déjà lié à votre compte : cela se fait uniquement depuis le tableau de bord.
Révoquer le jeton du plugin (onglet Connexion). Le plugin est désormais refusé, jusqu'à ce que vous reliiez le serveur avec /bench link. Le serveur, ses rapports et son historique de monitoring sont conservés. Faites-le si le jeton a pu fuiter, par exemple quand l'empreinte réseau change sans que vous ayez déplacé le serveur.
Délier (onglet Zone de danger). Le serveur quitte votre compte. Ses rapports et ses résultats de tests unitaires restent dans votre compte ; ses données de monitoring, ses événements, ses règles d'alerte et leur historique, ses cibles d'auto-bench, ses profils et ses rapports mémoire envoyés sont supprimés. Les prochains rapports de ce serveur ne sont plus rattachés à vous.

Sécurité

Le code de 8 caractères prouve que la personne qui le saisit peut lire la console du serveur. Il est valable 10 minutes et ne sert qu'une fois.
Le jeton de liaison est une chaîne hexadécimale aléatoire de 64 caractères. voxelbench.com ne le remet que pendant les 5 minutes qui suivent votre confirmation, et seulement à l'adresse qui a demandé le code. Il n'en garde ensuite qu'une empreinte, jamais le jeton lui-même.
Le plugin conserve le jeton dans plugins/VoxelBench/config.yml (authentication.token). Ne le partagez jamais : qui le détient peut envoyer des données au nom de votre serveur.
Le monitoring et les envois de fichiers utilisent le jeton seul. Les rapports de benchmark et les résultats de tests unitaires portent en plus une signature à usage unique que seuls les jars officiels de VoxelBench savent produire, et voxelbench.com refuse un jar qu'il ne connaît pas (voir Comment fonctionne VoxelBench).