FAQ et dépannage

Questions générales

Que mesure VoxelBench ?

VoxelBench mesure les performances de votre serveur Minecraft à travers plus de 40 tests couvrant le matériel (CPU, RAM, Disque, Réseau) et le gameplay (chargement de chunks, spawn de mobs, redstone, explosions, etc.). Les résultats sont combinés en un VoxelScore unique pour une comparaison facile.

Est-ce que lancer un benchmark affecte mes joueurs ?

Oui, temporairement. Pendant les tests gameplay, le serveur peut subir du lag car VoxelBench sollicite intentionnellement des systèmes spécifiques. Nous recommandons de :

• Lancer les benchmarks pendant les périodes de faible activité
• Prévenir vos joueurs à l'avance
• Utiliser /bench stop pour annuler si nécessaire

Les tests matériels (CPU, RAM, Disque) s'exécutent de manière asynchrone et ont un impact minimal sur le TPS.

Combien de temps dure un benchmark complet ?

Environ 10-15 minutes selon le matériel de votre serveur. Les serveurs plus rapides terminent les tests plus rapidement.

Puis-je lancer des benchmarks sur un serveur de production ?

Oui, mais gardez à l'esprit :

• Il y aura des chutes de TPS temporaires pendant les tests gameplay
• Toutes les entités et blocs de test sont nettoyés automatiquement
• Un cooldown de 30 minutes empêche les relances accidentelles
• Lancez pendant les heures creuses pour de meilleurs résultats

Mes résultats sont-ils publics ?

Les résultats de benchmarks standard soumis à voxelbench.com sont visibles sur le classement public. Vous contrôlez le niveau d'informations matérielles partagées via le paramètre d'anonymisation.

Comment le VoxelScore est-il calculé ?

Le VoxelScore est calculé côté backend en utilisant des moyennes pondérées :

• CPU Single-Core : 45%
• Stress Gameplay : 35%
• Matériel : 20%

Un score plus élevé indique de meilleures performances serveur.

Dépannage

Erreur "Rate limited"

Un cooldown de 30 minutes existe entre les benchmarks. Attendez que le cooldown expire, ou utilisez la permission voxelbench.start.force pour l'ignorer.

Le benchmark est bloqué

Si un test semble figé :

1. Utilisez /bench stop pour annuler
2. Vérifiez les messages d'erreur dans la console
3. Si c'était un test gameplay, vérifiez que le monde/la zone de test est accessible
4. Essayez de lancer le test individuellement : /bench test <nomDuTest>

"Échec de connexion" lors de la soumission des résultats

VoxelBench a besoin d'accéder à voxelbench.com via HTTPS. Vérifiez :

1. Votre serveur peut effectuer des connexions HTTPS sortantes (port 443)
2. voxelbench.com n'est pas bloqué par un pare-feu ou un proxy
3. La résolution DNS fonctionne (nslookup voxelbench.com depuis le serveur)

Les résultats sont sauvegardés localement quel que soit le résultat de la soumission. Vous ne perdrez pas vos données de benchmark.

L'interface ne s'ouvre pas

1. Vérifiez que vous avez la permission voxelbench.gui
2. Vérifiez que votre inventaire n'est pas plein
3. Essayez de recharger : /bench reload
4. Vérifiez la console pour des erreurs

Les tests créent des blocs/entités non nettoyés

VoxelBench utilise des blocs try-finally pour garantir le nettoyage. Si le nettoyage échoue :

1. Vérifiez la console pour des erreurs pendant le test
2. La zone de test est généralement dans des chunks éloignés qui peuvent être régénérés
3. Utilisez un éditeur de monde (WorldEdit) pour nettoyer si nécessaire
4. Signalez cela comme un bug

Le plugin ne se charge pas

1. Vérifiez la version Java : java -version (nécessite Java 16+)
2. Vérifiez la version du serveur : doit être 1.17 ou plus récent
3. Recherchez des erreurs dans la console au démarrage
4. Assurez-vous que le JAR est dans le dossier plugins/ (pas un sous-dossier)
5. Vérifiez que le JAR n'est pas corrompu (re-téléchargez si nécessaire)

Mauvaise langue

VoxelBench détecte automatiquement la langue du client Minecraft de chaque joueur. Pour forcer :

• Pour un joueur : /bench lang fr_FR
• Pour tous les joueurs : Mettez language.force: true et language.default: fr_FR dans la config

Le tableau de bord de monitoring n'est pas accessible

1. Vérifiez que le serveur web est lancé : /bench monitor web start
2. Vérifiez que le port est correct (défaut : 8080)
3. Vérifiez que le pare-feu autorise les connexions entrantes sur le port configuré
4. Si vous accédez à distance, assurez-vous que bind-address est 0.0.0.0 (pas 127.0.0.1)
5. Vérifiez les conflits de port avec d'autres plugins

Erreurs de certificat HTTPS

Avec un certificat auto-signé :

• Les navigateurs afficheront un avertissement de sécurité - c'est normal pour les certificats auto-signés
• Vous pouvez ajouter une exception dans votre navigateur
• Pour un usage en production, envisagez un vrai certificat SSL

Les notifications DiscordSRV ne fonctionnent pas

1. Vérifiez que DiscordSRV lui-même fonctionne
2. Vérifiez que integrations.discordsrv.enabled est à true
3. Vérifiez que le channel-id est correct (ou vide pour le salon par défaut)
4. Vérifiez que notifications.benchmark-results ou d'autres types de notifications sont activés

Les placeholders PlaceholderAPI ne s'affichent pas

1. Vérifiez que PlaceholderAPI est installé et fonctionne
2. Testez avec /papi parse me %voxelbench_tps%
3. Lancez d'abord un benchmark - certains placeholders nécessitent au moins un résultat
4. Rechargez PlaceholderAPI : /papi reload

Conseils de performance

Pour de meilleurs scores de benchmark

1. Réduisez les autres plugins : Désactivez les plugins gourmands en ressources pendant les benchmarks
2. Allouez assez de RAM : Assurez-vous que la JVM a suffisamment d'espace heap
3. Utilisez un Java récent : Java 21 apporte des améliorations de performance significatives par rapport à Java 16/17
4. Utilisez Paper : Paper inclut de nombreuses optimisations de performance par rapport à Spigot
5. Pré-générez votre monde : Pré-générez les chunks pour éliminer le coût de génération
6. Optimisez les flags JVM : Utilisez des flags de démarrage optimisés (flags d'Aikar recommandés)

Pour des résultats plus consistants

1. Lancez plusieurs benchmarks (/bench start 5 60) et moyennez les résultats
2. Assurez-vous que le serveur est inactif pendant les benchmarks
3. Arrêtez les tâches de backup en cours
4. Évitez de lancer pendant des tempêtes de garbage collection (augmentez le heap si nécessaire)