# 🗞️ Configuration de la Sidebar

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.

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"

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.

• 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

La sidebar prend en charge les mêmes placeholders que le tablist:

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"

• 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é

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.