Starboard is an advanced, reliable, and highly customizable starboard bot, allowing for multiple starboards, multiple emojis, auto-star channels, and much more coming!
This documentation gives you a quick start to using the bot. If you see a problem, please let me know, either by using the bots suggest command or joining the support server. My discord username is
Invite Starboard to your server
Join the support server
Supports multiple starboards
Advanced Channel/Role Whitlisting/Blacklisting
AutoStar Channels (media channels)
Supports multiple normal and custom emojis for each starboard
Leveling, rank, and leaderboard
Award Roles (XP Roles and Position-base Roles)
Starboard moderation, such as:
Freezing a message, preventing the points from updating on it
Forcing a message, so it’s on the starboard no matter what
Trashing a message, in case a bad message gets on the starboard
Advanced customization, giving you complete control over the bot
If you have any suggestions or found any bugs, please create an issue.
Note: Don’t actually type out
< > [ ] when I give you commands to run. Replace
[p] with the actual bot prefix which is
sb! by default.
channel means type “channel”, where as
<channel> means replace “<channel>” with the name of the channel.
Invite the bot to your server
[p]setupand use the setup wizard to create your starboard!
Once completed you can continue to use the setup wizard to modify the settings of the starboard (like emoji being used). A complete list of settings is available in the wiki.
Invite the bot to your server
Create a channel for the bot (name it something like #starboard). You can also use a existing channel
[p]starboards add <channel>(“<channel>” is the name of the channel you are using)
[p]starboards <channel>to view all the settings for this starboard!
The starboard is now good to go, but you might want to change more settings (like the number of reactions needed). A complete list of settings is available in the wiki.
These directions are for self-hosting the bot. If you just want a working bot, you can invite the main bot to your server instead.
What you will need:
- Something to run the bot on
- A Discord bot application from the Discord Developer Portal
- A Python 3.6 or higher installation
- A PostgreSQL database
Clone the repo by running
git clone https://github.com/CircuitsBots/Starboard.gitin the command line.
Make a copy of
bot_config.py.example, and rename it to
Update the settings to your liking. If you need help with this, you can join the support server. You only need to edit the first two lines, and you can just leave the others the same for now.
Create a file called
.env, and inside it paste the contents of the
.env.examplefile. The only required fields are
DB_PASSWORD. If you wish to have statistics for your bot you can fill out
STATCORD_TOKENwith a token from Statcord
If your database is not on the same device as the bot or has a different default user/database you maybe need to edit the bot to account for this. First, head over to the
database/database.pyfile. Second, open the file in a text editor and scroll down to line 249 (as of time of writing). Here you will find the connection config. You can edit the database host, dabasase name, and database user to suit your setup.
Now you need to install the dependencies required for the bot to run. These can be found in the
- Finally run
python bot.pyto run the bot!
If you see a bug or possible improvement and want to help out, you can fork this repostory, make the edits, and then create a pull request. Make sure to look at the guidelines in
CONTRIBUTING.md. I really appreciate any help that you can give.