Command Reference - WardForge

All commands use Discord’s slash command system. Type / in any channel to see the autocomplete list.

The Permission column refers to the Discord permission the invoking member must have. WardForge’s own bot permissions are separate — see Quickstart → Minimal Permissions.

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

Show Available modules for /guardian module

antiphishing · antiraid · automod · captcha · welcome · trustscore · globalban · tickets · report

Show 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

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

/forget is irreversible. An explicit confirmation is required before execution.

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

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

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

Show 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

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

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

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)

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

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	—

​Setup Wizard

​WardForge Core

​Moderation

​Server Configuration

​Anti-Phishing

​Anti-Raid

​Trust Score

​AutoMod

​Global Ban

​Welcome & Verification

​Tickets

​Reporting

​Backups

​Templates

​Permission Summary

Setup Wizard

WardForge Core

Moderation

Server Configuration

Anti-Phishing

Anti-Raid

Trust Score

AutoMod

Global Ban

Welcome & Verification

Tickets

Reporting

Backups

Templates

Permission Summary