Discord Starboard (v14)

A modern, lightweight Starboard bot for Discord built with Node.js and Discord.js v14.

Features

• Modern Discord.js v14: Uses the latest features and security updates.
• Persistent Memory: Looks back at previous starboard posts to avoid duplicates.
• Image Support: Automatically handles images from attachments and embeds.
• Live Updates: Updates the star count on the starboard message in real-time.
• Date Cutoff: Prevents users from starring ancient messages.

---

Installation (Linux/Ubuntu)

1. Requirements

• Node.js 18.0.0 or higher (Recommended: v20 or v24)
• npm (comes with Node)

2. Download and Setup

# Clone the repository
git clone https://github.com/the-jame/discord-starboard.git
cd discord-starboard

# Install dependencies
npm install

# Create your settings file
cp sample-settings.json settings.json

3. Configuration

Open settings.json and fill in your bot's details:

{
"token": "YOUR_BOT_TOKEN",
"serverID": "YOUR_SERVER_ID",
"channelID": "YOUR_STARBOARD_CHANNEL_ID",
"reactionEmoji": "⭐",
"threshold": 3,
"hexcolor": "d4af37",
"dateCutoff": 30,
"fetchLimit": 100
}

4. Running the Bot

For testing:

node app.js

For production (Recommended): Keep the bot running 24/7 using PM2:

npm install -g pm2
pm2 start app.js --name "Starboard"
pm2 save

---

Options & Config

Option	Type	Description
token	String	Your Discord Bot Token (from Developer Portal)
serverID	String	The ID of the server the bot is in
channelID	String	The ID of the channel where stars will be posted
reactionEmoji	String	The emoji the bot should track (usually ⭐)
threshold	Integer	Stars required before a message is "boarded"
hexcolor	Hex	The color of the embed (e.g., d4af37)
dateCutoff	Integer	Max age (in days) for a message to be eligible
fetchLimit	Integer	How many messages to scan for duplicates on startup

---

How to get Server/Channel IDs

1. Open Discord Settings.
2. Go to Advanced and enable Developer Mode.
3. Right-click on your Server Name to "Copy Server ID".
4. Right-click on your Starboard Channel to "Copy Channel ID".

---