starboard
starboard copied to clipboard
starboard / smugboard discord bot for moonmoon discord server
Starboard
Starboard (also known as the smugboard™) is a Discordjs bot originally created (and still running) for moonmoon's discord server. It allows users to react to messages on a given server, and pin messages that reach a threshold to a special channel. This implementation is a barebones starboard that can work on one discord server with minimal setup. No databases are required.
Getting Started
Requirements
- NodeJS 16.11.0+
- Enable Discord "Message Content Intent" (in Discord App/Bot settings)
Setup
Create a Discord application bot, and enable Message Content Intent under the Privilieged Gateway Intents section in the bot tab. This is required for your application to be able to view message content.
After creating your bot and cloning the repository, the only setup that needs to be done involves creating a settings.json
file in the config folder. The following is an example of how the file needs to look:
{
"token": "bot_token",
"serverID": "693277318496920420",
"channelID": "461248569698208129",
"reactionEmoji": "⭐",
"embedEmoji": "⭐",
"threshold": 15,
"hexcolor": "00AE86",
"dateCutoff": 3,
"fetchLimit": 100,
"editMsgGracePeriod": 300,
"webhook": "",
"authorAsUsername": false
}
PROP | TYPE | INFO |
---|---|---|
token | String | the discord bot token you get from your discord developer portal. |
serverID | String | the ID of the server you want the bot to run in. After enabling developer mode, you can right click the server icon to get the server ID. |
channelID | String | the ID of the channel you want the starboard bot to post to. You can right click the channel name and obtain the channel ID after enabling developer mode. |
webhook | URL | (OPTIONAL) The URL of a user created webhook (Server Settings > Integrations). When a valid URL exists, the bot will post messages through the webhook instead. This options allows the bot to use any global emote on Discord. |
reactionEmoji | String | the emoji you want the bot to listen to. For default emojis, use the literal emoji. To easily obtain this, you can put a \ infront of any emoji name like \:star: in discord (which would create ⭐). For custom emojis, simply put the exact name like moon2SMUG . |
embedEmoji | String | the emoji (Or any other piece of text) displayed at the bottom of the embeds in the starboard channel. |
threshhold | Integer | the amount of reactions it takes for a message to be posted to the starboard. |
hexcolor | String | the color of the embed in hex. if null, this value is generated from an incoming message's channel ID (unique color code per channel). |
dateCutoff | Integer | how old a message can be, in days, and still be tracked by the bot. if you don't want really old messages getting posted, then keep this number low. |
fetchLimit | Integer | how many messages from the starboard channel will be loaded in memory. This lets the script know what messages have already been posted. It's recommended to change this with respect to dateCutoff and how big your server is. Anything that isn't tracked has the possibility of getting double posted. |
editMsgGracePeriod | Integer | how long, in seconds, a message can to be edited to update its board post. disables this feature if set to null or 0. |
authorAsUsername | Boolean | Only when webhook is active. If true, sets the webhook username and avatar to the original post author. If false, it sets it to the bot. |
Running the Project
Use npm install
to download dependencies. Finally, you can run the bot with npm start
. I recommend using pm2 for continuous uptime.
Database Support
Using a database is completely optional, but if you wish to use one, it is partially supported. All you need to do is add the property sql
to your config.json like so:
{
...
"sql": {
"dialect": "mariadb",
"db": "db_name",
"hostname": "127.0.0.1",
"port": "3306",
"username": "username",
"password": "password"
}
...
}
Notes
-
DB support currently only sends data back to the DB. It will still load previous posts from the actual discord channel, up to the amount specified in the config.
-
All code is tested with the dialect mariadb. Additional dialects must be installed. For example, if you want to use
"dialect": "mysql"
, you must install it withnpm install mysql2
.
License
This project is licensed under the MIT License - see the LICENSE.txt file for details.