Sanctioning a member

When a member breaks the rules, your team has several sanctions, from the lightest to the heaviest: the warning, the mute, the kick and the ban. Each sanction is kept in the member's history.

In all these commands, you can target several members at once (+warn @member1 @member2 spam), and the reason is optional.

Warning

+warn @member reason warns a member: the warning is added to their history, and they are told by direct message.

If you set up automatic sanctions, each warn counts as a strike: a member who piles up warnings can be muted, kicked or banned automatically.

Muting

A muted member can no longer write or speak on the server.

• +mute @member reason mutes them with no time limit, +unmute @member unmutes them;
• +tempmute @member 1h reason mutes them for a duration (30m, 2h, 7d, 1h30m…): they are unmuted automatically at the end;
• +cmute, +tempcmute and +uncmute do the same, but only in the channel where you type the command;
• +mutelist shows the current mutes, with the time left; +unmuteall removes them all.

A muted member who leaves the server and comes back is muted again.

Discord timeout or mute role

By default, the bot uses Discord's timeout: the member sees in their app that they are timed out, and for how long. Discord limits it to 28 days: a mute with no duration therefore ends after 28 days.

+timeout off replaces the timeout with a mute role, with no time limit:

• +muterole creates this role and sets it up in every channel (no writing, reacting or threads, no speaking in voice). Run it again after creating new channels;
• or +set muterole @role uses a role that already exists, then +muterole sets its permissions.

+muterole reports the channels where another role explicitly allows writing: a muted member with that role could still talk there.

Kicking and banning

• +kick @member reason kicks: the member leaves the server, but can come back with an invite.
• +ban @member reason bans: they can't come back until you unban them. For someone no longer on the server, give their ID.
• +tempban @member 7d reason bans for a duration; the member is unbanned automatically at the end.
• +unban followed by their username (as shown in +banlist) or their ID unbans them.
• +banlist shows the current bans (10 per page, with the time left for temporary bans); +unbanall removes them all, including those of accounts banned for raiding.

When a member is banned, their messages from the last 7 days are deleted. +banclear 1h shortens that, +banclear 0 keeps all their messages.

The sanction history

+sanctions @member shows everything the member has received, from the most recent sanction to the oldest, 10 per page. Each line gives the date, who gave the sanction (the moderator, or auto when it was the automoderation), its type and its reason.

• +del sanction @member 2 removes the 2nd sanction of this list;
• +clear sanctions @member removes them all, and resets their strikes;
• +clear all sanctions empties the whole server's history.

Moderation notes

Notes keep a record between moderators, for example of a verbal warning. They are not sanctions, and the member isn't told.

• +note @member warned about their nickname adds a note;
• +note @member shows their notes, numbered from the oldest to the most recent;
• +note delete @member 2 deletes the 2nd, +note delete @member all all their notes, +note delete all those of the whole server.

Telling the member and keeping a record

• The bot tells the member by direct message at each sanction and when it ends: +mp settings sets when it does.
• Sanctions arrive in the moderation logs, with the moderator and the reason.

If it doesn't work

• The sanction isn't applied: the member is of an equal or higher level than yours, or their role is above the bot's.
• A muted member can still write in a channel: with the mute role, run +muterole again and look at the channels it reports.
• The mute stops after 28 days: that is the limit of Discord's timeout; switch to the mute role with +timeout off.

Every command

Each command of this guide, with its arguments, its default level and examples: Sanctions, Mutes, Kicks and bans and Moderation notes.