TypicalBot Documentation



Name Description Aliases Usage Examples
8ball Ask the magic 8ball a question.
  • $8ball <question>
  • $8ball Am I an awesome human being?
cookie Give another user a cookie or keep them all for yourself.
  • $cookie
  • $cookie <user-mention>
  • $cookie
  • $cookie @HyperCoder
dice Roll a n-sided die.
  • die
  • $dice
  • $dice <number-of-sides>
  • $dice
  • $dice 100
hug 'Hug' another user in the server.
  • $hug <user-mention>
  • $hug
  • $hug @HyperCoder
joke Gives you a random joke.
  • $joke
  • $hug
punch 'Punch' another user in the server.
  • $punch <user-mention>
  • $punch
  • $punch @Packer
quote Gives you a random quote.
  • $quote
  • $quote
shoot 'Shoot' another user in the server.
  • $shoot <user-mention>
  • $shoot
  • $shoot @Packer
slap 'Slap' another user in the server.
  • $slap <user-mention>
  • $slap
  • $slap @Xenotater
stab 'Stab' another user in the server.
  • $stab <user-mention>
  • $stab
  • $stab @Xenotater
urban Grabs the definition from Urban Dictionary for the specified word.
  • $urban <query>
  • $urban
  • $urban pineapple
yomama Gives you a random yomama joke.
  • yomomma
  • $yomama
  • $yomomma
Name Description Aliases Usage Examples
play Streams a song to a voice channel from YouTube. $play <song name | Youtube url | Youtube playlist url | Youtube live url>
  • $play Wavin' flag
  • $play https://youtu.be/WTJSt4wP2ME
  • $play https://www.youtube.com/playlist?list=PLC1670714BCED30AF
  • $play https://youtu.be/ueupsBPNkSc
stop Stop what is currently playing. $stop
  • $stop
queue Displays a list of videos queued to stream. $queue
  • $queue
unqueue Removes a song from the server's queue. $unqueue <song title>
  • $unqueue Wavin' flag
pause Pause the song currently streaming. $pause
  • $pause
resume Resume the song paused. unpause $resume
  • $resume
volume Change the volume of the song currently streaming. vol $volume (0 - 200)
  • $volume 150
  • $volume 55
  • $volume
youtube Search for a video from YouTube. yts $youtube <query>
  • $youtube Wavin' flag
Name Description Aliases Usage Examples
bunny Gives you a random bunny picture.
  • rabbit
  • $bunny
  • $bunny
cat Gives you a random cat picture.
  • kitty
  • kitten
  • $cat
  • $cat
dog Gives you a random dog picture.
  • puppy
  • doggy
  • $dog
  • $dog
tiger Gives you a random tiger picture.
  • $tiger
  • $tiger
Usage examples with # show the permission level required to execute the sub-command.
Name Permission Description Aliases Usage Examples
adcheck 2 Check if any members of a server have a server invite in their playing status.
  • $adcheck
  • $adcheck
announce 3 Send an announcement to the announcements channel. Use the flag '-e' before your content to make the message an embed. If the announcements mention role is set, it will always use it.
  • $announce <content>
  • $announce -e <content>
  • $announce Hey everyone! We have some updates!
  • $announce -e Hey everyone! We have some updates! [This is an embed!]
ban 2 Ban a member from the server.
  • $ban <user-mention>
  • $ban <user-mention> <days-to-purge>
  • $ban <user-mention> <reason>
  • $ban <user-mention> <days-to-purge> <reason>
  • $ban <user-mention> <ban-duration>
  • $ban <user-mention> <ban-duration> <reason>
  • $ban <user-mention> <ban-duration> <days-to-purge> <reason>
  • $ban @Xenotater
  • $ban @Xenotater 2
  • $ban @Xenotater Shamelessly promoting his YouTube channel.
  • $ban @Xenotater 3 Shamelessly promoting his YouTube channel.
  • $ban @Xenotater 2h 2m 5s
  • $ban @Xenotater 3d Shamelessly promoting his YouTube channel.
  • $ban @Xenotater 2h 1s 2 Shamelessly promoting his YouTube channel.
ignore 2 Makes the bot ignore commands or invites in a channel.
  • $ignore commands
  • $ignore invites
  • $ignore commands
  • $ignore invites
kick 2 Kick a member from the server.
  • $kick <user-mention>
  • $kick <user-mention> <reason>
  • $kick @Xenotater
  • $kick @Xenotater Shamelessly promoting his YouTube channel.
purge 2 Purge messages in a channel.
  • prune
  • $purge <message-count>
  • $purge <message-count> <reason>
  • $purge <user-mention> <message-count> <reason>
  • $purge <#channel-mention> <message-count> <reason>
  • $purge <@role-mention> <message-count> <reason>
  • $purge me <message-count>
  • $purge you <message-count>
  • $purge bots <message-count>
  • $purge 50
  • $purge @Xenotater 22
  • $purge @Xenotater 27 Shamelessly promoting his YouTube channel.
  • $purge #lounge 2
  • $purge #lounge 3 Shamelessly promoting his YouTube channel.
  • $purge @Administrators 3
  • $purge @Administrators 83 Shamelessly promoting his YouTube channel.
  • $purge me 8
  • $purge me 8 Spam!
  • $purge you 82
  • $purge you 82 Bot is sending so many responses.
  • $purge bots 88
  • $purge bots 88 Too many bot messages!
reason 2 Change or set a reason for a case in moderation logs.
  • $reason latest <reason>
  • $command <case-id> <reason>
  • $purge latest Because I said so!
  • $purge 2 Because I said so!
roles 0 Manage or list the server's roles or public roles.
* IDs, mentions, and names can be used for all usages.
  • role
  • $roles help
  • $roles list
  • $roles info[rmation] <role-name|role-id|role-mention>
  • $roles info[rmation] members <role-name|role-id|role-mention>
  • $roles give <user-tag|user-id|user-mention> <role-name|role-id|role-mention> 3
  • $roles take <user-tag|user-id|user-mention> <role-name|role-id|role-mention> 3
  • $roles public list
  • $roles public add <role-name|role-id|role-mention> 3
  • $roles public remove <role-name|role-id|role-mention> 3
  • $roles public clear 3
  • $roles help
  • $roles list
  • $roles info Administrator
  • $roles info @Administrators
  • $roles info 353618292067401728
  • $roles info members Administrator
  • $roles give @Xenotater Administrators
  • $roles give Xenotater#0303 @Administrators
  • $roles give @Xenotater 353618292067401728
  • $roles take @Xenotater Administrators
  • $roles public list
  • $roles public add Administrator
  • $roles public add @Administrators
  • $roles public add 353618292067401728
  • $roles public remove Administrator
  • $roles public clear
say 2 Makes the bot send a message with the content used.
  • speak
  • $say <content>
  • $say <#channel> <content>
  • $say Help me!
  • $say <#general> Help me!
settings 0 View or customize your server's settings and enable/disable specific features.
  • set
  • $settings list
  • $settings list <page-number>
  • $settings view <setting>
  • $settings edit <setting> <value> 3
  • $settings clear
  • $settings list
  • $settings list 2
  • $settings view logs-nickname
  • $settings edit announcements <#announcements>
  • $settings edit logs-join **{user.tag}** has joined us! Yay!
  • $settings clear
softban 2 Bans and unbans a member from the server, essentially kicking them and clearing their messages.
  • $softban <user-mention>
  • $softban <user-mention> <days-to-purge>
  • $softban <user-mention> <reason>
  • $softban <user-mention> <days-to-purge> <reason>
  • $softban @Xenotater
  • $softban @Xenotater 2
  • $softban @Xenotater Shamelessly promoting his YouTube channel.
  • $softban @Xenotater 2 Shamelessly promoting his YouTube channel.
unban 2 Unban a user from the server.
  • $unban <user-id>
  • $unban <user-id> <reason>
  • $unban 187980183569956864
  • $unban 187980183569956864 Agreed to stop shamelessly promoting his YouTube channel.
unignore 2 Makes the bot unignore commands or invites in a channel.
  • $unignore commands
  • $unignore invites
  • $unignore commands
  • $unignore invites
warn 2 Warn a member in the server.
  • $warn <user-mention>
  • $warn <user-mention> <reason>
  • $warn @Xenotater
  • $warn @Xenotater Shamelessly promoting his YouTube channel.
Usage examples with # show the permission level required to execute the sub-command.
Name Aliases Usage Description
bots
  • $bots
  • $bots <page-number>
Gives a list of bots from Carbonitex sorted by server count.
discriminator
  • discrim
  • $discriminator
  • $discriminator <discriminator>
Provides a list of all users with a given discriminator.
hex
  • $hex random
  • $hex <hex-code>
Sends a preview of a hex color.
mylevel
  • $mylevel
Shows you your permission level specific to the server requested it.
nickname
  • nick
  • $nickname
  • $nickname reset
  • $nickname <desired-nickname>
  • $nickname <user-mention> 2
  • $nickname <user-mention> reset 2
  • $nickname <user-mention> <desired-nickname> 2
Change or clear either your nickname or another user's nickname.
randomuser
  • $randomuser
Selects a random member in the server.
search
  • $search <query>
  • $search <query> <page-number>
Searches in the user list for a username or nickname.
serverinfo
  • $serverinfo
Displays the server's information.
strawpoll
  • $strawpoll <question> | <choice1; choice2; choice3; ...>
  • $strawpoll -m <question> | <choice1; choice2; choice3; ...>
Create a strawpoll vote. Use the '-m' flag for multiple choice.
subscribe
  • $subscribe
Subscribe to the server's announcements.
unsubscribe
  • $unsubscribe
Unsubscribe from the server's announcements.
userinfo
  • $userinfo
  • $userinfo <user-mention|user-id|user-tag>
Displays a user's information.
Name Aliases Usage Description
commands
  • cmds
  • $commands
Receive a list of TypicalBot's commands.
documentation
  • docs
  • $documentation
Grab a link to TypicalBot's documentation.
donate
  • $donate
Donate to the cause of TypicalBot.
help
  • $help
  • $help <command-name>
Get general information about TypicalBot or help with a specific command.
information
  • info
  • $information
Get general information about TypicalBot.
invite
  • $invite
Receive the OAuth2 authorization link for TypicalBot.
ping
  • $ping
A check to see if TypicalBot is able to respond.
server
  • $server
Receive an invite to the TypicalBot Lounge.
servers
  • $servers
  • $servers <page-number>
Get a list of servers of the current shard.
stats
  • $stats
Get TypicalBot's current statistics.
Name Aliases Usage Description
logs
  • $logs
Sends a help embed in regards to logs.
perms
  • $perms
Sends a help embed in regards to permissions.
Name Description Usage Permission
roles public add Add a role to the public roles list users can use $give or $take with.
  • $roles public add <role-name|role-id|role-mention>
3
roles public remove Remove a role from the public roles list users can use $give or $take with.
  • $roles public remove <role-name|role-id|role-mention>
3
roles public clear Clear all roles from the public roles list users can use $give or $take with.
  • $roles public clear
3
roles public list List all public roles list users can use $give or $take with.
  • $roles public list
0
give Receive a role off of the public roles list.
  • $give <role-name|role-id|role-mention>
0
take Remove a role from you off of the public roles list.
  • $take <role-name|role-id|role-mention>
0
Use the settings command found under the moderation tab to change these settings.
Name Setting Description Values Examples
Embed embed Embed responses from TypicalBot.
  • disable
  • enable
  • $settings edit embed disable
  • $settings edit embed enable
Administrator Role adminrole Administrator role that will grant users with the role(s) permission level 3.
  • disable
  • <role-name|role-id|role-mention>
  • add <role-name|role-id|role-mention>
  • remove <role-name|role-id|role-mention>
  • clear
  • $settings edit adminrole Administrators
  • $settings edit adminrole add Administrators
  • $settings edit adminrole remove Administrators
  • $settings edit adminrole clear
Moderator Role modrole Moderator role that will grant users with the role(s) permission level 2.
  • disable
  • <role-name|role-id|role-mention>
  • add <role-name|role-id|role-mention>
  • remove <role-name|role-id|role-mention>
  • clear
  • $settings edit modrole Moderators
  • $settings edit modrole add Moderators
  • $settings edit modrole remove Moderators
  • $settings edit modrole clear
DJ Role djrole DJ role that will grant users with the role(s) permission level 1.
  • disable
  • <role-name|role-id|role-mention>
  • add <role-name|role-id|role-mention>
  • remove <role-name|role-id|role-mention>
  • clear
  • $settings edit djrole Dj
  • $settings edit djrole add Dj
  • $settings edit djrole remove Dj
  • $settings edit djrole clear
Blacklist Role blacklistrole Blacklist role that will deny users with the role(s) access to any TypicalBot commands.
  • disable
  • <role-name|role-id|role-mention>
  • add <role-name|role-id|role-mention>
  • remove <role-name|role-id|role-mention>
  • clear
  • $settings edit blacklistrole Bot muted
  • $settings edit blacklistrole add Bot muted
  • $settings edit blacklistrole remove Bot muted
  • $settings edit blacklistrole clear
Mute role muterole A role the the bot will give users when muted.
  • disable
  • <role-name|role-id|role-mention>
  • $settings edit muterole Silent
Automatic Role autorole A role that users will gain upon joining the server.
  • disable
  • <role-name|role-id|role-mention>
  • $settings edit autorole User
Automatic Role Delay autoroledelay The amount of time to wait before giving the auto role.
  • disable
  • default
  • <time-in-milliseconds>
  • $settings edit autoroledelay 15000
  • $settings edit autoroledelay disable
Automatic Role Silent autorolesilent If not silent, a message will be sent in the logs channel stating a user was given the autorole.
  • disable
  • enable
  • $settings edit autorolesilent enable
  • $settings edit autorolesilent disable
Subscriber Role subscriberrole A role that will be given when a user uses the subscribe command.
  • disable
  • <role-name|role-id|role-mention>
  • $settings edit subscriberrole Subscriber
Announcements Channel announcements A channel for announcements to be posted, used with the announce command.
  • disable
  • here
  • <channel-name|channel-id|channel-mention>
  • $settings edit announcements #Information
  • $settings edit announcements information
Announcements Mention announcements-mention A mention to be put in the announcement when posted, such as a Subscriber role.
  • disable
  • <role-name|role-id|role-mention>
  • $settings edit announcements-mention Subscribers
Logs Channel logs A channel for activity logs to be posted.
  • disable
  • here
  • <channel-name|channel-id|channel-mention>
  • $settings edit logs #channel
User Join Logs logs-join A custom set message to be posted when a user joins the server.
  • disable
  • default
  • enable
  • embed
  • <custom-message>
  • $settings edit logs-join Welcome {user}! I hope you enjoy your stay!
  • $settings edit logs-join embed
  • $settings edit logs-join disable
User Leave Logs logs-leave A custom set message to be posted when a user leaves the server.
  • disable
  • default
  • enable
  • embed
  • <custom-message>
  • $settings edit logs-leave Goodbye {user}!
  • $settings edit logs-leave embed
  • $settings edit logs-leave disable
User Ban Logs logs-ban A custom set message to be posted when a user is banned from the server.
  • disable
  • default
  • enable
  • embed
  • <custom-message>
  • $settings edit logs-ban {user.name} was banned :(
  • $settings edit logs-ban embed
  • $settings edit logs-ban disable
User Unban Logs logs-unban A custom set message to be posted when a user is unbanned from the server.
  • disable
  • default
  • enable
  • embed
  • <custom-message>
  • $settings edit logs-unban {user.name} is now unbanned and all is forgiven!
  • $settings edit logs-unban embed
  • $settings edit logs-unban disable
User Nickname Logs logs-nickname A custom set message to be posted when a user changes their nickname in the server.
  • disable
  • default
  • enable
  • <custom-message>
  • $settings edit logs-nickname {user.name} changed nickname | {user.oldnick} => {user.nick}
  • $settings edit logs-nickname embed
  • $settings edit logs-nickname disable
User Invite Logs logs-invite A custom set message to be posted when a user posts an invite in the server.
  • disable
  • default
  • enable
  • <custom-message>
  • $settings edit logs-invite {user.name} shared an invite in {channel.name}
  • $settings edit logs-invite embed
  • $settings edit logs-invite disable
Moderation Logs Channel modlogs A channel to send moderation logs in. Aka audit logs.
  • disable
  • here
  • <channel-name|channel-id|channel-mention>
  • $settings edit modlogs #Moderation
  • $settings edit modlogs here
  • $settings edit modlogs disable
Message Purge Moderation Logs modlogs-purge A modlog to log when a moderator or administrator purges messages in a channel.
  • disable
  • enable
  • $settings edit modlogs-purge enable
  • $settings edit modlogs-purge disable
Automatic Message automessage A message to be sent to a user when they join the server.
  • disable
  • <custom-message>
  • $settings edit automessage Hey {user.name}! Please read our rules before typing!
  • $settings edit automessage disable
Automatic Nickname autonickname A nickname to give a user when they join the server.
  • disable
  • <custom-nickname>
  • $settings edit autonickname User
  • $settings edit autonickname disable
Mode mode A mode to enable/disable a list of commands.
  • free
  • lite
  • strict
  • $settings edit mode free
  • $settings edit mode lite
  • $settings edit mode strict
Custom Prefix customprefix A custom prefix to use other than $.
  • disable
  • <custom-prefix>
  • $settings edit customprefix !
  • $settings edit customprefix ?
  • $settings edit customprefix ;
Default Prefix defaultprefix The default prefix $.
  • disable
  • enable
  • $settings edit defaultprefix enable
  • $settings edit defaultprefix disable
Anti-Invite antiinvite Server moderation tool to delete any invites sent by users in the server.
  • disable
  • enable
  • $settings edit antiinvite enable
  • $settings edit antiinvite disable
Anti-Invite Action antiinvite-action Enable warning and kicking when sending invites. AntiInvite must be enabled for this to work.
  • disable
  • enable
  • $settings edit antiinvite-action enable
  • $settings edit antiinvite-action disable
Anti-Invite Warn antiinvite-warn Server moderation tool to warn users that post invites in the server.
  • disable|0
  • 1-10
  • $settings edit antiinvite-warn disable
  • $settings edit antiinvite-warn 2
  • $settings edit antiinvite-warn 5
Anti-Invite Kick antiinvite-kick Server moderation tool to kick users that post invites in the server. Note that this cannot be less than the antiinvite-warn setting.
  • disable|0
  • 1-10
  • $settings edit antiinvite-kick disable
  • $settings edit antiinvite-kick 4
  • $settings edit antiinvite-kick 7
Disable Nickname Command nonickname A way to disable the nickname command from being used.
  • disable
  • enable
  • $settings edit nonickname enable
  • $settings edit nonickname disable
Music Default Permissions music-permissions Change the required permission level for users to use all music commands.
  • all
  • dj
  • moderator
  • administrator
  • $settings edit music-permissions all
  • $settings edit music-permissions moderator
Music play Permissions music-play Change the required permission level for users to use the `play` music command. Unless set to `off`, this overwrites the `music-permissions` setting.
  • off
  • all
  • dj
  • moderator
  • administrator
  • $settings edit music-play moderator
  • $settings edit music-play dj
Music Skip Permissions music-skip Change the required permission level for users to use the `skip` music command. Unless set to `off`, this overwrites the `music-permissions` setting.
  • off
  • all
  • dj
  • moderator
  • administrator
  • $settings edit music-skip dj
  • $settings edit music-skip administrator
Music Pause Permissions music-pause Change the required permission level for users to use the `pause` music command. Unless set to `off`, this overwrites the `music-permissions` setting.
  • off
  • all
  • dj
  • moderator
  • administrator
  • $settings edit music-pause off
  • $settings edit music-pause administrator
Music Resume Permissions music-resume Change the required permission level for users to use the `resume` music command. Unless set to `off`, this overwrites the `music-permissions` setting.
  • off
  • all
  • dj
  • moderator
  • administrator
  • $settings edit music-resume off
  • $settings edit music-resume administrator
Music Unqueue Permissions music-unqueue Change the required permission level for users to use the `unqueue` music command. Unless set to `off`, this overwrites the `music-permissions` setting.
  • off
  • all
  • dj
  • moderator
  • administrator
  • $settings edit music-unqueue dj
  • $settings edit music-unqueue moderator
Music Volume Permissions music-volume Change the required permission level for users to use the `volume` music command. Unless set to `off`, this overwrites the `music-permissions` setting.
  • off
  • all
  • dj
  • moderator
  • administrator
  • $settings edit music-volume all
  • $settings edit music-volume dj
  • $settings edit music-volume off
Music Time limit music-timelimit Change the maximum time limit for a video. Set in seconds. Minimum is 120 seconds (2 minutes). Maximum is 600 seconds (10 minutes). TypicalBot Prime Member maximum is 7200 seconds (2 hours).
  • $settings edit music-timelimit 320
  • $settings edit music-timelimit default
Music Queue limit music-queuelimit Change the maximum queue limit for a video. Maximum is 10 videos. TypicalBot Prime Member maximum is 100 videos.
  • $settings edit music-queuelimit 10
  • $settings edit music-queuelimit default