Requirements
- Server must have at least one text channel for the starboard
- Bot must have permissions to:
- Read messages
- Send messages
- Add reactions
- Manage messages (for editing/updating starboard entries)
- View channels
- Read message history
Add a Starboard
To create a new starboard channel:channel
: The channel where starboard messages will be postedemoji
: The reaction emoji to track (can be any valid emoji)threshold
: Minimum number of reactions required to appear in starboard
List Starboards
View all starboards currently set up in your server:Remove a Starboard
To remove a starboard:Ignore Channels
You can prevent certain channels from being added to the starboard:Move Starboard
To move a starboard to a different channel:On the patch released on 15th of June you can now add these settings:
Additionally, you can now ignore
members
, channels
, or roles
.Special Features
Star Emoji Progression
When using the β emoji, the starboard will automatically upgrade the emoji based on reaction count:- 0-4 reactions: β
- 5-9 reactions: π
- 10-24 reactions: π«
- 25+ reactions: β¨
Message Format
Starboard entries include:- Original message content
- Author information
- Channel source
- Jump link to original message
- Reaction count
- Attached images/videos
- Reply context (if the message was a reply)
Batch Processing
The starboard uses a batch processing system to handle reactions efficiently:- Reactions are queued and processed every 5 seconds
- Messages are processed in chunks of 5 to prevent rate limiting
- Updates are batched to minimize API calls
Starboard messages are automatically updated when reaction counts change, and theyβre removed if the reaction count falls below the threshold.
Deleting a starboard channel will automatically remove its configuration. Make sure to properly remove starboards using the remove command before deleting channels.