every moderation action opens a numbered case, and goes to the moderation log if you’ve set one. you can look anybody’s record up later. whoever you act on gets a dm saying what happened, in which server, who did it and why. bans, kicks and softbans send it before they go, while drain can still reach them. closed dms never stop the action.

setting it up

open the dashboard, pick your server and go to moderation. pick the jail role, jail channel and the three mute roles you already have, or press build to make what’s missing (that needs administrator). the same page sets forced nicknames, how many days a warning counts for, what happens at a number of warnings, and what happens when somebody leaves timed out or comes back. the mod log channel is on the logs page.
setup writes those roles into every channel that exists at that moment. channels made later don’t get them, so add the muted and jailed overwrites to new channels yourself.

who you can act on

every action checks that:
  • you’re not acting on yourself or the server owner
  • their highest role is below yours (the owner skips this)
  • their highest role is below drain’s

warnings

,mod warns shows somebody’s newest 20 warnings. ,warndecay set 0 keeps every warning for good.

punishing at a count

a count is 1 to 50 and the action is kick, ban or timeout (a one hour timeout). it fires when somebody’s active warnings reach exactly that number.

timeouts, mutes and jail

a timeout is discord’s own, 60s by default and up to 28 days. a bare number means minutes: ,timeout @coy 30 is thirty minutes. jail takes every role, keeps them, and leaves only jailed; unjail gives them back. ,timeout, ,untimeout, ,jail, ,unjail, ,ban and ,unban also answer with mod in front, so ,jail and ,mod jail are the same command.

removing people

,ban works by mention or id, even on somebody who isn’t here. a hardban bans them again every time they’re let back in, and ,unbanall lifts every ban except hardbans.
up to 7d
clear that much of their recent messages

cases

channels and messages

,purge deletes 15 messages by default and up to 100. ,botclear looks back 100 messages by default and up to 500, and only ever deletes what bots and webhooks said, from any bot: people’s messages are never touched.
,mod unlockdown clears the send lock in every channel where @everyone can’t send, including channels that were locked before the lockdown.

when people leave and come back

when somebody leaves, drain keeps their roles and any timeout they were under.
  • a hardban bans them again the moment they rejoin
  • the muted, muted (images) and muted (reactions) roles always go back on
  • their other roles only come back if you turn it on
muteleave decides what happens to somebody who left while timed out: none (the default), remute to put the timeout back, or kick.

starting over

,mod reset clears moderation settings. cases and warnings are kept.

ways to type it

every command

moderation

clearing messages

the snipe commands are on the snipe page.

roles and channels