Server

The starboard

Members put an emoji on a message. Once it has gathered enough, the bot posts a copy in a channel of its own, the wall of the server's best moments.

>starboard
1 to 100 reactions for the threshold
3 reactions by default
4 steps from reaction to copy
4 settings for the whole starboard
00

Overview

A message everyone likes deserves to be seen. The starboard copies it on its own into a dedicated channel as soon as it gets enough reactions.

You read the server's best messages without searching for them. The stats show which messages and which moments come back most.

01

Getting started

  1. Create the channel

    Choose the channel where messages will be copied.

    >starboard create
  2. List the starboards

    Check what is already set up on the server.

    >starboard list
  3. Read the statistics

    The stats show the most popular messages and the activity peaks.

    >starboard stats
02

How it works

The reaction threshold can be set between 1 and 100. A value outside that range falls back to 3.

A starboard can follow up to 5 different emojis.

Settings are reloaded at most every 2 minutes, so a change of threshold takes a few minutes to count.

What it means

The stats look at the last 30 days to find the peak window.

An invalid threshold falls back to 3 reactions, so the starboard stays useful even when it is badly set.

03

Four settings, and nothing more

Without changes, it listens to ⭐, triggers at 3 reactions and watches the whole server.

Destination channel
One channel, one starboard It receives the copies. A channel already in use refuses a second starboard.
Listened emojis
Up to 5 emojis Native or server emojis. By default ⭐, only their reactions count.
Threshold
From 1 to 100 reactions Default 3. A value outside this range falls back to that default.
Watched channels
Empty, the whole server Either *only* the listed channels, or *everything except* them.
04

The journey of a reaction

A reaction goes through four steps, and each one can stop it. The bot does not reread old messages.

  1. 01
    The channel passes the filter

    The message's channel must be watched.

    Excluded channel: no reaction counts.
  2. 02
    The emoji is recognised

    A native emoji is recognised by its character, a server emoji by its identifier.

    Emoji not listed: the reaction is ignored.
  3. 03
    The count reaches the threshold

    The count comes from Discord, not from a bot tally.

    By default, 3 reactions are enough.
  4. 04
    The copy goes to the wall

    It carries the author, the text and the first image. A message already copied is updated when the count rises.

    Its counter never goes down.
Settings are reread at most every 2 minutes, and right after a change.
05

What lands in the channel

The copy is not the original message: it is a bot card that keeps a link to it.

Title x3

The listened emoji and the count reached, which never goes down.

Author Lyra

The name and avatar of the original author.

Content I finally pulled the void pepper after four hours of farming

The text, taken as it is.

Image the first attachment, otherwise the first link

A single one, and only if there is one.

Origin #general | full date

The original channel, then the date and time it was written.

Buttons Go to message

A link to the original, and one to the quoted message.

When the message replies to another, a second button leads to the quoted message.
06

Tips

  • A threshold that is too low

    With a threshold of 1 reaction, almost every message ends up copied. Raise the threshold to keep only what people really like.

  • Read the peaks

    A peak over the last 30 days may come from an event. Look at it before concluding that the channel has changed.

07

Reference

The exact figures, open them when you need them.

Commands
CommandEffect
>starboardManage server starboards
>starboard createCreate a new starboard
>starboard listList all starboards
>starboard deleteDelete a starboard
>starboard stats
08

Going further

Three other server settings, each on its own page.

Server levels

the tiers earned by talking

Command rules

who can use what, and where

Server statistics

the activity, day after day

Each command has its own entry, with its syntax and arguments.