Search the academy and reference.
Every lesson follows the same concept-first structure, with visuals, examples, production notes, warnings, performance, security, and challenges.
Foundation
Introduction: discord.py 2.x, Discord API, Gateway, REST, Events, app_commands, Views, and Components
Understand what discord.py wraps and how modern Python bots receive interactions.
Setup: Python, Virtual Environments, VS Code, Applications, Intents, Permissions, and Tokens
Set up a modern discord.py 2.x project with safe token handling and clear development workflow.
Python Core
Architecture
Commands
app_commands, Slash Commands, Subcommands, Permissions, Cooldowns, Localization, Sync, and Autocomplete
Build modern slash commands with discord.app_commands and avoid prefix-first teaching.
Hybrid Commands: When to Use Them and When Slash-Only Is Better
Understand hybrid commands without making prefix commands the center of your architecture.
Components
Views and Buttons: Persistent Views, Dynamic Custom IDs, Permission Checks, and Routing
Build button systems for tickets, moderation, verification, pagination, and confirmations.
Select Menus: String, User, Role, Channel, Mentionable, and Dynamic Options
Create role menus, ticket category selectors, configuration panels, and entity pickers.
Modals: Forms, Validation, Submissions, Database Writes, and Multi-Step Workflows
Collect reports, suggestions, applications, and feedback with modern discord.ui.Modal classes.
Persistent Views: Restart-Safe Buttons, Selects, Custom IDs, and Startup Registration
Make component handlers survive bot restarts.
Interaction Systems
Advanced Interaction Systems: State, Guards, Cooldowns, Multi-User Flows, and Error Boundaries
Design interaction callbacks that stay safe and readable as features grow.
Events and Tasks: on_ready, on_member_join, on_message, voice_state_update, role_update, message_delete, channel_create, presence_update, and tasks.loop
Use gateway events and background loops without blocking the event loop.
Data
Production
Production Architecture: Logging, Validation, Config, Error Handling, Rate Limits, Service Layers, and Anti-Crash Boundaries
Move from examples to a production Python service.
Security: Tokens, Environment Variables, Permission Checks, Abuse Resistance, and Safe Interaction Handling
Protect secrets and restrict dangerous actions inside commands, views, modals, and tasks.
Hosting: VPS, Railway, Docker, PM2 Alternatives, Pterodactyl, Linux Basics, Secrets, and Health Checks
Deploy a discord.py bot as a reliable long-running service.
Scaling
Real Projects
Full Project: Moderation System
Build moderation with app_commands, cogs, cases, audit logs, permission checks, and component confirmations.
Full Project: Ticket System
Build ticket panels with persistent views, category selects, staff buttons, transcripts, and database state.
Full Project: Economy System
Build balances, cooldowns, transactions, leaderboards, and abuse-resistant async database operations.
Full Project: AI Assistant System
Build a privacy-first AI assistant with rate limits, prompt boundaries, context trimming, and moderation guards.
Full Project: Dashboard Integration
Build dashboard-aware guild settings with OAuth2 thinking, API boundaries, and Discord confirmation flows.
Full Project: Verification System
Build verification flows with persistent buttons, roles, anti-raid checks, and audit trails.
Reference
Comparison Pages: discord.js vs discord.py, Buttons vs Selects, Slash vs Prefix, SQLite vs MongoDB, Cache vs Database, Sharding vs Clustering, Views vs Collectors
Use tradeoff tables to choose patterns, storage, and UI primitives.
Quick Syntax References, Interaction Lifecycle Tables, Component References, Permissions, Intents, and Response Types
Use this as a daily reference for modern discord.py work.
FAQ and Troubleshooting: Unknown Interaction, Missing Intents, Bad Permissions, Sync Issues, Event Loop Blocking, and Hosting Problems
Debug the problems beginners and production teams both hit.
Beginner Glossary: Async, Await, Event Loops, APIs, Classes, Cogs, Views, Interactions, Components, Caches, Shards, and Services
Explain the words that tutorials often assume learners already know.
Function and API Reference: discord.py 2.x
Detailed reference explaining what every major API, method, helper, and example function does.
