> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wardforge.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence des Commandes

> Liste complète de toutes les commandes slash WardForge — paramètres, permissions, cooldowns et comportements.

<Info>
  Toutes les commandes utilisent le système de **slash commands** Discord. Tapez `/` dans n'importe quel salon pour voir la liste avec autocomplétion.
</Info>

<Note>
  La colonne **Permission** correspond à la permission Discord que le **membre invocateur** doit posséder. Les permissions du bot sont distinctes — voir [Démarrage Rapide → Permissions Minimales](/fr/quickstart#permissions-minimales).
</Note>

***

## Assistant de Configuration

| Commande | Description                                                                                                             | Permission     |
| -------- | ----------------------------------------------------------------------------------------------------------------------- | -------------- |
| `/setup` | Lance l'assistant guidé en **7 étapes** : langue, logs, modules, vérification, tickets, rôle staff, sauvegarde initiale | Administrateur |

***

## WardForge Core

| Commande                             | Description                                                                                        | Permission         |
| ------------------------------------ | -------------------------------------------------------------------------------------------------- | ------------------ |
| `/guardian status`                   | État global : modules actifs, modes Ghost/Simulation, score de santé avec recommandations          | Gérer les messages |
| `/guardian health`                   | Score de sécurité du serveur (0–100) avec détail par critère                                       | Gérer les messages |
| `/guardian ghost`                    | Active/désactive le **Mode Fantôme** — WardForge agit silencieusement sans messages publics        | Gérer le serveur   |
| `/guardian simulate`                 | Active/désactive le **Mode Simulation** — détecte les menaces sans appliquer de sanctions (test)   | Gérer le serveur   |
| `/guardian module <module> <activé>` | Active ou désactive un module individuel                                                           | Gérer le serveur   |
| `/guardian doctor`                   | Diagnostique la configuration : hiérarchie des rôles, permissions bot, salon de logs, IDs de rôles | Gérer le serveur   |
| `/certificate`                       | Affiche le certificat **Guardian Secured** public du serveur avec statistiques                     | Aucune             |

<Expandable title="Modules disponibles pour /guardian module">
  `antiphishing` · `antiraid` · `automod` · `captcha` · `welcome` · `trustscore` · `globalban` · `tickets` · `report`
</Expandable>

<Expandable title="Critères du score de santé /guardian health">
  | Critère                 | Points |
  | ----------------------- | ------ |
  | Salon de logs configuré | 20 pts |
  | Anti-Phishing activé    | 15 pts |
  | Anti-Raid activé        | 15 pts |
  | AutoMod activé          | 15 pts |
  | Captcha activé          | 10 pts |
  | Global Ban activé       | 10 pts |
  | Messages de bienvenue   | 5 pts  |
</Expandable>

***

## Modération

| Commande                             | Arguments                                           | Description                                                                              | Permission         |
| ------------------------------------ | --------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------ |
| `/warn @membre [raison]`             | membre requis, raison optionnelle                   | Avertit un membre · DM envoyé · **-10 Trust Score**                                      | Gérer les messages |
| `/warnings @membre`                  | —                                                   | Affiche les 10 derniers avertissements avec dates et modérateurs                         | Gérer les messages |
| `/clearwarns @membre`                | —                                                   | Supprime tous les avertissements d'un membre                                             | Gérer le serveur   |
| `/mute @membre [durée] [raison]`     | durée : `10m` / `2h` / `1d` (max 28j), défaut `10m` | Timeout Discord · **-15 Trust Score**                                                    | Timeout membres    |
| `/unmute @membre`                    | —                                                   | Retire le timeout d'un membre                                                            | Timeout membres    |
| `/kick @membre [raison]`             | —                                                   | Expulse · infraction sévérité 3 · **-25 Trust Score**                                    | Expulser membres   |
| `/ban @utilisateur [raison] [jours]` | jours : 0-7 jours de messages à supprimer           | Bannit · infraction sévérité 5                                                           | Bannir membres     |
| `/unban <user_id>`                   | —                                                   | Lève le bannissement par ID                                                              | Bannir membres     |
| `/clear <quantité> [@membre]`        | 1–100 messages, membre optionnel                    | Supprime des messages dans le salon                                                      | Gérer les messages |
| `/history @utilisateur`              | —                                                   | Dossier complet : avertissements (5), infractions (8), Trust Score                       | Gérer les messages |
| `/forget <user_id>`                  | —                                                   | Supprime **toutes** les données WardForge de l'utilisateur (RGPD) — confirmation requise | Gérer le serveur   |

<Warning>
  `/forget` est **irréversible**. Une confirmation explicite est demandée avant l'exécution.
</Warning>

***

## Configuration Serveur

| Commande                                       | Arguments        | Description                                                     | Permission       |
| ---------------------------------------------- | ---------------- | --------------------------------------------------------------- | ---------------- |
| `/config logs <#salon>`                        | —                | Définit le salon de logs WardForge                              | Administrateur   |
| `/config lang <fr\|en>`                        | —                | Change la langue d'affichage du bot                             | Gérer le serveur |
| `/config roles [auto] [non-vérifié] [vérifié]` | Rôles optionnels | Configure les rôles attribués à l'arrivée et après vérification | Gérer le serveur |

***

## Anti-Phishing

<Tip>
  WardForge scanne automatiquement toutes les URLs et QR codes dans les messages. Les commandes ci-dessous permettent de personnaliser ce comportement.
</Tip>

| Commande                                   | Arguments                              | Description                                            | Permission       |
| ------------------------------------------ | -------------------------------------- | ------------------------------------------------------ | ---------------- |
| `/antiphishing whitelist add <domaine>`    | Accepte URLs complètes ou domaines nus | Ajoute un domaine à la liste blanche                   | Gérer le serveur |
| `/antiphishing whitelist list`             | —                                      | Liste les domaines en liste blanche (réponse éphémère) | Gérer le serveur |
| `/antiphishing whitelist remove <domaine>` | —                                      | Retire un domaine de la liste blanche                  | Gérer le serveur |

**Déclenchement automatique** : Scan via PhishTank, Google Safe Browsing, VirusTotal · Résolution récursive des redirections (max 3 sauts) · Scan des QR codes dans les images · Action : suppression du message, -40 Trust Score, timeout 1h, log infraction.

***

## Anti-Raid

| Commande                        | Arguments               | Description                                                                       | Permission       |
| ------------------------------- | ----------------------- | --------------------------------------------------------------------------------- | ---------------- |
| `/lockdown [état]`              | `on` / `off` ou bascule | Active/désactive le Lockdown (restreint l'envoi de messages aux membres vérifiés) | Gérer le serveur |
| `/panic [état]`                 | `on` / `off` ou bascule | 🚨 **Mode Panique** : Lockdown + slowmode 10s + Captcha + DM admins               | Administrateur   |
| `/antiraid config [paramètres]` | Voir tableau ci-dessous | Ajuste les seuils de détection                                                    | Gérer le serveur |

<Expandable title="Paramètres de /antiraid config">
  | Paramètre           | Défaut | Description                            |
  | ------------------- | ------ | -------------------------------------- |
  | `raid_threshold`    | 5      | Arrivées pour déclencher le lockdown   |
  | `raid_window`       | 10s    | Fenêtre temporelle (secondes)          |
  | `nuke_threshold`    | 3      | Salons supprimés pour déclencher Panic |
  | `nuke_window`       | 10s    | Fenêtre temporelle                     |
  | `mod_action_limit`  | 3      | Limite d'actions modérateur            |
  | `mod_action_window` | 10s    | Fenêtre temporelle                     |
</Expandable>

***

## Trust Score

| Commande         | Arguments | Description                                                                | Permission         |
| ---------------- | --------- | -------------------------------------------------------------------------- | ------------------ |
| `/trust @membre` | —         | Affiche le Trust Score avec historique et seuils de sanctions automatiques | Gérer les messages |

| Score | Statut                 | Sanction automatique |
| ----- | ---------------------- | -------------------- |
| ≥ 70  | 🟢 Membre de confiance | —                    |
| 50–70 | 🟡 Normal              | —                    |
| 30–50 | 🟠 Sous surveillance   | —                    |
| \< 50 | ⚠️ Alerte              | DM d'avertissement   |
| \< 30 | 🔴 Danger              | Mute automatique 1h  |
| \< 10 | ⚫ Critique             | **Ban automatique**  |

***

## AutoMod

| Commande                             | Arguments                        | Description                               | Permission       |
| ------------------------------------ | -------------------------------- | ----------------------------------------- | ---------------- |
| `/automod status`                    | —                                | Affiche toute la configuration AutoMod    | Gérer le serveur |
| `/automod toggle`                    | —                                | Active ou désactive l'AutoMod             | Gérer le serveur |
| `/automod spam <messages> <fenêtre>` | messages : 2–20, fenêtre : 3–60s | Configure le seuil anti-spam              | Gérer le serveur |
| `/automod caps <pourcentage>`        | 30–100%                          | Configure le seuil anti-majuscules        | Gérer le serveur |
| `/automod mentions <max>`            | 2–20 mentions                    | Configure le seuil anti-mentions en masse | Gérer le serveur |

**Comportements automatiques** :

* **Anti-spam** : 5 msgs/5s → avertissement, escalade des mutes (1min → 5min → 10min → 1h)
* **Anti-majuscules** : 75% caps + ≥8 caractères → suppression message, -5 Trust Score
* **Anti-mentions** : 5+ mentions → suppression message
* **Anti-répétition** : même message 3x → suppression
* **Détection d'arnaques** : regex patterns → suppression, -20 Trust Score, infraction sévérité 3

***

## Global Ban

<Warning>
  `/global ban` déclenche un ban sur **tous les serveurs WardForge du réseau**. Vérifiez deux fois la cible.
</Warning>

| Commande                                                      | Arguments                                        | Description                                                          | Permission         |
| ------------------------------------------------------------- | ------------------------------------------------ | -------------------------------------------------------------------- | ------------------ |
| `/global ban @utilisateur <catégorie> [détails] [bannir_ici]` | catégorie : `scammer`/`raider`/`spammer`/`other` | Ajoute à la liste noire globale (tous serveurs)                      | Administrateur     |
| `/global unban <user_id>`                                     | —                                                | Retire de la liste noire globale                                     | Administrateur     |
| `/global check @utilisateur`                                  | —                                                | Vérifie si un utilisateur est blacklisté globalement                 | Gérer les messages |
| `/global list`                                                | —                                                | Affiche les 20 derniers bans globaux avec dates, raisons, catégories | Gérer les messages |

***

## Bienvenue & Vérification

| Commande                             | Arguments                                | Description                                                                    | Permission       |
| ------------------------------------ | ---------------------------------------- | ------------------------------------------------------------------------------ | ---------------- |
| `/welcome setup <#salon>`            | —                                        | Définit le salon de bienvenue                                                  | Gérer le serveur |
| `/welcome message <texte>`           | max 1500 chars                           | Personnalise le message · Variables : `{mention}` `{user}` `{guild}` `{count}` | Gérer le serveur |
| `/welcome toggle`                    | —                                        | Active/désactive les messages de bienvenue                                     | Gérer le serveur |
| `/welcome test`                      | —                                        | Simule un message de bienvenue                                                 | Gérer le serveur |
| `/welcome verify <#salon> [âge_min]` | âge\_min : défaut 24h                    | Envoie un bouton de vérification persistant dans le salon                      | Gérer le serveur |
| `/leave setup <#salon>`              | —                                        | Définit le salon de départ                                                     | Gérer le serveur |
| `/leave message <texte>`             | Variables : `{user}` `{guild}` `{count}` | Personnalise le message de départ                                              | Gérer le serveur |
| `/leave toggle`                      | —                                        | Active/désactive les messages de départ                                        | Gérer le serveur |

***

## Tickets

| Commande                                          | Arguments | Description                                                 | Permission                                 |
| ------------------------------------------------- | --------- | ----------------------------------------------------------- | ------------------------------------------ |
| `/ticket setup <#salon> [rôle_staff] [catégorie]` | —         | Envoie le panneau "Ouvrir un ticket" avec bouton persistant | Gérer le serveur                           |
| `/ticket close`                                   | —         | Ferme le ticket courant et envoie la transcription par DM   | Propriétaire du ticket ou Gérer les salons |

***

## Signalement

| Commande                               | Arguments | Description                                      | Permission         |
| -------------------------------------- | --------- | ------------------------------------------------ | ------------------ |
| `/report @utilisateur [raison] [lien]` | —         | Signale un utilisateur pour arnaque en DM        | Trust Score ≥ 20   |
| `/report-config channel <#salon>`      | —         | Définit le salon de réception des signalements   | Gérer le serveur   |
| `/report-config stats`                 | —         | Statistiques : total, bans confirmés, en attente | Gérer les messages |

**Cooldown** : 10 minutes par reporter. Si le lien est malveillant → ban global automatique. Sinon → envoi au canal staff (prioritaire si ≥3 signalements).

***

## Sauvegardes

| Commande                          | Arguments                             | Description                                                          | Permission                 |
| --------------------------------- | ------------------------------------- | -------------------------------------------------------------------- | -------------------------- |
| `/backup create`                  | —                                     | Crée une sauvegarde chiffrée **AES-256** (PBKDF2 480k itérations)    | Administrateur             |
| `/backup list`                    | —                                     | Liste les sauvegardes : taille, créateur, visibilité                 | Aucune (propres backups)   |
| `/backup restore <code\|fichier>` | code `GB-XXXX-YYYY` ou nom de fichier | Restaure une sauvegarde — confirmation requise                       | Administrateur             |
| `/backup share <fichier>`         | —                                     | Génère un code de partage pour d'autres serveurs                     | Créateur ou Administrateur |
| `/backup delete <fichier>`        | —                                     | Supprime définitivement une sauvegarde                               | Créateur ou Administrateur |
| `/backup diff <ancien> <récent>`  | —                                     | Compare deux sauvegardes : rôles/salons ajoutés, supprimés, modifiés | Aucune (propres backups)   |

<Note>
  Les sauvegardes contiennent la **structure uniquement** (salons, rôles, permissions). Les données personnelles (infractions, Trust Score, DMs) ne sont pas incluses.
</Note>

***

## Templates

| Commande                               | Arguments                                   | Description                                                     | Permission                 |
| -------------------------------------- | ------------------------------------------- | --------------------------------------------------------------- | -------------------------- |
| `/template create <nom> [description]` | nom : 3–64 chars                            | Enregistre la structure du serveur comme template public        | Administrateur             |
| `/template list [page]`                | défaut page 1                               | Parcourt la boutique (10 templates/page)                        | Aucune                     |
| `/template load <id> [clean]`          | clean : supprimer salons Discord par défaut | Charge un template ⭐ **Premium**                                | Gérer le serveur           |
| `/template info <id>`                  | —                                           | Détails : créateur, serveurs utilisateurs, salons, rôles, notes | Aucune                     |
| `/template delete <id>`                | —                                           | Désactive un template de la boutique                            | Créateur ou Administrateur |

***

## Récapitulatif des Permissions

| Groupe                     | Permission utilisateur                | Permission bot       |
| -------------------------- | ------------------------------------- | -------------------- |
| Ban / Kick / Mute          | `Bannir` / `Expulser` / `Timeout`     | Identique            |
| Warn / Clear / History     | `Gérer les messages`                  | `Gérer les messages` |
| Config / Setup             | `Gérer le serveur` / `Administrateur` | —                    |
| WardForge (modes/modules)  | `Gérer le serveur`                    | —                    |
| Anti-Phishing whitelist    | `Gérer le serveur`                    | —                    |
| Lockdown / Antiraid config | `Gérer le serveur`                    | —                    |
| Panic                      | `Administrateur`                      | —                    |
| Global Ban                 | `Administrateur`                      | —                    |
| Tickets                    | `Gérer le serveur`                    | `Gérer les salons`   |
| Report                     | Aucune (Trust Score ≥ 20)             | —                    |
| Certificate                | Aucune                                | —                    |
