Documentation

# 🔨 Maintenance

# 📝 Introduction

La commande /maintenance permet aux administrateurs d'activer un mode maintenance qui bloque l'accès au serveur pour tous les joueurs sauf les membres du staff. Ce mode est utile lors de mises à jour, de maintenance ou de tests.

# 🔑 Permission

  • horizons.maintenance

# 📋 Syntaxe

Syntaxe principale: /maintenance [sous-commande]

Alias: /maint, /maintenancemode

# 🧪 Sous-commandes

# Activer/Désactiver

  • /maintenance on - Active le mode maintenance
  • /maintenance off - Désactive le mode maintenance
  • /maintenance toggle - Inverse l'état actuel

Alias acceptés: enable, disable, activate, deactivate, switch, true, false, 1, 0

# Configuration

  • /maintenance message <message> - Définit le message affiché aux joueurs bloqués
  • /maintenance status - Affiche l'état actuel et le message configuré

# 💡 Exemples d'utilisation

# Activer le mode maintenance

/maintenance on

Active le mode maintenance. Seuls les membres du staff peuvent se connecter.

# Définir un message personnalisé

/maintenance message &c&l[MAINTENANCE]\n&7Le serveur est en maintenance.\n&7Réouverture prévue dans 1 heure.

Définit un message personnalisé avec codes de couleur. Utilisez \n pour les sauts de ligne.

# Vérifier le statut

/maintenance status

Affiche si le mode maintenance est activé et le message actuel.

# Toggle rapide

/maintenance toggle

Bascule entre activé et désactivé.

# ⚙️ Configuration

La configuration se fait dans le fichier config.yml:

maintenance:
  enabled: false  # Activer/désactiver le mode maintenance
  
  # Message affiché aux joueurs non-staff
  message:
    - "&c&l[MAINTENANCE]"
    - "&7Le serveur est actuellement en maintenance."
    - "&7Seuls les membres du staff peuvent se connecter."
    - "&7Merci de votre compréhension."

# 🎯 Fonctionnement

# Lors de l'activation

  • Tous les joueurs non-staff qui tentent de se connecter sont bloqués
  • Le message configuré leur est affiché
  • Seuls les joueurs avec la permission horizons.staff ou OP peuvent se connecter
  • Les joueurs sont automatiquement kick du serveur

# Lors de la désactivation

  • Tous les joueurs peuvent à nouveau se connecter normalement

# 👥 Gestion des joueurs

  • Staff: Les joueurs avec la permission horizons.staff ou OP peuvent toujours se connecter
  • Joueurs normaux: Sont bloqués à la connexion avec le message configuré
  • Joueurs en ligne: Les joueurs déjà connectés ne sont pas affectés lors de l'activation

# 📝 Format du message

Le message peut être défini de deux façons:

# Format liste (recommandé)

message:
  - "&c&l[MAINTENANCE]"
  - "&7Le serveur est en maintenance."

# Format string avec \n

message: "&c&l[MAINTENANCE]\n&7Le serveur est en maintenance."

Codes de couleur: Utilisez & suivi du code (ex: &c pour rouge, &a pour vert)

# 🔒 Restrictions

  • Seuls les joueurs avec la permission horizons.maintenance peuvent utiliser cette commande
  • Le mode maintenance peut être activé depuis la console
  • Les joueurs déjà connectés ne sont pas déconnectés lors de l'activation