UnbelievaBoat - Commands
Command Prefix

Default: ! or @mention
Example: !help or @UnbelievaBoat#1046 help


Command Usage Syntax
[] - optional parameter
<> - required parameter
<thing1 | thing2> - select one of these options
    - configuration command (if these commands are entered without any parameters, it will tell you the current setting)

(DO NOT INCLUDE THESE WHEN TYPING THE COMMAND)

Command Description

set-starting-balance <amount>



Permissions: Manage server or Bot commander role

Set bank balance members joining your server start with.

Set this to 0 if you want to disable it.


Example:
set-starting-balance 200

set-currency <new symbol>



Permissions: Manage server or Bot commander role

Set the currency symbol to use.

You can use anything for this, including emojis.


Example:
set-currency $
set-currency 💰

lock-channel [channel or all]



Permissions: Manage channels or Bot commander role

Lock channels from earning money from chatting.

If no channel is given, the current channel will be locked.


Example:
lock-channel #general
lock-channel all

unlock-channel [channel or all]



Permissions: Manage channels or Bot commander role

Unlock channels to earn money from chatting.

If no channel is given, the current channel will be unlocked.


Example:
unlock #general
unlock all

chat-cooldown <duration>



Permissions: Manage server or Bot commander role

Set's the cooldown between messages for earning money.


Example:
chat-cooldown 10 seconds

chat-money <min | max> <amount>



Permissions: Manage server or Bot commander role

Sets the minimum or maximum you could receive for each message sent.

Channels have to be unlocked (using the unlock-channel command) for chat-money to be enabled.

(This has a cooldown to prevent any spam)


Example:
chat-money min 14
chat-money max 55

add-money [cash | bank] <member> <amount>



Permissions: Manage server or Bot commander role

Add money to a member's cash or bank balance.

If the cash or bank argument isn't given, it will be added to the cash part.

For an infinite amount of money use Infinity as the amount.


Example:
add-money @user 350
add-money bank @user 350

add-money-role [cash | bank] <role> <amount>



Permissions: Manage server or Bot commander role

Add money to the cash or bank balance of every member in a role.

Bots are not included.

If the cash or bank argument isn't given, it will be added to the cash part.


Example:
add-money-role @Members 350
add-money-role bank @everyone 200

remove-money [cash | bank] <member> <amount>



Permissions: Manage server or Bot commander role

Remove money from a member's cash or bank balance.

If the cash or bank argument isn't given, it will be removed from the cash part.

For an infinite amount of money use Infinity as the amount.


Example:
remove-money @user 280
remove-money bank @user Infinity

remove-money-role [cash | bank] <role> <amount>



Permissions: Manage server or Bot commander role

Remove money from the cash of every member in a role.


Example:
remove-money-role @Muted 950
remove-money-role bank @Muted 950

bank

Check the total bank balance for the server, and current interest rate.

Related Commands

withdraw - takes money out of your bank to your cash

deposit - puts money from your cash into your bank

deposit <amount or all>

Deposit money to your bank.


Example:
deposit 500
deposit all

withdraw <amount or all>

Withdraw money from your bank.


Example:
withdraw 100
withdraw all

give-money <member> <amount>

Give another member your money :)


Example:
give-money @user 480

money [member]

Check your balance, or the balance of another member.

leaderboard [page]

Displays the money leaderboard for the server.

To remove users from the leaderboard that are no longer in the server, use the clean-leaderboard command.

clean-leaderboard



Permissions: Manage server or Bot commander role

Removes anyone from the leaderboard that are no longer in your server.

This resets their money to 0, and removes them from the leaderboard.

reset-money [user]

Reset your money, or another user's money.

reset-economy



Permissions: Manage server or Bot commander role

Resets everyone's balance back to 0.


How to earn money?
  • Contribute to chat in text channels (only in unlocked channels)
  • Play games
  • Go to work, be a slut, commit a crime, or try to rob another member's cash
  • Role income

Command Description

role-income add <role> <cash | bank> <amount> <interval> [<channel> <message>]
role-income list
role-income info <id>
role-income remove <id>



Permissions: Manage server or Bot commander role

Role income can be used to give (or take) money from members in a role at the interval you set.

Role income can be a fixed amount (e.g. 100) or a percentage of the chosen destination (e.g. 10%).

Role income can go to the cash or bank part of the member balance.


Example:
role-income add @VIP cash 100 12h
role-income add @everyone bank 5% 1d
role-income add @VIP cash 100 12h #updates {role.name} just received £100!
role-income list
role-income info 1
role-income remove 3

set-cooldown <command> <cooldown>



Permissions: Manage server or Bot commander role

Set the cooldown for the work, slut, crime or rob commands.


Example:
set-cooldown work 3m

add-reply <work | slut | crime> <reply text>



Permissions: Manage server or Bot commander role

Add a custom reply for work, slut or crime.

Put {amount} in place of where you want the amount earned to be.

{amount} is just a placeholder for where the amount will be generated.

You can change the range using the set-payout command.

Use the delete-reply command to remove a custom reply you've added.


Example:
add-reply crime You kidnap a bride and take her hostage for {amount}

list-custom-replies [work | slut | crime]



Permissions: Manage server or Bot commander role

List the custom replies for your server.


Example:
list-custom-replies work

add-fail-reply <slut | crime> <reply text>



Permissions: Manage server or Bot commander role

Add a custom fail/fine reply for slut or crime.

Put {amount} in place of where you want the fine amount to be.

{amount} is just a placeholder for where the amount will be generated.

You can change the fine range using the set-fine-amount command.

Use the delete-reply command to remove a custom reply you've added.


Example:
add-fail-reply crime You were caught trying to rob an old lady, and have been given a {amount} fine!

delete-reply <ID>



Permissions: Manage server or Bot commander role

Delete a custom reply you've added for work, slut or crime.

You can get the ID of the reply using the command list-custom-replies.


Example:
delete-reply 274

default-replies <enable | disable>



Permissions: Manage server or Bot commander role

Whether to use the default replies to work, slut, and crime.


Example:
default-replies disable

set-fine-amount <command> <min | max> <amount>



Permissions: Manage server or Bot commander role

Sets the minimum or maximum fine amount/percentage for slut or crime

Use the fine-type command to switch between percentage (of networth) or set amounts.

Make sure the type and range match, to prevent something like a 400% fine.


Example:
set-fine-amount slut max 30%
set-fine-amount crime min 10

set-payout <command> <min | max> <amount>



Permissions: Manage server or Bot commander role

Sets the minimum or maximum payout for work or slut or crime


Example:
set-payout slut max 240
set-payout work min 30

set-fail-rate <command> <percentage>



Permissions: Manage server or Bot commander role

Sets the fail rate (e.g. 70%) for slut or crime.

The higher the percentage, the more chance there is for getting fined.


Example:
set-fail-rate crime 60%

set-fine-type <amount | percentage>



Permissions: Manage server or Bot commander role

Sets whether the fine is a percentage or fixed amount.

The range can be changed using the set-fine-amount command.

Make sure the type and range match, to prevent something like a 400% fine.


Example:
set-fine-type amount
set-fine-type percentage

work

Work, work, work, work, work. This command has no chance of getting fined.

slut

Whip it out, for a bit of quick cash ;)

(Some of these may be a bit NSFW)

crime

Commit a crime, this has more risk but a higher payout

rob <member>

Rob another member's money!

You can only attempt to rob the cash part of their balance.

Probability (of failing): your networth / (their cash + your networth).

The amount you are fined, if unsuccessful, is the same as the crime command.


Example:
rob @user

Command Description

set-game-cooldown <usages> <duration>



Permissions: Manage server or Bot commander role

Set the cooldown for games.

The example shown will allow you to play each game 4 times every 5 minutes.


Example:
set-game-cooldown 4 5m

slot-machine-symbol <add | remove> <symbol | all> [multiplier]



Permissions: Manage server or Bot commander role

Add your own emotes or symbols for the slot machine.

The multiplier for calculating the win payout can be set, and defaults to 1.

After adding custom symbols the defaults are no longer used.

To revert back to the defaults remove all.

Defaults: 🍑, 🍍, 🍆, 🍕, 🍺, 🥐


Example:
slot-machine-symbol add 🍔
slot-machine-symbol add 🍕 2.5
slot-machine-symbol remove all

roulette <bet> <space>

Start a game of roulette, or place your bet in an existing game.


Example:
roulette 100 odd
roulette 100 3rd
roulette 100 13-24
roulette 100 16

blackjack <bet>

Play a game of blackjack for money.

The aim of blackjack is to beat the dealer's hand, without going over 21.

hit - take another card

stand - hold your cards and end your turn

double down - double your bet, and take 1 more card


Example:
blackjack 100

roulette-info

Displays information about the roulette

cock-fight <bet>

Place your bet and send your chicken off to fight.

The more times your chicken wins, the stronger it gets!

You start out with a 50% chance of winning, increasing by 1% each time it wins up to a total of 70% chance of winning.

You can only own 1 chicken at a time.


Example:
cock-fight 100

russian-roulette <bet>

Play a game of Russian Roulette.

The first player to place a bet is the controller of the game. This means all further bets have to be the same, and they decide when the game starts.

When the game starts, each player takes it in turn until somebody loses. The losers bet is distributed amongst the winners.

Players: 2 to 6


Example:
russian-roulette 100

roll [max number or options to choose from]

Roll a dice, or select a random option from the given list.

Specify how many side the dice has (default 6 sided)

Or provide a list of things to choose from (separated by a comma)


Example:
roll 6
roll pizza, more pizza, pineapple

slot-machine <bet>

Bet on the slot machine. If you get three in a row on the middle row, you win!

Your winnings are calculated by multiplying your bet by the symbol multiplier.

Use the slot-machine-symbol command to use your own symbols, or change the probability of winning.


Example:
slot-machine 100

What could items be used for?
  • Link a role, to allow access to secret channels
  • Link a role, to allow purchase of "coloured roles"
  • Sell something with a limited amount of time to buy
  • Sell something with a limited quantity
  • Provide a custom reply when the item is bought, or used

Command Description

create-item [item name]



Permissions: Manage server or Bot commander role

Create an item for your store.

Use this command without any arguments to be guided through every option, and type cancel at any point to stop.

Use this command, with the item name, to create a "simple" item you can edit later.


Example:
create-item
create-item Pizza

edit-item <option> <item name> [new value]



Permissions: Manage server or Bot commander role

Edit an existing item in the store.

If the item's name contains spaces, put it inside double quotes "like this".

Options: Use the item-options command to view the different options.


Example:
edit-item name "Some Pizza" Pizza
edit-item price "Some Pizza" 15
edit-item description "Some Pizza" Can't go wrong with pizza

delete-item <item name>



Permissions: Manage server or Bot commander role

Delete an item from the store.


Example:
delete-item Pizza

item-options

View the different options available for editing an item.

store [page]

View a list of items available to buy in the store.


Example:
store 3

inventory [member] [page]

View yours or somebody else's inventory

item-info <item name>

View the details for an item.


Example:
item-info Pizza

sell-item <member> [quantity] <name>

Sell an item in your inventory to another member for money.


Example:
sell-item @user 5 Pizza
sell-item @user Pizza

buy-item [quantity] <item name>

Buy an item from the store. If no quantity is given, you will buy 1.


Example:
buy Pizza
buy 10 Pizza

use-item [amount] <item name>

Use an item in your inventory.

If the item comes with a role, you will be given this role.


Example:
use-item Pizza
use-item 10 Pizza

give-item <member> [quantity] <item name>



Permissions: Manage server or Bot commander role

Give a member an item from the store, this command also ignores any stock limits.

If no quantity is specified, 1 item will be given.

Use sell-item to give an item from your own inventory.


Example:
give-item @user 6 Pizza
give-item @user Pizza

take-item <member> [amount] <item name>



Permissions: Manage server or Bot commander role

Take (remove) an item from a member's inventory.


Example:
take-item @user Pizza
take-item @user 10 Pizza

A history of all moderation commands used on the server are saved.
You can also keep a log in a separate channel.


Command Description

deleted-message-log <enable | disable> [channel]



Permissions: Manage messages, Manage channels or Bot commander role

Logs messages that have been deleted on the server to a channel.

Bot messages are not logged.


Example:
deleted-message-log enable #message-log
deleted-message-log disable

edited-message-log <enable | disable> [channel]



Permissions: Manage messages, Manage channels or Bot commander role

Logs messages that have been edited on the server to a channel.

Bot messages are not logged.


Example:
edited-message-log enable #message-log
edited-message-log disable

mod-role <enable | disable> [role]



Permissions: Administrator

Enable a role to use moderation commands, without needing the discord permissions.


Example:
mod-role enable @Moderators
mod-role disable

mod-log <enable | disable> [channel]



Permissions: Manage server

Set the channel to log moderation commands.


Example:
mod-log enable #mod-log
mod-log disable

muted-role <create | set> [role]



Permissions: Manage roles

Creates a muted role, or sets an existing role to use.


Example:
muted-role create
muted-role set @Muted

warn <member> <reason>



Permissions: Kick members or Moderator role

Gives member a warning, usually for breaking the rules.

kick <member> [reason]



Permissions: Kick members or Moderator role

Kick a user from the server.


Example:
kick @user
kick @user Did a bad thing

mute <member> [length] [reason]



Permissions: Kick members or Moderator role

Mutes a member from the server. This prevents them from sending messages.

If no length is given they will be muted until un-muted.

Length format examples: 1s, 1m, 1h, 1d, 1w, 1mth, 1y.


Example:
mute @user
mute @user 3d
mute @user 1w Did a bad thing

soft-ban <member> [reason]



Permissions: Kick members or Moderator role

Kicks a user from the server, deleting a days worth of messages.

(Specifically, this bans and then immediately un-bans them)

ban <user> [days delete] [reason]



Permissions: Ban members or Moderator role

Bans user and deletes last x days worth of messages.

If days is not a number, it's treated as the first word of the reason.

Minimum 0 days, maximum 7. Defaults to 0.


Example:
ban @user
ban @user Did a bad thing
ban @user 1 Did a very bad thing

un-ban <user> [reason]



Permissions: Ban members or Moderator role

Unbans a user from the server

un-mute <member> [reason]



Permissions: Kick members or Moderator role

Unmute a muted member. This allows them to send messages again.

view-case <case ID>

View details of a user's punishment. Don't include the # when specifying the case ID

remove-case <case ID> [reason]



Permissions: Kick members or Moderator role

Remove a case id from a user. If this is a ban case, the ban for that user is also removed.

punishments [user] [page]

Shows information regarding a user's punishments in the server (warn / mute / kick / soft-ban / ban)

reason <case ID> <new reason>



Permissions: Kick members or Moderator role

Edit the reason for an existing punishment.


Example:
reason 25 Spam

purge <limit> [user | -bots | -users | -links | -invites | -embeds | -images | -files]

Delete many messages quickly. Any pinned messages are not deleted.

The maximum limit is 1000, and multiple filters can be used.

If a filter is provided, messages within the limit will be checked if they match all filters.


Example:
purge 1000
purge 100 -images
purge 10 -bots -embeds
purge 50 -invites @user

lock-down [channel | server] [duration]



Permissions: Manage channels or Moderator role

If no duration is provided the channel/server will be locked down until the command is used again.

Channel Lockdown

The channel will be locked down for anyone that doesn't have the Send Messages permissions set to allow in the channel settings.

Server Lockdown

This denies the Send Messages permission for the first role that allows Send Messages.

It will lockdown all channels for all users/roles that don't allow the Send Messages permission in the role settings or channel settings.


Example:
lockdown #general 20s
lockdown #general
lockdown server

Command Description

auto-mod-mentions <enable | disable> <amount> <duration> [action] [args]



Permissions: Kick members or Moderator role

Auto moderate mass mentions of users and roles, with a custom amount of mentions and time period. A moderation case is given if an action is provided.

[action] can be any of the normal moderation commands

[args] is the arguments for the normal moderation command. For example for action mute the arguments would be [duration] [reason]


Example:
auto-mod-mentions enable 5 10s ban Too many mentions. ({amount} mentions)
auto-mod-mentions disable

auto-mod-invites <enable | disable> [action] [args]



Permissions: Kick members or Moderator role

When enabled invites are auto deleted, and a moderation case is given if an action is provided.

[action] can be any of the normal moderation commands

[args] is the arguments for the normal moderation command. For example for action mute the arguments would be [duration] [reason]


Example:
auto-mod-invites enable mute 1h Invite link. Code: {invite.code}
auto-mod-invites disable

invites-whitelist <add | remove> <server ID | all>



Permissions: Kick members or Moderator role

Add or remove a server ID to the whitelist, invites to these servers won't be auto-moderated.

The current server is always whitelisted.

all can be used to remove all whitelisted servers.


Example:
invites-whitelist add 305129477627969547
invites-whitelist remove 305129477627969547
invites-whitelist remove all

auto-mod-ignore <add | remove> <user | role | channel | permission> <value>



Permissions: Kick members or Moderator role

Ignore a user/role/channel/discord permission from being auto moderated.

all can be used as the <value> to remove all ignored of a type.


Example:
auto-mod-ignore add role @Moderators
auto-mod-ignore remove permission ban
auto-mod-ignore remove role @Admins

auto-mod-silent <add | remove> <user | role | channel | permission> <value>



Permissions: Kick members or Moderator role

Don't send a confirmation message to the channel when auto moderated.

all can be used as the <value> to remove all silenced of a type.


Example:
auto-mod-silent add channel #welcome
auto-mod-silent remove role @Admin
auto-mod-silent remove user all

Command Description

remind-me <duration> [channel] <reminder>

Receive a reminder in the given channel, or your DM's if no channel is given, after the specified amount of time.

Ensure you have allowed DM's for servers you share with the bot.

Include --everyone to mention everyone in the reminder (only for reminders sent to a channel)


Example:
remind-me 10m Eat more pizza

list-reminders

Show a list of your reminders, and when you will next be reminded

forget-reminder <ID>

Forget a reminder you've set.

Use list-reminders to show a list of your current reminders to get the ID.


Example:
forget-reminder 3

Command Description

dog

Sends a dog picture

cat

Sends a cat picture

never-have-i-ever

Gives you a "never have I ever" question.

dad-joke

Tells a dad joke

say [channel mention] <message>



Permissions: Manage messages

Make the bot send a message in the current channel or a given channel.

Options:

--embed to send the message as an embed.

--everyone enable everyone mentions in the message

--voting add the voting reactions to the message


Example:
say hi
say #general hi --embed --voting
say #general hi @everyone --everyone

akinator

Akinator guesses characters by asking questions.

http://en.akinator.com/

random-user <amount> [reaction] [message ID] [channel]

Host giveaways, or other events that require random user selection from reactions. Amount is how many random users to pick that reacted. External/custom emojis can also be given in the format name:id.


Example:
random-user 5
random-user 1 🎉
random-user 1 bloblul:451430693319475200 460967608968282122
random-user 3 🎉 460967608968282122 #giveaways

reddit <subreddit name>

Retrieves a random hot post from the given subreddit. 18+ subreddits can only be used in channels marked as NSFW.


Example:
reddit memes
reddit funny
reddit cute

Command Description

server-info

Shows various information and data of the server.

role-info <role>

Shows various information on the given role.

user-info [user]

Shows various information for the given user.


Allow members to self assign themselves roles, or enable auto-roles to be given to new members when they join the server.

Command Description

auto-role <add | remove> <role>



Permissions: Manage roles

Adds or removes a role to be given to all new members joining the server.

If no arguments are given, a list of the current auto roles are shown.


Example:
auto-role add @Member
auto-role remove @Moderator

self-role <add | remove> <role>

Adds or removes a role as self assignable.

Roles that are self assignable, any user can assign to themselves.


Example:
self-role add @Updates
self-role remove @Member

join-role <role>

Give yourself one of the self assignable roles.

Use the self-roles command to list the roles you can assign yourself.


Example:
join-role Updates

leave-role <role>

Remove yourself from one of the self assignable roles.

Use the self-roles command to list the roles you can assign yourself.


Example:
leave-role Updates

role-id <role>

Easy and simple way to get the ID of any role.


Command Description

boobs

Sends a NSFW image of boobs

butt

Sends a NSFW image of a butt

rule-34 [search]

Sends a NSFW image from rule34


Command Description

bot-commander <enable | disable> <role>



Permissions: Administrator

Enable a role to use commands that require higher permissions, without having those permissions (e.g. Manage Server).

Moderation commands are excluded from this.


Example:
bot-commander enable @Commanders
bot-commander disable

member-agree <enable | disable> [channel] [role]



Permissions: Manage server

Enable this to require new members to type agree in a channel before being given a role.

This could be used to hide the rest of the server until they type agree.

If you already have the role that's being given or you have the Manage Server permission, none of your messages will be deleted in that channel and you will also be allowed to use commands in that channel.


Example:
member-agree enable #welcome @Member
member-agree disable

user-join <enable | disable> [channel] [message]



Permissions: Manage server

Display a welcome message in a channel when a new user joins the server.

Options:

--embed to send the message as an embed.


Example:
user-join enable #welcome Welcome {user.mention} to {server.name}. We now have {server.members} members!
user-join disable

user-left <enable | disable> [channel] [message]



Permissions: Manage server

Display a goodbye message in a channel when a user leaves the server.

Options:

--embed to send the message as an embed.


Example:
user-leave enable #goodbye Goodbye {user.tag}, you will be missed from {server.name}. We now have {server.members} members!
user-leave disable

prefix [new prefix]

View the bot prefix, or change the prefix if you have Manage Server permission.


Example:
prefix !!

suggestions <enable | disable> [channel]



Permissions: Manage server

Allow your server members to give their suggestions using the suggest command.

These will be posted in this channel to be voted on using reactions.


Example:
suggestions enable #suggestions
suggestions disable

suggest <suggestion>

Add your suggestion to the suggestion channel (if configured using the suggestions command), to be voted on.

export <option>

This command has been replaced with the command list-custom-replies




Command Description

disable <name>



Permissions: Manage server

Disable a command or module.

This can be overridden in specific channels using channel-override.


Example:
disable slut
disable fun

enable <name>



Permissions: Manage server

Enable a command or module.

This can be overridden in specific channels using channel-override.


Example:
enable economy

channel-override <deny | delete | allow> <name>



Permissions: Manage server

Explicitly allow or deny a command/module to be run in the current channel.

This overrides any server disabled modules or commands.


Example:
channel-override deny slut
channel-override allow moderation

test <name> [channel]

Test whether a command or module will work in the current channel, or a given channel.


Example:
test add-money

Command Description

help [command | module]

Get help on using the commands


Example:
help money
help auto moderation

invite

Get an invite link to add this bot to your server.

discrim [discriminator]

Find the number of users with the same discriminator as you.

donate

Provides information on how to donate, and the perks you get.

verify-donation <paypal transaction id> [user]

Verify a PayPal donation to your Discord account, to receive any perks.

If you want the perks to apply to a different user, enter their user ID after the transaction ID.

USE THIS COMMAND IN THE BOT'S DM


Example:
verify-donation 36C38912MN9658832

quote-message <message ID> [channel]

Quotes the message with the given message id and channel. Defaults to the current channel.

Messages can only be quoted from the current server.


Example:
quote-message 305157516847742979
quote-message 305157516847742979 #general

check-upvoted

Check if you have upvoted the bot.


Music is only available on the Donator bot. (https://unbelievable.pizza/donate)
Play or stream music from YouTube, Bandcamp, SoundCloud, Twitch, Vimeo, Mixer, Discord.FM, or any other music URL.
You can join the Support Server to try these commands first for free.


Command Description

play <song name or url>

Search for a song to play/stream on YouTube, or play/stream from a url.

Music providers: YouTube, Bandcamp, SoundCloud, Twitch, Vimeo, Mixer, HTTP


Example:
play Thunder - Imagine Dragons
play https://www.youtube.com/watch?v=ueupsBPNkSc

radio [station name]

Stream a radio station to a voice channel. Use this command without arguments to view a list of the current stations.


Example:
radio BBC Radio 1

pause

Pause or resume the song.

discord-fm [playlist]

Play music from discord.fm playlists (also known as amped.fm). Use this command without arguments to view a list of the current playlists.


Example:
discord-fm chill

stop

Stops playing music, and leaves the voice channel. Use --force if it't refusing to leave.

loop

Repeat the whole queue.

queue [page]

View a list of the queued tracks.

clear-queue [all | user]

Remove yours, someone else, or all tracks from the queue.

Clearing all of the queue requires the Move Members permission


Example:
clear-queue
clear-queue all
clear-queue @user

now-playing

Shows the current song playing.

skip

Skip to the next song in the queue.

volume [number]

Change the volume level to between 0% and 150%.


Example:
volume 50%


Some of the games are based off this repo by Crawl.