> 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/ignore.md).

# Ignore

## 📝 Introduction

La commande `/ignore` permet aux joueurs de bloquer complètement la communication avec d'autres joueurs. Quand un joueur est ignoré, vous ne recevrez plus :

* Ses messages dans le chat général
* Ses messages dans le chat d'équipe (si vous êtes dans la même équipe)
* Ses whispers/messages privés

{% hint style="warning" %}
Important : le joueur ignoré n'est **pas notifié** qu'il a été ignoré. Il peut toujours envoyer des messages, mais vous ne les recevrez tout simplement pas.
{% endhint %}

## 🔑 Permission

{% hint style="info" %}
Aucune permission spéciale requise — tous les joueurs peuvent utiliser cette commande.
{% endhint %}

## 📋 Syntaxe

{% stepper %}
{% step %}

### Ignorer un joueur

**Syntaxe:** `/ignore <joueur>`

**Description:** Ignore ou désignore un joueur (fonction toggle)

**Paramètres:**

* `joueur` - Nom du joueur à ignorer ou désignorer

**Exemple:**

{% code title="/ignore Steve" %}

```
/ignore Steve
```

{% endcode %}
{% endstep %}

{% step %}

### Voir la liste des joueurs ignorés

**Syntaxe:** `/ignore`

**Description:** Affiche la liste de tous les joueurs que vous ignorez actuellement

**Exemple:**

{% code title="/ignore" %}

```
/ignore
```

{% endcode %}
{% endstep %}
{% endstepper %}

## 🧪 Fonctionnalités

### Fonction toggle

* Si vous ignorez un joueur qui est déjà ignoré, il sera désignoré et inversement.

### Liste des ignorés

* Affiche facilement tous les joueurs que vous ignorez.
* Affiche le nombre total de joueurs ignorés.
* Affiche les noms des joueurs ignorés (même s'ils sont hors ligne).

## 📋 Format des messages

### Ignorer un joueur

```
Vous ignorez maintenant Steve. Vous ne verrez plus ses messages ni ses whispers.
```

### Désignorer un joueur

```
Vous ne ignorez plus Steve.
```

### Liste des joueurs ignorés

```
Joueurs ignorés (2): Steve, Alex
```

### Aucun joueur ignoré

```
Vous n'ignorez aucun joueur.
```

## 💾 Persistance

Les listes d'ignorés sont sauvegardées automatiquement selon la configuration choisie.

<details>

<summary>Options de stockage (développer pour détails)</summary>

Le système supporte deux méthodes de stockage :

**JSON (Local)**

* Stockage dans un fichier JSON local
* Pas de configuration de base de données requise
* Idéal pour les petits serveurs

**MySQL (Base de données)**

* Stockage dans une base de données MySQL
* Partage des listes d'ignorés entre serveurs (si même base de données)
* Idéal pour les réseaux de serveurs

</details>

### Configuration

Dans le fichier `config.yml` :

{% code title="config.yml" %}

```yaml
ignore:
  storage:
    type: "JSON"                  # "JSON" ou "MYSQL"
    # Si type est "MYSQL", utilise la configuration database.mysql ci-dessus
    
    # Intervalle de sauvegarde automatique (en minutes)
    auto_save_interval: 5
    
    # Sauvegarder à l'arrêt du serveur
    save_on_shutdown: true
```

{% endcode %}

<details>

<summary>Remarque sur MySQL</summary>

Si vous choisissez `MYSQL`, assurez-vous que la configuration de la base de données MySQL est correctement configurée dans la section `database.mysql` du fichier `config.yml`.

</details>

## ⚙️ Configuration

La commande peut être activée ou désactivée dans le fichier `config.yml` :

{% code title="config.yml (commands.ignore)" %}

```yaml
commands:
  ignore:
    enabled: true  # Passer à false pour désactiver la commande ignore
```

{% endcode %}

## ⚠️ Restrictions & FAQ

<details>

<summary>Restrictions et comportements (développer)</summary>

* ❌ Impossible de s'ignorer soi-même — Vous ne pouvez pas vous ignorer.
* ✅ Joueurs hors ligne — Vous pouvez désignorer un joueur même s'il est hors ligne en utilisant son nom.
* ✅ Insensible à la casse — Les noms de joueurs sont insensibles à la casse.
* ✅ Auto-complétion — L'auto-complétion inclut les joueurs en ligne et les joueurs ignorés.

</details>

## 🔄 Alias

* `/block` - Alias pour `/ignore`


---

# 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/ignore.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.