🤖 Discord Bot

A feature-rich Discord bot demonstrating async Python, command handling, database storage, and scheduled tasks.

🎯 Learning Objectives

• Async/Await Patterns - Non-blocking event handling
• Command Framework - Parsing and dispatching commands
• Event-Driven Architecture - Responding to Discord events
• Database Integration - Persistent storage with SQLite
• Task Scheduling - Background jobs and reminders
• Error Handling - Graceful error recovery

Features

• Custom command prefix and help system
• User reminders with natural time parsing
• Polls with reaction voting
• User statistics tracking
• Moderation commands (kick, ban, mute)
• Fun commands (8ball, roll, quote)
• Scheduled announcements
• Persistent settings per server

🚀 Quick Start

1. Create Discord Application

1. Go to Discord Developer Portal
2. Click "New Application" and give it a name
3. Go to "Bot" section and click "Add Bot"
4. Copy the bot token
5. Enable "Message Content Intent" under Privileged Gateway Intents

2. Install Dependencies

cd 04_discord_bot
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
pip install -r requirements.txt

3. Configure

cp .env.example .env
# Edit .env and add your bot token

4. Run the Bot

python -m bot

5. Invite Bot to Server

Use this URL (replace CLIENT_ID):

https://discord.com/api/oauth2/authorize?client_id=CLIENT_ID&permissions=8&scope=bot

📁 Project Structure

04_discord_bot/
├── bot/
│   ├── __init__.py
│   ├── __main__.py       # Entry point
│   ├── client.py         # Main bot client
│   ├── config.py         # Configuration
│   ├── database.py       # SQLite database
│   ├── cogs/
│   │   ├── __init__.py
│   │   ├── admin.py      # Admin commands
│   │   ├── fun.py        # Fun commands
│   │   ├── moderation.py # Mod commands
│   │   ├── reminders.py  # Reminder system
│   │   ├── polls.py      # Poll system
│   │   └── stats.py      # Statistics
│   └── utils/
│       ├── __init__.py
│       ├── embeds.py     # Discord embeds
│       ├── checks.py     # Permission checks
│       └── time_parser.py # Parse time strings
├── tests/
│   ├── __init__.py
│   └── test_bot.py
├── .env.example
├── requirements.txt
└── README.md

🎮 Commands

General

Reminders

Polls

Fun

Moderation (Admin only)

🔑 Key Concepts

Cog System (Modular Commands)

from discord.ext import commands

class Fun(commands.Cog):
    """Fun commands for entertainment."""

    def __init__(self, bot):
        self.bot = bot

    @commands.command()
    async def roll(self, ctx, dice: str = "1d6"):
        """Roll dice: !roll 2d6"""
        # Implementation
        await ctx.send(f"🎲 You rolled: {result}")

# Load in main bot
bot.add_cog(Fun(bot))

Event Handling

class MyBot(commands.Bot):
    async def on_ready(self):
        print(f"Logged in as {self.user}")

    async def on_member_join(self, member):
        channel = member.guild.system_channel
        await channel.send(f"Welcome {member.mention}!")

    async def on_command_error(self, ctx, error):
        if isinstance(error, commands.MissingPermissions):
            await ctx.send("You don't have permission!")

Background Tasks

from discord.ext import tasks

class Reminders(commands.Cog):
    def __init__(self, bot):
        self.bot = bot
        self.check_reminders.start()

    @tasks.loop(seconds=30)
    async def check_reminders(self):
        """Check for due reminders."""
        due = self.db.get_due_reminders()
        for reminder in due:
            user = self.bot.get_user(reminder.user_id)
            await user.send(f"⏰ Reminder: {reminder.message}")

🧪 Running Tests

pytest tests/ -v

📚 Related Learning

• discord.py Documentation
• Discord Developer Portal
• Async Python Tutorial

✅ Project Checklist

• Set up Discord application and bot
• Implement basic commands (ping, help)
• Add reminder system with database
• Create poll command with reactions
• Add moderation commands
• Implement user statistics
• Add error handling
• Deploy to cloud (Railway, Heroku)