Command reference

29 commands. Start a message with , (for example ,help); arguments in <angle brackets> are required, [square brackets] are optional. Put text with spaces in "quotes", or set an option by name like delete_days:2; the last text option (usually the reason) takes the rest of the line. Durations look like 10m, 2h, 7d, 1d12h or perm.

For everyone

Commands any member can use.

,help

What can this bot do?

Who: Members

,help

,ping

Check that the bot is alive

Who: Members

,ping

,boosterrole

Your own custom role (server boosters only)

Who: Members

,boosterrole create <name> <color> [color2] [holographic] [emoji] [icon]

Create your custom role

Option	Type		What it does
`name`	text	required	Role name
`color`	text	required	Hex color, e.g. #ff66aa
`color2`	text	optional	Second hex color for a gradient (needs Boost level 3)
`holographic`	yes/no	optional	Holographic style (needs Boost level 3)
`emoji`	text	optional	Role icon as a standard emoji (needs Boost level 2)
`icon`	file	optional	Role icon image, PNG/JPG/GIF under 256 KB (needs Boost level 2)

,boosterrole edit [name] [color] [color2] [holographic] [emoji] [icon]

Change your role name and/or color

Option	Type		What it does
`name`	text	optional	New name
`color`	text	optional	New hex color (resets any gradient unless color2 is given)
`color2`	text	optional	Second hex color for a gradient (needs Boost level 3)
`holographic`	yes/no	optional	Holographic style (needs Boost level 3)
`emoji`	text	optional	Role icon as a standard emoji (needs Boost level 2)
`icon`	file	optional	Role icon image, PNG/JPG/GIF under 256 KB (needs Boost level 2)

,boosterrole delete

Delete your custom role

,boosterrole show

Show your custom role

,boosterrole setup [enabled] [anchor] [grace_hours]

Configure booster roles (admin)

Option	Type		What it does
`enabled`	yes/no	optional	Turn on/off
`anchor`	role	optional	New roles are placed just below this role
`grace_hours`	number	optional	Keep the role this long after boosting stops (0 = remove at once)

Moderation

Warns, mutes, kicks, bans and jail. Every action is saved as a numbered case and posted in the mod log.

,warn

Warn a member

Who: Staff · Discord permission: ModerateMembers

,warn <user> <reason>

Option	Type		What it does
`user`	user	required	Member
`reason`	text	required	Reason

,warnings

List a member's active warnings

Who: Staff · Discord permission: ModerateMembers

,warnings <user>

Option	Type		What it does
`user`	user	required	Member

,delwarn

Remove one warning by case number

Who: Staff · Discord permission: ModerateMembers

,delwarn <case>

Option	Type		What it does
`case`	number	required	Case number

,clearwarns

Remove all active warnings of a member

Who: Staff · Discord permission: ModerateMembers

,clearwarns <user>

Option	Type		What it does
`user`	user	required	Member

,mute

Time out a member (max 28 days)

Who: Staff · Discord permission: ModerateMembers

,mute <user> <duration> [reason]

Option	Type		What it does
`user`	user	required	Member
`duration`	text	required	e.g. 10m, 2h, 7d
`reason`	text	optional	Reason

,unmute

Remove a member's timeout

Who: Staff · Discord permission: ModerateMembers

,unmute <user> [reason]

Option	Type		What it does
`user`	user	required	Member
`reason`	text	optional	Reason

,kick

Kick a member

Who: Staff · Discord permission: KickMembers

,kick <user> [reason]

Option	Type		What it does
`user`	user	required	Member
`reason`	text	optional	Reason

,ban

Ban a user (optionally temporary)

Who: Staff · Discord permission: BanMembers

,ban <user> [reason] [duration] [delete_days]

Option	Type		What it does
`user`	user	required	User
`reason`	text	optional	Reason
`duration`	text	optional	e.g. 7d, or perm (default perm)
`delete_days`	number	optional	Delete their messages from the last N days (0-7)

,unban

Unban a user by ID

Who: Staff · Discord permission: BanMembers

,unban <user_id> [reason]

Option	Type		What it does
`user_id`	text	required	User ID
`reason`	text	optional	Reason

,jail

Jail a member: they can only see the jail channel

Who: Staff · Discord permission: ModerateMembers

,jail setup

Create the Jail role and channel (admin)

,jail add <user> <duration> [reason]

Jail a member

Option	Type		What it does
`user`	user	required	Member
`duration`	text	required	e.g. 1h, 2d, perm
`reason`	text	optional	Reason

,unjail

Release a member from jail

Who: Staff · Discord permission: ModerateMembers

,unjail <user> [reason]

Option	Type		What it does
`user`	user	required	Member
`reason`	text	optional	Reason

,case

Show one moderation case

Who: Staff · Discord permission: ModerateMembers

,case <number>

Option	Type		What it does
`number`	number	required	Case number

,history

Moderation history of a user

Who: Staff · Discord permission: ModerateMembers

,history <user>

Option	Type		What it does
`user`	user	required	User

,modstats

Moderation activity in the last 30 days

Who: Staff · Discord permission: ModerateMembers

,modstats

,clear

Delete messages in this channel: a number, or all

Who: Staff · Discord permission: ManageMessages

,clear [amount] [all]

Option	Type		What it does
`amount`	number	optional	How many messages to delete (1-1000)
`all`	yes/no	optional	Delete every message in the channel (pinned messages are kept)

Logs and audit

See deleted and edited messages (with their files) and the server audit log.

,audit

Look through the server audit log (staff)

Who: Staff · Discord permission: ViewAuditLog

,audit recent [by] [action] [limit]

Latest audit log entries

Option	Type		What it does
`by`	user	optional	Only actions done by this user
`action`	text	optional	Only this action type (Ban, Unban, Kick, Member update (timeout/nick), Member roles, Role create, Role update, Role delete, Channel create, Channel update, Channel delete, Overwrite update, Invite create, Webhook create, Bot added, Server update, Message delete, Bulk delete)
`limit`	number	optional	1-25 (default 10)

,audit search <text>

Search saved audit copies (kept 90 days) by text

Option	Type		What it does
`text`	text	required	Reason, action name or ID

,snipe

Show the last deleted message in a channel (staff)

Who: Staff · Discord permission: ManageMessages

,snipe [channel]

Option	Type		What it does
`channel`	channel	optional	Channel (default: here)

,editsnipe

Show the last edited message in a channel (staff)

Who: Staff · Discord permission: ManageMessages

,editsnipe [channel]

Option	Type		What it does
`channel`	channel	optional	Channel (default: here)

,messagelog

Deleted or edited messages of a member (staff)

Who: Staff · Discord permission: ManageMessages

,messagelog <user> <type>

Option	Type		What it does
`user`	user	required	Member
`type`	text	required	What to show (deleted, edited)

Giveaways

Members press the Enter button; a random eligible winner is picked when time is up.

,giveaway

Run giveaways (staff)

Who: Staff / giveaway managers · Discord permission: ManageMessages

,giveaway start <prize> <duration> [winners] [channel] [required_role] [min_account_days] [min_server_days]

Start a giveaway

Option	Type		What it does
`prize`	text	required	What is the prize?
`duration`	text	required	e.g. 30m, 2h, 7d
`winners`	number	optional	Number of winners (default 1)
`channel`	channel	optional	Where to post (default: here)
`required_role`	role	optional	Only members with this role can enter
`min_account_days`	number	optional	Minimum account age in days
`min_server_days`	number	optional	Minimum days in this server

,giveaway end <id>

End a giveaway now and pick the winner(s)

Option	Type		What it does
`id`	number	required	Giveaway number

,giveaway reroll <id> [count]

Pick new random winner(s) for an ended giveaway

Option	Type		What it does
`id`	number	required	Giveaway number
`count`	number	optional	How many (default 1)

,giveaway cancel <id>

Cancel a running giveaway

Option	Type		What it does
`id`	number	required	Giveaway number

,giveaway list

Running giveaways

,giveaway manager-role <role> <allow>

Let a role run giveaways (admin)

Option	Type		What it does
`role`	role	required	Role
`allow`	yes/no	required	true = allow, false = remove

Server setup (admin)

Configuration. Needs Manage Server unless a staff role is noted.

,setup

Configure the bot for this server (admin)

Who: Admins · Discord permission: ManageGuild

,setup staff-add <role>

Add a staff role (can use moderation commands)

Option	Type		What it does
`role`	role	required	Role

,setup staff-remove <role>

Remove a staff role

Option	Type		What it does
`role`	role	required	Role

,setup modlog <channel>

Set the moderation log channel

Option	Type		What it does
`channel`	channel	required	Channel

,setup show

Show the current setup

,verify

Verification system (staff)

Who: Admins · Discord permission: ManageGuild

,verify setup <verified_role> [adult_role] [log_channel] [enabled] [unverified_role]

Set roles and channels

Option	Type		What it does
`verified_role`	role	required	Role given after verifying
`adult_role`	role	optional	Role for members who confirmed 18+ (optional)
`log_channel`	channel	optional	Where verification events go
`enabled`	yes/no	optional	Turn the system on/off (default on)
`unverified_role`	role	optional	Role given on join and removed when they verify (optional)

,verify settings [min_age_days] [fail_action] [challenge] [age_confirm] [attempts] [unverified_minutes] [raid_joins]

Tune the rules

Option	Type		What it does
`min_age_days`	number	optional	Minimum account age in days (default 60)
`fail_action`	text	optional	If rejected (kick, hold (stay, cannot verify))
`challenge`	yes/no	optional	Require the typed code
`age_confirm`	yes/no	optional	Require the 18+ and rules confirmation
`attempts`	number	optional	Failed attempts allowed
`unverified_minutes`	number	optional	Kick unverified members after N minutes (0 = never)
`raid_joins`	number	optional	Auto lockdown at N joins per window (0 = off)

,verify panel [channel]

Post the Verify button

Option	Type		What it does
`channel`	channel	optional	Where to post (default: here)

,verify manual <user>

Verify someone by hand

Option	Type		What it does
`user`	user	required	Member

,verify allow <user>

Whitelist a user (skips age/risk checks)

Option	Type		What it does
`user`	user	required	User

,verify block <user>

Blacklist a user (always rejected)

Option	Type		What it does
`user`	user	required	User

,verify unlist <user>

Remove a user from both lists

Option	Type		What it does
`user`	user	required	User

,verify lockdown <on>

Start or end a raid lockdown

Option	Type		What it does
`on`	yes/no	required	true = start, false = end

,verify show

Show verification settings

,logs

Configure message and audit logging (admin)

Who: Admins · Discord permission: ManageGuild

,logs channel <type> <channel>

Set a log channel

Option	Type		What it does
`type`	text	required	Which log (messages (edits and deletes), audit log, members (join/leave/roles), voice)
`channel`	channel	required	Text channel

,logs toggle <enabled>

Turn logging on or off

Option	Type		What it does
`enabled`	yes/no	required	On?

,logs ignore-channel <channel> <ignore>

Do not log a channel (or remove it from the list)

Option	Type		What it does
`channel`	channel	required	Channel
`ignore`	yes/no	required	true = ignore, false = log again

,logs ignore-role <role> <ignore>

Do not log members with a role

Option	Type		What it does
`role`	role	required	Role
`ignore`	yes/no	required	true = ignore, false = log again

,logs retention <days>

How long logged messages are kept

Option	Type		What it does
`days`	number	required	1-90

,logs archive <enabled>

Keep copies of attached files (not from age-restricted channels)

Option	Type		What it does
`enabled`	yes/no	required	On?

,logs purge-user <user>

Delete all logged messages of a user

Option	Type		What it does
`user`	user	required	User

,logs show

Show logging settings

,links

Block links except for boosters and staff

Who: Admins · Discord permission: ManageGuild

,links toggle <enabled>

Turn link blocking on or off

Option	Type		What it does
`enabled`	yes/no	required	On?

,links domain <domain> <allow>

Allow or disallow a domain for everyone

Option	Type		What it does
`domain`	text	required	e.g. tenor.com
`allow`	yes/no	required	true = allow, false = remove

,links channel <channel> <allow>

Allow links for everyone in a channel

Option	Type		What it does
`channel`	channel	required	Channel
`allow`	yes/no	required	true = allow, false = remove

,links exempt-role <role> <exempt>

Let a role post links

Option	Type		What it does
`role`	role	required	Role
`exempt`	yes/no	required	true = exempt, false = remove

,links autowarn <enabled>

Warn members who post blocked links

Option	Type		What it does
`enabled`	yes/no	required	On?

,links automod <enabled>

Also use Discord's native AutoMod (needs Manage Server)

Option	Type		What it does
`enabled`	yes/no	required	On?

,links show

Show link settings

,voice

Temporary voice rooms (admin)

Who: Admins · Discord permission: ManageGuild

,voice setup [hub] [category] [max_rooms] [cooldown]

Enable join-to-create voice rooms

Option	Type		What it does
`hub`	channel	optional	Existing voice channel to use as the "join to create" hub (default: create one)
`category`	channel	optional	Category for new rooms
`max_rooms`	number	optional	Rooms per user (default 1)
`cooldown`	number	optional	Seconds between creating rooms (default 10)

,voice disable

Turn the feature off

,modconfig

Configure automatic warn thresholds

Who: Admins · Discord permission: ManageGuild

,modconfig threshold-add <warns> <action> [duration]

At N active warnings do an action

Option	Type		What it does
`warns`	number	required	Warning count
`action`	text	required	Action (mute, kick, ban, jail)
`duration`	text	optional	e.g. 1h, 7d, perm

,modconfig threshold-remove <warns>

Remove the threshold at N warnings

Option	Type		What it does
`warns`	number	required	Warning count

,modconfig threshold-list

List thresholds

Things that are not commands

Verify button

Posted by ,verify panel. New members press it, type the code shown and confirm 18+ and the rules. Accounts younger than the minimum age (default 60 days) are rejected.

Voice room panel

Join the "Join to create" voice channel and a private room appears with buttons: lock/unlock, hide/show, user limit, rename, region, bitrate, kick, allow, block, transfer owner, claim. The room is deleted when empty.

Giveaway Enter button

Press once to enter, press again to leave. Requirements (role, account age, time in server) are checked when entering and again when the winner is drawn.

Automatic things

Warn thresholds (default 3 warns = 1 h mute, 5 warns = 7 d ban), timed bans/jail ending on schedule, link removal for non-boosters, booster role removal when boosting stops, raid lockdown, deleted/edited message logging, audit log mirroring, and data retention clean-up.

Generated from the bot's code. Terms · Privacy