Command Reference

Moderation commands

Every moderation command, what it does and who can run it.

Most days you'll only touch half a dozen of these — ban, kick, timeout, purge, warn. The rest are here for when something unusual happens, and it's worth knowing they exist before you need them at 3am.

Anything that punishes a member writes a case, so ,history @user will show it later. Commands that need a permission say so in the table.

Moderation

CommandAliasesWhat it does
,audit [user],auditlog, ,alShow recent audit-log entries, optionally filtered to a user. (needs view audit log)
,autolockdown <on|off|set <mentions> <seconds>|status>,mentionlockdown, ,autolockLock the server automatically when mentions spike. (needs manage guild)
,autopurge #channel <duration> | autopurge #channel off | autopurge list,autodeleteAutomatically delete messages older than a given age in a channel. (needs manage channels)
,autoslowmode #channel on [threshold] [window] [max] | autoslowmode #channel off | autoslowmode list,autoslowAutomatically raise slowmode when a channel spikes and relax it when quiet. (needs manage channels)
,backup <create [label]|list|info <id>|load <id>|delete <id>|auto <hours|off>|config>,backupsCreate, list, restore and delete full server backups of roles and channels. (needs administrator)
,ban <user> [user2 user3 ...] [reason] [--hardban],bBan one or more members or users from the server. (needs ban members)
,baninfo <user_id>,biShow the ban entry for a user. (needs ban members)
,bans,banlistList the server's bans. (needs ban members)
,banwave <window> [--norole] [--noavatar] [reason],raidpruneBan every member who joined within a recent window, with confirmation. (needs ban members)
,caselog <case id>,caseShow the full detail of a single moderation case. (needs manage messages)
,clearinvites,wipeinvitesDelete all server invites. (needs manage guild)
,clearwarns <user>,clearwarnings, ,cwClear all active warnings for a member. (needs manage messages)
,copilot <member> | copilot reason <rough note>,aicase, ,modaiAI moderation copilot: review a member's history for a risk briefing and suggested action, or polish a mod-log reason. Advisory only. (needs manage messages)
,deafen <member> [reason],vdeafen, ,deafServer deafen a member in voice. (needs deafen members)
,dehoist [enable | disable | run]Enable or disable auto-dehoist, or scan the server to clean hoisting names now. (needs manage nicknames)
,drag <member>,pullPull a member into your current voice channel. (needs move members)
,dump <role> [--humans] [--bots],inrole, ,rolemembersList all members who have a given role. (needs manage roles)
,fakepermissions <add|remove|list|reset> [role] [permission],fakeperms, ,fpGrant Discord-less fake permissions to roles (owner only).
,filterchannel <#channel> <links|nolinks|images|media|attachments|contains|notcontains|off> [text] | filterchannel list,channelfilter, ,cfilterRestrict a channel to certain content and auto-delete the rest. Modes: links, nolinks, images, media, attachments, contains <text>, notcontains <text>. (needs manage channels)
,forcenick <member> [nickname] | forcenick list,fnLock a member's nickname, clear the lock, or list forced nicknames. (needs manage nicknames)
,hardban <user> [reason] | hardban list,hbBan a user and keep them banned even if re-added. Administrator or whitelisted only.
,hardbanlist,hardbansList users on the hardban list. (needs administrator)
,hide [channel]Hide a channel from everyone. (needs manage channels)
,history [member] | history view <case id> | history remove <member> <case id> | history removeall <member>,modlogs, ,casesShow, view, or remove a member's moderation history.
,imute <user> [duration] [reason],imagemuteApply the image-muted role to a member, optionally for a duration. (needs manage roles)
,jail <user> [reason]Strip a member's roles and confine them to the jail role. (needs manage roles)
,jaillist,jailed, ,jailsList members currently jailed. (needs manage messages)
,kick <user> [reason],kKick a member from the server. (needs kick members)
,lock [channel],lockchannelDeny everyone from sending messages in a channel, including roles that could bypass it.
,lockdown [end]Lock or unlock every text channel, including roles that could bypass the lock. (needs manage guild)
,lockdownignore add <channel> | lockdownignore remove <channel> | lockdownignore list,lockignoreManage channels that lockdown should skip. (needs manage guild)
,massmute [reason],mmute, ,vcmuteallServer-mute everyone in your current voice channel. (needs mute members)
,massunmute,munmute, ,vcunmuteallServer-unmute everyone in your current voice channel. (needs mute members)
,moderationhistory <member> [command],modhistory, ,staffhistoryShow the cases a moderator has issued, optionally filtered by action. (needs manage messages)
,modsetup,moderationsetupCreate the mod-log channel, jail role, and jail channel. (needs administrator)
,modstats [member],staffstatsShow moderator action statistics.
,move <member> <voice channel>,vmoveMove a member to another voice channel. (needs move members)
,moveall <voice channel>,mvallMove everyone in your current voice channel to another channel. (needs move members)
,mute <user> [duration] [reason],mApply the muted role to a member, optionally for a duration. (needs manage roles)
,naughty [channel]Temporarily mark a channel NSFW for 30 seconds, then revert it. (needs manage channels)
,newmembers [count],newmember, ,recentmembers, ,newjoinsList the most recently joined members. (needs manage guild)
,nickname <member> [new nickname],setnick, ,nickSet or clear a member's nickname. (needs manage nicknames)
,notes <member> | notes add <member> <note> | notes remove <member> <id> | notes clear <member>,noteView, add, remove, or clear moderator notes on a member. (needs manage messages)
,nuke | nuke add <channel> <interval> [message] | nuke remove <channel> | nuke list | nuke view <channel> | nuke archive <channel> <on|off>Nuke the current channel now, or manage recurring scheduled nukes. (needs manage channels)
,permissions [member] [channel],permsShow a member's effective permissions. (needs manage roles)
,proof add <case id> <media url> | proof set <case id> <explanation> | proof view <case id> | proof list <case id> | proof remove <case id> <index>,evidenceAttach proof or an explanation to a moderation case. (needs manage messages)
,purge [member] <amount> [--replies] [--old] | purge <filter> [value] [amount],clear, ,prune, ,p, ,cBulk delete messages. purge <amount> clears the last <amount> messages. purge <member> <amount> scans the last <amount> messages and deletes that member's among them (same for purge bots <amount>); raise <amount> to reach further back in busy channels. Also filter by: humans, links, images, files, embeds, stickers, mentions, emojis, reactions, contains/startswith/endswith text, or by position (before, after, between, upto a message). Add --replies when purging a member to also delete replies to them. Add --old to also remove messages older than 14 days one by one (this is slower).
,reactionmod add <emoji> <delete|warn|timeout|kick|ban> | reactionmod remove <emoji> | reactionmod list,reactmodMap an emoji to a moderation action triggered when staff react to a message. (needs manage guild)
,reason <case id> <reason>Update the reason on an existing moderation case. (needs manage messages)
,reasontemplate <add <key> <text> | remove <key> | list>,reasontemplates, ,rtManage reason templates. Use #key inside a moderation reason to expand it to the stored text. (needs manage guild)
,recentban <count> [reason],recentbans, ,banrecentBan the most recently joined members after a confirmation. (needs ban members)
,recover <messages [#channel] [count]|message <id>|channel <id>|channels>,recovery-restoreRecover deleted messages and channels from the recovery archive. (needs manage messages)
,report <user> [reason]Report a member to the server staff.
,restore <user>,restorerolesRe-add a returning member's previously held roles. (needs manage roles)
,restoreroles <on|off|status>,rolerestore, ,rolepersistWhen on, members who rejoin get back the roles they had when they left. (needs manage guild)
,restrictcommand add <command> <role> | remove <command> <role> | list | reset [command],restrictcmdRestrict a command to specific roles. (needs manage guild)
,revokefiles | revokefiles on <channel> | revokefiles off <channel>Toggle attaching files and embedding links for everyone in a channel. (needs manage channels)
,rmute <user> [duration] [reason],reactionmuteApply the reaction-muted role to a member, optionally for a duration. (needs manage roles)
,role <member> <role> | role create <name> [hex] | role delete <role> | role color <role> <hex> | role rename <role> <name> | role icon <role> | role all|humans|bots [remove] <role> | role hoist <role> | role mentionable <role> | role edit <role> <name> | role gradient <hex> <hex> <role> | role topcolor <hex> [member] | role has [remove] <role> <assign role>,rToggle, create, delete, edit, or mass-assign roles. (needs manage roles)
,rolecreate <name> [hex_color],createroleCreate a new role. (needs manage roles)
,roledelete <role>,deleteroleDelete a role. (needs manage roles)
,rollback <mod> <timeframe> [--type role,nick,ban,...] [--dry-run],undoUndo all reversible actions a moderator did within a timeframe. (needs ban members)
,secaudit,securityaudit, ,permauditScan roles and key settings for permission and security risks. (needs manage guild)
,setupmute,mutesetupCreate Muted, Image Muted, and Reaction Muted roles with overwrites. (needs administrator)
,slowmode <seconds> | slowmode on <channel> <delay> | slowmode off <channel>,slowSet the slowmode delay on a channel. (needs manage channels)
,softban <user> [reason],sbBan then immediately unban a member to clear their messages. (needs ban members)
,stickyrole <member> <role> | stickyrole remove <member> <role> | stickyrole list,stickyMark a role as sticky so it is re-applied when a member rejoins. (needs manage guild)
,stripstaff <user>,stripRemove every role granting a dangerous permission from a member. (needs administrator)
,talk <channel> <role>Toggle whether a role can send messages in a channel. (needs manage channels)
,tempban <user> <duration> [reason],tbTemporarily ban a member; they are unbanned automatically. (needs ban members)
,temprole <member> <duration> <role> | temprole list,temprAssign a role that is automatically removed when its duration expires. (needs manage roles)
,thread lock [thread] [reason] | thread unlock [thread] [reason] | thread add [thread] <member> | thread remove [thread] <member> | thread rename [thread] <name> | thread watch [thread] | thread watchlist,threadsManage threads: lock, unlock, add, remove, rename, watch, and watchlist. (needs manage channels)
,timeout <user> <duration> [reason],toTimeout a member using Discord's native timeout. (needs moderate members)
,timeoutlist,timeouts, ,mutedlistList members who are currently timed out. (needs moderate members)
,topic <text>Set the topic of the current channel. (needs manage channels)
,unban <user_id> [reason],ubUnban a user from the server. (needs ban members)
,unbanall | unbanall cancel,liftallLift all bans on the server. (needs ban members)
,undeafen <member>,unvdeafen, ,undeafRemove a member's server deafen in voice. (needs deafen members)
,unforcenickname <member> [member2 ...],unforcenick, ,ufnRemove a forced nickname lock from one or more members. (needs manage nicknames)
,unhide [channel]Reveal a hidden channel to everyone. (needs manage channels)
,unimute <user> [reason],unimagemuteRemove the image-muted role from a member. (needs manage roles)
,unjail <user> [reason]Release a member from jail and restore their roles. (needs manage roles)
,unlock [channel]Restore sending messages in a channel, including roles a lock denied.
,unlockallUnlock every text channel, skipping channels ignored by lockdown. (needs manage guild)
,unmute <user> [reason],umRemove the muted role from a member. (needs manage roles)
,unrmute <user> [reason],unreactionmuteRemove the reaction-muted role from a member. (needs manage roles)
,untimeout <user> [reason],unto, ,untimeRemove a member's active timeout. (needs moderate members)
,unvoicemute <member>,unvmuteRemove a member's server mute in voice. (needs mute members)
,voicekick <member>,vkick, ,vkDisconnect a member from their voice channel. (needs move members)
,voicemute <member> [reason],vmuteServer mute a member in voice. (needs mute members)
,warn <user> [reason],wWarn a member. (needs manage messages)
,warnescalation <add <threshold> <mute|timeout|kick|ban> [duration]|remove <threshold>|list|decay <days|off>>,warnpunishConfigure automatic punishments at warning thresholds and warn decay. (needs manage guild)
,warns <user>,warnings, ,warnlistList a member's active warnings. (needs manage messages)
,watchlist <add <target> <reason...> | remove <id> | list | check <member>>,watchTrack suspicious Discord or Roblox accounts and get alerts when they join. (needs manage guild)
,wipe <member> [amount] [--old],wipeuserDelete a member's messages across all channels in the server using the message index. wipe <member> [amount] removes up to <amount> of their most recently indexed messages. Add --old to also remove messages older than 14 days one by one (slower). Only messages indexed since indexing began can be wiped.

Anti-nuke

Watches for the destructive stuff: mass bans, channel deletions, role changes, webhook spam.

CommandAliasesWhat it does
,antinuke <module> <on/off> [flags] | antinuke <whitelist|admin|list|config> ...,anProtect the server from nuke attacks (mass bans, channel/role wipes, webhook spam, and more). (needs administrator)
,integrity <on|off|channel|whitelist|status|resnapshot> ...,integReal-time privilege-escalation guard with auto-revert. (needs manage guild)
,modguard <enable|disable|threshold|window|action|freezetime|channel|exempt|triggers|status>,modaccountability, ,modwatchDetect and stop a moderator performing too many destructive actions in a short window. (needs administrator)
,sentinel <on|off|action <alert|quarantine>|channel <#channel|none>|restore <@user>|status>Detect compromised staff accounts and alert or quarantine them before a nuke. (needs manage guild)

Anti-raid

Join-rate and account-fingerprint checks, plus panic mode when it's already happening.

CommandAliasesWhat it does
,antiraid <massjoin|age|lock|whitelist|config> ...,araidProtect the server from raids (mass joins, new accounts). (needs administrator)
,impersonators <@role> [#channel] | list | remove <@role> | channel <#channel> | action <type> | ignore ...,imposter, ,impostorCatch members impersonating your staff or protected roles by name or avatar. (needs administrator)
,panic <on|off|status>,lockdownmode, ,panicmodeEngage a hardened raid panic state: raise verification, lock channels, quarantine recent joiners. (needs manage guild)

Automod

Message filtering. ,filter handles the simple stuff, ,heat catches people who stay just under every individual limit.

CommandAliasesWhat it does
,filter <links|invites|caps|add|remove|list|exempt|autoregex> ...,automodConfigure automod filters (links, invites, caps, banned words). (needs manage guild)
,heat <on|off|set <threshold> <decay>|action <warn|timeout|kick|ban> [seconds]|factor <name> <points>|multiplier <n>|status>,heatsystemCumulative heat scoring that punishes members who trip several filters at once. (needs manage guild)
,regexfilter <add|remove|list|toggle> ...,regex, ,rfilterManage regex message filters (add, remove, list, toggle). (needs manage guild)

Security

CommandAliasesWhat it does
,vanityguard <on|off|channel|punish|boostwarn|watch|whitelist|config> ...,vguard, ,vanitysecureProtect your server vanity URL: alert on theft/loss, warn before boosts drop, watch target vanities. (needs administrator)
,vanityverify <invite or code>,vverify, ,checkvanityProve which server a vanity currently points to (timestamped) — kills vanity-trade scams.