Command List

User Commands

Commands under this category are able to be used by any member of your guild that is not flagged as revoked. In some instances, commands may be locked to specific channels depending on your guilds configuration of CatBot.

General User

addrole

Assigns the role to you if it exists and is self assignable.

**Examples**
addrole <role>
addrole Member

Aliases: addrole, iam, sar
                    

bio

Show someones bio or sets your personal bio for people to see.

**Examples**
bio @user
bio This is a test bio.

Aliases: bio, biography
                    

delrole

Removes specified self assignable role from you.

**Examples**
delrole <role>
delrole Member

Aliases: delrole, iamnot
                    

help

Provides a list of commands or information about a specific command.

**Examples**
help
help <command>
help bio

Aliases: help, h
                    

hotlines

Displays a list of useful hotline information and resources for those in despair.

**Examples**
hotlines

Aliases: hotlines
                    

invite

Shows the current invite link for the server.

**Examples**
invite

Aliases: invite, inv
                    

joined

Shows when a user joined the server. If no user is specified, the invoker is used.

**Examples**
joined
joined @user

Aliases: joined
                    

roles

Provides a list of roles for yourself or another user

**Examples**
roles @user
roles

Aliases: roles
                    

rolesummary

Shows a summary view of a provided role

**Examples**
rolesummary <rolename>
rolesummary Member

Aliases: rolesummary
                    

rules

Shows the server rules, if the server has a set value.

**Examples**
rules

Aliases: rules
                    

serverinfo

Gives information about the server.

**Examples**
serverinfo

Aliases: serverinfo, sinfo, ginfo, guildinfo
                    

staffalert

Notify staff with the message you specified.

**Examples**
staffalert <message>
staffalert MAYDAY MAYDAY MAYDAY! I'M OUT OF CUPCAKES!

Aliases: staffalert, callmod, callstaff, staffcall, alertstaff
                    

whois

Gives information about the requested user. If no user is mentioned, the invoker will be used.

**Examples**
whois
whois @user

Aliases: whois, userinfo, uinfo
                    

Other

8ball

Ask and get an 8ball answer

**Examples**
8ball [question]
8ball Will it rain today?

Aliases: 8ball, 8b
                    

choose

Give the bot a list of options and one will be chosen.

**Examples**
choose <option1|option2>
choose Pepperoni|Cheese
choose Left|Center|Right

Aliases: choose
                    

cuddle

Cuddles the specified person

**Examples**
cuddle @user

Aliases: cuddle
                    

giphy

Fetches the first SFW gif from Giphy for the provided search term. If the channel is an NSFW channel, search will be for rated R.

**Examples**
giphy <searchterm>
giphy hug

Aliases: giphy, gif
                    

high5

High5 the specified person

**Examples**
highfive @user

Aliases: high5, h5, highfive
                    

hug

Hugs the specified person

Aliases: hug
                    

kiss

Kisses the specified person

**Examples**
kiss @user

Aliases: kiss
                    

lewd

Announces someone is lewd

**Examples**
lewd @user

Aliases: lewd
                    

mouser

Searches Mouser.com for the keyword specified. Only the first 10 results are provided.

**Examples**
mouser <keyword>
mouser 47uf 10v electrolyte

Aliases: mouser
                    

nom

Noms the specified person

**Examples**
nom @user

Aliases: nom
                    

nyan

NYAN!

**Examples**
nyan

Aliases: nyan
                    

pat

Pats the specified person.

**Examples**
pat @user

Aliases: pat
                    

ping

Gives the latency of the Bot to the Discord API.

**Examples**
ping

Aliases: ping
                    

poke

Pokes the specified person

**Examples**
poke @user

Aliases: poke
                    

roll

Generate a random roll between two numbers.

**Examples**
roll <lower> <upper>
roll 1 50
roll 1000
roll

Aliases: roll
                    

slap

Slaps the specified person

**Examples**
slap @user

Aliases: slap
                    

stare

Stares at the specified

**Examples**
stare @user

Aliases: stare
                    

tenor

Fetches the first SFW gif from Tenor for the provided search term. If the channel is an NSFW channel, search will be for rated R.

**Examples**
tenor <searchterm>
tenor hug

Aliases: tenor
                    

tickle

Tickles the specified person

**Examples**
tickle @user

Aliases: tickle
                    

xdy

Rolls x number of d sided dice, then factors in a modifier.

**Examples**
xdy d6
xdy 1d20
xdy 1d20+3
xdy 1d10/2
1d10*2
1d6/2+3

Aliases: xdy
                    

User Registration

register

Registers a user with the provided roles. Does not work if user is already a member. If any role contains spaces, wrap all roles in []

**Examples**
register <roles>
register role1 role2 role3
register [role 1] [role 2] [role 3]

Aliases: register
                    

rolelist

Gives you a list of all self-asisgnable roles.

**Examples**
rolelist
rolelist <category>


Aliases: rolelist, getlist, sars, lsar, sarlist
                    

Staff Commands

Commands under this category are able to be used by any member of your guild that has the staff role. Guild owners can specify this role with the "role" command. Staff have no restrictions on which channel they can use these commands in. In general, all members of staff can alter configurations of CatBot.

General Staff

channel

Allows you to configure or reset the various channels the bot uses for certain actions.

**Examples**
channel
channel <actionname to reset>
channel <actionname> #channel
channel punishlogs
channel punishmentlogs #punishmentlogs

Aliases: channel
                    

channeltrigger

Adds or removes commands to a trigger list. When users say one of these words, staff is notified privately.

**Examples**
channeltrigger <word>
channeltrigger chopper

Aliases: channeltrigger, ct
                    

disablecommand

Disables a command for general users of this guild.

**Examples**
disablecommand <cmd>
disablecommand hug

Aliases: disablecommand, dc
                    

gifsupport

Enables or disables gif support for various commands on the server. 

**Examples**
gifsupport


Aliases: gifsupport
                    

hotlinesmsg

Sets the hotlines message.

**Examples**
hotlinesmsg <message>
hotlinesmsg Call 18001234567

Aliases: hotlinesmsg, hotlinesmessage, hmsg, sethotlinesmsg
                    

leavemsg

Sets the user leave message.

**Examples**
leavemsg <message>
leavemsg {user} has left the server.

Aliases: leavemsg, leavemessage, lmsg, setleavemsg
                    

limitcommand

Lists channels a command is limited too.

**Examples**
limitcommand <command>
limitcommand sys

Aliases: limitcommand, commandlimit
                    

message

Messages the channel specified.

**Examples**
message <channel> <message>
message #entry I am so not a bot!

Aliases: message, msg
                    

messagethreshold

Sets the message threshold for new users on the server. After 24 hours, and the user sending the threshold amount of messages, the New User role will be lifted. Set to 0 to have no message limit. Leave the limit blank to see current threshold.

**Examples**
messagethreshold <# of msgs>
messagethreshold 50
messagethreshold

Aliases: messagethreshold, mt
                    

moderationrules

Sets the moderation rules link if a value is provided, or returns the current link.

**Examples**
moderationrules
moderationrules <url>
moderationrules http://google.com/

Aliases: moderationrules
                    

newusermessage

Sets the message that is private messaged to new users when they become full-time members.

**Examples**
newusermessage <message>
newusermessage Welcome to {server}, {user}! You have fulfilled all required obligations!

Aliases: newusermessage, num
                    

prefix

Displays or sets the prefix of the bot for this server.

**Examples**
prefix
prefix <newprefix>
prefix !

Aliases: prefix
                    

privmessage

Messages the user specified.

**Examples**
privmessage @user <message>
privmessage @Lash#1234 BOO!

Aliases: privmessage, privmsg, privatemessage, privatemsg
                    

purge

Purges some amount of messages from the channel. The bot can only go back 2 weeks.

**Examples**
purge <# of messages to delete>
purge 20

Aliases: purge, prune
                    

raid

Toggles server raid mode. When the server is in raid mode, the register command will not work.

**Examples**
raid

Aliases: raid, raidmode
                    
Sets the rule link, which is displayed on successful registration.

**Examples**
ruleslink <url>
ruleslink http://google.com/

Aliases: ruleslink
                    

staffhelp

Provides a list of staff commands or information about a specific staff command.

**Examples**
staffhelp
staffhelp <command>
staffhelp kick

Aliases: staffhelp, sh, shelp
                    

sys

Provides statistics about the bot.

**Examples**
sys

Aliases: sys, info
                    

togglechanneltrigger

Toggles if a message will be deleted or not when a channel trigger is spotted by a users message. If the message gets deleted, the user will be notified with the offending message and the words that triggered.

**Examples
togglechanneltrigger

Aliases: togglechanneltrigger, tct
                    

toggleleave

Toggles if leave announcements are in or out of embeds.

**Examples**
toggleleave

Aliases: toggleleave, togglel, tl
                    

togglewelcome

Toggles if welcome announcements are in or out of embeds.

**Examples**
togglewelcome

Aliases: togglewelcome, togglew, tw
                    

welcomemsg

Sets the welcome message for new users who join the server.

**Examples**
welcomemsg <message>
welcomemsg Welcome to {server}, {user}!

Aliases: welcomemsg, welcomemessage, wmsg, setwelcomemsg
                    

Role Management

addroleblocker

Adds blockers between the two role names provided. If a role contains spaces, please wrap both roles with [].

**Examples**
addroleblocker <role1> <role2>
addroleblocker Member Newbie
addroleblocker [Member Role] [Newbie Role]

Aliases: addroleblocker, addrb, roleblocker
                    

addrolecategory

Adds a role category to the server. Syntax: addrolecategory [category] [required true/false]

**Examples**
addrolecategory <category> <true/false>
addrolecategory General true
addrolecategory [General Roles] [true]

Aliases: addrolecategory
                    

addsar

Adds a role to the self assignable role list. If you wish to leave the role uncategorized, use 0 as for the category name. If you wish to prevent users from removing this role once added, add false to the end. In case either the name or category has spaces, please use [] around all values.

**Examples**
addsar <role> <category> <(optional) userremovable = true/false>
addsar Member General
addsar [Member Role] [General]
addsar Member General false
addsar [Member Role] [General] [false]

Aliases: addsar, asar
                    

delrolecategory

Removes a role category from the server. Defaults any role currently assigned to this category to 'null'

**Examples**
delrolecategory <category>
delrolecategory General

Aliases: delrolecategory, rmrolecategory, rmrc
                    

regblocklist

Shows, adds, or removes the blocklist word from the current registration blacklist. Words appearing here will ban the user if used in Register.

**Examples**
regblocklist
regblocklist <word>

Aliases: regblocklist, registerblocklist, rbl
                    

removeroleblocker

Removes both roles from blocking each other. Please wrap each role with [] so that I can fully understand the roles.

**Examples**
removeroleblocker <role1> <role2>
removeroleblocker Member Newbie
removeroleblocker [Members Role] [Newbie Role]

Aliases: removeroleblocker, rmroleblocker, rmrb, delroleblocker
                    

rmsar

Removes a role from being self-assignable.

**Examples**
rmsar <role>
rmsar Member

Aliases: rmsar, rsar, delsar
                    

role

Allows you to configure or reset the various roles the bot uses for certain actions.

**Examples**
role
role <section to reset>
role <section> <rolename>
role defaultrole
role defaultrole Member

Aliases: role
                    

rolelistmsg

Sets the message that appears at the bottom of rolelist.

**Examples**
rolelistmsg <message>
rolelistmsg Please message us for assistance.

Aliases: rolelistmsg, rlm
                    

Server Owner

reconcileserver

Reconciles ban log and cases log for any missing entries

Aliases: reconcileserver
                    

reconcileusers

Reconciles users to build a proper user profile in the database

Aliases: reconcileusers
                    

webcolor

Specifies the color of the guild base theme on the CatBot Dashboard

Aliases: webcolor
                    

User Management

ban

Bans a user

**Examples**
ban @user <optional reason>

Aliases: ban
                    

botrevoke

Revokes or restores user access to all bot commands.

**Examples**
revoke @user

Aliases: botrevoke
                    

cases

Lists all cases a user currently has.

**Examples**
cases @user

Aliases: cases, listcases
                    

changenickname

Changes the users nickname.

**Examples**
privmessage @user <message>
privmessage @Lash#1234 BOO!

Aliases: changenickname, cn
                    

channelrevoke

Removes or restores access to a channel for the specified user.

**Examples**
channelrevoke @user #channel
role @Lash#1234 #random

Aliases: channelrevoke
                    

heynow

Issues a heynow to a user.

**Examples**
heynow @user <optional reason>
hey @Lash#1234 Play nice in the sandbox

Aliases: heynow
                    

kick

Kicks a user

**Examples**
kick @user <optional reason>

Aliases: kick
                    

pardon

Pardons a user and removes all their cases.

**Examples**
pardon @user

Aliases: pardon
                    

reason

Updates the reason on a case. If the case is marked as unknown, it flags with your credentials.

**Examples**
reason <case #> <reason>
reason 5 Violation of the roles.

Aliases: reason
                    

rmallwarn

Removes all Warnings for the specified user.

**Examples**
rmallwarn @user

Aliases: rmallwarn, removeallwarnings, rmallwarnings, rmwarns
                    

rmwarn

Removes a specific warning by user and warning number.

**Examples**
rmwarn @user <warning #>
rmwarn @Cat#1234 2

Aliases: rmwarn, removewarning, rmwarning
                    

suspect

Marks a user as suspect or not. Users who are suspected will have their chat logs posted to the servers suspect channel.

**Examples**
suspect @user

Aliases: suspect
                    

timeout

Puts a user in timeout and applys the timeout role. If "true" is specified at the end of the command, no roles are lifted. When lifted, roles are restored..

**Examples**
timeout @user
timeout @user <striproles (true/false)>
timeout @Lash#1234
timeout @Lash#1234 true

Aliases: timeout
                    

warn

Issues a warning to a user.

**Examples**
warn @user <optional reason>
warn @Lash#1234 Violation of the Rules

Aliases: warn, warning
                    

whowas

Gives information about who the requested user was.

**Examples**
whowas <username>
whowas <nickname>
whowas <userid>

Aliases: whowas