Documentation

# ✍️ Chat et Messages

# 📝 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
Nom du joueur
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
Préfixe d'équipe du joueur
Nom du joueur
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é)