# cog-creators/red-discordbot

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/cog-creators-red-discordbot).**

5,437 stars · 2,432 forks · Python · gpl-3.0

## Links

- GitHub: https://github.com/Cog-Creators/Red-DiscordBot
- Homepage: https://docs.discord.red
- awesome-repositories: https://awesome-repositories.com/repository/cog-creators-red-discordbot.md

## Topics

`bot` `chatbot` `discord` `discord-bot` `fun` `hacktoberfest` `moderation` `modular` `music` `python` `trivia`

## Description

Red-DiscordBot is a modular framework for building and self-hosting Discord bots. It functions as a server management tool and community moderation bot that can be tailored by enabling or disabling specific feature modules.

The system is distinguished by its extensible plugin architecture, which allows for the integration of third-party modules and the development of custom functional packages. Users can manage bot behavior through a chat-based interface, enabling them to assemble custom bots and define unique responses and behaviors without writing new code.

The framework covers a broad range of capabilities, including automated server moderation, role-based access control, and community engagement tools such as audio streaming and interactive trivia. It also provides automation for repetitive administrative tasks and real-time notifications for external stream activity.

The software is designed for self-hosting on local machines or private servers with support for lifecycle automation and backup routines.

## Tags

### Networking & Communication

- [Bot Frameworks](https://awesome-repositories.com/f/networking-communication/bot-frameworks.md) — Functions as a modular framework for building, managing, and hosting automated Discord messaging bots.
- [Bot Management Interfaces](https://awesome-repositories.com/f/networking-communication/chat-bot-integrations/bot-management-interfaces.md) — Provides a chat-based interface for enabling or disabling feature modules and third-party plugins. ([source](https://cdn.jsdelivr.net/gh/cog-creators/red-discordbot@V3/develop/README.md))
- [Chat Community Engagement Tools](https://awesome-repositories.com/f/networking-communication/chat-community-engagement-tools.md) — Ships interactive features like trivia games and stream notifications to increase member activity in Discord servers.

### Part of an Awesome List

- [Bot Development](https://awesome-repositories.com/f/awesome-lists/devtools/bot-development.md) — Provides a comprehensive framework and set of libraries for building and managing custom Discord bots.
- [Modular Capability Tailoring](https://awesome-repositories.com/f/awesome-lists/devtools/core-and-community-extensions/system-capability-extensions/modular-capability-tailoring.md) — Allows for the assembly of custom bots by enabling or disabling specific functional modules. ([source](https://docs.discord.red))
- [Modular Bot Instances](https://awesome-repositories.com/f/awesome-lists/ai/bot/modular-bot-instances.md) — Allows users to assemble custom bots by enabling or disabling feature modules for moderation, music, and trivia.

### Operating Systems & Systems Programming

- [Dynamic Library Loading](https://awesome-repositories.com/f/operating-systems-systems-programming/dynamic-library-loading.md) — Automatically discovers and initializes extension modules from a filesystem directory at runtime.
- [Bot Module Development](https://awesome-repositories.com/f/operating-systems-systems-programming/platform-development-integration/native-system-extensions/extension-development/bot-module-development.md) — Provides tools for developing custom modular extensions that load directly into a bot instance. ([source](https://docs.discord.red/en/stable/guide_cog_creation.html))

### Security & Cryptography

- [Automated Moderation](https://awesome-repositories.com/f/security-cryptography/automated-moderation.md) — Implements automated systems for tracking user warnings and managing mutes to maintain community order. ([source](https://docs.discord.red))
- [Role-Based Access Control](https://awesome-repositories.com/f/security-cryptography/role-based-access-control.md) — Validates command execution by comparing user permissions against a configurable hierarchy of administrative roles.
- [Command Access Rules](https://awesome-repositories.com/f/security-cryptography/permission-systems/command-access-rules.md) — Defines granular access rules to restrict specific bot commands to authorized administrative roles. ([source](https://docs.discord.red))

### Software Engineering & Architecture

- [Extension Frameworks](https://awesome-repositories.com/f/software-engineering-architecture/extension-frameworks.md) — Offers a development framework for building and publishing functional packages that include command decorators and event handling. ([source](https://docs.discord.red))
- [Modular Plugin Architectures](https://awesome-repositories.com/f/software-engineering-architecture/modular-plugin-architectures.md) — Implements a shared application interface for building, testing, and publishing packaged modules via decorators. ([source](http://docs.discord.red/en/stable/))
- [Modular Plugin Frameworks](https://awesome-repositories.com/f/software-engineering-architecture/modular-plugin-frameworks.md) — Implements a modular plugin framework that allows loading and executing third-party code extensions at runtime.
- [Plugin-Based Architectures](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/plugin-module-systems/modular-plugin-architectures/plugin-based-architectures.md) — Provides an architecture for loading and unloading discrete functional packages at runtime to extend capabilities.

### System Administration & Monitoring

- [Discord Server Administrators](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/service-and-infrastructure-management/server-management/discord-server-administrators.md) — Automates repetitive Discord server administration tasks, such as role assignment and broadcasting announcements. ([source](https://cdn.jsdelivr.net/gh/cog-creators/red-discordbot@V3/develop/README.md))
- [Community Administration Tools](https://awesome-repositories.com/f/system-administration-monitoring/community-administration-tools.md) — Provides administrative utilities for managing user permissions, warnings, and moderation hierarchies within Discord communities.
- [Content Moderation](https://awesome-repositories.com/f/system-administration-monitoring/content-moderation.md) — Provides a moderation system for logging administrative actions, issuing warnings, and managing user mutes. ([source](http://docs.discord.red/en/stable/index.html))
- [Moderation Tools](https://awesome-repositories.com/f/system-administration-monitoring/moderation-tools.md) — Ships administrative tools for kicking, banning, and cleaning chat history to enforce server guidelines. ([source](https://cdn.jsdelivr.net/gh/cog-creators/red-discordbot@V3/develop/README.md))

### Development Tools & Productivity

- [Chat Command Shortcuts](https://awesome-repositories.com/f/development-tools-productivity/automation-shortcuts/chat-command-shortcuts.md) — Allows users to create custom responses and shortcuts to handle repetitive tasks within the chat. ([source](http://docs.discord.red/en/stable/index.html))
- [User-Defined Command Parameters](https://awesome-repositories.com/f/development-tools-productivity/terminal-shell-cli/cli-tooling-frameworks/cli-tooling/argument-configuration-management/command-configurations/user-defined-command-parameters.md) — Enables the definition of unique bot behaviors and responses using parameters and cooldowns without writing code. ([source](https://cdn.jsdelivr.net/gh/cog-creators/red-discordbot@V3/develop/README.md))

### DevOps & Infrastructure

- [Self-Hosted Bot Deployments](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-bot-deployments.md) — Designed for deployment on local machines or private servers with support for automatic restarts.
- [Self-Hosted Bot Management](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-bot-management.md) — Supports self-hosting on private servers with integrated lifecycle automation and backup routines.
- [Self-Hosted Deployment Tools](https://awesome-repositories.com/f/devops-infrastructure/self-hosted-deployment-tools.md) — Provides installation support and utilities for deploying the bot on local machines or private servers. ([source](https://docs.discord.red/en/stable/install_guides/index.html))

### Graphics & Multimedia

- [Audio Playlist Managers](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/playlist-aggregators/personal-playlist-managers/audio-playlist-managers.md) — Provides a system for playing music with support for queues, skipping, and curated playlists. ([source](http://docs.discord.red/en/stable/))
- [Voice Channel Audio Delivery](https://awesome-repositories.com/f/graphics-multimedia/voice-channel-audio-delivery.md) — Delivers music from local tracks or external services directly into a voice channel. ([source](https://cdn.jsdelivr.net/gh/cog-creators/red-discordbot@V3/develop/README.md))

### Web Development

- [Third Party Integrations](https://awesome-repositories.com/f/web-development/third-party-integrations.md) — Enables the integration of community-provided modules to add specialized features and commands. ([source](http://docs.discord.red/en/stable/))
