Starboard — ⭐ Highlight the Best Messages

GrumpyStarboard automatically highlights particularly popular messages: once a message has collected enough reactions (default: ⭐), it is posted in a dedicated starboard channel. Perfect for highlights, jokes, and memorable moments.

---

Activation

In configs/config.yml:

addons:
  starboard: true

channels:
  starboard: "CHANNEL_ID"   # Starboard output channel

On first start, configs/modules/starboard.yml is created.

---

starboard.yml

enabled: true
channelId: ""               # Empty = falls back to channels.starboard in config.yml
emoji: "⭐"                 # Reaction emoji (Unicode or custom emoji)
threshold: 3                # Minimum reactions required for a starboard post
ignoredChannels: []         # Channel IDs excluded from the starboard
ignoreBots: true            # Bot reactions don't count
selfStarAllowed: false      # Starring your own message doesn't count

Channel fallback: If channelId is empty, channels.starboard from config.yml is used.

---

Behavior

Threshold reached → Post

Once a message reaches threshold valid reactions, it is posted in the starboard channel:

⭐ 3 | #general

┌─────────────────────────────────────────┐
│ [Avatar] Jonas                          │
│                                         │
│ Today I ate more spaghetti than in my   │
│ entire life up to this point            │
│                                         │
│ 🔗 Jump to message                      │
│ ⭐ 3 · #general                         │
└─────────────────────────────────────────┘

Live update

With each additional reaction, the counter in the starboard post is updated: ⭐ 3 → ⭐ 5 → ⭐ 7

Below threshold → Remove

If reactions are removed and the count drops below threshold, the starboard post is automatically deleted.

---

Starboard Embed Contents

Field	Content
Author	Avatar + display name of the message author
Description	Original message text (max 2048 characters)
Image	First image attachment (if present)
Link field	🔗 Direct link to the original message
Footer	⭐ N · #channel-name
Color	Yellow

---

Counter Logic

Total reactions
  - Bot reactions (if ignoreBots: true)
  - Self-stars (if selfStarAllowed: false)
= Valid count

Example with threshold: 3, ignoreBots: true, selfStarAllowed: false:

• Jonas writes a message and reacts with ⭐ himself → count: 0 (self-star, immediately excluded)
• Two more users react → count: 2 (no post yet)
• Third user reacts → count: 3 → Starboard post!

---

Custom Emoji

To use a server emoji as the starboard emoji, add the emoji mention in starboard.yml:

emoji: "<:grumpy:1234567890123456>"

To get the emoji mention in Discord: type \:emoji-name: → Discord shows the ID.

---

Tips

• Dedicated channel: Use a dedicated #starboard channel with slow mode for a clean overview
• Higher threshold: For larger servers, set threshold: 5 or higher
• Exclude staff areas: Add staff channels to ignoredChannels so internal conversations don't end up on the starboard
• Starboard channel excluded: The starboard channel itself is automatically excluded (no cascading)