Discord Bot Framework

Advanced extensible system with hot-reload, atomic operations,
and enterprise-grade architecture for Discord bot development

Get Started Explore Features

Powerful Features

Dynamic Extension Loading

Load, unload, and **hot-reload extensions** on the fly without restarting your bot. Perfect for development and production environments.

Atomic File Operations

**Race-condition-free file handling** with intelligent caching, ensuring data integrity across all operations.

Role-Based Permissions

**Granular command access control** with role-based permissions, configurable per-guild and per-command.

SQLite with WAL Mode

**High-performance database management** with Write-Ahead Logging for concurrent operations and automatic backups.

Advanced Metrics

Built-in analytics tracking command usage, errors, messages, and performance metrics with detailed statistics.

Hybrid Commands

**Seamlessly support both prefix and slash commands** with automatic synchronization and conflict resolution.

Framework Cogs System

**Modular internal architecture** with event hooks, plugin registry, diagnostics, and automatic dependency tracking.

Event Hooks System

**Priority-based internal event system** allowing extensions to react to framework lifecycle events programmatically.

Plugin Registry

**Automatic metadata tracking** with dependency resolution, conflict detection, and comprehensive plugin information.

Framework Diagnostics

**Real-time health monitoring** tracking CPU, memory, error rates, and system performance with automated reports.

Slash Command Limiter

**Automatic protection** against Discord's 100 command limit with graceful degradation to prefix-only mode.

Dependency Auto-Fix

**Automatic detection and installation** of missing Python dependencies from error logs via marketplace commands.

Command Reference

All commands below support **both prefix and slash (hybrid)** invocation unless marked prefix-only.

User Commands

!help / /help
Display an interactive help menu with all available commands organized by categories. Shows command type indicators (slash/prefix/both).
!stats / /stats
View bot statistics including uptime, commands processed, messages seen, error count, and framework cog information.
!extensions / /extensions
List all currently loaded user extensions and framework cogs with their load times.
!plugins / /plugins
Display all registered plugins with metadata including version, author, and dependencies.
!plugininfo <name>
View detailed information about a specific plugin including commands, cogs, dependencies, and conflicts.
!slashlimit / /slashlimit
Check current slash command usage against Discord's 100 command limit with visual progress indicators.
!discordbotframework / /framework
Display comprehensive framework information and features including all core capabilities.

Admin Commands

!setprefix <prefix> / /setprefix <prefix>ADMIN
Set a custom command prefix for your server (max 5 characters).
!config <command> <@role> / /config <command> <role>OWNER
Configure role-based permissions for specific commands. Use "none" to remove restrictions.

Bot Owner Commands

!reload <extension> / /reload <extension>OWNER
Hot-reload a specific extension without restarting the bot. Automatically updates load times and emits hooks.
!load <extension> / /load <extension>OWNER
Load a new extension dynamically. Supports automatic file renaming for spaces in filenames.
!unload <extension> / /unload <extension>OWNER
Unload an extension from the bot. Emits unload hooks for cleanup.
!sync / /syncOWNER
Force synchronization of slash commands globally. Handles rate limiting automatically.
!atomictest / /atomictestOWNER
Test atomic file operations and caching system with concurrent write tests.
!hooks / /hooksOWNER
Display all registered framework event hooks with priority levels and callback information.
!hookhistory / /hookhistoryOWNER
View hook execution history showing recent events, success counts, and errors.
!diagnostics / /diagnosticsOWNER
Display comprehensive framework diagnostics including CPU, memory, health status, and system metrics.

Marketplace Commands

!marketplace / /marketplace
Open the extension marketplace to browse, search, and install official extensions with interactive menus.
!marketplace browse
Browse all available extensions with pagination and detailed information.
!marketplace search <query>
Search for extensions by title, description, or details with filtering.
!marketplace install <id>
Install an extension by ID with confirmation dialog and automatic setup instructions.
!marketplace fixdepsOWNER
Automatically detect and install missing Python dependencies from error logs using pip.
!marketplace myidOWNER
Retrieve your unique ZygnalID for support and extension tracking purposes (sent via DM).
30+
Core Features
4
Framework Cogs
MIT
Licensing (with addtl. terms)
∞
Extensibility

Ready to Build Something Amazing?

Join developers who are building the next generation of Discord bots with enterprise-grade architecture

View on GitHub Documentation