> For the complete documentation index, see [llms.txt](https://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/commandes/maintenance.md).

# 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`:

```yaml
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é)

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

### Format string avec \n

```yaml
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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://horizons-cite-plugin.gitbook.io/horizons-cite-plugin/commandes/maintenance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.