Documentation — Discord bot

Moderation

Sanctions, roles and nicknames, channel management and automatic scam detection.

Anti-scam moderation

Automatic detection system for phishing/scam messages, always on, no configuration required.

Detection: typical phrasings ("Nitro gratuit", "claim your free gift"...) and a list of known fake domains imitating Discord/Steam.

Automatic reaction when a message is detected:


General moderation

/clear <nombre> [cible] [salon] [utilisateur] [id] — deletes 1 to 100 messages (the number is required), in the current channel, a specific channel, or all channels; can be filtered by user (mention or ID). Required permission: "Manage Messages", and only in channels where you actually have it.

Sanctions

/kick <membre> [raison]Kick Members

Kicks a member (a warning DM is sent before the kick)

/ban <membre> [raison] [durée] [supprimer_messages]Ban Members

Bans a member, permanently or temporarily

/unban <id> [raison]Ban Members

Unbans a user by ID (also cancels an ongoing temp-ban)

/tempmute <membre> <durée> [raison]Timeout Members

Temporary mute via Discord's native timeout (max 28 days)

/unmute <membre>Timeout Members

Removes an ongoing mute

/warn add <membre> <raison>Timeout Members

Warns a member (warning recorded, DM sent with the total count)

/warn list <membre>Timeout Members

Lists a member's warnings

/warn remove <id>Timeout Members

Deletes a warning by its ID

Required permissions: "Kick Members" for /kick, "Ban Members" for /ban and /unban. Reasons are limited to 500 characters.

/ban without a duration = classic permanent ban. With a duration (e.g. 1d, 1w), it is a temp-ban: the bot automatically unbans when it expires. supprimer_messages (0-7 days) also purges the banned member's recent messages.

Restart-proof: as with giveaways, the temp-ban timer is restored automatically if the bot restarts.
Hierarchy check on all of these commands: a moderator cannot act on someone whose role is higher than or equal to their own (the server owner can never be targeted), nor on a role higher than the bot's. Permissions are re-checked on every execution, even if the server changed the command's permissions in Discord's integration settings.

Roles and nicknames

/nickname <membre> [pseudo]Manage Nicknames

Changes a member's nickname (empty = reset).

/role add / remove <membre> <rôle>Manage Roles

Assigns or removes a role for a member.

/allrole add / remove <rôle> [cible] [avec_role]Manage Roles

Assigns or removes a role for many members at once.

/role rejects roles above the highest role of the person using it, and roles managed by an integration.

/allrole in detail. cible: all members (default), humans only or bots only. avec_role: only affects members who already have that role. A summary (members affected, skipped) is shown and a confirmation is requested before acting.

Channel management

/lock [salon] [raison]

Locks a channel (prevents @everyone from writing, without overwriting other permissions)

/unlock [salon]Manage Channels

Unlocks a previously locked channel

/slowmode <secondes> [salon]Manage Channels

Sets slowmode (0 to 6h)