Starboard is an advanced, reliable, and highly customizable starboard bot. I’ve been working on this project for a while now, mostly for use in personal servers. When it turned out better than I imagined, I open-sourced it and posted it to bot lists. I hope you find this code and/or bot useful. This documentation gives you a quick start to using the bot. If you see a problem, please let me know. You can use the bots
suggest command, or you can join the support server. My discord username is
Click here for a demonstration
Invite Starboard to your server
Join the support server
- Supports multiple starboards
- Supports multiple normal and custom emojis for each starboard
- Leveling, rank, and leaderboard
- 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.
channel means type “channel”, where as
<channel> means replace “<channel>” with the name of the channel.
- Invite the bot to your server
- Create a channel for the bot (name it something like #starboard).
[p]add <channel>(“<channel>” is the name of the channel you just created)
[p]addEmoji <channel> <emoji>(
<emoji>is usually “:star:”)
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 setting in the wiki.
These directions are for self-hosting the bot. If you just want a working bot, you can invite it to your server instead.
- 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.
- Create a file called
.env, and inside it put
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.