roxbot/docs/commands.md

---

title: Command Documentaion summary: Documentation for all of Roxbot’s commands. authors:

- Roxanne Gibsin

date: 2018-10-27

Command Documentaion

Before reading this, it is highly recommened you read the quick start guide that will get you upto date with how Roxbot works and how to run her. This is handy if you expect to use commands that will edit Roxbot or Roxbot’s guild settings.

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, unavalible to average users.

;backup

!!! warning

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

;blacklist

!!! warning

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

;changeactivity

!!! warning

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

;changeavatar

!!! warning

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

;changenickname

!!! warning

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

;changestatus

!!! warning

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

;printsettings

!!! warning

Command requires the user has the `manage_guild` permission.

!!! warning

This command cannot be used in private messages.

;shutdown

!!! warning

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

Cog Commands

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

!!! warning

Command requires the user **and** Roxbot have the `ban_users` permission.

;kick

!!! warning

Command requires the user **and** Roxbot have the `kick_users` permission.

;purge

!!! warning

Command requires the user **and** Roxbot have the `manage_messages` permission.

;slowmode

!!! warning

Command requires the user **and** Roxbot have the `manage_channels` permission.

;unban

!!! warning

Command requires the user **and** Roxbot have the `ban_users` permission.

;warn

!!! warning

Group requires the user has 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>

;warn add

;warn list

;warn prune

;warn remove

;warn set_limit

---

Custom Commands

;custom

!!! warning

This command group cannot be used in private messages.

Subcommands

;custom add

!!! warning

Command requires the user has the `manage_messages` permission.

;custom edit

!!! warning

Command requires the user has the `manage_messages` permission.

;custom list

;custom remove

!!! warning

Command requires the user has the `manage_messages` permission.

---

Fun

;aesthetics

;coinflip

;frogtips

;hug

;numberfact

;onthisday

;pet

;roll

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 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

;spank

!!! warning

This command will only work in channels marked NSFW 

;suck

!!! warning

This command will only work in channels marked NSFW 

;waifurate

;xkcd

Grabs the image & metadata of the given xkcd comic

Example:

{command_prefix}xkcd 666
{command_prefix}xkcd Silent Hammer
{command_prefix}xkcd latest

;zalgo

---

Image Editor

;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. Avalible 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!](https://github.com/Roxxers/roxbot/issues/new)

Subcommands

;pride agender

;pride asexual

Aliases

ace

;pride bisexual

Aliases

bi

;pride genderfluid

Aliases

gf

;pride genderqueer

Aliases

gq

;pride lgbt

;pride nonbinary

Aliases

nb, enby

;pride transgender

Aliases

trans

---

Join Leave

;goodbyes

!!! warning

This command cannot be used in private messages.

;greets

!!! warning

This command cannot be used in private messages.

---

NSFW

;e621

!!! warning

This command will only work in channels marked NSFW or DMs.

;gelbooru

!!! warning

This command will only work in channels marked NSFW or DMs.

;rule34

!!! warning

This command will only work in channels marked NSFW or DMs.

---

;nsfw

!!! warning

This command cannot be used in private messages.

---

Reddit

;subreddit

Grabs an image or video (jpg, png, gif, gifv, webm, mp4) from the subreddit inputted.

Command Structure ;subreddit name_of_subreddit

Example ;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

---

Self Assign

!!! warning

This whole cog cannot be used in private messages.

;iam

;iamn

;listroles

---

;selfassign

---

Trivia

;trivia

!!! warning

This command group cannot be used in private messages.

Subcommands

;trivia about

;trivia join

;trivia leave

;trivia start

;trivia kick

---

Util

;avatar

;echo

;emote

;guild

!!! warning

This command cannot be used in private messages.

;info

;invite

;role

!!! warning

This command cannot be used in private messages.

---

Voice

!!! warning

This whole cog cannot be used in private messages.

;join

;nowplaying

;pause

;play

;queue

;remove

;resume

;skip

;stop

;stream

;volume

;voice