**Rocket Gambling Bot (RGB)** is a Discord Bot that (you guessed it) adds a fun gambling mechanism to Discord.

_Gamers love RGB! 😂_

You can compete with your friends to get the top score on the leaderboards, earn achievements, experience points, 
virtual cash, find and buy swag in the shop (there are leaderboards for owning these too!)

[Join the Discord Server](https://discord.gg/U4zfgHXqjz) server to play with the bot, or add it to your server!

# Permissions

There are two modes for the bot. Recommended mode gives the best player experience and uses message reactions for a lot of the games (like blackjack and hol). It reduces the clutter in your game channels and is generally more fun.

Minimum mode relies on typed responses to games. The games work exactly the same other than that and only a few games are unavailable in 'Minimum' mode (like Connect Four).

The bot only ever adds reactions to or edits its own messages and will not use these permissions to touch any other messages.

If you would like to force it to use the commands all the time you can call `$guildConfig forceCommands true` which will disable all reaction-based verions of games and force commands instead. (Disable with `$guildConfig forceCommands false`)

If you are having trouble, join the Support Server and ask for help ❤️

## Recommended Permissions
[Bot Invite Link](https://discord.com/oauth2/authorize?client_id=800383254389194754&scope=bot&permissions=354368)

`ADD_REACTIONS`: Allows the bot to add reactions to its own messages. Some games can't work without this, others will fall back to 'message' based responses

`MANAGE_MESSAGES`: Allows the bot to _remove_ user reactions from its messages in order to allow the user to react multiple times with the same reaction.

Also requires the minimum permissions below

## Minimum Permissions
[Bot Invite Link](https://discord.com/oauth2/authorize?client_id=800383254389194754&scope=bot&permissions=346112)

`SEND_MESSAGES`: Required so the bot can respond to commands (you’ll only see this message when you are missing this permission)

`READ_MESSAGE_HISTORY`: Required to let the bot 'remember' the games it is currently playing

`EMBED_LINKS`: All the games and commands use Embed messages to make the games nicer to look at

`USE_EXTERNAL_EMOJIS`: Most of the games use custom emoji to give a better experience that aren’t available as a standard emojis


# A brief history

I'm a Software Engineer and have been working on the bot in my spare time. It started as an interesting project 
in one of the servers I frequent and grew into a small gambling bot with 'higher or lower' and blackjack.

I was playing with other great discord bots and noticed that they were a bit dubious with consistency across 
the games and many were rife with bugs. The game messages were a bit ugly in a few and the games were simple 
and not that engaging.

I have tried to resolve all of these in my own bot, making the two available games more engaging and driving 
competition between members of the server.

Seeing how much fun people were having with the bot, I then thought other people might want to play with the 
bot so split the games out to a separate bot, added more games and **Rocket Gambling Bot** was born!!!


# Using the bot

For up-to-date commands, see the `$help` command.

The command is populated automatically so will always be the most accurate list.

List help for any command with `$help <command>` (e.g. `$help blackjack` or `$h bj`)


# Features

## Guild Configuration

_Default access is guild owner and anyone with the `MANAGE_GUILD` role_

- Add bot admins without needing to be owner or have any permissions
- Set a nickname for the bot
- Change the prefix
- Set a specific channel for the bot to use (it won't respond in other channels)


## Player commands

- Work every 10 minutes to get cash for more games (base between 100 - 500)
- Earn Daily cash with `$daily` (base between 1,000 - 5,000)


## Current Games

List all the current games with `$help games`, the list below may be outdated as the bot is being updated regularly!

- Blackjack 
- Crash
- Dice Roll (d4 -> d20)
- Higher or lower
- Race (turtle, dog, horse and DINOSAUR!)
- Rock Paper Scissors
- Roulette
- Slots

### Multiplayer Games

- Connect Four (the A.I to play against the bot with gambling is in progress but multiplayer is working)


## Planned Games

- Baccarat
- Coin Flip
- Hangman (single and multiplayer)
- Texas Hold'em Bonus (Poker vs Dealer)
- Unscramble (timed anagram solving + speed-anagram solving events)
- _AND MANY MORE!!_


## Leaderboards

Call `$leaderboard` to see the list of all leaderboards, or `$leaderboard <game>` for a specific leaderboard.

Every game has a leaderboard with either 'most wins' or 'most cash won' (depending on the game)

There are also leaderboards for:

- Player Level
- Current cash
- Max cash (i.e. the max amount ever owned)
- Total cash (i.e. the sum of all cash ever owned)
- Item leaderboards to match cash (WIP)


## Economy

Call `$shop` to see the shop, `$shop buy 1 <itemId>` / `$shop sell 1 <itemId>` to buy and sell items!

Buy and sell items in the shop to get to the top of the leaderboards!

Find special items by playing games that can't be bought in the shop!


## Achievements & Levelling

Call `$achievements` to list all your achievements

View all your stats with `$me`

Earn experience from achievements and gambling!

Every leaderboard is linked to an achievement, get achievements for cash, finding items, winning games and more!

Increase your betting maximum by levelling up!



## Donation rewards

See [Patreon](https://patreon.com/rocket_gambling_bot/) for full details of tiers and rewards

See the #donate channel in the support server for other kinds of donations available


### Personal rewards

- Access to `$weekly` cash (base between 5,000 - 10,000)
- Access to `$monthly` cash (base between 100,000 - 500,000)
- Access to `$yearly` cash (base between 10,000,000 - 50,000,000)
- Cash command multipliers - top tier donators get 5x cash from _all_ cash commands above! That's up to 250,000,000 for yearly!
- Reduce (or even remove) cooldowns between games
- Reduce your personal sales tax on items
- Increase your betting maximum!

#### Guild Rewards

- Set a custom `cash` name and emoji for your server
- Reduce item sales taxes

TheBotDev Community

Support server + community for the Rocket Gambling Bot

Voting for TheBotDev Community