# 🧾 Configuration du Tablist

# 📝 Introduction

Le système de tablist de Horizons permet de personnaliser l'en-tête et le pied de page de la tablist. Ce système prend en charge de nombreux placeholders dynamiques pour afficher des informations sur le joueur, le serveur et les équipes.

# ⚙️ Configuration

La configuration du tablist se fait dans le fichier config.yml:

settings:
  tablist:
    enabled: true        # Activer/désactiver le système de tablist
    header:              # En-tête du tablist (affiché en haut)
      - '&7'
      - '&3&lMa cité'
      - '&7'
      - '&fBienvenue sur le serveur!'
      - '&7'
    footer:              # Pied de page du tablist (affiché en bas)
      - '&7'
      - '&fJoueurs connectés: &e{online}'
      - '&7'
      - '&fDiscord: &bdiscord.gg/macité'
      - '&7'

# 🔄 Fonctionnement

Le header et le footer sont composés de listes de lignes qui seront jointes par des sauts de ligne
Chaque ligne peut contenir des codes couleur Minecraft (& suivi d'un caractère) et des placeholders
Le tablist est mis à jour automatiquement pour tous les joueurs
Un joueur qui se connecte reçoit immédiatement le tablist configuré

# 📊 Placeholders disponibles

Le système de tablist prend en charge de nombreux placeholders qui sont remplacés dynamiquement :

# 🧑 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

En-tête avec informations du joueur

settings:
  tablist:
    enabled: true
    header:
      - '&6&lServeur Survie'
      - '&fBonjour &b{player} &f(&a{ping}ms&f)'
      - '&fVie: &c{health} &f| &7Mode: &e{gamemode}'
    footer:
      - '&7'
      - '&fVotre équipe: {prefix} {teamname}'
      - '&fJoueurs en ligne: &e{online}&7/&f{maxplayer}'
      - '&fDate: &e{date} &7| &fHeure: &e{time}'

# ⚠️ Remarques

Les codes couleur utilisent le format Minecraft (& + code)
Les lignes vides ('&7') peuvent être utilisées pour l'espacement
Certains placeholders, comme , nécessitent l'utilisation de Vault
Les placeholders d'équipe ne s'afficheront que si le joueur appartient à une équipe

# 🔗 Intégration

Le système de tablist s'intègre parfaitement avec le système d'équipes de Horizons. Les préfixes et couleurs d'équipe configurés via la commande /horizons team seront automatiquement utilisés dans les placeholders d'équipe.