🗞️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

Placeholder	Description	Exemple
{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

Placeholder	Description	Exemple
{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

Placeholder	Description	Exemple
{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é)

Placeholder	Description	Exemple
{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.