🗞️Configuration de la Sidebar
Ce document détaille la configuration de la sidebar (barre latérale) dans le plugin Horizons.
📝 Introduction
Le système de sidebar de Horizons permet d'afficher une barre latérale personnalisée à droite de l'écran des joueurs. Ce système prend en charge les mêmes placeholders dynamiques que le tablist pour afficher des informations sur le joueur, le serveur et les équipes.
⚙️ Configuration
La configuration de la sidebar se fait dans le fichier config.yml:
settings:
sidebar:
enabled: true # Activer/désactiver la sidebar
title: "&e&lHorizons" # Titre affiché en haut de la sidebar
batch-size: 30 # Nombre de joueurs compris dans chaque batch
update-delay: 20 # Ticks entre chaque batch (20 ticks = 1 seconde)
lines: # Lignes affichées dans la sidebar (de haut en bas)
- "&7&m--------------------"
- "&6Joueur: &f{player}"
- "&6Équipe: &f{teamname}"
- "&6Score d'équipe: &f{teamscore}"
- "&6Santé: &c❤ {health}"
- "&6En ligne: &f{online}/{maxplayer}"
- "&6Ping: &f{ping}ms"
- "&7&m--------------------"
- "&ewww.votreserveur.com"🚀 Paramètres de performance
La sidebar doit être mise à jour régulièrement pour chaque joueur afin d'afficher les informations actualisées (vie, ping, nombre de joueurs, etc.). Sur les serveurs avec beaucoup de joueurs, cette mise à jour peut devenir exigeante pour les performances. Pour résoudre ce problème, Horizons utilise un système de traitement par lots:
batch-size: Détermine combien de joueurs sont mis à jour en même temps.
Valeur plus élevée = mises à jour plus rapides mais possible impact sur les performances
Valeur plus basse = charge répartie mais mises à jour moins fréquentes
Recommandation: 30 pour les serveurs moyens, 10-15 pour les grands serveurs (100+ joueurs)
update-delay: Détermine l'intervalle (en ticks) entre les mises à jour de chaque lot.
20 ticks = 1 seconde dans Minecraft
Valeur plus basse = mises à jour plus fréquentes mais plus de charge serveur
Valeur plus élevée = mises à jour moins fréquentes mais économise des ressources
Recommandation: 20-60 ticks (1-3 secondes) pour un bon équilibre
Ces paramètres vous permettent d'optimiser la sidebar selon votre nombre de joueurs et la puissance de votre serveur. Si vous constatez des ralentissements (lag) liés à la sidebar, essayez d'augmenter l'update-delay ou de réduire le batch-size.
🔄 Fonctionnement
La sidebar affiche un titre configurable en haut et une liste de lignes en dessous
Chaque ligne peut contenir des codes couleur Minecraft (& suivi d'un caractère) et des placeholders
Le contenu est mis à jour automatiquement selon le taux de rafraîchissement défini
Les placeholders sont remplacés par leurs valeurs réelles pour chaque joueur
Un joueur qui se connecte reçoit immédiatement la sidebar configurée
📊 Placeholders disponibles
La sidebar prend en charge les mêmes placeholders que le tablist:
🧑 Placeholders Joueur
{player}
Nom du joueur
Steve
{displayname}
Nom d'affichage du joueur
[VIP] Steve
{ping}
Ping du joueur en ms
42
{health}
Points de vie du joueur
19.5
{food}
Niveau de nourriture du joueur
20
{xp}
Niveau d'expérience du joueur
30
{gamemode}
Mode de jeu du joueur
survival
{uuid}
UUID du joueur
550e8400-e29b-41d4-a716-446655440000
{playerscore}
Score personnel du joueur
250
🏆 Informations sur l'équipe
{prefix}
Préfixe d'équipe du joueur
[Rouge]
{teamname}
Nom de l'équipe du joueur
Rouge
{suffix}
Suffixe d'équipe du joueur
★
{teamcolor}
Couleur de l'équipe du joueur
RED
{teamscore}
Score de l'équipe du joueur
250
🌍 Informations sur le serveur
{online}
Nombre de joueurs en ligne
42
{maxplayer}
Capacité maximale du serveur
100
{world}
Nom du monde actuel
world
{time}
Heure actuelle (HH:mm:ss)
15:30:45
{date}
Date actuelle (JJ/MM/AAAA)
01/01/2023
{ip}
Adresse IP du serveur
127.0.0.1
💰 Intégration avec Vault (si installé)
{balance}
Solde économique du joueur
1250.00
💡 Exemples d'utilisation
Sidebar simple avec informations essentielles
settings:
sidebar:
enabled: true
title: "&6&l✦ &e&lMon Serveur &6&l✦"
batch-size: 30
update-delay: 20
lines:
- "&fJoueur: &e{player}"
- "&fÉquipe: &e{teamname}"
- "&fPoints de vie: &c{health} ❤"
- "&fEn ligne: &e{online}&7/&e{maxplayer}"Sidebar détaillée
settings:
sidebar:
enabled: true
title: "&6&l✦ &e&lMon Serveur &6&l✦"
batch-size: 30
update-delay: 20
lines:
- "&7&m------------------------"
- "&fÉquipe: &e{teamname} &7(&f{teamscore}&7)"
- "&7"
- "&fJoueurs: &e{online}&7/&e{maxplayer}"
- "&fPing: &a{ping}ms"
- "&7"
- "&fDate: &e{date}"
- "&fHeure: &e{time}"
- "&7&m------------------------"
- "&ewww.mon-serveur.com"⚠️ Remarques
Le nombre maximum de lignes recommandé est de 15 pour éviter les problèmes d'affichage
Les codes couleur utilisent le format Minecraft (& + code)
Les lignes vides peuvent être utilisées pour espacer le contenu ("&7")
Le taux de rafraîchissement ne devrait pas être trop rapide pour éviter les problèmes de performance
Si une ligne contient uniquement un placeholder qui renvoie une valeur vide, la ligne sera quand même affichée (avec un espace vide)
La sidebar peut fonctionner en même temps que le tablist personnalisé
🔗 Intégration
La sidebar s'intègre parfaitement avec le système d'équipes de Horizons. Les préfixes, noms et scores d'équipe configurés via la commande /horizons team seront automatiquement utilisés dans les placeholders d'équipe.
Dernière mise à jour