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

# Command Reference

> Complete list of every WardForge slash command — parameters, permissions, cooldowns, and behaviors.

<Info>
  All commands use Discord's **slash command** system. Type `/` in any channel to see the autocomplete list.
</Info>

<Note>
  The **Permission** column refers to the Discord permission the **invoking member** must have. WardForge's own bot permissions are separate — see [Quickstart → Minimal Permissions](/en/quickstart#minimal-permissions).
</Note>

***

## Setup Wizard

| Command  | Description                                                                                                       | Permission    |
| -------- | ----------------------------------------------------------------------------------------------------------------- | ------------- |
| `/setup` | Launches the guided **7-step wizard**: language, logs, modules, verification, tickets, staff role, initial backup | Administrator |

***

## WardForge Core

| Command                               | Description                                                                              | Permission      |
| ------------------------------------- | ---------------------------------------------------------------------------------------- | --------------- |
| `/guardian status`                    | Global status: active modules, Ghost/Simulation modes, health score with recommendations | Manage Messages |
| `/guardian health`                    | Server security score (0–100) with per-criterion breakdown                               | Manage Messages |
| `/guardian ghost`                     | Toggle **Ghost Mode** — WardForge acts silently with no public messages                  | Manage Guild    |
| `/guardian simulate`                  | Toggle **Simulation Mode** — detects threats without applying sanctions (dry run)        | Manage Guild    |
| `/guardian module <module> <enabled>` | Enable or disable an individual security module                                          | Manage Guild    |
| `/guardian doctor`                    | Diagnose configuration: role hierarchy, bot permissions, log channel, role ID validity   | Manage Guild    |
| `/certificate`                        | Display the public **Guardian Secured** certificate with server statistics               | None            |

<Expandable title="Available modules for /guardian module">
  `antiphishing` · `antiraid` · `automod` · `captcha` · `welcome` · `trustscore` · `globalban` · `tickets` · `report`
</Expandable>

<Expandable title="Health score criteria for /guardian health">
  | Criterion               | Points |
  | ----------------------- | ------ |
  | Logs channel configured | 20 pts |
  | Anti-Phishing enabled   | 15 pts |
  | Anti-Raid enabled       | 15 pts |
  | AutoMod enabled         | 15 pts |
  | Captcha enabled         | 10 pts |
  | Global Ban enabled      | 10 pts |
  | Welcome messages        | 5 pts  |
</Expandable>

***

## Moderation

| Command                             | Arguments                                              | Description                                                             | Permission      |
| ----------------------------------- | ------------------------------------------------------ | ----------------------------------------------------------------------- | --------------- |
| `/warn @member [reason]`            | member required, reason optional                       | Warn a member · DM sent · **-10 Trust Score**                           | Manage Messages |
| `/warnings @member`                 | —                                                      | Show last 10 warnings with dates and moderators                         | Manage Messages |
| `/clearwarns @member`               | —                                                      | Clear all warnings for a member                                         | Manage Guild    |
| `/mute @member [duration] [reason]` | duration: `10m` / `2h` / `1d` (max 28d), default `10m` | Discord timeout · **-15 Trust Score**                                   | Timeout Members |
| `/unmute @member`                   | —                                                      | Remove a member's timeout                                               | Timeout Members |
| `/kick @member [reason]`            | —                                                      | Kick · severity 3 infraction · **-25 Trust Score**                      | Kick Members    |
| `/ban @user [reason] [days]`        | days: 0–7 days of messages to delete                   | Ban · severity 5 infraction                                             | Ban Members     |
| `/unban <user_id>`                  | —                                                      | Lift a ban by user ID                                                   | Ban Members     |
| `/clear <amount> [@member]`         | 1–100 messages, member optional                        | Delete messages in the current channel                                  | Manage Messages |
| `/history @user`                    | —                                                      | Full user file: warnings (5), infractions (8), Trust Score              | Manage Messages |
| `/forget <user_id>`                 | —                                                      | Delete **all** WardForge data for a user (GDPR) — confirmation required | Manage Guild    |

<Warning>
  `/forget` is **irreversible**. An explicit confirmation is required before execution.
</Warning>

***

## Server Configuration

| Command                                        | Arguments      | Description                                             | Permission    |
| ---------------------------------------------- | -------------- | ------------------------------------------------------- | ------------- |
| `/config logs <#channel>`                      | —              | Set the WardForge logs channel                          | Administrator |
| `/config lang <fr\|en>`                        | —              | Change the bot's display language                       | Manage Guild  |
| `/config roles [auto] [unverified] [verified]` | Optional roles | Configure roles assigned on join and after verification | Manage Guild  |

***

## Anti-Phishing

<Tip>
  WardForge automatically scans all URLs and QR codes in messages. The commands below let you customize this behavior.
</Tip>

| Command                                   | Arguments                         | Description                                | Permission   |
| ----------------------------------------- | --------------------------------- | ------------------------------------------ | ------------ |
| `/antiphishing whitelist add <domain>`    | Accepts full URLs or bare domains | Add a domain to the whitelist              | Manage Guild |
| `/antiphishing whitelist list`            | —                                 | List whitelisted domains (ephemeral reply) | Manage Guild |
| `/antiphishing whitelist remove <domain>` | —                                 | Remove a domain from the whitelist         | Manage Guild |

**Auto-scan behavior**: PhishTank + Google Safe Browsing + VirusTotal · Recursive redirect resolution (max 3 hops) · QR code scanning in image attachments · Action: message deletion, -40 Trust Score, 1h timeout, infraction log.

***

## Anti-Raid

| Command                     | Arguments              | Description                                                            | Permission    |
| --------------------------- | ---------------------- | ---------------------------------------------------------------------- | ------------- |
| `/lockdown [state]`         | `on` / `off` or toggle | Enable/disable Lockdown (restricts messaging to verified members)      | Manage Guild  |
| `/panic [state]`            | `on` / `off` or toggle | 🚨 **Panic Mode**: Lockdown + 10s slowmode + Captcha + admin DM alerts | Administrator |
| `/antiraid config [params]` | See table below        | Adjust detection thresholds                                            | Manage Guild  |

<Expandable title="Parameters for /antiraid config">
  | Parameter           | Default | Description                       |
  | ------------------- | ------- | --------------------------------- |
  | `raid_threshold`    | 5       | Joins to trigger lockdown         |
  | `raid_window`       | 10s     | Detection window (seconds)        |
  | `nuke_threshold`    | 3       | Deleted channels to trigger Panic |
  | `nuke_window`       | 10s     | Detection window                  |
  | `mod_action_limit`  | 3       | Moderator action limit            |
  | `mod_action_window` | 10s     | Detection window                  |
</Expandable>

***

## Trust Score

| Command          | Arguments | Description                                                     | Permission      |
| ---------------- | --------- | --------------------------------------------------------------- | --------------- |
| `/trust @member` | —         | Show Trust Score with history and automatic sanction thresholds | Manage Messages |

| Score | Status     | Automatic sanction |
| ----- | ---------- | ------------------ |
| ≥ 70  | 🟢 Trusted | —                  |
| 50–70 | 🟡 Normal  | —                  |
| 30–50 | 🟠 Watched | —                  |
| \< 50 | ⚠️ Alert   | Warning DM sent    |
| \< 30 | 🔴 Danger  | Auto-mute 1h       |
| \< 10 | ⚫ Critical | **Auto-ban**       |

***

## AutoMod

| Command                             | Arguments                     | Description                        | Permission   |
| ----------------------------------- | ----------------------------- | ---------------------------------- | ------------ |
| `/automod status`                   | —                             | Display full AutoMod configuration | Manage Guild |
| `/automod toggle`                   | —                             | Enable or disable AutoMod          | Manage Guild |
| `/automod spam <messages> <window>` | messages: 2–20, window: 3–60s | Configure anti-spam threshold      | Manage Guild |
| `/automod caps <percent>`           | 30–100%                       | Configure anti-caps threshold      | Manage Guild |
| `/automod mentions <max>`           | 2–20 mentions                 | Configure mass-mentions threshold  | Manage Guild |

**Automatic behaviors**:

* **Anti-spam**: 5 msgs/5s → warning, escalating mutes (1min → 5min → 10min → 1h)
* **Anti-caps**: 75% caps + ≥8 chars → message deletion, -5 Trust Score
* **Anti-mentions**: 5+ mentions → message deletion
* **Anti-repeat**: same message 3x → deletion
* **Scam detection**: regex patterns → deletion, -20 Trust Score, severity 3 infraction

***

## Global Ban

<Warning>
  `/global ban` triggers an immediate ban on **every WardForge-protected server in the network**. Double-check the target before using this command.
</Warning>

| Command                                             | Arguments                                      | Description                                                  | Permission      |
| --------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------ | --------------- |
| `/global ban @user <category> [details] [ban_here]` | category: `scammer`/`raider`/`spammer`/`other` | Add to global blacklist (all servers)                        | Administrator   |
| `/global unban <user_id>`                           | —                                              | Remove from global blacklist                                 | Administrator   |
| `/global check @user`                               | —                                              | Check if a user is globally blacklisted                      | Manage Messages |
| `/global list`                                      | —                                              | Show the last 20 global bans with dates, reasons, categories | Manage Messages |

***

## Welcome & Verification

| Command                                | Arguments                               | Description                                                             | Permission   |
| -------------------------------------- | --------------------------------------- | ----------------------------------------------------------------------- | ------------ |
| `/welcome setup <#channel>`            | —                                       | Set the welcome channel                                                 | Manage Guild |
| `/welcome message <text>`              | max 1500 chars                          | Customize message · Variables: `{mention}` `{user}` `{guild}` `{count}` | Manage Guild |
| `/welcome toggle`                      | —                                       | Enable/disable welcome messages                                         | Manage Guild |
| `/welcome test`                        | —                                       | Simulate a welcome message                                              | Manage Guild |
| `/welcome verify <#channel> [min_age]` | min\_age: default 24h                   | Send a persistent verification button to the channel                    | Manage Guild |
| `/leave setup <#channel>`              | —                                       | Set the farewell channel                                                | Manage Guild |
| `/leave message <text>`                | Variables: `{user}` `{guild}` `{count}` | Customize farewell message                                              | Manage Guild |
| `/leave toggle`                        | —                                       | Enable/disable farewell messages                                        | Manage Guild |

***

## Tickets

| Command                                            | Arguments | Description                                     | Permission                      |
| -------------------------------------------------- | --------- | ----------------------------------------------- | ------------------------------- |
| `/ticket setup <#channel> [staff_role] [category]` | —         | Send persistent "Open Ticket" panel             | Manage Guild                    |
| `/ticket close`                                    | —         | Close current ticket and send transcript via DM | Ticket owner or Manage Channels |

***

## Reporting

| Command                             | Arguments | Description                                | Permission       |
| ----------------------------------- | --------- | ------------------------------------------ | ---------------- |
| `/report @user [reason] [link]`     | —         | Report a user for a scam DM                | Trust Score ≥ 20 |
| `/report-config channel <#channel>` | —         | Set the report reception channel           | Manage Guild     |
| `/report-config stats`              | —         | Statistics: total, confirmed bans, pending | Manage Messages  |

**Cooldown**: 10 minutes per reporter. If link is malicious → automatic global ban. Otherwise → forwarded to staff channel (priority if ≥3 reports).

***

## Backups

| Command                        | Arguments                       | Description                                                     | Permission               |
| ------------------------------ | ------------------------------- | --------------------------------------------------------------- | ------------------------ |
| `/backup create`               | —                               | Create an **AES-256** encrypted backup (PBKDF2 480k iterations) | Administrator            |
| `/backup list`                 | —                               | List backups: size, creator, visibility                         | None (own backups)       |
| `/backup restore <code\|file>` | code `GB-XXXX-YYYY` or filename | Restore a backup — confirmation required                        | Administrator            |
| `/backup share <file>`         | —                               | Generate a share code for other servers                         | Creator or Administrator |
| `/backup delete <file>`        | —                               | Permanently delete a backup                                     | Creator or Administrator |
| `/backup diff <older> <newer>` | —                               | Compare two backups: roles/channels added, removed, modified    | None (own backups)       |

<Note>
  Backups contain **structure only** (channels, roles, permissions). Personal data (infractions, Trust Score, DMs) is not included.
</Note>

***

## Templates

| Command                                 | Arguments                              | Description                                              | Permission               |
| --------------------------------------- | -------------------------------------- | -------------------------------------------------------- | ------------------------ |
| `/template create <name> [description]` | name: 3–64 chars                       | Register server structure as a public template           | Administrator            |
| `/template list [page]`                 | default page 1                         | Browse the shop (10 templates/page)                      | None                     |
| `/template load <id> [clean]`           | clean: delete default Discord channels | Load a template ⭐ **Premium**                            | Manage Guild             |
| `/template info <id>`                   | —                                      | Details: creator, server count, channels, roles, ratings | None                     |
| `/template delete <id>`                 | —                                      | Disable a template from the shop                         | Creator or Administrator |

***

## Permission Summary

| Group                      | User Permission                  | Bot Permission    |
| -------------------------- | -------------------------------- | ----------------- |
| Ban / Kick / Mute          | `Ban` / `Kick` / `Timeout`       | Same              |
| Warn / Clear / History     | `Manage Messages`                | `Manage Messages` |
| Config / Setup             | `Manage Guild` / `Administrator` | —                 |
| WardForge (modes/modules)  | `Manage Guild`                   | —                 |
| Anti-Phishing whitelist    | `Manage Guild`                   | —                 |
| Lockdown / Antiraid config | `Manage Guild`                   | —                 |
| Panic                      | `Administrator`                  | —                 |
| Global Ban                 | `Administrator`                  | —                 |
| Tickets                    | `Manage Guild`                   | `Manage Channels` |
| Report                     | None (Trust Score ≥ 20)          | —                 |
| Certificate                | None                             | —                 |