Liaison de compte — Premiers pas

Anonyme vs authentifié

Fonctionnalité	Anonyme	Authentifié
Lancer des benchmarks	Oui	Oui
Soumettre à voxelbench.com	Oui	Oui
Conservation des rapports sur voxelbench.com	30 minutes	30 jours avec l'offre gratuite, 1 an avec Pro, Enterprise et les comptes d'hébergeur
Historique des rapports	Aucun : un rapport n'est accessible que par son lien	Dans votre tableau de bord
Tableau de bord serveur	Non	Oui
Synchronisation des tests unitaires	Non	Oui
Profils personnalisés (`/bench custom run`)	Non	Oui
Monitoring distant	Non	Oui

Comment lier

1. Démarrer le processus de liaison

Exécutez la commande suivante sur votre serveur :

/bench link

/bench link (et /bench link force, qui remplace un token existant) exige la permission voxelbench.link en plus de voxelbench.use.

2. Recevoir un code de liaison

Le plugin contacte le backend VoxelBench et affiche un code temporaire ainsi qu'un lien. Cliquez sur le lien dans le chat, ou copiez-le dans votre navigateur.

3. Confirmer sur le site

Connectez-vous à votre compte VoxelBench (ou créez-en un) et confirmez la liaison. Le plugin détecte automatiquement votre confirmation.

4. Terminé

Une fois la liaison confirmée, le plugin sauvegarde un token d'authentification et passe en mode authentifié dans config.yml :

mode: authenticated
authentication:
  token: "votre-token"

Important : ne partagez jamais votre token d'authentification. Il permet de soumettre des rapports au nom de votre serveur.

Re-lier

Si vous devez lier le serveur à un autre compte :

/bench link force

Cela remplace le token existant par un nouveau.

Comment ça marche

La liaison suit un flux de type « code d'appareil » :

Le plugin envoie une requête à /api/v1/server/link avec le hash d'identité de votre serveur
Le backend renvoie un code temporaire et une URL de confirmation
Le plugin affiche le code et l'URL à l'opérateur
Le plugin interroge le backend toutes les 5 secondes pour savoir si le code a été confirmé
Une fois le code confirmé, le backend renvoie un token d'authentification
Le plugin sauvegarde le token et passe en mode authentifié

Délais

Le code de liaison expire au bout de 10 minutes
Le plugin cesse d'interroger le backend au bout de 5 minutes ; si vous confirmez plus tard, relancez /bench link
Si le code a expiré, relancez /bench link pour en obtenir un nouveau

Dépannage

« Erreur de connexion » lors de la liaison

Assurez-vous que votre serveur peut ouvrir des connexions HTTPS sortantes (/bench ping aide à le diagnostiquer)
Vérifiez que voxelbench.com n'est pas bloqué par un pare-feu
Réessayez dans quelques minutes si le backend est temporairement indisponible

Message « Déjà lié »

Votre serveur possède déjà un token d'authentification. Utilisez /bench link force pour le remplacer.

Message « Liaison déjà en cours »

« Un processus de liaison est déjà en cours. Veuillez patienter. » signifie qu'une tentative de liaison attend encore sa confirmation : tout autre /bench link ou /bench link force, tapé par vous, par un autre joueur ou depuis la console, est refusé tant qu'elle n'est pas terminée. Confirmez-la sur le site, ou attendez que le plugin cesse d'interroger le backend (5 minutes), puis relancez /bench link si besoin.

Problèmes de token

Si vous rencontrez des erreurs d'authentification après la liaison :

Vérifiez que le token dans config.yml n'est pas corrompu
Essayez de re-lier avec /bench link force
Vérifiez que le backend VoxelBench est accessible