🧾Configuration du Tablist

Ce document détaille la configuration du tablist dans le plugin Horizons.

📝 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 {balance}, 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.