Commandes
Toutes les commandes VoxelBench commencent par /bench. Alias : /benchmark, /b.
Commandes générales
| Commande | Description | Permission |
|---|---|---|
/bench | Ouvre l'interface graphique principale. | voxelbench.use |
/bench start | Lance le benchmark standard. | voxelbench.start |
/bench start force | Outrepasse le contrôle de présence de joueurs. | voxelbench.start.force |
/bench stop | Annule le benchmark / le run auto-bench en cours. | voxelbench.stop |
/bench test <id> [k=v…] | Lance un test unique. | voxelbench.test.<id> |
/bench tests | Alias de /bench test. | — |
/bench tests list | Liste tous les tests enregistrés, groupés par catégorie. | voxelbench.test |
/bench gui | Ouvre l'interface directement. | voxelbench.gui |
/bench info | Identité serveur + infos plugin. | voxelbench.info |
/bench reports | Navigateur des rapports locaux. | voxelbench.reports |
/bench reload | Recharge la config + les langues. | voxelbench.reload |
/bench lang <locale> | Change la langue en jeu pour l'auteur. | voxelbench.lang |
/bench monitor | Ouvre l'interface de monitoring. | voxelbench.monitor |
/bench stresslimit | Lance le mode point-de-rupture. | voxelbench.stresslimit |
/bench verify <code> | Flux de vérification d'appairage serveur. | voxelbench.verify |
/bench world … | Cycle de vie des mondes de benchmark. | voxelbench.world |
/bench custom … | Profils de benchmark personnalisés. | voxelbench.custom |
/bench help | Aide explicite. | — |
Commandes de benchmark
| Commande | Description | Permission |
|---|---|---|
/bench | Ouvre l'interface graphique principale. | voxelbench.use |
/bench start | Lance le benchmark standard. | voxelbench.start |
/bench start force | Outrepasse le contrôle de présence de joueurs. | voxelbench.start.force |
/bench stop | Annule le benchmark / le run auto-bench en cours. | voxelbench.stop |
/bench test <id> [k=v…] | Lance un test unique. | voxelbench.test.<id> |
/bench tests | Alias de /bench test. | — |
/bench tests list | Liste tous les tests enregistrés, groupés par catégorie. | voxelbench.test |
/bench gui | Ouvre l'interface directement. | voxelbench.gui |
/bench info | Identité serveur + infos plugin. | voxelbench.info |
/bench reports | Navigateur des rapports locaux. | voxelbench.reports |
/bench reload | Recharge la config + les langues. | voxelbench.reload |
/bench lang <locale> | Change la langue en jeu pour l'auteur. | voxelbench.lang |
/bench monitor | Ouvre l'interface de monitoring. | voxelbench.monitor |
/bench stresslimit | Lance le mode point-de-rupture. | voxelbench.stresslimit |
/bench verify <code> | Flux de vérification d'appairage serveur. | voxelbench.verify |
/bench world … | Cycle de vie des mondes de benchmark. | voxelbench.world |
/bench custom … | Profils de benchmark personnalisés. | voxelbench.custom |
/bench help | Aide explicite. | — |
Benchmark complet
/bench start
Exécute tous les tests dans l'ordre : Matériel → Gameplay → CPU Single-Core. Les résultats sont soumis à voxelbench.com.
Une confirmation est requise avant le lancement (configurable via confirmation.require-confirmation dans la config).
Mode multi-run
/bench start 5 60
Lance le benchmark 5 fois avec un délai de 60 secondes entre chaque exécution. Utile pour obtenir des résultats moyennés et réduire la variance. Nécessite une confirmation.
Avec préchauffage du benchmark
/bench start 5 60 warmup
Exécutez un ou plusieurs tests de performance, en commençant par un test de préchauffage afin de préparer le serveur, le GC et les autres facteurs susceptibles d'influencer le calcul du score.
Commandes de tests individuels
| Commande | Permission | Description |
|---|---|---|
/bench test | voxelbench.test | Lister tous les tests disponibles |
/bench test <nom> | voxelbench.test.<nom> | Lancer un test spécifique |
Tests matériels
| Commande | Permission |
|---|---|
/bench test multiCore | voxelbench.test.multicore |
/bench test memory | voxelbench.test.memory |
/bench test disk | voxelbench.test.disk |
/bench test network | voxelbench.test.network |
Tests single-core
| Commande | Permission |
|---|---|
/bench test mobPathfinding | voxelbench.test.mobpathfinding |
/bench test redstone | voxelbench.test.redstone |
/bench test blockPhysics | voxelbench.test.blockphysics |
Tests gameplay
| Commande | Permission |
|---|---|
/bench test chunkLoading | voxelbench.test.chunkloading |
/bench test mobSpawn | voxelbench.test.mobspawn |
/bench test hopper | voxelbench.test.hopper |
/bench test explosion | voxelbench.test.explosion |
/bench test worldSave | voxelbench.test.worldsave |
/bench test lightingUpdate | voxelbench.test.lighting |
/bench test entityCollision | voxelbench.test.collision |
/bench test tickingTileEntity | voxelbench.test.tileentity |
/bench test villagerTrading | voxelbench.test.villager |
/bench test chunkTicking | voxelbench.test.chunkticking |
/bench test boneMealGrowth | voxelbench.test.bonemealgrowth |
/bench test liquidPhysics | voxelbench.test.liquidphysics |
/bench test combatSimulation | voxelbench.test.combatsimulation |
/bench test mobAI | voxelbench.test.mobai |
Paramètres personnalisés
En mode custom (benchmark-mode: custom dans la config), certains tests acceptent des paramètres :
/bench test multiCore 100 100000 # threads, itérations
/bench test disk 512 # taille du fichier en Mo
/bench test memory 512 3 # taille en Mo, passes
/bench test chunkLoading 200 # nombre de chunks
/bench test mobSpawn 300 # nombre de mobs
/bench test hopper 3 # lignes parallèles
/bench test explosion 30 # nombre de TNT
/bench test mobPathfinding 100 # nombre de mobs
/bench test redstone 50 # nombre de circuits
/bench test blockPhysics 200 # nombre de blocs
En mode standard (par défaut), des valeurs fixes sont utilisées pour garantir la comparabilité entre serveurs.
Profils de benchmark personnalisés
Les profils personnalisés sont des fichiers YAML qui décrivent une
séquence de tests reproductible avec vos propres paramètres. Ils sont
stockés dans plugins/VoxelBench/custom_benchmarks/.
| Commande | Description |
|---|---|
/bench custom run <nom> | Lance le profil <nom>.yml. |
/bench custom list | Liste tous les profils trouvés dans le dossier. |
/bench custom info <nom> | Affiche les métadonnées du profil + la liste de tests. |
/bench custom reload | Relit le dossier sans redémarrer le serveur. |
Trois profils préconfigurés sont fournis avec le plugin :
standard.yml (miroir de /bench start), showcase.yml (plus long et
exhaustif), et example.yml (référence annotée). Voir
Profils personnalisés pour le schéma
YAML.
Permission : voxelbench.custom (défaut : op).
Commandes de monitoring
| Commande | Permission | Description |
|---|---|---|
/bench monitor web start | voxelbench.monitor.web | Démarrer le tableau de bord web |
/bench monitor web stop | voxelbench.monitor.web | Arrêter le tableau de bord web |
/bench monitor bars | voxelbench.monitor.bars | Activer/désactiver les boss bars |
/bench monitor push start | voxelbench.monitor.web | Démarrer le mode push |
/bench monitor push stop | voxelbench.monitor.web | Arrêter le mode push |
/bench monitor hash <mdp> | voxelbench.monitor.web | Définir le mot de passe du dashboard |
/bench monitor apikey | voxelbench.monitor.web | Générer une clé API |
/bench monitor whitelist add <ip> | voxelbench.monitor.web | Ajouter une IP à la whitelist |
/bench monitor whitelist remove <ip> | voxelbench.monitor.web | Retirer une IP de la whitelist |
/bench monitor https generate | voxelbench.monitor.web | Générer un certificat SSL |
Gestion des mondes de benchmark
Les benchmarks de VoxelBench ont besoin d'un environnement contrôlé. Par défaut, le plugin crée un monde plat jetable à chaque run, mais vous pouvez épingler un monde précis pour que chaque exécution utilise la même carte.
| Commande | Description |
|---|---|
/bench world list | Liste tous les mondes voxelbench_* connus du serveur. |
/bench world show | Affiche le monde actuellement épinglé (ou <aucun> si auto-temp). |
/bench world set <nom> | Épingle <nom> comme monde cible pour les benchmarks suivants. |
/bench world unset | Retire l'épinglage. Les futurs runs reviennent en auto-temp. |
/bench world create <nom> | Crée un nouveau monde plat voxelbench_<nom>. |
/bench world delete <nom> | Décharge et supprime le monde voxelbench_<nom> du disque. |
Le préfixe voxelbench_* est imposé — ces commandes ne peuvent pas
toucher votre map survie ou production. Voir
Gestion des mondes pour le cycle de
vie complet, la persistance et l'intégration avec Multiverse-Core.
Permission : voxelbench.world (défaut : op).
Profils de benchmark personnalisés
Les profils personnalisés sont des fichiers YAML qui décrivent une
séquence de tests reproductible avec vos propres paramètres. Ils sont
stockés dans plugins/VoxelBench/custom_benchmarks/.
| Commande | Description |
|---|---|
/bench custom run <nom> | Lance le profil <nom>.yml. |
/bench custom list | Liste tous les profils trouvés dans le dossier. |
/bench custom info <nom> | Affiche les métadonnées du profil + la liste de tests. |
/bench custom reload | Relit le dossier sans redémarrer le serveur. |
Trois profils préconfigurés sont fournis avec le plugin :
standard.yml (miroir de /bench start), showcase.yml (plus long et
exhaustif), et example.yml (référence annotée). Voir
Profils personnalisés pour le schéma
YAML.
Commandes de rapports
| Commande | Permission | Description |
|---|---|---|
/bench reports | voxelbench.reports | Ouvrir l'interface des rapports |
/bench reports list | voxelbench.reports | Lister les rapports sauvegardés |
Commandes de vérification du serveur
| Commande | Permission | Description |
|---|---|---|
/bench verify <CODE> | voxelbench.verify | Lancer la vérification du serveur |
/bench verify status | voxelbench.verify | Vérifier le statut de la vérification |
/bench verify cancel | voxelbench.verify | Annuler la vérification en cours |
Commandes de liaison de compte
| Commande | Permission | Description |
|---|---|---|
/bench link | voxelbench.use | Démarrer le processus de liaison |
/bench link force | voxelbench.use | Re-lier (remplacer le token existant) |
Commandes Stress Limit
| Commande | Permission | Description |
|---|---|---|
/bench stresslimit | voxelbench.stresslimit | Ouvrir l'interface Stress Limit |
Tests d'extension
Les tests enregistrés par des plugins tiers via l'API d'extension
apparaissent sous leur propre namespace <plugin>.<id> et acceptent
des paramètres sous forme clé=valeur en ligne de commande :
/bench test monplugin.cacheBench iterations=200 warmup=20
/bench test <id> <TAB> complète automatiquement à partir du registry
en direct, donc tout test d'extension apparaît dès que son plugin
s'active. La liste de paramètres dans l'autocomplétion est dérivée des
ParamSpec déclarées par le test — aucune liste maintenue à la main.