# Free Premium 🥳

— Now you AND your friends in your server can vote for Booster Bot  and claim 1 month free premium with 100 votes (combined)

• Check your progress by bb vote command

• Server members can vote & donate their votes by using bb vote donate <count> (votes will be added to server where command is executed)

• Once your server reaches 100 votes, use bb votes avail to get 30 days free premium.

---

# Welcome to Booster Bot!

Hi! Booster Bot can manage, track & log the server boosts events for you in your server.
From sending thankyou/greet message to assigning auto roles on server boost.. .
To allowing boosters to maintain their own personal role (only name and color)


# Getting Started

Setup is quite simple. You can start with **bb help** or **bb guide** command to get step by step instructions.

Mainly there are 3 things in setup

- Make sure your **System Channel** is selected & **Send Message on Server Boost** is enabled (server settings -> overview)
- **bb help setup** - For prefix, bot-manager, auto-role on boost & allowing boosters for personal role.
- **bb help greet** - For thankyou message, channel, image, embeds and other customizations.

> Please set log-channel (`bb setup log-channel #logs`), greet channel (`bb greet channel #boosts`), System Channel and make sure bot has all perms in respective channels for proper functioning.

## Setup

You can start with `.help setup` to see what configurations you can edit & you want to set.
- _You can remove any config anytime by setting it's value to  `none`_
_ex :  `bb setup manager none`  will remove bot manager role._

Setup command will let you add/edit/remove bot settings like :

| Command   |      Example |  Usage |
|----------|:-------------|:-------|
| prefix |  `bb setup prefix !` | It'll change prefix to `!` |
| manager|  `bb setup manager @mods` | Mods role will be able to manage bot settings |
| log-channel |  `bb setup log-channel #bb-logs` | Logs changes related to boosts (role, boost add/remove) etc. |
| add-role|  `bb setup add-role @boosted` | Boosted role will be auto assigned on server boost. But will not be removed automatically if boost is removed. |
| custom-role|  `bb setup custom-role enable` | Will let boosters maintain their personal role. **Role will be deleted if boost is removed by user** |

## Greet

**Setting up greet/thankyou message & channel is necessary** if you want bot to send custom message.

- Bot will send random message & image(if enabled) from a list of custom messages you'll provide one-by-one

To setup message, image, embeds use these commands :

| Command   |      Example |  Usage |
|----------|:-------------|:-------|
| message |  `bb greet message You're cool, hangout with us in #private` | Add this message to custom message list and if you want to reset list : `bb greet message none` |
| image |  `bb greet image https://mediafile-utl.gif` | Same as message, adds image to list and you can clear list by : `bb greet image none` |
| embed|  `bb greet embed disable` | Will not send embed message & It'll ping the booster (Enabled by default) |
| thumbnail |  `bb greet thumbnail server` | Will show server icon as thumbnail if embed is enabled (set to `user` by default) You can also provide custom URL |
| stats|  `bb greet stats disable` | Will not show total boosts & server level on greet message (Enabled my default) |


# For Server Boosters

You claim your custom role by `bb role` command (If enabled my server admins)

- Your auto role (if assigned) will not be removed automatically on removing boost.
- But your custom/personal role will be deleted once you remove your boost.

To maintain personal role : 

| Command   |      Example |  Usage |
|----------|:-------------|:-------|
| claim |  `bb role claim My Role` | Will make a new role `My Role` and assign to booster |
| name |  `bb role name My New Role` | Edit role name to `My New Role` |
| color |  `bb role color ##18DEDE` | Will change role color to `#18DEDE` |
| delete |  `bb role delete` | Deletes your custom role! But don't worry, you can claim it back |

- Also, server boosters can see what roles others claimed by using `bb rolelist` command.
- It'll show role, along with booster that role belongs to and when it was claimed.


# User Commands

When It comes to normal server members, bot provides limited functionalities... but you can always provide your useful suggestions on [Support Server](https://discord.gg/8kdx63YsDf "https://discord.gg/8kdx63YsDf") :

🔗 [https://discord.gg/8kdx63YsDf](https://discord.gg/8kdx63YsDf "https://discord.gg/8kdx63YsDf")

Here is list of commands users can access :

| Command   |      Example |  Usage |
|----------|:-------------|:-------|
| count |  `bb count` | Show server boosts & level statistics  |
| userinfo|  `bb userinfo` | Shows your/mentioned user's boost statistics |
| help |  `bb help` | Shows help general embed / provided command's info (_ex: `bb help ping`_) |
| invite |  `bb invite` | Sends useful invite links (bot's invite, support server invite) in embed. |


> - More commands will be added for users to see boost stats analytics in more representative way.

Your suggestions are always welcomed :)

---

# Please upvote ☝️
Please upvote on top.gg if you liked this bot. It really help a lot.. especially a small bot like this .
Your 1 upvote can make this bot come in suggestion if they want a similar bot.


Booster Bot

Tracking, logging & greeting server boosters. Boost level, custom & auto roles with booster stats and everything related to server boosts.

التصويت لـBooster Bot