Skip to content

Discord bot which allows you to pin messages to a special channel with a star reaction

Notifications You must be signed in to change notification settings

Windfave/StarboardBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Starboard Bot

This project lets you star react messages and pin them to a special channel when it receives enough said votes (default = 2).

The embed sent into said channel contains the author of the message and the message itself, along with the reaction counter which is updated constantly (until the bot is turned off) [That is subject to change]

Acknowledgements

  • amateur (probably outdated) code

Features

  • Live Starboard System
  • More to come in the future

Any message that gets 2 and more star reactions gets sent as an embed into a #starboard channel. If there is no said channel, the bot will create it. (Do not rename it.)

The embed is constantly being updated (the reaction count) as long as the bot is turned on. If it is restarted (manually or via ratelimit) the bot loads data from before, so there shouldn't be any memory loss. It won't update any information about the reaction count during the time the bot is offline or restarting.

If the message goes below 2 reactions, it gets removed from the #starboard.

example

Installation

To be able to use this project you need python 3.11.2. Make sure you add pip to PATH. Restart your computer afterwards. After this you will need some libraries that you can find in the requirements.txt file. The most important one is discord.py

  cd theproject
  py -3 -m pip install -U discord.py (if on Windows)

You can also get the library directly from PyPI:

  python3 -m pip install -U discord.py

After this is done, you should be ready to set up the bot. First to make the bot even work, you need to create the Bot Application in Discord. To do so, you must go to the Developer Application section.

Making the discord bot

When you access the Developer Application section, you want to go to the Applications tab. That should be open by default. Press New Application.

Stepone

Now, you will see this window open. Enter the desired name of your bot and agree to the ToS and Developer Policy.

Steptwo

Here, you will now be redirected to your bots settings. Here, you can change the name, profile picture and even add more information about your bot in the description, which will show in the bot's about me section on it's profile. From here you want to open the bot tab.

Stepthree

This is what the bot tab will look like. You want to press Add Bot.

Stepfour

Now, you have created the bot. Now, copy the token and save it, paste it into the python file.

Stepfive

Replace the 'INSERTBOTTOKENHERE' with the token you just added to your clipboard.

Stepsix

Now you want to enable all of these intents.

Stepseven

After doing so, save the changes in the python file. You will have to invite the bot to a server, you can use this tool to generate you an invite link using your bot's application id

Select the needed permissions and invite the bot. Now all you need to do is to turn on the bot like so:

cd thefolderwiththebot
python star.py

The bot should turn on and tell you that the bot is online.