Settings reference
All Starboard settings and entry fields used by the current code.
| Setting | Type | Default | Meaning |
|---|---|---|---|
enabled | boolean | false | When false, reaction events return without creating, editing, or deleting starboard posts. |
channelId | snowflake or null | null | Destination text channel. Enabling requires a valid selected channel ID. |
minStars | integer | 3 | Minimum live reaction count required to appear on the board. API range is 2–20. |
emoji | string | ⭐ | Reaction emoji to count. Unicode names must match exactly. Custom emoji can match by full mention or ID. |
StarboardEntry.sourceMessageId | snowflake | created when posted | Original message ID. Unique per guild so one source message has one board entry. |
StarboardEntry.sourceChannelId | snowflake | created when posted | Original channel used for references and cleanup. |
StarboardEntry.starboardMessageId | snowflake | created when posted | Current Discord message ID of the board post; updated if the post is recreated. |
StarboardEntry.starCount | integer | 0 | Last stored count after a successful create, edit, or recreate. |
Custom emoji matching
For custom emoji, the bot accepts the full configured emoji, the bare ID, or a configured string containing the emoji ID. For Unicode emoji, the configured value must equal Discord's emoji name.