This project has a complementary web interface that you can use to control or configure your experience

Web Interface

This project has leaderboards highlighting the top players within either the server or globally

Leaderboards

Automatically grant roles to users who achieve configured requirements

Automatic Roles

This bot offers extra features or perks that can be unlocked through optional payments or subscriptions.

Paid Features Available

Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features

# 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投票

你想要支持我们吗？