A modular and extensible Discord bot built with discord.py and MongoDB.

• 🧩 Modular Structure: Easily add and manage commands and events.
• 🐢 Turtle System: Users can create and list their own turtles.
• 🛡️ Advanced Error Handling: User-friendly error messages and auto-deletion.
• 📦 MongoDB Integration: Persistent data storage support.
• ⚡ Easy Setup & Run: Quick start with Makefile and .env support.

git clone https://github.com/Xjectro/python-discord-bot.git
cd python-discord-bot
python -m venv venv
venv\Scripts\activate  # For Windows
# or
source venv/bin/activate  # For Linux/macOS
pip install -r requirements.txt

Create a .env file and fill it as follows:

BOT_TOKEN="YOUR_DISCORD_BOT_TOKEN"
PREFIX="!"
MONGODB_URI="mongodb://localhost:27017/python-discord-bot"

python main.py

or

make run

• !create_turtle <name> — Creates a new turtle.
• !list_turtles — Lists all turtles.

For more commands, check the code or look in the cogs/ folder.

Pull requests and suggestions are welcome! Please open an issue first to discuss what you would like to change.

MIT License © 2025 Xjectro