Commands

General

General commands.

avatar

Usage: avatar [id/name/mention]

Gets a user’s avatar

Flags:

  • -f/--format - The file format. Can be ‘jpg’, ‘png’, ‘webp’, or ‘gif’. Defaults to ‘png’, or ‘gif’ if it’s an animated avatar.
  • -s/--size - The file size. Can be 128, 256, 512, 1024, or 2048. Defaults to 512.

beemovie

Usage: ``

Gives a quote from the Bee Movie.

Flags:

  • -n/--name - Shows the name of the character the quote is from, if applicable.
  • -c/--only-characters - Only give quotes from actual characters (no stage directions).

brainfuck

Usage: brainfuck <code>
Aliases: rainfuck | br

Executes brainfuck code.

Flags:

  • -p/--pointers - Shows a list of pointers after the execution.
  • -i/--input - Specifies the input for the , operator.

decancer

Usage: decancer <user | text>

Decancerify’s the user’s nickname/username, or the provided text, to simple ASCII.

define

Usage: define <word>

Gets the definition for the specified word. The word must be in english.

dmerrors

Usage: dmerrors

Toggles whether to DM you errors.

donate

Usage: donate

Gets you my donation information

emoji

Usage: emoji <emoji> [size]
Aliases: e

Gives you a large version of an emoji. If size is specified and the emoji is not a custom emoji, the image will be that size.

Flags:

  • -s/--svg - Get the emote as an svg instead of a png.

emojify

Usage: emojify <text>
Aliases: 💬

Gets emojis based on input.

feedback

Usage: feedback <feedback>
Aliases: suggest | report

This command has three different functions for varying purposes. Please do not abuse it.

feedback - give me feedback about the bot
suggest - tell me something you want to be added or changed
report - let me know about a bug you found

Thank you for your support. It means a lot to me!

Flags:

  • -d/--desc - The description for your suggestion
  • -c/--command - Signify your suggestion is for a command
  • -b/--bbtag - Signify your suggestion is for BBTag
  • -a/--docs - Signify your suggestion is for documentation
  • -o/--other - Signify your suggestion is for other functionality
  • -e/--edit - Edits an existing suggestion with the provided case number

help

Usage: help [command]

Gets a list of command or specific command help.

info

Usage: info

Returns some info about me.

insult

Usage: insult [name]

Generates a random insult directed at the name supplied.

invite

Usage: invite
Aliases: join

Gets you invite information.

mods

Usage: mods [online | o | away | a | dnd | d | offline]

Gets a list of mods.

names

Usage: names [user] [flags]

Returns the names that I’ve seen the specified user have in the past 30 days.

Flags:

  • -a/--all - Gets all the names.
  • -v/--verbose - Gets more information about the retrieved names.

nato

Usage: nato <text>

Translates the given text into the NATO phonetic alphabet.

personalprefix

Usage: personalprefix add|remove [prefix]
Aliases: pprefix

Adds or removes a personal prefix.

ping

Usage: ping

Pong!
Find the command latency.

poll

Usage: poll <question> [flags]

Creates a poll for the given question and duration. If no duration is given, defaults to 60 seconds. If emojis are given, they will be used as options for the poll.

Flags:

  • -t/--time - How long before the poll expires, formatted as ‘1 day 2 hours 3 minutes and 4 seconds’, ‘1d2h3m4s’, or some other combination.
  • -e/--emojis - The emojis to apply to the poll.
  • -d/--description - The description of the poll.
  • -c/--colour - The colour of the poll (in HEX).
  • -a/--announce - If specified, it will make an announcement. Requires the proper permissions.
  • -s/--strict - If specified, only accept reactions that were in the initial list.

remind

Usage: remind <text> -t <time>
Aliases: remindme

Reminds you about something after a period of time in a DM.

Flags:

  • -t/--time - The time before the user is to be reminded, formatted as ‘1 day 2 hours 3 minutes and 4 seconds’, ‘1d2h3m4s’, or some other combination.
  • -c/--channel - If set, this will notify the user in current channel instead of in a DM.

roles

Usage: roles

Displays a list of roles and their IDs.

roll

Usage: roll [dice] [modifier]

Rolls an amount of dice (ex. 1d20) and adds the modifier.

rr

Usage: rr [bullets] [emote]

Plays russian roulette with a specified number of bullets. If emote is specified, uses that specific emote.

shard

Usage: shard <id>

Gives you information about the current shard.

ship

Usage: ship <user1> <user2>

Gives you the ship name for two users.

snippet

Usage: snippet <submit <code> <flags> | approve <id> | reject <id> <reason>>

submit a snippet and stuff

Flags:

  • -t/--title - The title of the snippet
  • -d/--description - The description of the snippet
  • -c/--command - Use this to designate it as a command instead of a snippet

spell

Usage: spell [name]

Gives you a description for a D&D 5e spell.

stats

Usage: stats [c]

Gives you some information about me

status

Usage: status <code> [cat | dog]

Gets you an image of an HTTP status code.

syntax

Usage: syntax [command name]
Aliases: syntaxify

Gives you the ‘syntax’ for a command :wink:

tag

Usage: tag [<name> <args> | create <name> <content> | edit <name> <content> | delete <name> | rename <tag> <name> | cooldown <name> [time] | raw <name> | info <name> | top | author <tag> | search <name> | list [author] | favorite [tag] | report <tag> <reason> | test [debug] <code> | debug <name> <args> | help [command] | docs [topic] | flag <tag> | <add|remove> <name> <flags> | setlang <tag> <lang> | test <content>]
Aliases: t

Tags are a system of public commands that anyone can create or run, using the BBTag language.

Subcommands:
, create, edit, delete, rename, cooldown, raw, info, top, author, search, list, favorite, report, test, debug, help, docs, flag, setlang, test
For more information about a subcommand, do b!tag help <subcommand>.

For more information about BBTag, visit https://blargbot.xyz/tags.
By creating a tag, you acknowledge that you agree to the Terms of Service (https://blargbot.xyz/tags/tos)

time

Usage: time < <timezone> [ <timezone2> <time> ] | <user> >

Tells you the current time in the specified timezone. If timezone2 and time are specified, converts the time from timezone to timezone2. Time must be formatted as hh:mm[AM/PM], and timezones must use the timezone codes listed here: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. Alternatively, tells you what time it is for a specified user if they’ve set their timezone code using the timezone command.

timer

Usage: timer <time>
Aliases: stopwatch

Sets a timer for the provided amount of time, formatted as ‘1 day 2 hours 3 minutes and 4 seconds’, ‘1d2h3m4s’, or some other combination.

timezone

Usage: time [timezone]

Sets or retrieves your timezone. Timezones must use the timezone codes listed here: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

todo

Usage: todo [remove <item id> | add <item>]

Access your todo list.
To add items, do todo add <item>.
To remove items, do todo remove <item id>, where item id is the number shown when you do todo by itself.

tokenify

Usage: tokenify <input>

Converts the given input into a token.

uptime

Usage: uptime

Tells you how long I have been online.

user

Usage: user [id/name/mention]

Gets information about specified user

version

Usage: version

Tells you what version I am on

voteban

Usage: voteban [info <user> | <user> [reason]]
Aliases: pollban | vb | pb

Sign a petition to ban somebody, or check the status of a petition. If no arguments are provided, get the most signed petitions.

warnings

Usage: warnings [user]

Gets how many warnings you or a specified user has.

NSFW

Commands that can only be executed in NSFW channels.

danbooru

Usage: danbooru <tags...>

Gets three pictures from ‘https://danbooru.donmai.us/’ using given tags.

e621

Usage: e621 <tags...>

Gets three pictures from ‘https://e621.net/’ using given tags.

rule34

Usage: rule34 <tags...>

Gets three pictures from ‘https://rule34.xxx/’ using given tags.

Image

Commands that generate or display images.

art

Usage: art [user]

Shows everyone a work of art.

Flags:

  • -I/--image - A custom image.

cah

Usage: cah

Generates a set of CAH cards.

caption

Usage: caption [url] [flags]

Captions an image. If url isn’t provided, you must give an attachment.

Flags:

  • -t/--top - The top caption.
  • -b/--bottom - The bottom caption.
  • -f/--font - The font to use (case insensitive). Use the command with the -l flag to view the available fonts. Defaults to impact.
  • -l/--list - Lists the available fonts.

cat

Usage: cat

Gets a picture of a cat.

clint

Usage: clint [user]

I don’t even know, to be honest.

Flags:

  • -I/--image - A custom image.

clippy

Usage: clippy <text>
Aliases: clippit | paperclip

Clippy the paperclip is here to save the day!

clyde

Usage: clyde <text>

Give everyone a message from Clyde.

color

Usage: color [codes]...

Returns the provided colors

commit

Usage: commit [number]

Gets a random or specified blargbot commit.

delete

Usage: delete [text]

Shows that you’re about to delete something.

distort

Usage: distort [user]

Turns an avatar into modern art.

Flags:

  • -I/--image - A custom image.

free

Usage: free <caption> [flags]

Tells everyone what you got for free

Flags:

  • -b/--bottom - The bottom caption.

linus

Usage: linus [user]

Shows a picture of Linus pointing at something on his monitor.

Flags:

  • -I/--image - A custom image.

pccheck

Usage: pccheck <text>

Tells everyone a reason why they should get their PC checked. Template credits go to Ghosty#8204.

pixelate

Usage: pixelate [url] [flags]

Pixelates an image. If url isn’t provided, you must give an attachment.

Flags:

  • -u/--user - A user avatar instead of a url
  • -s/--scale - The amount to pixelate by (defaults to 64)

retarded

Usage: retarded <text> [flags]

Tells everyone who is retarded.

Flags:

  • -u/--user - The person who is retarded.
  • -I/--image - A custom image.

shit

Usage: shit <text> [flags]
Aliases: heck

Tells everyone what’s shit.

Flags:

  • -p/--plural - Whether or not the text is plural (use ARE instead of IS).

sonicsays

Usage: sonicsays <text>

Sonic wants to share some words of wisdom.

starvstheforcesof

Usage: starvstheforcesof [user]
Aliases: svtfo

WHO IS STAR BATTLING THIS EPISODE?

Flags:

  • -I/--image - A custom image.

thesearch

Usage: thesearch [text]

Tells everyone about the progress of the search for intelligent life.

triggered

Usage: triggered [user]

Shows everyone how triggered you are.

Flags:

  • -i/--invert - Inverts the image.
  • -h/--horizontal - Flips the image horizontally.
  • -v/--vertical - Flips the image vertically.
  • -s/--sepia - Applies a sepia filter.
  • -b/--blur - Applies a blur.
  • -g/--greyscale - Makes the image greyscale
  • -I/--image - A custom image.

truth

Usage: truth <text>
Aliases: scrolloftruth

Shows everyone what is written in the Scroll of Truth.

xkcd

Usage: xkcd [number]

Gets an xkcd comic. If a number is not specified, gets a random one.

Admin

Powerful commands that require an `admin` role or special permissions.

announce

Usage: announce < <text> | flags >

Makes an annoucement to a configured role, or resets the announcement configuration.

Flags:

  • -r/--reset - Resets the announcement settings

autoresponse

Usage: autoresponse < add | remove | edit | list>
Aliases: ar

Creates autoresponses. You can create up to 20 autoresponses to certain phrases, and 1 autoresponse that responds to everything.

Autoresponses will be checked in the order they’re added, and only one will be executed (excluding the everything autoresponse). Rather than specifying the code in this command, autoresponses will execute a hidden custom command that you can modify on the IDE. The everything autoresponse will not automatically output the execution result.
Commands:
ADD [flags] - Adds a autoresponse with for the provided text.
REMOVE - Brings up a menu to remove a autoresponse
INFO - Displays information about autoresponses.

Flags:

  • -R/--regex - If specified, parse as /regex/ rather than plaintext. Unsafe and very long (more than 2000 characters) regexes will not parse successfully.
  • -e/--everything - Makes the added autoresponse respond to everything. Only one is allowed.

ban

Usage: ban <user> [days] [flags]

Bans a user, where days is the number of days to delete messages for (defaults to 0).
If mod-logging is enabled, the ban will be logged.

Flags:

  • -r/--reason - The reason for the ban.
  • -t/--time - If provided, the user will be unbanned after the period of time. (softban)

blacklist

Usage: blacklist [channel]

Blacklists the current channel, or the channel(s) that you mention. The bot will not respond until you do blacklist again.

ccommand

Usage: ccommand <subcommand>
Aliases: cc

Creates a custom command, using the BBTag language.

Custom commands take precedent over all other commands. As such, you can use it to overwrite commands, or disable them entirely. If the command content is “null” (without the quotations), blargbot will have no output whatsoever, allowing you to disable any built-in command you wish. You cannot overwrite the ‘ccommand’ command. For more in-depth command customization, see the editcommand command.

Subcommands:
author, cooldown, create, debug, delete, docs, edit, flag, hide, help, import, list, raw, rename, set, sethelp, setlang, setrole, test
For more information about a subcommand, do b!cc help <subcommand>.

For more information about BBTag, visit https://blargbot.xyz/tags.

censor

Usage: censor help

Creates message censorships.
Commands:
ADD [flags] - Adds a censor with for the provided text.
REMOVE - Brings up a menu to remove a censor
EXCEPTION <add | remove> [flags] - Adds or removes an exception.
RULE [flags] - Sets the censorship rules.
INFO - Displays information about censors.

Flags:

  • -R/--regex - Add/Edit: If specified, parse as /regex/ rather than plaintext. Unsafe and very long (more than 2000 characters) regexes will not parse successfully.
  • -w/--weight - Add/Edit: How many incidents the censor is worth.
  • -r/--reason - Add/Edit: A custom modlog reason. NOT BBTag compatible.
  • -d/--deletemessage - Add/Rule/Edit: The BBTag-compatible message to send after a message is deleted. Adds override rules.
  • -k/--kickmessage - Add/Rule/Edit: The BBTag-compatible message to send after a user is kicked. Adds override rules.
  • -b/--banmessage - Add/Rule/Edit: The BBTag-compatible message to send after a user is banned. Adds override rules.
  • -u/--users - Exception: A list of users that are exempt from censorship.
  • -r/--roles - Exception: A list of roles that are exempt from censorship.
  • -c/--channels - Exception: A list of channels that are exempt from censorship.

changelog

Usage: changelog

Sets the current channel as your guild’s changelog channel. A message will be posted in this channel whenever there is an update. The bot requires the embed links permission for this.

editcommand

Usage: editcommand < list | setrole <commandname | "commandname,..."> [role name]... | setperm <commandname | "commandname,..."> [perm number] | toggle <commandname | "commandname,...">

Changes command-specific usage permissions.

list
Shows a list of modified commands (role required/perms required)

setrole
Sets the role(s) required in order to use the command(s). Set to blank to disable the custom role requirement.

setperm
Sets the permissions required in order to bypass the role requirement (requires permoverride in the settings command to be enabled). This has to be a permission number, which can be calculated at https://discordapi.com/permissions.html. Set to blank to disable the custom permission options.

toggle
Enables/disables the listed commands

farewell

Usage: farewell [message]

Sets a farewell message for when users leave.

Flags:

  • -c/--channel - The channel to put the farewell messages in.
  • -r/--raw - Gets the code from the currently-set greeting.

greet

Usage: greet [message]

Sets a greeting for when users join. To disable it, simply type the command with no content.

Flags:

  • -c/--channel - The channel to put the greeting in.
  • -r/--raw - Gets the code from the currently-set greeting.

hackban

Usage: hackban <user...> [days]

Bans a user who isn’t currently on your guild, where <user...> is a list of user IDs or mentions (separated by spaces) and days is the number of days to delete messages for (defaults to 0).
If mod-logging is enabled, the ban will be logged.

Flags:

  • -r/--reason - The reason for the ban.

kick

Usage: kick <user> [flags]

Kicks a user.
If mod-logging is enabled, the kick will be logged.

Flags:

  • -r/--reason - The reason for the kick.

log

Usage: log <list | enable <channel> <event name>... | disable <event name>... | ignore <users>... | track <users>...>

Toggles logging for the specified events. Available events are:

  • memberban - when a user gets banned
  • memberunban - when a user gets unbanned
  • memberjoin - when a user joins
  • memberleave - when a user leaves
  • messagedelete - when a message gets deleted
  • messageupdate - when a message gets updated
  • nameupdate - when a user changes their username
  • avatarupdate - when a user changes their avatar
  • nickupdate - when a user changes their nickname
  • role: - when a role gets added or removed
  • all - enables all of the events

ignore adds a list of users to ignore from logging. Useful for ignoring bots.
track removes users from the ignore list

logs

Usage: logs <number> [flags]

Creates a chatlog page for a specified channel, where number is the amount of lines to get. You can retrieve a maximum of 1000 logs.For more specific logs, you can specify flags.
For example, if you wanted to get 100 messages stupid cat deleted, you would do this:
logs 100 --type delete --user stupid catIf you want to use multiple of the same type, separate parameters with commas or chain them together. For example:
logs 100 -CU -u stupid cat, dumb cat

Flags:

  • -t/--type - The type(s) of message. Value can be CREATE, UPDATE, and/or DELETE, separated by commas.
  • -c/--channel - The channel to retrieve logs from. Value can be a channel ID or a channel mention.
  • -u/--user - The user(s) to retrieve logs from. Value can be a username, nickname, mention, or ID. This uses the user lookup system.
  • -C/--create - Get message creates.
  • -U/--update - Get message updates.
  • -D/--delete - Get message deletes.
  • -j/--json - Returns the logs in a json file rather than on a webpage.

modlog

Usage: modlog [disable | clear [number to clear]]

Enables the modlog and sets it to the current channel. Doing modlog disable will disable it. Doing modlog clear [number] will clear the specified number of cases from the modlog. Leaving number blank will clear all cases.When an admin does a moderation command (ban, unban, mute, unmute, and kick), the incident will be logged. The admin will then be encouraged to do reason <case number> <reason> to specify why the action took place.
Bans and unbans are logged regardless of whether the ban or unban commands are used.

mute

Usage: mute <user> [flags]

Gives the user a special muted role. On first run, this role will be created. The bot needs to be able to manage roles to create and assign the role, and manage channels to configure the role. You are able to manually configure the role without the bot, but the bot has to make it. Deleting the muted role causes it to be regenerated.
If the bot has permissions for it, this command will also voice-mute the user.
If mod-logging is enabled, the mute will be logged.
You can also specify a length of time the user should be muted for, using formats such as 1 hour 2 minutes or 1h2m.

Flags:

  • -r/--reason - The reason for the mute.
  • -t/--time - The amount of time to mute for, formatted as ‘1 day 2 hours 3 minutes and 4 seconds’, ‘1d2h3m4s’, or some other combination.

pardon

Usage: pardon <user> [flags]

Pardons a user.
If mod-logging is enabled, the pardon will be logged.
This will not unban users.

Flags:

  • -r/--reason - The reason for the pardon.
  • -c/--count - The number of warnings that will be removed.

prefix

Usage: prefix add|remove [prefix] [flags]

Sets the command prefix.

Flags:

  • -d/--default - Sets the provided prefix as the default prefix for the guild.

purge

Usage: purge

Purges messages made by me.

reason

Usage: reason <caseid | latest> <reason>

Sets the reason for an action on the modlog.

roleme

Usage: roleme <list | add | remove | edit>

A roleme is a system to automatically give/remove roles to a user when they say a specific catchphrase. You can make these catchphrases anything you want, case sensitive/insensitive, and only activate in specific channels. The roleme command has three subcommands:

list: lists all the rolemes active on the guild.
add: adds a roleme to the guild. Just follow the instructions, or use flags.
remove: returns a list of rolemes so you can choose one to remove.
edit: modifies a roleme using the provided flags

Flags:

  • -a/--add - Add: A list of roles to add in the roleme
  • -r/--remove - Add: A list of roles to remove in the roleme
  • -p/--phrase - Add: The phrase to respond to
  • -C/--case - Add: Whether the phrase is case sensitive
  • -c/--channel - Add: The channels the roleme should be in
  • -m/--message - Add: The BBTag-compatible message to output on activation

rvoteban

Usage: rvoteban (<user> | <flags>)
Aliases: rpollban | removevoteban | removepollban | rvb | rpb

Removes the votebans for a specific user, or removes all votebans completely.

Flags:

  • -a/--all - Removes all votebans

settings

Usage: settings [keys|help|set <key>]

Gets or sets the settings for the current guild. Visit https://blargbot.xyz/commands/settings for key documentation.

slowmode

Usage: slowmode [time]

Sets the channel’s slowmode to 1 message every time seconds, with a max of 120. Leave empty to disable slowmode.

Flags:

  • -c/--channel - The channel to put under slowmode
  • -r/--reason - The reason for the slowmode

tidy

Usage: tidy [amount] [flags]

Clears messages from chat. Defaults to 100.

Flags:

  • -b/--bots - Remove messages from bots.
  • -i/--invites - Remove messages containing invites.
  • -l/--links - Remove messages containing links.
  • -e/--embeds - Remove messages containing embeds.
  • -a/--attachments - Remove messages containing attachments.
  • -u/--user - Removes messages from the users specified, separated by commas.
  • -q/--query - Removes messages that match the provided query. You can also use /regex/.
  • -I/--invert - Reverses the effects of all the flag filters.
  • -y/--yes - Bypasses the confirmation

timers

Usage: timers <[page] | cancel <ids...> | clear | raw <id>>

Lists all the timers currently active here. You can also cancel any of them by using the cancel subcommand

unban

Usage: unban <userid> [flags]

Unbans a user.
If mod-logging is enabled, the unban will be logged.

Flags:

  • -r/--reason - The reason for the unban.

unmute

Usage: unmute <user> [flags]

Unmutes a user.
If mod-logging is enabled, the unmute will be logged.

Flags:

  • -r/--reason - The reason for the unmute.

warn

Usage: warn <user> [flags]

Issues a warning.
If mod-logging is enabled, the warning will be logged.
If kickat and banat have been set using the settings command, the target could potentially get banned or kicked.

Flags:

  • -r/--reason - The reason for the warning.
  • -c/--count - The number of warnings that will be issued.

Social

Social commands for interacting with other people

awoo

Usage: awoo

Awoooooooooo!

bang

Usage: bang

Bang bang!

bite

Usage: bite [user]

Give someone a bite!

blush

Usage: blush

Show everyone that you’re blushing.

cry

Usage: cry

Show everyone that you’re crying.

cuddle

Usage: cuddle [user]

Cuddle with someone.

dance

Usage: dance

Break out some sweet, sweet dance moves.

hug

Usage: hug [user]

Give somebody a hug.

jojo

Usage: jojo

This must be the work of an enemy stand!

kiss

Usage: kiss [user]

Give someone a kiss!

lewd

Usage: lewd

T-that’s lewd…

lick

Usage: lick [user]

Give someone a lick. Sluurrpppp!

megumin

Usage: megumin

Darkness blacker than black and darker than dark, I beseech thee, combine with my deep crimson. The time of awakening cometh. Justice, fallen upon the infallible boundary, appear now as an intangible distortion! Dance, Dance, Dance! I desire for my torrent of power a destructive force: a destructive force without equal! Return all creation to cinders, and come from the abyss!

nom

Usage: nom [user]

Nom on somebody.

owo

Usage: owo

owo whats this?

pat

Usage: pat [user]

Give somebody a lovely pat.

poke

Usage: poke [user]

Gives somebody a poke.

pout

Usage: pout

Let everyone know that you’re being pouty.

punch

Usage: punch [user]

Punch someone. They probably deserved it.

rem

Usage: rem

Worst girl.

shrug

Usage: shrug

Let everyone know that you’re a bit indifferent.

slap

Usage: slap [user]

Slaps someone.

sleepy

Usage: sleepy

Let everyone know that you’re feeling tired.

smile

Usage: smile

Smile!

smug

Usage: smug

Let out your inner smugness.

stare

Usage: stare

Staaaaaaaaare

thumbsup

Usage: thumbsup

Give a thumbs up!

wag

Usage: wag

Wagwagwagwag