Features
HaileyBot aims to be an incredibly versatile bot, with every feature you can think of, as well as some you would never even imagine. Of course, getting to that point takes time, and we're still on our way. With every new update comes a new feature, bringing us closer to our goal of becoming one of the 'greats', alongside Tatsumaki, Mee6, and Dyno.Statistics
Registered Ads
The total number of ads that have been registered via the bot's advertising functionGlobal Bans
The total number of people who have been put on our global ban list for violating our global ban policyTotal Members
The total number of members across all the servers the bot is inServers
The total number of servers the bot is currently inOpen-Source Libraries
This bot makes use of some free, open-source node.js libraries, listed below:
Discord.js
Used as a secondary API wrapper, deals with things that the main wrapper can't handle due to depracation.
Discordie
Used as the main API wrapper, and although its 2 years out-of-date, it still does most of what I need it to.
File-System
Used to read and write from configuration and database files.
Snekfetch
Used to create custom API endpoints and post things to the API that the other wrappers don't handle.
Documentation
This section provides Documentation of the bot's commands and examples of correct usage.Notes:
< and > are used to represent mandatory command input, [ and ] are for optional input. Do not include the brackets when typing the command.
-
Advertising
ad, bump, register Bot-related commands
donate, error, help, info, invite, ping, stats, suggest, tip, vote Global
addserver, appeal, delserver, ranks, report, rules Images
banne, blorp, dab, dafuq, delet, doge, facepalm, gay, grr, heck, jebus, knuckles, ohno, oof, oops, panic, sadde, thonk, umm, wat, wink, yay Miscellaneous
avatar, balance, poll, profile, quote, server, user Moderation
autorole, ban, disable, enable, filter, goodbye, kick, prune, warn, welcome Music
clearqueue, leave, pause, play, queue, resume, skip, volume
Advertising
Commands related to the advertising functionality of the bot$-ad
Usage: $-adGet a preview of your server's ad sent to your DMs.
Possible Errors:This command can only be used in a guild
NO_ADVERT
This command only works if your server has a registered ad
$-bump
Usage: $-bumpBump your server's ad to the designated bump channel on the bot's main server.
Possible Errors:This command can only be used in a guild
LATEST_BUMP
Your server's ad is already the most recently bumped ad
NO_ADVERT
This command only works if your server has a registered ad
$-register
Usage: $-register <ad>Register an ad for your server.
Possible Errors:The length of an ad cannot exceed 1500 characters
INVALID_SCOPE
This command can only be used in a guild
MISSING_PERMS
This command can only be executed by server admins
NO_INVITE
Server ads must include a discord.gg invite link
Bot-related Commands
Commands related directly to the bot$-donate
Usage: $-donateGet a link to our PayPal so you can donate to us.
$-error
Usage: $-error <report>Send a bug report to the bot creator so it can be fixed.
Possible Errors:The command must include an actual error report
$-help
Usage: $-help [command]Get a list of commands, or get help for a specific command.
$-info
Usage:$-info ads
$-info global
$-info images
Get information about some of the things the bot does
Possible Errors:Info topic must be one of the phrases listed in this command's usage
$-invite
Usage: $-inviteGet an invite link to the bot, the bot's server, the bot's website, and our partner bot.
$-ping
Usage: $-pingCheck the network connection speed of the bot, and how many computations per second its currently processing (TPS).
$-stats
Usage: $-statsView some of the bot's statistics, such as how many users it currently has, how many servers it's in, and more.
$-suggest
Usage: $-suggest <suggestion>Send a suggestion for the bot to the creator. If your suggestion is accepted, you'll be granted one point.
Possible Errors:The command must include an actual suggestion
$-tip
Usage: $-tipRecieve a random tip regarding bot usage.
$-vote
Usage: $-voteGet a link to the bot's upvote page on Discord Bot List.
Global
Commands related to the bot's global chat functionality$-addserver
Usage: $-addserverThe channel you type this command into will be linked to the bot's global chat.
Possible Errors:Global chat can only have 50 connected servers. Your server will be added to a queue and linked up once a slot is available
GUILD_CONNECTED
Your server can only have one channel linked to global chat
INVALID_SCOPE
This command can only be used in a guild
MISSING_PERMS
This command can only be executed by a server admin
$-appeal
Usage: $-appeal <message>Send an appeal to the bot creator if you've been banned according to our global ban policy.
Possible Errors:This command can only be executed by members on our global ban list
$-delserver
Usage: $-delserverThis will unlink your server from global chat. An alternative is to delete your server's global channel.
Possible Errors:This command can only be used in a guild
MISSING_PERMS
This command can only be executed by a server admin
NO_LINK
This command only works if your server is linked to global chat
$-ranks
Usage: $-ranksView a list of the available global ranks.
$-report
Usage: $-report <user> <action>Report a user for violating our global ban policy.
Possible Errors:Must include a user to report as well as a reason for the report
$-rules
Usage: $-rulesView the rules that you must follow in the global chat.
Images
These commands are for sending 'reaction' images$-banne
$-blorp
$-dab
$-dafuq
$-delet
$-doge
$-facepalm
$-gay
$-grr
$-heck
$-jebus
$-knuckles
$-ohno
$-oof
$-oops
$-panic
$-sadde
$-thonk
$-umm
$-wat
$-wink
$-yay
Miscellaneous
Various commands that don't quite fit any other category$-avatar
Usage: $-avatar [mention]View your profile pic, or include a user mention to view their profile pic.
Possible Errors:If you provide an input to this command, it must be a valid user
$-balance
Usage: $-balanceView your current points balance (earn points with $-suggest).
$-poll
Usage: $-poll <question> <options>Post a poll with a question and up to 5 answers for people to vote on. Use a question mark and a space ( ? ) to separate the question from the answers, and use a comma and a space ( , ) to separate the answers from each other.
Example: $-poll Who is the best? me, you, someone else, that one, that other personPossible Errors:
Input data must follow the format stated above
MISSING_ARGS
Command must include a question and 2 to 5 possible options to vote on
$-profile
Usage:$-profile set bio <type your bio here>
$-profile set birthday <month.day.year>
$-profile set gender <your gender>
$-profile set height <feet.inches>
$-profile set name <your name >
Set up your own profile or view another user's profile. Leave [mention] field blank to view your own profile.
Examples:$-profile set birthday 7.27.2000
$-profile set gender Female
$-profile set height 6.0
$-profile set name cheesits456
Possible Errors:
You'll get this error if you try to set a value that doesn't exist, for example $-profile set weight, or if you try to get the profile of a user that doesn't exist
INVALID_SETTING
You haven't used the correct formatting when setting a value; the error message will contain the information you need
MISSING_ARGS
You'll get this error if you try to execute $-profile set without providing any other input
NaN
Some settings require numbers as input - if you don't provide numbers, you'll get the NaN error (Not a Number)
$-quote
Usage:$-quote <message ID> [channel ID]
$-quote <message ID> [guild ID]
Recall a message based on its ID. If the message is in a different channel from the one you execute the command in, you must provide either the ID of the guild its in, or the ID of the channel.
Possible Errors:You'll receive this error if the quoted message is above 256 characters, if its an NSFW channel's quote being quoted into a non-NSFW channel, or if the specified message ID can't be found
MISSING_ARGS
You must provide at least a message ID for this command to work
$-server
Usage: $-serverView information about the server this command is executed in. Info includes server age, channel count, global chat channel, ID, member count, server name, and owner username/discriminator.
$-user
Usage: $-user [user info]Get detailed information about a user account. The command input [user info] can be a username, discriminator, ID, or @ mention. Leave the input blank to view your own user information.
Examples:$-user cheesits456
$-user 306018440639152128
$-user @cheesits456#6494
Possible Errors:
You'll receive this error if the command input doesn't match any known user account
Moderation
Commands to assist you in staffing your server$-autorole
Usage:$-autorole <role mention>
$-autorole disable
Set up or disable autorole, or view the current autorole status on your server.
Possible Errors:Autorole can only be set to a valid role on your server
INVALID_SCOPE
This command can only be executed in a guild
MISSING_PERMS
This command can only be executed by a server admin
$-ban
Usage: $-ban <mention> [reason]Ban the mentioned user from your server. If [reason] is provided, it'll appear in your server's audit log.
Possible Errors:This command can only be executed in a guild
MISSING_ARGS
Must include a user to ban
MISSING_PERMS
Both the bot and the user executing this command must have the Ban Members permission
$-disable
Usage: $-disableDisable the bot in the channel you type this command in. This will prevent the bot from responding to any command in that channel, aside from $-enable. This will not prevent the bot from using the filter function in that channel. To prevent that, deny the bot's permission to delete messages in that channel.
Possible Errors:This command can only be executed by a server admin
INVALID_SCOPE
This command can only be executed in a guild
$-enable
Usage: $-enableRe-enable the bot's ability to respond to commands in a channel that you've previously used $-disable in.
Possible Errors:This command can only be executed by a server admin
INVALID_SCOPE
This command can only be executed in a guild
$-filter
Usage:$-filter remove <word>
$-filter clear
$-filter list
Set up your server's filter, view the list of filtered words, or clear your filter.
Possible Errors:Filter can only have up to 10 terms in it
INVALID_FILTER
Your filter must include a word that you are trying to remove from it
INVALID_INPUT
Command input keywords must match the documentation above
INVALID_SCOPE
This command can only be executed in a guild
MISSING_ARGS
Must include all mandatory command input
MISSING_PERMS
This command can only be executed by a server admin
NO_FILTER
You can't execute certain filter functions if your server doesn't have a filter
$-goodbye
Usage:$-goodbye message <message>
$-goodbye disable
Variables:
{count} Server's new user count
{discrim} Leaving user's discriminator
{mention} Mention the leaving user
{server} Server's name
{username} Leaving user's username
Set up goodbye messages for when members leave your server
Examples:$-goodbye message Goodbye, {username}#{discrim}. The server now has {count} members.
Possible Errors:
The specified channel has to be a channel that exists on your server
INVALID_INPUT
Command input must match the formatting listed in the above documentation
INVALID_SCOPE
This command can only be executed in a guild
$-kick
Usage: $-kick <mention> [reason]Kick the mentioned user from your server. If [reason] is provided, it'll appear in your server's audit log.
Possible Errors:This command can only be executed in a guild
MISSING_ARGS
Must include a user to kick
MISSING_PERMS
Both the bot and the user executing this command must have the Kick Members permission
$-prune
Usage:$-prune <number> bot
$-prune <number> user
$-prune <number> [mention]
Bulk delete messages from a channel. If no input is provided aside from <number>, it'll simply delete the previous <number> messages. If user is included, it will be limited to deleting user messages. If bot is included, it will be limited to deleting bot messages. If a user mention is provided, it will only delete messages from the specified user.
Possible Errors:Filter can only have up to 10 terms in it
INVALID_FILTER
Your filter must include a word that you are trying to remove from it
INVALID_INPUT
Command input keywords must match the documentation above
INVALID_SCOPE
This command can only be executed in a guild
MISSING_ARGS
Must include all mandatory command input
MISSING_PERMS
This command can only be executed by a server admin
NO_FILTER
You can't execute certain filter functions if your server doesn't have a filter
$-warn
Usage:$-warn channel <channel mention>
$-warn global <true|false>
After setting the warn channel, you can use this command to warn users for breaking your server's rules. Executing this command will cause the bot to DM the mentioned user, as well as post a warning in the set warning channel for your staff to see. If you enable global warnings, then every time a member joins your server, it checks if they've been put on our watchlist for violating our global ban policy. If they have, the bot posts a warning in your server's warning channel, and you or your staff team can take whatever action you feel is necessary.
Possible Errors:$-warn global must be set to either true or false
INVALID_CHANNEL
Warning channel must be set to a channel that exists within your guild
INVALID_INPUT
Command input must match the documentation above
INVALID_SCOPE
This command can only be executed in a guild
MISSING_ARGS
Must include all mandatory command input
MISSING_PERMS
Warning channel can only be set by a server admin, and users can only be warned by members with the KICK_MEMBERS permission
$-welcome
Usage:$-welcome message <message>
$-welcome disable
Variables:
{count} Server's new user count
{discrim} New user's discriminator
{mention} Mention the new user
{server} Server's name
{username} New user's username
Set up welcome messages for when members join your server
Examples:$-welcome message Welcome to **{server}**, {mention}! You're member #{count}.
Possible Errors:
The specified channel has to be a channel that exists on your server
INVALID_INPUT
Command input must match the formatting listed in the above documentation
INVALID_SCOPE
This command can only be executed in a guild
Music
Due to latency issues, the Music feature will most likely be removed from this bot, and as such, no documentation will be provided. For a more enjoyable music experience, try our partner bot.