Plugins

Starboards

Starboards are channels where messages go when a specific reaction is added. They are usually used to highlight funny, memorable, or otherwise noteworthy messages. Reacting with ⭐ might send an embed of a message to #starboard. You can use the same feature for any collection of messages that your community wants to surface.

Hierarchy

Starboards higher in the list will take priority over ones lower in the list. If there is a restriction setup for a starboard higher in the list that isn't matched, lower priority starboards will be considered.

As an example, let's say we have #starboard and #staff-starboard. If someone reacts with ⭐ in any channel in the Staff category, we want it to go to the #staff-starboard channel, and any messages sent elsewhere will go to the regular starboard channel. To do this, we would create a #staff-starboard starboard with the ⭐ emoji, and setup a whitelist for the Staff category. Then, we would create the regular starboard below it without a whitelist so that it sends other messages to #starboard.

This also works with other options, such as minAge, maxAge and minStars. If a starboard's requirements are not met, we consider other starboards that match the same emoji. You can use this fall-through behavior for category-specific starboards, separate starboards for extremely old messages, etc.

Restrictions can also limit a starboard to selected channels, categories, roles, or users. Read Restrictions before combining restrictions with priority rules.

# Output options

Each starboard output has its own emoji, destination channel, minimum star count, and optional minimum or maximum message age. A message must meet every requirement before it can be posted. Prevent Self stops a message author from contributing their own star reaction.

An output can be disabled without deleting its configuration. Reordering outputs changes their priority, so move a specialised output above a broader fallback output. Atlas needs access to the source message and permission to send messages in the destination channel for an entry to be created or updated.