

Command Documentation¶

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.

How to use the docs¶

What is an alias?¶

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.

What do I do when a command wants a channel, user, role, etc.?¶

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.

Core Commands¶

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.

;about¶

Outputs info about RoxBot, showing up time, how to report issues, contents of roxbot.conf and credits.

Command Structure:

;about

;backup¶

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

;blacklist¶

Manage the global blacklist for Roxbot.

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

;changeactivity¶

Changes the activity that Roxbot is doing. This will be added as a game. "none" can be passed to remove an activity from Roxbot.

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

;changeavatar¶

Changes the avatar of the bot account. This cannot be a gif due to Discord limitations.

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

;changenickname¶

Changes the nickname of Roxbot in the guild this command is executed in.

Warning

This command cannot be used in private messages.

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

;changestatus¶

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

;echo¶

Echos the given string to a given channel.

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

;help¶

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

;invite¶

Posts this invite. This allows you to invite Roxbot to your own server.

Command Structure:

;invite

;printsettings¶

Prints settings for the cogs in this guild.

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:

cog - OPTIONAL. If given, this will only show the setting of the cog given. This has to be the name the printsettings command gives.

Examples:

# Print the settings for the guild 
;printsettings
# print settings just for the Admin cog.
;printsettings Admin

;shutdown¶

Required Permissions

This command can only be executed by the owner of the Roxbot instance.

Shutdowns the bot.

Command Structure:

;shutdown

Cog Commands¶

Cog commands are all of the commands that aren't in the Core Roxbot code. This is anything that sits in the cogs/ folder;

Admin¶

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.

;ban¶

Bans the mentioned user with the ability to give a reason.

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"

;kick¶

Kicks the mentioned user with the ability to give a reason.

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"

;purge¶

Purges the text channel the command is executed in. You can specify a certain user to purge as well.

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

;slowmode¶

Puts the channel in slowmode. Users with manage_channel or manage_messages permissions will not be effected.

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

;unban¶

Unbans the mentioned user with the ability to give a reason.

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

;warn¶

Required Permissions

Group requires the user to have the kick_users permission. The logic here is that if a mod can kick a user, they can warn a user too as they are similar in function.

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.

;warn add¶

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"

;warn list¶

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

;warn prune¶

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

;warn remove¶

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

;warn set_limit¶

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

Custom Commands¶

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.

;custom¶

This command group handle settings for the custom commands.

Warning

This command group cannot be used in private messages.

;custom add¶

Add a custom command.

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.

;custom edit¶

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.

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"

;custom list¶

Lists all custom commands for this guild.

Command Structure:

;custom list

;custom remove¶

Removed the named custom command.

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

Fun¶

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.

;8ball¶

Asks a magic 8 ball to tell the future via the means of yes and no questions.

Command Structure:

;8ball question

Aliases:

magicball, 8b

Arguments:

question - a yes or no question to ask and Roxbot will enquire with the Magic 8-Ball to look into the future!

Examples: ;8ball Will this command take off as a good idea?

;aesthetics¶

Converts text to be more ａｅｓｔｈｅｔｉｃ fix-width text

Command Structure:

;aesthetics text

Aliases:

ae, aesthetic

Example:

# Convert "Hello World" to fixed-width text.
;ae Hello World

;coinflip¶

Flips a magical digital coin!

Command Structure:

;coinfilp

Aliases:

cf

;frogtips¶

RETURNS FROG TIPS FOR HOW TO OPERATE YOUR FROG

Command Structure:

;frogtips

Aliases:

ft, frog

;hug¶

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

;numberfact¶

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

;onthisday¶

Returns a random fact of something that happened today!

Command Structure:

;onthisday

Aliases:

otd

;pet¶

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

;roll¶

Rolls a die using dice expression format. Spaces in the expression are ignored.

Command structure:

;roll expression

Aliases:

die, dice

Examples

Roll one d10 two times

Output

Roll two d20s and takes the highest value, then adds 7

Output

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 total
d[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 them
- add l[number] - only sum the [number] lowest rolls rather than all of them
x[number] - only use at the end. roll the rest of the expression [number] times(max 10)

Credit: TBTerra#5677

;roxbotfact¶

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

;spank¶

Spanks the mentioned user

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

;suck¶

Sucks the mentioned user

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

;waifurate¶

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

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

This command is dedicated to Hannah, who came up with the command. I hope she's out there getting her waifus rated in peace.

;xkcd¶

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

;zalgo¶

Sends text to the nether and returns it back to you ̭҉̭̭ͭi̭͎̭ṋ̭̀҈̭̭̋ ̭͉̭z̭̩̭a̭̭̽ḽ̦̭g̭̞̭o̭̤̭ ̭̭͑f̭̻̭o̭̭͢r̭̭̀m̭̭ͮ

Command Structure:

;zalgo text

Aliases:

za

Example:

# Convert "Hello World" to zalgo.
;zalgo Hello World

ImageEditor¶

The ImageEditor cog is a cog with multiple commands to manipulate images provided by the user.

;deepfry¶

Deepfrys the given image

Command structure:

;deepfry image

Aliases:

df

Args:

image: Optional
1. If no image is provided, image will be your avatar
2. Mention a user, their avatar will be the image
3. Provide a URL, that will be the image
4. Provide an image via upload, that image will be deepfried

;pride¶

;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
1. If no image is provided, image will be your avatar
2. Mention a user, their avatar will be the image
3. Provide a URL, that will be the image
4. Provide an image via upload, that image will be deepfried

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!

;pride agender¶

Command structure:

;pride agender image

;pride asexual¶

Command structure:

;pride asexual image

Aliases:

ace

;pride bisexual¶

Command structure:

;pride bisexual image

Aliases:

bi

;pride genderfluid¶

Command structure:

;pride genderfluid image

Aliases:

gf

;pride genderqueer¶

Command structure:

;pride genderqueer image

Aliases:

gq

;pride lgbt¶

Command structure:

;pride lgbt image

;pride nonbinary¶

Command structure:

;pride nonbinary image

Aliases:

nb, enby

;pride transgender¶

Command structure:

;pride transgender image

Aliases:

trans

JoinLeave¶

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.

;goodbyes¶

Edits settings for the goodbye messages.

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

;greets¶

Edits settings for the welcome messages

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.

NSFW¶

The NSFW cog is a collection of commands that post images from popular NSFW sites.

;e621¶

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.

Warning

e621 limits searches to 6 tags via the API. Blacklisting a lot of tags may break this command.

Command Structure:

;e621 [*tags: optional]

Examples:

# Post a random image
;e621
# Post a random image with the tag "test"
;e621 test

;gelbooru¶

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

;rule34¶

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

;nsfw¶

Edits settings for the nsfw cog and other nsfw commands.

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 addbadtag test
# Remove "Roxbot" as a blacklisted tag
;nsfw removebadtag Roxbot

Reddit¶

The Reddit cog is a cog that allows users to get images and videos from their favourite subreddits.

;subreddit¶

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.

;aww¶

Gives you cute pics from reddit

Subreddits:

"aww", "redpandas", "lazycats", "rarepuppers", "awwgifs", "adorableart"

Command Structure:

;aww

;feedme¶

Feeds you with food porn.

Subreddits:

"foodporn", "food", "DessertPorn", "tonightsdinner", "eatsandwiches", "steak", "burgers", "pizza", "grilledcheese", "PutAnEggOnIt", "sushi"

Command Structure:

;feedme

;feedmevegan¶

Feeds you with vegan food porn.

Subreddits:

"veganrecipes", "vegangifrecipes", "veganfoodporn"

Command Structure:

;feedmevegan

;me_irl¶

The full (mostly) me_irl network of subs.

Subreddits:

"me_irl", "woof_irl", "meow_irl", "metal_me_irl"

Command Structure:

;me_irl

Aliases:

meirl

;traa¶

Gives you the best trans memes for daysssss

Subreddits:

"gaysoundsshitposts", "traaaaaaannnnnnnnnns"

Command Structure:

;traa

Aliases:

gssp, gss, trans_irl

SelfAssign¶

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.

;iam¶

Self-assign yourself a role. Can only be done one role at a time.

Command Structure:

;iam role

Example:

;iam OverwatchPing

;iamn¶

Remove a self-assigned role. Can only be done one role at a time.

Command Structure:

;iamn role

Example:

;iamn OverwatchPing

;listroles¶

List's all roles that can be self-assigned on this server.

Command Structure:

;listroles

;selfassign¶

Edits settings for self assign cog.

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

Trivia¶

roxbottrivialogo

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.

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. Find out more at https://opentdb.com/.

;trivia¶

Command group for the Roxbot Trivia game. All interactions with the game are done through this command.

Command Structure:

;trivia subcommand

Aliases:

tr

;trivia about¶

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

;trivia join¶

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

;trivia leave¶

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

;trivia start¶

Starts a trivia game in the channel the command was invoked in.

Command Structure:

;trivia start [*args: optional]

Args:

--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 solo game of Roxbot Trivia
;tr start -s

# Start a solo short game
;tr start --solo --length short

;trivia kick¶

Mod command to kick users out of the game. Useful if a user is AFK because of the timer on answering questions.

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

Util¶

The Util cog is a cog filled with a number of utility commands to help more advanced users of Discord.

;avatar¶

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

;emote¶

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 emoji

Example:

# Get infomation of the emoji ":Kappa:"
;emote :Kappa:

;guild¶

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

;info¶

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

;role¶

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

Voice¶

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.

;join¶

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.

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 Channel

Example:

# Join a voice channle called General
;join General

;nowplaying¶

Displays what is currently playing.

Command Structure:

;nowplaying

Aliases:

;np

;pause¶

Pauses the current video, if playing.

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

;play¶

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

;queue¶

Displays what videos are queued up and waiting to be played.

Command Structure:

;queue

;remove¶

Removes a video from the queue.

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

;resume¶

Resumes the bot, if paused.

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

;skip¶

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

;stop¶

Stops Roxbot from playing music and has her leave voice chat.

Required Permissions

Command requires the user to have the manage_channels permission.

Command Structure:

;stop

Aliases:

disconnect

;stream¶

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

;volume¶

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.

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

;voice¶

Edits settings for the voice cog.

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 skip_voting
# Disbale needing perms for volume, pause, etc.
;voice disable need_perms
# Edit max_length to 5 minutes
;voice max_length 300