MGY Bot

Discord Bot in python.

Includes music playing, moderation tools, games, trolls, user and level management using a postgres database.

Be aware that this started a few years ago as a small, personal and troll project that eventually grew a bit, there wasn't much planning, actually there wasn't any thinking involved at all. I did refactor it recently so it is somewhat readable, be careful and good luck.

Bot language is in PT-BR

How to add bot to my server

This bot is not publically available.

I do run a private instance, feel free to message me or run your own

Use mgy prefix to run commands. Example:

mgy help

Getting Started

• Clone the repo
• Copy .env.example, rename it to .env and update the variables with your credentials
• Install dependencies

pip install -r poetry
poetry install

Run bot

poetry run python main.py

Prerequisites

• Git
• Python ^3.11
• Postgres database
• Dicord bot token
• Spotify token
• YouTube API token - You need to create a GCP account for this and enable the YouTube Data v3 API. Here is a guide on how to do it
• YouTube cookies.txt - optional file. Can help avoid errors in age restricted videos
• FFMpeg - Make sure you have FFMPeg
• Everything else in: pyproject.toml

Built With

• Python - Python 3.11
• DiscordPy - discord.py 2.2
• yt-dlp - yt-dlp (always up to date)
• ruff - Ruff for linting and code styling

TODOs

• There is a lot of TODO tags in code
• Fix styling and variable/classes/method/logs names
• reddit module
• twitch module
• markov module
• optimizations
• Make every module optional and give warnings instead of errors
• Fix spotipy - Randomly gives errors 403 - Support more links
• Fix dropbox mashups
• Automate deploy
• Anything you want

Authors

• Ulf - everything - Ulf881
• Max - crappyDungeonCrawlerForPython - https://www.youtube.com/channel/UCzyiiswVM6UyCD_G6A7ee2g

See also the list of contributors who participated in this project.

Acknowledgments

• Template by PurpleBooth

Extras

Level up table and rules