title: Command Documentation description: Documentation for all of Roxbot’s commands. authors:
- Roxanne Gibson
If you intend to use any commands requiring permissions, it is highly recommend you read the Configuring Roxbot guide that will get you up to date with how Roxbot works and how to run her.
An alias is just another way of executing the command. Usually to shorten the command to be easier to type. If emoji
is an alias of emote
, using either emoji
or emote
will execute emote
.
When the command wants a CHANNEL, USER, MEMBER, or ROLE. This means the ID, name, or mention of that part of Discord. Role, User, and Member mentions start with a ‘@’ and Channel mentions start with a ‘#’. A Member is the same as a User except a Member is explicitly a User in a Guild.
These are the base commands for Roxbot that are a part of the core bot. All of them deal with internal management and are, for the most part, unavailable to average users.
Outputs info about RoxBot, showing up time, how to report issues, contents of roxbot.conf and credits.
Command Structure:
;about
!!! warning “Required Permissions”
This command can only be executed by the owner of the Roxbot instance.
Creates a backup of all server’s settings manually. This will make a folder in settings/backups/
. The name of the folder will be outputted when you use the command. Using only this and not the automatic backups is not recommend.
Command Structure:
;backup
Manage the global blacklist for Roxbot.
!!! warning “Required Permissions”
This command can only be executed by the owner of the Roxbot instance.
Command Structure:
;blacklist option *users
Options:
option
- This is whether to add or subtract users from the blacklist. +
or add
for add and -
or remove
for remove.
users
- A name, ID, or mention of a user. This allows multiple users to be mentioned.
Examples:
# Add three users to the blacklist
;blacklist add @ProblemUser1 ProblemUser2#4742 1239274620373
# Remove one user from the blacklist
;blacklist - @GoodUser
Changes the activity that Roxbot is doing. This will be added as a game. “none” can be passed to remove an activity from Roxbot.
!!! warning “Required Permissions”
This command can only be executed by the owner of the Roxbot instance.
Command Structure:
;changeactivity text
Aliases:
activity
Options:
text
- Either text to be added as the “game” or none to remove the activity.Examples:
# Change activity to "with the command line" so that it displays "Playing with the command line"
;activity "with the command line"
# Stop displaying any activity
;activity none
Changes the avatar of the bot account. This cannot be a gif due to Discord limitations.
!!! warning “Required Permissions”
This command can only be executed by the owner of the Roxbot instance.
Command Structure:
;changeavatar image
Aliases:
setavatar
Options:
image
- This can either be uploaded as an attachment or linked after the command.Example:
# Change avatar to linked image
;changeavatar https://i.imgur.com/yhRVl9e.png
Changes the nickname of Roxbot in the guild this command is executed in.
!!! warning
This command cannot be used in private messages.
!!! warning “Required Permissions”
This command can only be executed by the owner of the Roxbot instance.
Command Structure:
;changenickname name
Aliases:
nickname
, nick
Options:
name
- OPTIONAL: If not given, Roxbot’s nickname will be reset.Example:
# Make Roxbot's nickname "Best Bot 2k18"
;nick Best Bot 2k18
# Reset Roxbot's nickname
;nick
!!! warning “Required Permissions”
This command can only be executed by the owner of the Roxbot instance.
Changes the status of the bot account.
Command Structure:
;changestatus status
Aliases:
status
Options:
status
- There are four different options to choose. online
, away
, dnd
(do not disturb), and offline
Examples:
# Set Roxbot to offline
;changestatus offline
# Set Roxbot to online
;changestatus online
Echos the given string to a given channel.
!!! warning “Required Permissions”
This command can only be executed by the owner of the Roxbot instance.
Command Structure:
;echo channel message
Example:
# Post the message "Hello World" to the channel #general
;echo #general Hello World
Displays all commands you can execute in that channel. If a command is specified, it will show the help for that command.
Command Structure:
;help [command: optional]
Options:
command
- OPTIONAL: If a command is specified, it will show the help for that command. If this is a command group, it will show the commands in that group and some help. If a subcommand in a group, then the help for that command.Examples:
# List all commands I can execute in this current channel
;help
# Show help for the "subreddit" command
;help subreddit
# Show help for the "custom" command group
;help custom
# Show help for the "custom add" subcommand
;help custom add
Posts this invite. This allows you to invite Roxbot to your own server.
Command Structure:
;invite
Prints settings for the cogs in this guild.
!!! warning “Required Permissions”
Command requires the user to have the `manage_guild` permission.
!!! warning
This command cannot be used in private messages.
Command Structure:
;printsettings [cog: optional]
Aliases:
printsettingsraw
- Using this will print the raw version of these files.
Options:
Examples:
# Print the settings for the guild
;printsettings
# print settings just for the Admin cog.
;printsettings Admin
!!! warning “Required Permissions”
This command can only be executed by the owner of the Roxbot instance.
Shutdowns the bot.
Command Structure:
;shutdown
Cog commands are all of the commands that aren’t in the Core Roxbot code. This is anything that sits in the cogs/
folder;
The Admin cog adds admin commands to Roxbot which should make moderating a Discord server easier.
!!! warning
This whole cog cannot be used in private messages.
Bans the mentioned user with the ability to give a reason.
!!! warning “Required Permissions”
Command requires the user **and** Roxbot to have the `ban_users` permission.
Command Structure:
;ban USER [reason: optional]
Options:
USER
- A name, ID, or mention of a user.
reason
- OPTIONAL. A short reason for the banning.
Examples:
# Ban user BadUser
;ban @BadUser
# Ban user Roxbot for being a meanie
;ban Roxbot "for being a meanie"
Kicks the mentioned user with the ability to give a reason.
!!! warning “Required Permissions”
Command requires the user **and** Roxbot to have the `kick_users` permission.
Command Structure:
;kick USER [reason: optional]
Options:
USER
- A name, ID, or mention of a user.
reason
- OPTIONAL. A short reason for the kicking.
Examples:
# Kick user BadUser
;kick @BadUser
# Kick user Roxbot for being a meanie
;kick Roxbot "for being a meanie"
Purges the text channel the command is executed in. You can specify a certain user to purge as well.
!!! warning “Required Permissions”
Command requires the user **and** Roxbot to have the `manage_messages` permission.
Command Structure:
;purge limit [USER: optional]
Options:
limit
- This the the amount of messages Roxbot will take from the chat and purge. Note: This does not mean the amount that will be purged. Limit is the amount of messages Roxbot will look at. If a user is given, it will only delete messages from that user in that list of messages.
USER
- A name, ID, or mention of a user. If the user has left the guild, this has to be the ID.
Examples:
# Delete 20 messages from the chat
;purge 20
# Take 20 messages, and delete any message in it by user @Spammer
;purge 20 @Spammer
Puts the channel in slowmode. Users with manage_channel
or manage_messages
permissions will not be effected.
!!! warning “Required Permissions”
Command requires the user **and** Roxbot to have the `manage_channels` permission.
Command Structure:
;slowmode seconds
Options:
seconds
- Has to be between 0 - 120. This will set the timeout a user receives once they send a message in this channel. If 0, Roxbot will disable slowmode.Examples:
# Set slowmode to 30 seconds
;slowmode 30
# Turn slowmode off
;slowmode 0
Unbans the mentioned user with the ability to give a reason.
!!! warning “Required Permissions”
Command requires the user **and** Roxbot to have the `ban_users` permission.
Command Structure:
;unban user_id [reason: optional]
Options:
user_id
- The ID of a banned user.
reason
- OPTIONAL. A short reason for the unbanning.
Examples:
# Unban user with ID 478294672394
;unban 478294672394
!!! warning “Required Permissions”
Group requires the user to have the `kick_users` permission. <small>The logic here is that if a mod can kick a user, they can warn a user too as they are similar in function.</small>
The warn command group allows Discord moderators to warn users and log them within the bot. The command group also supports setting limits to warn mods if a user has been warned over a certain threshold.
Adds a warning to a user.
Command Structure:
;warn add USER [warning: optional]
Options:
USER
- A name, ID, or mention of a user.
warning
- OPTIONAL. A reason for the warning. This supports markdown formatting.
Example:
# Add warning to user @Roxbot for being a meanie
;warn add @Roxbot "for being a meanie"
Lists all warning in this guild or all the warnings for one user.
Command Structure:
;warn list [USER: optional]
Options:
USER
- OPTIONAL. A name, ID, or mention of a user.Examples:
# List all warnings in the guild
;warn list
# List all warnings for @Roxbot
;warn list @Roxbot
Prunes the warnings of any banned users. You can add a 1 at the end to dryrun the command. This will show you how many would be deleted without deleting them.
Command Structure:
;warn prune [dryrun: optional]
Options:
dryrun
- Add 1
to the end of the command to do a dryrun of the prune command.Examples:
# Prune the warnings of banned users in this guild
;warn prune
# Dryrun the prune command to see how many warnings would be removed
;warn prune 1
Removes one or all of the warnings for a user.
Command Structure:
;warn remove USER [index: optional]
Options:
USER
- A name, ID, or mention of a user.
index
- OPTIONAL. The index of the single warning you want to remove.
Examples:
# Remove all warnings for Roxbot
;warn remove Roxbot
# Remove warning 2 for Roxbot
;warn remove Roxbot 2
Sets the limit for how many warnings a user can get before mod’s are notified. If 3 is set, on the third warning, mods will be DM’d. If this is set to 0, DM’s will be disabled.
Command Structure:
;warn set_limit number
Aliases:
sl
, setlimit
Options:
number
- A positive integer. Once this number is equal to the number of warnings a user has, the mod who did the latest warning will be dm’d about it. If it is set to 0, this is disabled.Examples:
# Set the warning limit to 3
;warn sl 3
# Disable warnings
;warn set_limit 0
The Custom Commands cog allows moderators to add custom commands for their Discord server to Roxbot. Allowing custom outputs predefined by the moderators.
For example, we can set a command to require a prefix and call it “roxbot” and configure an output. Then if a user does ;roxbot
roxbot will output the configured output.
This command group handle settings for the custom commands.
!!! warning
This command group cannot be used in private messages.
Add a custom command.
!!! warning “Required Permissions”
Command requires the user to have the `manage_messages` permission.
Command Structure:
;custom add type name *output
Aliases:
cc
Options:
type
- There are three types of custom commands.
no_prefix
/0
- These are custom commands that will trigger without a prefix. Example: a command named test
will trigger when a user says test
in chat.prefix
/1
- These are custom commands that will trigger with a prefix. Example: a command named test
will trigger when a user says ;test
in chat.embed
/2
- These are prefix commands that will output a rich embed. You can find out more about rich embeds from Discord’s API documentation. Embed types currently support these fields: title, description, colour, color, url, footer, image, thumbnail
name
- The name of the command. No commands can have the same name.output
- The output of the command. The way you input this is determined by the type.no_prefix
and prefix
types support single outputs and also listing multiple outputs. When the latter is chosen, the output will be a random choice of the multiple outputs.
Examples:
# Add a no_prefix command called "test" with a URL output.
;cc add no_prefix test "https://www.youtube.com/watch?v=vJZp6awlL58"
# Add a prefix command called test2 with a randomised output between "the person above me is annoying" and "the person above me is cool :sunglasses:"
;cc add prefix test2 "the person above me is annoying" "the person above me is cool :sunglasses:
# Add an embed command called test3 with a title of "Title" and a description that is a markdown hyperlink to a youtube video, and the colour #deadbf
;cc add embed test3 title "Title" description "[Click here for a rad video](https://www.youtube.com/watch?v=dQw4w9WgXcQ)" colour #deadbf
!!! note
With custom commands, it is important to remember that "" is used to pass any text with spaces as one argument. If the output you want requires the use of these characters, surround your output with """this""" instead.
Edits an already existing custom command.
!!! note
You cannot change the type of a command. If you want to change the type, remove the command and re-add it.
!!! warning “Required Permissions”
Command requires the user to have the `manage_messages` permission.
Command Structure:
;custom edit command_name new_output
Example:
For more examples of how to setup a custom command, look at the help for the ;custom add command.
# edit a command called test to output "new output"
;cc edit test "new output"
Lists all custom commands for this guild.
Command Structure:
;custom list
Removed the named custom command.
!!! warning “Required Permissions”
Command requires the user to have the `manage_messages` permission.
Command Structure:
;custom remove command
Example:
# Remove custom command called "test"
;cc remove test
The Fun cog provides many commands just meant to be fun. Full of a lot of misc commands as well that might provide a few laughs or be entertaining.
Converts text to be more aesthetic fix-width text
Command Structure:
;aesthetics text
Aliases:
ae
, aesthetic
Example:
# Convert "Hello World" to fixed-width text.
;ae Hello World
Flips a magical digital coin!
Command Structure:
;coinfilp
Aliases:
cf
RETURNS FROG TIPS FOR HOW TO OPERATE YOUR FROG
Command Structure:
;frogtips
Aliases:
ft
, frog
Gives headpats to the mentioned user :3
Command Structure:
;hug USER
Options:
USER
- A name, ID, or mention of a user.Examples:
# Two ways to give Roxbot hugs.
;hug @Roxbot#4170
;hug Roxbot
Returns a fact for the positive integer given. A random number is chosen if none is given.
Command Structure:
;numberfact postive_integer
Aliases:
nf
Example:
# Random fact for the number 35
;nf 35
Returns a random fact of something that happened today!
Command Structure:
;onthisday
Aliases:
otd
Gives headpats to the mentioned user :3
Command Structure:
;pet USER
Aliases:
headpat
, pat
Options:
USER
- A name, ID, or mention of a user.Examples:
# Two ways to give Roxbot headpats.
;pet @Roxbot#4170
;pet Roxbot
Rolls a die using dice expression format. Spaces in the expression are ignored.
Command structure:
;roll expression
Aliases:
die
, dice
!!! example “Examples”
Roll one d10 two times
![Output](assets/images/outputs/roll1.png)
Roll two d20s and takes the highest value, then adds 7
![Output](assets/images/outputs/roll2.png)
An expression can consist of many sub expressions added together and then a multiplier at the end to indicate how many times the expression should be rolled.
Sub expressions can be of many types:
[number]
- add this number to the totald[sides]
- roll a dice with that many sides and add it to the total[n]d[sides]
- roll n dice. each of those dice have [sides] number of sides, sum all the dice and add to the total
add r[number]
- reroll any rolls below [number]add h[number]
- only sum the [number] highest rolls rather than all of themadd l[number]
- only sum the [number] lowest rolls rather than all of themx[number]
- only use at the end. roll the rest of the expression [number] times(max 10)Credit: TBTerra#5677
Returns a random fact about Roxbot! Roxbot has her own lore that you can discover through out these facts. Written especially for Roxbot.
Command Structure:
;roxbotfact
Aliases:
rf
, roxfact
Spanks the mentioned user :wink:
!!! warning
This command will only work in channels marked NSFW or DMs.
Command Structure:
;spank USER
Options:
USER
- A name, ID, or mention of a user.Examples:
# Two ways to give Roxbot spanks.
;spank @Roxbot#4170
;spank Roxbot
Sucks the mentioned user :wink:
!!! warning
This command will only work in channels marked NSFW or DMs.
Command Structure:
;suck USER
Aliases:
succ
Options:
USER
- A name, ID, or mention of a user.Examples:
# Two ways to give Roxbot the succ.
;suck @Roxbot#4170
;suck Roxbot
Rates the mentioned waifu(s). By using the aliases husbandorate or spousurate, it will change how Roxbot addresses those who she has rated. This may allow multiple people to be rated at once :eyes:
Command Structure:
;waifurate
Aliases:
Waifu Aliases:
wf
, wr
Husbando Aliases:
husbandorate
, hr
Spousu Aliases:
spousurate
, sr
Options:
USER
- A name, ID, or mention of a user.Example:
# Rate user#9999
;waifurate @user#9999
!!! quote “”
This command is dedicated to Hannah, who came up with the command. I hope she's out there getting her waifus rated in peace.
Grabs the image & metadata of the given xkcd comic. The query can be a comic number, comic title, or latest to get the latest. If not given, Roxbot will return a random comic.
Command Structure:
;xkcd [query: optional]
Examples:
# Get random comic
;xkcd
# Get comic number 666
;xkcd 666
# Get comic with the title "Silent Hammer"
;xkcd "Silent Hammer"
# Get latest comic
;xkcd latest
Sends text to the nether and returns it back to you ̭҉̭̭ͭi̭͎̭ṋ̭̀҈̭̭̋ ̭͉̭z̭̩̭a̭̭̽ḽ̦̭g̭̞̭o̭̤̭ ̭̭͑f̭̻̭o̭̭͢r̭̭̀m̭̭ͮ
Command Structure:
;zalgo text
Aliases:
za
Example:
# Convert "Hello World" to zalgo.
;zalgo Hello World
The ImageEditor cog is a cog with multiple commands to manipulate images provided by the user.
Deepfrys the given image
Command structure:
;deepfry image
Aliases:
df
Args:
image: Optional
;pride
is a command group for multiple pride flag filters. Available pride filters are: LGBT, Bisexual, Asexual, Pansexual, Transgender, Non Binary, Agender, Gender Queer, Gender Fluid.
Command structure:
;pride subcommand image
Args:
subcommand: One of the following: lgbt, bisexual, asexual, pansexual, transgender, nonbinary, agender, genderqueer, genderfuild.
image: Optional
!!! note
If you want there to be more pride flag filters or feel there are some missing, don't be afraid to [submit an issue to the Github repo!](https://github.com/Roxxers/roxbot/issues/new)
Command structure:
;pride agender image
Command structure:
;pride asexual image
Aliases:
ace
Command structure:
;pride bisexual image
Aliases:
bi
Command structure:
;pride genderfluid image
Aliases:
gf
Command structure:
;pride genderqueer image
Aliases:
gq
Command structure:
;pride lgbt image
Command structure:
;pride nonbinary image
Aliases:
nb
, enby
Command structure:
;pride transgender image
Aliases:
trans
JoinLeave is a cog that allows you to create custom welcome and goodbye messages for your Discord server.
!!! warning
This whole cog cannot be used in private messages.
Edits settings for the goodbye messages.
!!! warning “Required Permissions”
Command requires the user to have the `manage_messages` permission.
Command Structure
;goodbyes option [changes: optional]
Options
enable/disable
- Enable/disables goodbye messages.channel
- Sets the channel for the message to be posted in. If no channel is provided, it will default to the channel the command is executed in.Example:
# Enable goodbye messages, set the channel one called `#logs` using a channel mention.
;goodbyes enable
;goodbyes channel #logs
Edits settings for the welcome messages
!!! warning “Required Permissions”
Command requires the user to have the `manage_messages` permission.
Command Structure:
;greets option [changes: optional]
Options:
enable/disable
- Enable/disables greet messages.channel
- Sets the channel for the message to be posted in. If no channel is provided, it will default to the channel the command is executed in.message
- Specifies a custom message for the greet messages.Example:
# Enable greet messages, set the channel to the current one, and set a custom message to be appended.
;greets enable
;greets message "Be sure to read the rules and say hi! :wave:"
;greets channel # if no channel is provided, it will default to the channel the command is executed in.
The NSFW cog is a collection of commands that post images from popular NSFW sites.
Posts a random image from e621 using the tags you provide. Tags can be anything you would use to search the site normally like author and ratings.
!!! warning
This command will only work in channels marked NSFW or DMs.
Command Structure:
;e621 [*tags: optional]
Examples:
# Post a random image
;e621
# Post a random image with the tag "test"
;e621 test
Posts a random image from gelbooru using the tags you provide. Tags can be anything you would use to search the site normally like author and ratings.
!!! warning
This command will only work in channels marked NSFW or DMs.
Command Structure:
;gelbooru [*tags: optional]
Examples:
# Post a random image
;gelbooru
# Post a random image with the tag "test"
;gelbooru test
Posts a random image from rule34.xxx using the tags you provide. Tags can be anything you would use to search the site normally like author and ratings.
!!! warning
This command will only work in channels marked NSFW or DMs.
Command Structure:
;rule34 [*tags: optional]
Examples:
# Post a random image
;rule34
# Post a random image with the tag "test"
;rule34 test
Edits settings for the nsfw cog and other nsfw commands.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission.
!!! warning
This command cannot be used in private messages.
Options:
`enable/disable`: Enable/disables nsfw commands.
`addbadtag/removebadtag`: Add/Removes blacklisted tags so that you can avoid em with the commands.
Example:
# Enabled NSFW commands
;nsfw enable
# Add "test" as a blacklisted tag
;nsfw addbagtag test
# Remove "Roxbot" as a blacklisted tag
;nsfw removebadtag Roxbot
The Reddit cog is a cog that allows users to get images and videos from their favourite subreddits.
Grabs an image or video (jpg, png, gif, gifv, webm, mp4) from the subreddit inputted.
Command Structure:
;subreddit name_of_subreddit
Example:
# Get images from /r/pics
;subreddit pics
!!! info
The following commands are alias-like commands that function like `;subreddit`, randomly selecting a subreddit in a collection of themed subreddits to get a post from.
Gives you cute pics from reddit
Subreddits:
"aww", "redpandas", "lazycats", "rarepuppers", "awwgifs", "adorableart"
Command Structure:
;aww
Feeds you with food porn.
Subreddits:
"foodporn", "food", "DessertPorn", "tonightsdinner", "eatsandwiches", "steak", "burgers", "pizza", "grilledcheese", "PutAnEggOnIt", "sushi"
Command Structure:
;feedme
Feeds you with vegan food porn.
Subreddits:
"veganrecipes", "vegangifrecipes", "veganfoodporn"
Command Structure:
;feedmevegan
The full (mostly) me_irl network of subs.
Subreddits:
"me_irl", "woof_irl", "meow_irl", "metal_me_irl"
Command Structure:
;me_irl
Aliases:
meirl
Gives you the best trans memes for daysssss
Subreddits:
"gaysoundsshitposts", "traaaaaaannnnnnnnnns"
Command Structure:
;traa
Aliases:
gssp
, gss
, trans_irl
The SelfAssign cog allows guild’s to mark roles as ‘self assignable’. This allows users to give themselves these roles and to see all the roles marked as ‘self assignable’.
!!! warning
This whole cog cannot be used in private messages.
Self-assign yourself a role. Can only be done one role at a time.
Command Structure:
;iam role
Example:
;iam OverwatchPing
Remove a self-assigned role. Can only be done one role at a time.
Command Structure:
;iamn role
Example:
;iamn OverwatchPing
List’s all roles that can be self-assigned on this server.
Command Structure:
;listroles
Edits settings for self assign cog.
!!! warning “Required Permissions”
Command requires the user to have the `manage_roles` permission.
Command Structure:
;sa option [role: optional]
Aliases:
sa
Options:
enable/disable: Enable/disables the cog.
add/remove: adds or removes a role that can be self assigned in the server.
Example:
# Turn on self assigned roles and add a role called "ROLE"
;sa enable
;sa add ROLE
Roxbot Trivia is a trivia game in your discord server. It’s heavily inspired by Tower Unite’s Trivia mini-game. Learn how to play Roxbot Trivia here. More detailed documentation can be found below.
This cog works better if the bot account is in the Roxbot Emoji Server. If it cannot find the emotes it needs, it will default to unicode emoji.
!!! warning
This whole cog cannot be used in private messages.
!!! info “Disclaimer”
Roxbot Trivia uses the Open Trivia Database, made and maintained by Pixeltail Games LLC. The OpenTDB is licensed under the [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/). Find out more at [https://opentdb.com/](https://opentdb.com/).
Command group for the Roxbot Trivia game. All interactions with the game are done through this command.
Command Structure:
;trivia subcommand
Aliases:
tr
Displays help in playing Roxbot Trivia. If nothing/an incorrect subcommand is passed to the trivia command, this command is invoked instead. This outputs something similar to the About Roxbot Trivia page.
Command Structure:
;trivia about
Joins a Trivia game in this channel. The game must be waiting for players to join after a user has executed the ;trivia start
command. You cannot join a game in progress.
Command Structure:
;trivia join
Command to leave the game. When invoked, the user leaves the game and their score is removed from the leaderboard. This can be done at any point of the game.
Command Structure:
;trivia leave
Starts a trivia game in the channel the command was invoked in.
Command Structure:
;trivia start [*args: optional]
Args:
--mobile
/-m
- Launches the game in a mobile compatible mode. In case rich embeds are not readable, especially for Android users.
--solo
/-s
- Skips waiting for users to join and launches the game immediately. Useful for users just wanting to play solo.
--length
/-l
- Takes option for the length of the game. Acceptable options are short
(5 Questions), medium
(10), and long
(15).
Examples:
# Start a standard trivia game
;trivia start
# Start a mobile compatible solo game of Roxbot Trivia
;tr start -ms
# Start a solo short game
;tr start --solo --length short
Mod command to kick users out of the game. Useful if a user is AFK because of the timer on answering questions.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission.
Command Structure:
;trivia kick user
Options:
user
- A name, ID, or mention of a user.Example:
# Kick user called BadTriviaPlayer
;tr kick @BadTriviaPlayer
The Util cog is a cog filled with a number of utility commands to help more advanced users of Discord.
Uploads a downloadable picture of an avatar.
Command Structure:
;avatar [user: optional]
Options:
user
- OPTIONAL: A name, ID, or mention of a user. If provided, the command will return the user’s avatar, if not, it will provide your own.Example:
# Get my avatar
;avatar
# Get USER's avatar
;avatar USER#0001
Displays information (creation date, guild, ID) and an easily downloadable version of the given custom emote.
Command Structure:
;emote EMOTE
Aliases:
emoji
Options:
emote
- Needs to be a valid custom emojiExample:
# Get infomation of the emoji ":Kappa:"
;emote :Kappa:
Gives information (creation date, owner, ID) on the guild this command is executed in.
!!! warning
This command cannot be used in private messages.
Command Structure:
;guild
Aliases:
server
Provides information (account creation date, ID, roles [if in a guild]) on your or another persons account.
Command Structure:
;info [USER: optional]
Aliases:
user
Options:
USER
- OPTIONAL: A name, ID, or mention of a user.Examples:
# Get account information for yourself
;info
# Get account information for a user called USER
;info @USER
Gives information (creation date, colour, ID) on the role given. Can only work if the role is in the guild you execute this command in.
!!! warning
This command cannot be used in private messages.
Command Structure:
;role ROLE
Options:
ROLE
- Name, ID, or mention of the role you want the info for.Example:
# Get information on the role called Admin
;role Admin
The Voice cog is a cog that adds and manages a fully-functional music bot for Roxbot.
!!! warning
This whole cog cannot be used in private messages.
Summon Roxbot to a voice channel, usually the one you are currently in.
!!! note
This is done automatically when you execute the `;play` or `;stream` commands.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission
Command Structure:
;join [Voice Channel: optional]
Options:
Voice Channel
- OPTIONAL. The name of a Voice ChannelExample:
# Join a voice channle called General
;join General
Displays what is currently playing.
Command Structure:
;nowplaying
Aliases:
;np
Pauses the current video, if playing.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission if this is enabled by server admins using the needperms setting in `;voice`
Command Structure:
;pause
Plays a video over voice chat using the given URL. This URL has to be one that YoutubeDL can download from. A list can be found here.
If the bot is already playing something, this will be queued up to be played later. If you want to play a livestream, use the ;stream
command.
!!! info
The user needs to be in a voice channel for this command to work. This is ignored if the user has the `manage_channels` permission. There is also a duration limit that can be placed on videos. This is also ignored if the user has the `manage_channels` permission.
Command Structure:
;play url
Options:
url
- A url to a video or playlist or a search term. If a playlist, it will play the first video and queue up all other videos in the playlist. If just text, Roxbot will play the first Youtube search result.Examples:
# Play the quality youtube video
;play https://www.youtube.com/watch?v=3uOPGkEJ56Q
Displays what videos are queued up and waiting to be played.
Command Structure:
;queue
Removes a video from the queue.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission
Command Structure:
;remove index/"all"
Options:
index/all
- A number representing an index in the queue to remove one video, or “all” to clear all videos.Examples:
# Remove 2nd video
;remove 2
# Clear the queue
;remove all
Resumes the bot, if paused.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission if this is enabled by server admins using the needperms setting in `;voice`
Command Structure:
;resume
Skips the current playing video.
If skipvoting is enabled, multiple people will have to use this command to go over the ratio that is also set by server moderators.
Command Structure:
;skip [--force: optional]
Options:
--force
- if skip voting is enabled, users with the manage_channel
permission can skip this process and for the video to be skipped.Examples:
# Vote to skip a video
;skip
# Force skip a video
;skip --force
Stops Roxbot from playing music and has her leave voice chat.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission.
Command Structure:
;stop
Aliases:
disconnect
A version of ;play
that should be used to stream livestreams or internet radio sources.
For more details on how this command words, please look at the documentation for the ;play
command.
Command Structure:
;stream url
Sets the volume percentage for Roxbot’s audio.
The current volume of Roxbot is displayed by her nowplaying rich embeds that are displayed when she begins to play a video or when the ;nowplaying
command is used.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission if this is enabled by server admins using the needperms setting in `;voice`
Command Structure:
;volume percent
Options:
percent
- A positive integer between 0-100 representing a percentage.Example:
# Set volume to 20%
;volume 20
Edits settings for the voice cog.
!!! warning “Required Permissions”
Command requires the user to have the `manage_channels` permission
Command Structure:
;voice option [change: optional]
Options:
enable/disable
: Enable/disables specified change.skipratio
: Specify what the ratio should be for skip voting if enabled. Example: 0.6 for 60%maxlength/duration
: Specify (in seconds) the max duration of a video that can be played.
Possible settings to enable/disable:
needperms
: specifies whether volume
, pause
, or resume
require permissions or not.skipvoting
: enables voting to skip instead of one user skipping.
Example:
# Enable skipvoting
;voice enable skipvoting
# Disbale needing perms
;voice disable needperms
# Edit maxlength to 5 minutes
;voice maxlength 300