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



Permissions: Manage server or Bot commander role

Set the interest rate of the bank.

Interest is applied to users bank balance every 12 hours.

Maximum: 15.00% Minimum: -100%


Example: set-interest-rate 4%

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

unlock-channel [channel or all]



Permissions: Manage channels or Bot commander role

Unlock channels for earning money from chatting.

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


Example: 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.

(This has a cooldown to prevent any spam)


Example: chat-money min 14

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 (case-sensitive) as the amount.


Example: add-money unbelievable 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 Member 350

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 (case-sensitive) as the amount.


Example: remove-money unbelievable 280

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

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

withdraw <amount or all>

Withdraw money from your bank.


Example: withdraw 100

give-money <member> <amount>

Give another member your money :)


Example: give-money unbelievable 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
  • Deposit money to the bank, to earn interest

Command Description

add-reply <command> <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.


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

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-fail-reply <command> <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.


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

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

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 export custom replies.


Example: delete-reply 274

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


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

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

~~split - split into two hands, only if you have two of the same card~~

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


Example: blackjack 250

roulette <bet> <space>

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


Example: roulette 350 odd

roulette-info

Displays information about the roulette

cock-fight <bet>

Place your bets, and send your chicken off to fight, and hope it comes back in all pieces.

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

You can only own 1 chicken at a time.


Example: cock-fight 250

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 OR roll pizza, more pizza, pineapple


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.

edit-item <option (see list)> <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:

name - item name.

price - item price.

description - item description.

inventory - whether this item shows in your inventory. (yes = show in inventory, no = don't)

role - role you are given when buying (non-inventory item) or using (inventory item) the item. (leave blank to remove)

duration - amount of time the item will stay in the store (e.g. 3 days), enter 0 for no limit.

stock - amount of stock left, enter Infinity for no limit.

reply - message the bot replies with when the item is "used".


Example: edit-item description 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

store [page]

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


Example: store 3

inventory [member] [page]

View your's 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 jake 5 pizza

buy-item [quantity] <item name>

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


Example: buy 10 pizza OR buy 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

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



Permissions: Manage server or Bot commander role

Give a member an item from the store.

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

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


Example: give-item unbelievable 6 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 unbelievable 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

message-delete-channel <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: message-delete-channel enable #message-log

mod-log <enable | disable> [channel]



Permissions: Manage server

Set the channel to log moderation commands.


Example: mod-log enable #moderation-log

mod-role <enable | disable> [role]



Permissions: Administrator

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


Example: mod-role enable @Moderators

muted-role <create | set> [role]



Permissions: Manage roles

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


Example: 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.

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 lizard 5d Too much of a weeb

soft-ban <member> [reason]



Permissions: Kick members or Moderator role

Kicks a user from the server, deleting a day's 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.

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>

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

punishments [user]

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

reason <case ID> <new reason>

Edit the reason for an existing punishment.


Example: reason 25 spam

purge <limit> [user | -bots | -users]



Permissions: Manage messages or Moderator role

Delete messages.

The limit is capped at 100.

If a filter is provided, messages within the limit will be checked against it to find any matches.


Example: purge 100 OR purge 10 -bots OR purge 50 unbelievable

lock-down [channel] [duration]



Permissions: Manage channels or Moderator role

Lock down a channel, to prevent anyone sending messages. (Unless they have Administrator permission, or Send Messages is set to Allow in channel permissions for a role they have.)

If no duration is provided, the channel is locked-down until the command is run again.


Command Description

remind-me <duration> <description>

Receive a reminder in your DM's after the specified amount of time.

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


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

never-have-i-ever

Gives you a "never have I ever" question.


Command Description

server-info

Shows various information and data of the server.

user-info [user]

Shows various information and data on the mentioned 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. (Max. 3)

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


Example: auto-role add Member

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

join-role <role name>

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

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

bot-commander <enable | disable> [role]



Permissions: Administrator

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

Moderation commands are excluded from this.


Example: bot-commander enable @Commanders

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.


Example: member-agree enable #welcome @Member

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



Permissions: Manage server

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

Include the {embed} tag at the end, if you want the message to be an embed.

Other Tags: https://unbelievable.pizza/tags


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

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



Permissions: Manage server

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

Include the {embed} tag at the end, if you want the message to be an embed.

Other Tags: https://unbelievable.pizza/tags


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

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.

To give your suggestion for the bot, join the support server and use this command in #bot_commands.


Example: suggestions enable #suggestions

suggest <suggestion>

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

export <option>



Permissions: Administrator

Export data for easier configuration.

Options: money custom-replies


Example: export money




Command Description

disable <name>



Permissions: Manage server

Disable a command or module.

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


Example: disable slut or disable command:reminders

enable <name>



Permissions: Manage server

Enable a command or module.

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


Example: enable slut or enable command:reminders or enable module: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 allow slut or channel-override allow module:economy

test <name>

Test whether a command or module will work in that channel.

If a command and module have the same name, you can specify which using the following format:

command:reminders or module:reminders


Example: test slut or test command:reminders


Command Description

help [command | module | all]

Get help on using the commands


Example: help money or help module:reminders

invite

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

discrim [discriminator]

Find users with the same discriminator as you.

donate

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

verify-donation <paypal transaction id>

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

USE THIS COMMAND IN THE BOT'S DM


Example: verify-donation 36C38912MN9658832




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