Intégrations
VoxelBench s'intègre avec des plugins populaires pour étendre ses fonctionnalités. Toutes les intégrations sont optionnelles - elles s'activent automatiquement lorsque le plugin correspondant est détecté.
PlaceholderAPI
PlaceholderAPI fournit des placeholders personnalisés utilisables dans les scoreboards, tab lists, hologrammes et autres plugins.
Placeholders disponibles
| Placeholder | Description |
|---|---|
%voxelbench_tps% | TPS actuel |
%voxelbench_mspt% | MSPT actuel |
%voxelbench_score% | Dernier VoxelScore |
%voxelbench_rank% | Dernier palier de classement |
Placeholders Spark
Lorsque VoxelBench et Spark sont tous les deux installés :
| Placeholder | Description |
|---|---|
%voxelbench_spark_available% | Si Spark est disponible (true/false) |
%voxelbench_spark_tps% | TPS Spark (10 secondes) |
%voxelbench_spark_tps_1m% | TPS Spark (1 minute) |
%voxelbench_spark_tps_5m% | TPS Spark (5 minutes) |
%voxelbench_spark_tps_15m% | TPS Spark (15 minutes) |
%voxelbench_spark_mspt% | MSPT moyen Spark (10 secondes) |
%voxelbench_spark_mspt_1m% | MSPT moyen Spark (1 minute) |
%voxelbench_spark_mspt_95% | MSPT 95e percentile Spark |
%voxelbench_spark_mspt_median% | MSPT médian Spark |
%voxelbench_spark_cpu_system% | Utilisation CPU système |
%voxelbench_spark_cpu_process% | Utilisation CPU processus JVM |
%voxelbench_spark_gc% | Résumé GC |
Placeholder DiscordSRV
| Placeholder | Description |
|---|---|
%voxelbench_discordsrv_available% | Si DiscordSRV est disponible (true/false) |
Dynmap
L'intégration Dynmap ajoute des couches visuelles à votre carte en direct.
Configuration
integrations:
dynmap:
enabled: true
update-interval-seconds: 30
layers:
entity-heatmap:
enabled: true
thresholds:
low: 50 # Vert → Jaune
medium: 150 # Jaune → Orange
high: 300 # Orange → Rouge
performance-markers:
enabled: true
entity-threshold: 200
test-zones:
enabled: true
Couches
Heatmap de densité d'entités
Affiche la densité d'entités par chunk sur la carte avec des marqueurs colorés :
- Vert : Sous le seuil
low(normal) - Jaune : Entre
lowetmedium(modéré) - Orange : Entre
mediumethigh(élevé) - Rouge : Au-dessus du seuil
high(critique)
Marqueurs d'alerte de performance
Place des marqueurs d'alerte sur la carte là où la densité d'entités dépasse le seuil configuré. Utile pour identifier les zones causant du lag.
Marqueurs de zones de test
Affiche les zones de test de benchmark actives sur la carte pendant l'exécution des tests.
Permissions
Pour restreindre l'accès aux couches Dynmap, éditez plugins/dynmap/markers.yml et ajoutez les permissions :
sets:
voxelbench.heatmap:
perm: voxelbench.dynmap.heatmap
voxelbench.performance:
perm: voxelbench.dynmap.alerts
voxelbench.testzones:
perm: voxelbench.dynmap.testzones
| Permission | Couche |
|---|---|
voxelbench.dynmap.view | Accès global à toutes les couches |
voxelbench.dynmap.heatmap | Heatmap de densité d'entités |
voxelbench.dynmap.alerts | Marqueurs d'alerte de performance |
voxelbench.dynmap.testzones | Zones de test actives |
Les joueurs doivent être connectés à Dynmap ET avoir la permission appropriée.
Spark
L'intégration Spark fournit des métriques avancées de profilage CPU accessibles via PlaceholderAPI.
Configuration
integrations:
spark:
enabled: true
Quand Spark est installé et activé, VoxelBench expose les métriques de Spark sous forme de placeholders PlaceholderAPI (voir le tableau ci-dessus). Cela permet d'afficher des métriques de qualité Spark dans n'importe quel plugin supportant PlaceholderAPI.
DiscordSRV
L'intégration DiscordSRV envoie les résultats de benchmark et les alertes de performance vers un salon Discord.
Configuration
integrations:
discordsrv:
enabled: true
channel-id: "" # ID du salon Discord (vide = salon principal DiscordSRV)
notifications:
benchmark-results: true # Envoyer les résultats de benchmark
test-results: false # Envoyer les résultats de tests individuels
tps-alerts: true # Envoyer les alertes de chute de TPS
tps-alert-threshold: 18.0 # Seuil TPS pour les alertes
Obtenir un ID de salon
- Activez le Mode développeur dans les paramètres Discord (Paramètres utilisateur → Avancé → Mode développeur)
- Faites un clic droit sur le salon souhaité
- Cliquez sur Copier l'identifiant du salon
- Collez-le dans
channel-id
Si channel-id est vide, VoxelBench utilise le salon principal configuré dans DiscordSRV.
Types de notifications
Résultats de benchmark
Envoyés à la fin d'un benchmark complet. Incluent :
- VoxelScore final et palier de classement
- Scores par catégorie (Matériel, Single-Core, Gameplay)
- Résumé des performances
Résultats de tests
Envoyés après chaque test individuel. Utile pour suivre la progression en temps réel. Désactivé par défaut pour éviter le spam.
Alertes TPS
Envoyées quand le TPS du serveur descend sous le seuil configuré. Limitées à une alerte par 5 minutes pour éviter le spam.
Ajouter d'autres intégrations
Le système de hooks de VoxelBench est conçu pour une dégradation gracieuse :
- Les hooks ne sont chargés que lorsque le plugin correspondant est présent
- Si une intégration échoue, VoxelBench continue de fonctionner normalement
- Aucune configuration supplémentaire n'est nécessaire pour activer les plugins détectés (ils sont activés par défaut)