> ## Documentation Index
> Fetch the complete documentation index at: https://docs.criminal.work/llms.txt
> Use this file to discover all available pages before exploring further.

# Sob Board

> A starboard driven by crying-emoji reactions, with live counts and author stats.

The Sob Board mirrors messages that collect enough 😭 reactions into a channel you choose. It listens
to raw reaction events, so it works on messages older than the bot's cache.

## Setup

```text theme={null}
/config channel starboard-channel #sob-board
/config number  starboard-threshold 3
```

The threshold defaults to **3** reactions. Nothing is posted until a channel is set.

## How a post behaves

A mirrored post contains the author, a jump link to the original message, the message text (up to
1,500 characters) and any image attachments as a gallery. The heading shows the current sob count.

| Event | Result |
| - | - |
| Reactions reach the threshold | Post is created on the board |
| More reactions arrive | The existing board post is edited, count updated |
| Reactions drop below the threshold | The board post is deleted |

Self-stars don't count by default: if the author reacts to their own message, that reaction is
subtracted from the total. Enable it with the `starboard_self_star` setting if you want authors to
count.

## What it ignores

* Messages already in the board channel
* NSFW channels
* Channels `@everyone` cannot view
* Threads and forum posts (only text channels are mirrored)
* Emoji other than 😭

## Stats

```text theme={null}
/sobstats
```

Ranks the top ten authors by total sobs received, with how many of their posts made the board. The
data comes from the mapping table, so it stays accurate even if board posts are manually deleted.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.