Moderation: Timeouts
Regular timeouts, plus a 'force' version that reapplies itself if someone tries to remove it early.
Part of Moderation - see also Actions, Nicknames, and Mass Actions.
Regular timeout
$timeout <@member> [duration=5m] [reason]
$untimeout <@member or all> [reason]
$timeout @user 2h spamming - duration defaults to 5 minutes if you leave it off, and caps
at 28 days (Discord's own limit). $untimeout all lifts every active timeout in the server
at once, after a confirm prompt telling you how many members that affects.
A member with a forced timeout (below) won't budge from a plain untimeout
- it just reapplies itself. You'll get told to use forceuntimeout on them instead, and
untimeout all automatically skips anyone forced rather than silently failing on them.
DM notifications: a single-target timeout/untimeout DMs
the member by default (not untimeout all). Add --dm no anywhere in the
reason to skip it, or use /timeout//untimeout's real dm option.
Forced timeout
$forcetimeout <@member> [duration=5m] [reason]
$forceuntimeout <@member or all> [reason]
Same as a regular timeout, except if the timeout gets removed or shortened early by anyone (including
another mod, or the member somehow escaping it), Pixie automatically reapplies it for whatever time was
left. It persists across bot restarts too. The only way to actually lift a forced timeout is
forceuntimeout on that member - or forceuntimeout all to cancel every forced
timeout on the server at once (also confirm-gated).
Use this over a regular timeout when you specifically don't trust the target (or another mod) not to just remove it.
DM notifications: forcetimeout DMs the member by default, same as a
regular timeout - add --dm no anywhere in the reason, or use /forcetimeout
set's real dm option to skip it. forceuntimeout (single member or
all) never DMs at all.