Starboard is an advanced, reliable, and highly customizable starboard bot, which I’ve been working on for a while now, mostly for use on personal servers. When it turned out better than I imagined, I open-sourced it and posted it to both lists. I hope you find this code and bot useful.
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
- Supports multiple starboards
- AutoStar Channels (media channels)
- 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]starboards add <channel>("<channel>" is the name of the channel you just created)
[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 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.