A discord bot that allows you to run fun commands all over discord, developed by the community for the community. To start working on the bot, you can read the contributing guidelines and make sure you have the latest version of python installed. Make sure you have the latest version of pip installed as well as git.
For a basic introduction to the bot, you can read the documentation.
Anything you would want in a discord bot, we want it too. From moderation to fun commands, we accept it all. Some basic commands are given in the Issues Section. If you want to add a command, you can make a pull request, and we will review it.
Make sure to put admin role requirements in the code, so that only admins can use server centric commands such as ban or kick. Treat the role "Admin" as the admin role.
Write descriptive help fields for the commands, so that the user knows what the command does.
Install all the dependencies using the following command:
pip install -r requirements.txtFirst, you will need at least Python 3.8.
Clone the repo:
$ git clone https://github.com/MicrosoftStudentChapter/Hack-O-Bot
$ cd Hack-O-BotInstall dependencies:
$ pip install -r requirements.txtRename the .env.example to .env and fill out the fields. If .env.example is nonexistent (hidden), create a text file named .env and copy the contents of .env.example then modify the values.
Finally, start the bot.
$ python discord_main.pyHere is a list of all the commands that the bot has:
Fun commands
| Command | Description |
|---|---|
.8ball |
Use the magic 8 ball to get a random answer |
.roll |
Roll a n sided die |
.horoscope |
Get your horoscope for today based on your discord birthday |
.emoji |
Emoji-fy your text |
.github |
Get information about a random Github Repository |
.dog |
Send an adorable dog image, optionally with a specified breed |
.cat |
Send a cute cat image, optionally with some text! |
.duck |
Send a random duck image! |
.richest |
Get information about the richest person according to the Forbes list |
Moderation commands
| Command | Description |
|---|---|
.ban |
Ban a user from the server |
.kick |
Kick a user from the server |
.unban |
Unban a user from the server |
.timeout |
Restricts a User from sending messages for some time |
.addrole |
Gives specified roles to the provided members |
.server_info |
Basics information about the server |
Image manipulation commands
| Command | Description |
|---|---|
.wanted |
Make yourself the most wanted person in all of the wild west |
Utility commands
| Command | Description |
|---|---|
.ping |
Get the bot's latency |
.help |
Get help with the bot |
.invite |
Get the bot's invite link |
.enable |
Enables Different Categories Access: Administrator |
.disable |
Disables Different Categories Access: Administrator |
.about |
Get the info about Hacktoberfest and MLSC's contribution to it |
.contributors |
Get the info about the contributors |
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Pull requests will be on a first come first serve basis. Please make sure to update tests as appropriate.