✍️Chat et Messages

Ce document détaille la configuration du système de chat et des messages de connexion/déconnexion du plugin Horizons.

📝 Introduction

Horizons permet de personnaliser entièrement le format du chat et les messages de connexion/déconnexion des joueurs. Le système prend en charge les codes couleur et inclut des fonctionnalités avancées comme le ping des joueurs dans le chat.

⚙️ Configuration

La configuration se fait dans le fichier config.yml:

settings:
  # -------------------------------------
  # Join/Leave Messages
  # -------------------------------------
  join-leave-messages:
    enabled: true              # Activer/désactiver les messages personnalisés
    join: '&8[&a+&8] {prefix}{player}'  # Message quand un joueur se connecte
    quit: '&8[&c-&8] {prefix}{player}'  # Message quand un joueur se déconnecte
      
  # -------------------------------------
  # Chat Configuration
  # -------------------------------------
  custom-chat:
    # Format du chat personnalisé avec variables:
    # {prefix} - Préfixe de l'équipe du joueur
    # {player} - Nom du joueur
    # {message} - Message envoyé
    enabled: true
    format: '{prefix}{player} &8» &7{message}'
    staff-format: '{prefix}{player} &8» &f{message}'
    
    # Configuration du ping des joueurs dans le chat
    ping:
      enabled: true
      highlight-color: '&e'  # Couleur de surbrillance pour le nom pingé
      sound: ENTITY_EXPERIENCE_ORB_PICKUP  # Son joué lorsqu'un joueur est pingé
      volume: 1.0
      pitch: 1.0

🔊 Messages de connexion et déconnexion

🎮 Fonctionnalités

• Personnalisation complète: Modifiez le format des messages de connexion/déconnexion

• Intégration des équipes: Les préfixes d'équipe sont automatiquement inclus

• Activation/désactivation: Possibilité de désactiver le système pour revenir aux messages par défaut

📊 Placeholders disponibles

Placeholder	Description
{player}	Nom du joueur
{prefix}	Préfixe d'équipe du joueur

💡 Exemples

# Message de connexion standard
join: '&8[&a+&8] &7{prefix}{player}'

# Message de connexion amélioré
join: '&8[&a+&8] &f{prefix}{player} &7a rejoint le serveur'

# Message de déconnexion personnalisé
quit: '&8[&c-&8] &f{prefix}{player} &7a quitté le serveur &8(&7Au revoir!&8)'

💬 Système de chat

🎮 Fonctionnalités

• Format personnalisable: Configurez l'apparence des messages dans le chat

• Chat du staff: Format spécial pour les joueurs ayant la permission cite.chat

• Ping des joueurs: Mention des joueurs dans le chat, avec surlignage et notification sonore

📊 Placeholders disponibles

Placeholder	Description
{prefix}	Préfixe d'équipe du joueur
{player}	Nom du joueur
{message}	Contenu du message

🔔 Configuration du ping

Lorsqu'un joueur mentionne le nom d'un autre joueur dans le chat:

• Le nom est mis en surbrillance avec la couleur configurée

• Un son est joué pour le joueur mentionné

• Personnalisable via les paramètres de volume et de hauteur

💡 Exemples

# Format de chat standard
format: '{prefix}{player} &8» &7{message}'

# Format de chat plus élaboré
format: '&8[&7Chat&8] {prefix}{player} &8➡ &7{message}'

# Format pour le staff avec message en blanc plutôt qu'en gris
staff-format: '{prefix}{player} &8» &f{message}'

# Configuration du ping avec son différent
ping:
  enabled: true
  highlight-color: '&b'
  sound: ENTITY_PLAYER_LEVELUP
  volume: 0.8
  pitch: 1.2

⚠️ Remarques

• Les codes couleur utilisent le format Minecraft (& + code)

• Le système de ping fonctionne automatiquement lorsqu'un joueur écrit le nom exact d'un autre joueur

• Le chat d'équipe requiert que le joueur soit membre d'une équipe

• Les joueurs en mode vanish n'envoient pas de messages de connexion/déconnexion

🔗 Intégration

Le système de chat s'intègre avec:

• Le système d'équipes pour les préfixes

• Le système de vanish pour la gestion des messages de connexion/déconnexion

• PlaceholderAPI pour une personnalisation encore plus poussée (si installé)