Skip to content
flankerDocs
Dashboard

Moderation commands

Type / and pick the slash command, or mention Flanker before the command. (round) parameters are required; [square] parameters are optional. Expand a syntax row for its slash command, permissions and example.

setup

Opens the setup hub: every flanker module, set up with buttons and menus. `setup jail` creates the jail role, jail channel and jail log.

Permission
Administrator
Dashboard
Choose your server/moderation/jail
setup

Opens the setup hub with every module and its status.

Permission: Manage Server

Slash: /setup show

Mention
@Flanker setup
setup jail

Creates everything the jail needs and hides other channels from jailed members.

Slash: /setup jail

Mention
@Flanker setup jail

setupmute

Creates the image mute and reaction mute roles.

Permission
Manage Server
setupmute

Creates both roles and denies them in every channel.

Slash: /moderation setupmute

Mention
@Flanker setupmute

settings

Moderation settings. Run `settings` on its own for a setup panel with menus and buttons.

Permission
Manage Server (real)
Aliases
config
Dashboard
Choose your server/moderation
settings modlog (channel)

Where a case is posted for every moderation action.

Slash: /moderation settings modlog

Mention
@Flanker settings modlog (channel)
Example/moderation settings modlog #mod-log
settings jail (channel)

The jail channel.

Slash: /moderation settings jail

Mention
@Flanker settings jail (channel)
settings jailthreads (on/off)

Gives each jailed member a private thread with staff.

Slash: /moderation settings jailthreads

Mention
@Flanker settings jailthreads (on/off)
settings jailmsg (message)

The message jailed members see.

Slash: /moderation settings jailmsg

Mention
@Flanker settings jailmsg (message)
settings jailmsgchannel (channel)

Where the jail message is posted.

Slash: /moderation settings jailmsgchannel

Mention
@Flanker settings jailmsgchannel (channel)
settings imuted (role/none)

The image mute role.

Slash: /moderation settings imuted

Mention
@Flanker settings imuted (role/none)
settings rmuted (role/none)

The reaction mute role.

Slash: /moderation settings rmuted

Mention
@Flanker settings rmuted (role/none)
settings appealserver (invite/none)

An appeal server link added to ban messages.

Slash: /moderation settings appealserver

Mention
@Flanker settings appealserver (invite/none)
settings dj (role/off)

The DJ role for music.

Permission: Manage Server

Slash: /moderation settings dj

Mention
@Flanker settings dj (role/off)
settings 247 (on/off)

Stay in empty voice channels and autoplay similar tracks.

Permission: Manage Server

Slash: /moderation settings 247

Mention
@Flanker settings 247 (on/off)
settings autoplay (on/off)

Plays similar tracks when the music queue runs out.

Permission: Manage Server

Slash: /moderation settings autoplay

Mention
@Flanker settings autoplay (on/off)

invoke

Custom messages for moderation actions: what the member gets in DMs and what's posted in the channel. Run `invoke` on its own for a setup panel with menus and buttons.

Permission
Manage Server
invoke (action) (dm/message) (message)

Sets the message for ban, softban, tempban, hardban, unban, kick, timeout (also `mute`, `to`), untimeout, warn, jail, unjail, imute, iunmute, rmute or runmute. Also on the dashboard under Moderation, Command replies.

Slash: /invoke run

Mention
@Flanker invoke (action) (dm/message) (message)
Example/invoke run ban dm You were banned from {guild.name}: {reason}
invoke (action) (dm/message) view

Shows the current message.

Slash: /invoke view

Mention
@Flanker invoke (action) (dm/message) view
invoke (action) (dm/message) clear

Goes back to the default.

Slash: /invoke clear

Mention
@Flanker invoke (action) (dm/message) clear
invoke test (action) (dm/message) [member]

Sends a preview.

Slash: /invoke test

Mention
@Flanker invoke test (action) (dm/message) [member]
invoke list

Shows which actions have custom messages.

Slash: /invoke list

Mention
@Flanker invoke list

access

Chooses who can use each moderation command: extra roles that may use it, roles it's limited to, or turning it off.

Permission
Server owner or Flanker Admin
Aliases
cmdaccessmodaccess
Dashboard
Choose your server/moderation
access

Shows every customised command.

Slash: /access show

Mention
@Flanker access
access list [page]

Pages through moderation command access rules.

Slash: /access list

Mention
@Flanker access list [page]
access allow (command) (role)

Lets a role use a command without the Discord permission. Commands that hand out roles are owner-only.

Slash: /access allow

Mention
@Flanker access allow (command) (role)
Example/access allow ban @Mods
access only (command) (role)

Members also need one of these roles. Admins are never limited.

Slash: /access only

Mention
@Flanker access only (command) (role)
Example/access only kick @Seniors
access disable (command)

Turns a command off for everyone but admins.

Slash: /access disable

Mention
@Flanker access disable (command)
access enable (command)

Turns it back on.

Slash: /access enable

Mention
@Flanker access enable (command)
access reset (command/all)

Goes back to Discord permissions.

Slash: /access reset

Mention
@Flanker access reset (command/all)

ban

Bans a member and deletes their recent messages.

Permission
Ban Members
Aliases
b
Dashboard
Choose your server/moderation
ban (member) [reason] [--silent]

Bans a member. Already-banned users are left unchanged, without another DM or case. Use --silent to skip the punishment DM.

Slash: /ban

Mention
@Flanker ban (member) [reason] [--silent]
Example/ban @spammer posting scam links

softban

Bans and unbans right away to clear someone's recent messages.

Permission
Ban Members
Aliases
sban
Dashboard
Choose your server/moderation
softban (member) [reason] [--silent]

Removes the member and their last day of messages, then lifts the new ban so they can rejoin. Never lifts an existing ban. Reports if the release fails.

Slash: /moderation softban

Mention
@Flanker softban (member) [reason] [--silent]
Example/moderation softban @spammer

tempban

Bans a member for a set time.

Permission
Ban Members
Aliases
tban
Dashboard
Choose your server/moderation
tempban (member) (duration) [reason] [--silent]

Bans them until the duration ends. An existing ban and its expiry are left unchanged.

Slash: /moderation tempban

Mention
@Flanker tempban (member) (duration) [reason] [--silent]
Example/moderation tempban @member 7d toxicity

hardban

A ban that sticks: if anyone unbans them, flanker bans them again.

Permission
Owner, backup owner or antinuke admin
Aliases
hban
Dashboard
Choose your server/moderation
hardban (member) [reason]

Bans and re-bans on every unban until the hardban is lifted. An existing normal ban gains hardban protection without another ban or DM. Pending tempban expiry is cancelled. Repeating a hardban changes nothing.

Slash: /moderation hardban

Mention
@Flanker hardban (member) [reason]

unban

Lifts a ban.

Permission
Ban Members
Aliases
ub
Dashboard
Choose your server/moderation
unban (user, id or username) [reason]

Unbans a user. A name is looked up in the ban list.

Slash: /unban

Mention
@Flanker unban (user, id or username) [reason]
Example/unban baduser

kick

Removes a member from the server.

Permission
Kick Members
Aliases
k
Dashboard
Choose your server/moderation
kick (member) [reason] [--silent]

Kicks a member. They can rejoin with an invite.

Slash: /kick

Mention
@Flanker kick (member) [reason] [--silent]
Example/kick @member

timeout

Stops a member from talking for a while.

Permission
Timeout Members
Aliases
mutetotmute
Dashboard
Choose your server/moderation
timeout (member) [duration] [reason] [--silent]

Times a member out. Defaults to 5 minutes, up to 28 days.

Slash: /timeout

Mention
@Flanker timeout (member) [duration] [reason] [--silent]
Example/timeout @member 1h spam

untimeout

Ends a timeout early.

Permission
Timeout Members
Aliases
unmuteuto
Dashboard
Choose your server/moderation
untimeout (member) [reason]

Lets a member talk again.

Slash: /untimeout

Mention
@Flanker untimeout (member) [reason]

warn

Gives a member a formal warning, saved as a case.

Permission
Timeout Members
Aliases
w
Dashboard
Choose your server/moderation
warn (member) (reason) [--silent]

Warns a member and DMs them.

Slash: /warn

Mention
@Flanker warn (member) (reason) [--silent]
Example/warn @member keep it civil

warnings

Lists a member's warnings.

Permission
Timeout Members
Aliases
warns
Dashboard
Choose your server/moderation
warnings [member]

Shows warnings, newest first.

Slash: /warnings

Mention
@Flanker warnings [member]

clearwarns

Removes a member's warnings.

Permission
Timeout Members
Aliases
clearwarningsdelwarns
Dashboard
Choose your server/moderation
clearwarns (member)

Deletes every warning for the member.

Slash: /cases clearwarns

Mention
@Flanker clearwarns (member)

jail

Locks a member in the jail channel, away from the rest of the server.

Permission
Timeout Members
Aliases
j
Dashboard
Choose your server/moderation/jail
jail (member) [duration] [reason] [--silent]

Jails a member. Their roles are saved and given back when they're released.

Slash: /jail

Mention
@Flanker jail (member) [duration] [reason] [--silent]
Example/jail @member 2h

unjail

Releases a jailed member.

Permission
Timeout Members
Aliases
uj
Dashboard
Choose your server/moderation/jail
unjail (member) [reason]

Gives their roles back.

Slash: /unjail

Mention
@Flanker unjail (member) [reason]

imute

Stops a member posting images and embeds.

Permission
Timeout Members
Aliases
imagemute
imute (member) [reason]

Gives the image mute role.

Slash: /moderation imute

Mention
@Flanker imute (member) [reason]

iunmute

Lifts an image mute.

Permission
Timeout Members
Aliases
imageunmute
iunmute (member)

Removes the image mute role.

Slash: /moderation iunmute

Mention
@Flanker iunmute (member)

rmute

Stops a member adding reactions.

Permission
Timeout Members
Aliases
reactionmute
rmute (member) [reason]

Gives the reaction mute role.

Slash: /moderation rmute

Mention
@Flanker rmute (member) [reason]

runmute

Lifts a reaction mute.

Permission
Timeout Members
Aliases
reactionunmute
runmute (member)

Removes the reaction mute role.

Slash: /moderation runmute

Mention
@Flanker runmute (member)

purge

Bulk deletes messages.

Permission
Manage Messages
Aliases
clearcprune
purge (1-1000)

Deletes the last messages in the channel.

Slash: /purge messages

Mention
@Flanker purge (1-1000)
Example/purge messages 50
purge (member) (1-1000)

Only that member's messages.

Slash: /purge member

Mention
@Flanker purge (member) (1-1000)
Example/purge member @spammer 100
purge (bots/humans/links/images/embeds/mentions/stickers) (1-1000)

Only one kind of message.

Slash: /purge matching

Mention
@Flanker purge (bots/humans/links/images/embeds/mentions/stickers) (1-1000)
Example/purge matching bots 30
purge contains (text) (1-1000)

Only messages containing some text.

Slash: /purge contains

Mention
@Flanker purge contains (text) (1-1000)

lock

Stops everyone except staff from typing in a channel.

Permission
Manage Roles
Aliases
lockdown
lock [channel] [reason]

Locks a channel.

Slash: /lock

Mention
@Flanker lock [channel] [reason]

unlock

Unlocks a locked channel.

Permission
Manage Roles
Aliases
unlockdown
unlock [channel]

Lets everyone type again.

Slash: /unlock

Mention
@Flanker unlock [channel]

slowmode

Sets a channel's slowmode.

Permission
Manage Channels
Aliases
smslow
slowmode [channel] (duration/off)

Members wait this long between messages.

Slash: /slowmode

Mention
@Flanker slowmode [channel] (duration/off)
Example/slowmode 10s

nickname

Changes a member's nickname.

Permission
Manage Nicknames
Aliases
nickrename
nickname (member) [nickname/reset]

Sets or clears a nickname.

Slash: /nickname

Mention
@Flanker nickname (member) [nickname/reset]
Example/nickname @member Bob

role

Gives or takes roles, and creates, edits and deletes them.

Permission
Manage Roles
Aliases
r
role (member) (roles)

Toggles each role on the member. You can only hand out roles below yours that have no permissions you lack.

Slash: /role toggle

Mention
@Flanker role (member) (roles)
Example/role toggle @member Verified, Member
role restore (member)

Restores the latest saved roles after a member leaves, is kicked or is banned, once they rejoin. Respects current hierarchy, actor permissions and antinuke limits. Does not bypass jail, captcha or protected roles. Member settings remain keyed to their user ID.

Slash: /role restore

Mention
@Flanker role restore (member)
Example/role restore @member
role create (name) [--color hex] [--hoist]

Creates a role with no permissions.

Slash: /role create

Mention
@Flanker role create (name) [--color hex] [--hoist]
Example/role create Events --color #a3b6ff
role delete (role)

Deletes a role. Counts toward antinuke's role limit.

Slash: /role delete

Mention
@Flanker role delete (role)
role color (role) (hex)

Changes a role's colour.

Slash: /role color

Mention
@Flanker role color (role) (hex)
role rename (role) (new name)

Renames a role.

Slash: /role rename

Mention
@Flanker role rename (role) (new name)
role icon (role) (image URL, emoji or attachment)

Sets a role icon (boost level 2).

Slash: /role icon

Mention
@Flanker role icon (role) (image URL, emoji or attachment)
role hoist (role) (on/off)

Shows the role separately in the member list.

Slash: /role hoist

Mention
@Flanker role hoist (role) (on/off)
role mentionable (role) (on/off)

Lets anyone mention the role.

Slash: /role mentionable

Mention
@Flanker role mentionable (role) (on/off)
role all (roles) [remove]

Gives or removes up to 10 roles in one batch. One bulk role job per server, including humans/bots and paused jobs. Pauses during panic and resumes after recovery. Dangerous roles cannot be mass given.

Slash: /role all

Mention
@Flanker role all (roles) [remove]
Example/role all @Member @Events @Updates
role humans (roles) [remove]

Gives or removes up to 10 roles for humans. Shares the one-job server limit with role all/bots.

Slash: /role humans

Mention
@Flanker role humans (roles) [remove]
role bots (roles) [remove]

Gives or removes up to 10 roles for bots. Shares the one-job server limit with role all/humans.

Slash: /role bots

Mention
@Flanker role bots (roles) [remove]

history

A member's moderation history.

Permission
Timeout Members
Aliases
casesmodlogs
history [member] [page]

Every case for the member, a few per page: when, who, why, how long, any evidence, and a link to each case's modlog post.

Slash: /cases history

Mention
@Flanker history [member] [page]

case

Looks up one moderation case.

Permission
Timeout Members
case (number)

Shows the case with its evidence. Modlog posts for new cases have buttons to undo the action, add evidence and open the member's history.

Slash: /cases case

Mention
@Flanker case (number)
Example/cases case 42

reason

Changes the reason on a case.

Permission
Timeout Members
reason (case) (new reason)

Updates the case and its modlog post.

Slash: /cases reason

Mention
@Flanker reason (case) (new reason)
Example/cases reason 42 alt account