Modules (Cogs)
Starboard
The Starboard module automatically reposts messages to a highlight channel when they receive enough reactions of a configured emoji.
Configuration
| Option | Type | Default | Description |
|---|---|---|---|
channel_id | string | — | Starboard channel (required) |
emoji | string | ⭐ | Emoji to track |
threshold | number | 3 | Minimum reactions to post |
self_star | boolean | false | Allow authors to star their own messages |
ignore_bots | boolean | true | Ignore bot messages |
ignore_channels | string[] | [] | Channels excluded from starboard |
How It Works
- A user reacts with the configured emoji on a message
- Bot counts valid reactions (excluding self-star if disabled)
- When count reaches threshold → message is posted to the starboard channel
- If count changes → starboard embed is updated with new count
- If count drops below threshold → starboard post is removed
Starboard Embed
The starboard embed includes:
- Message content (up to 2048 chars)
- Author name and avatar
- First image attachment or embed image
- "Jump to message" link
- Channel source in footer
- Star count in the header
Tips
Best Practices
- Set threshold to 3–5 for servers with 100+ active members
- Use a dedicated #starboard channel with send-message disabled for users
- Exclude bot-command channels from starboard to avoid noise