Iris
Add to Discord

Starboard

Highlight popular messages in a starboard channel.

Configure Starboard in the dashboard

Overview#

Starboard is a hall of fame your members vote for. React to a message with the starboard emoji, and once enough people have done the same, Iris reposts it in the starboard channel with a link back to the original.

Any emoji works, standard or custom to your server, and the threshold is yours to set. Self-stars can be refused so nobody nominates themselves, and channels you exclude never reach the board.

The dashboard tracks what the board is doing over time: how many messages were starred, how many stars were given, and who keeps landing on it.

Setup#

  1. Make a channel for the board that everyone can read and only Iris posts in.
  2. Open the dashboard and go to Engagement > Starboard, then turn the module on.
  3. Set the Starboard Channel.
  4. Pick the Reaction Emoji and the Threshold.
  5. Style the repost under Embed Appearance, watching the live preview.
  6. Add any channels that should never reach the board under Ignored Channels, then save.

Settings#

SettingTypeDefaultWhat it does
Enable StarboardToggleOnWhether reactions are counted at all.
Starboard ChannelChannelNoneWhere starred messages are reposted.
Reaction EmojiEmojiA starThe reaction members use to nominate a message.
ThresholdNumber3How many of that reaction a message needs before it is reposted.
Allow Self-StarToggleOffWhether members may star their own messages.
Embed ColorColour#f1c40fAccent of the repost.
Show jump linkToggleOnAdds a source field linking back to the original message.
Show attached imagesToggleOnEmbeds the first image from the starred message.
Show timestampToggleOnShows when the original message was sent.
Ignored ChannelsChannelsNoneMessages here never reach the board however many stars they get.

Commands#

CommandWhat it doesRequires
.starboard configChannel, emoji, threshold and ignored channels from chat.Manage Server
.starboard statsThe starboard leaderboard for this server.Anyone

Permissions#

PermissionWhy Iris needs it
View ChannelsSees the channels stars are given in, and the board.
Send MessagesPosts the repost.
Embed LinksThe repost is an embed.
Read Message HistoryReads the starred message and counts its reactions.
Use External EmojisOnly when the starboard emoji comes from another server.

What it looks like#

I
Iris APP Today at 8:52 PM
@member in #general

I have been working on this for three weeks and it finally compiles.

Source

Jump to message

Attached image from the starred message
7 stars
A message that reached the threshold, reposted to the board.

Tips and gotchas#

Nothing reaches the board.

Check the threshold, that members are using the configured emoji, that the channel is not on the Ignored Channels list, and that Iris can read history there.

A custom emoji does not count.

Iris has to be in the server that emoji belongs to. Use one from this server.

Can a message be removed from the board?

Delete the repost in the starboard channel. The original is untouched.

Do stars still count after it is posted?

Yes. The count on the repost keeps up with the reactions on the original.