https://github.com/cog-creators/red-discordbot

A multi-function Discord bot
https://github.com/cog-creators/red-discordbot

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

Last synced: 5 days ago
JSON representation

A multi-function Discord bot

• Host: GitHub
• URL: https://github.com/cog-creators/red-discordbot
• Owner: Cog-Creators
• License: gpl-3.0
• Created: 2016-01-02T09:27:12.000Z (almost 9 years ago)
• Default Branch: V3/develop
• Last Pushed: 2024-10-20T20:20:29.000Z (2 months ago)
• Last Synced: 2024-10-29T12:37:05.228Z (about 2 months ago)
• Topics: bot, chatbot, discord, discord-bot, fun, hacktoberfest, moderation, modular, music, python, trivia
• Language: Python
• Homepage: https://docs.discord.red
• Size: 78.9 MB
• Stars: 4,801
• Watchers: 213
• Forks: 2,303
• Open Issues: 289
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.rst
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md

Awesome Lists containing this project

README

        


  


  

  


  Red Discord Bot

  




Music, Moderation, Trivia, Stream Alerts and Fully Modular.




  

    

  

  

     

  

  

    

  

  

     

  

  

    

  





  

    

  

  

    

  

  

    

  

  

    

  

  

    

  





  Overview

  •

  Installation

  •

  Documentation

  •

  Plugins

  •

  Community

  •

  License



# Overview

Red is a fully modular bot – meaning all features and commands can be enabled/disabled to your

liking, making it completely customizable. This is a *self-hosted bot* – meaning you will need

to host and maintain your own instance. You can turn Red into an admin bot, music bot, trivia bot,

new best friend or all of these together!  

[Installation](#installation) is easy, and you do **NOT** need to know anything about coding! Aside

from installing and updating, every part of the bot can be controlled from within Discord.

**The default set of modules includes and is not limited to:**

- Moderation features (kick/ban/softban/hackban, mod-log, filter, chat cleanup)

- Trivia (lists are included and can be easily added)

- Music features (YouTube, SoundCloud, local files, playlists, queues)

- Stream alerts (Twitch, Youtube, Picarto)

- Bank (slot machine, user credits)

- Custom commands

- Imgur/gif search

- Admin automation (self-role assignment, cross-server announcements, mod-mail reports)

- Customisable command permissions

**Additionally, other [plugins](#plugins) (cogs) can be easily found and added from our growing

community of cog repositories.**

# Installation

**The following platforms are officially supported:** 

- [Windows](https://docs.discord.red/en/stable/install_guides/windows.html)

- [MacOS](https://docs.discord.red/en/stable/install_guides/mac.html)

- [Most major linux distributions](https://docs.discord.red/en/stable/install_guides/index.html)

If after reading the guide you are still experiencing issues, feel free to join the

[Official Discord Server](https://discord.gg/red) and ask in the **#support** channel for help.

# Plugins

Red is fully modular, allowing you to load and unload plugins of your choice, and install 3rd party

plugins directly from Discord! A few examples are:

- Cleverbot integration (talk to Red and she talks back)

- Ban sync

- Welcome messages

- Casino

- Reaction roles

- Slow Mode

- AniList

- And much, much more!

Feel free to take a [peek](https://index.discord.red) at a list of

available 3rd party cogs!

# Join the community!

**Red** is in continuous development, and it’s supported by an active community which produces new

content (cogs/plugins) for everyone to enjoy. New features are constantly added. If you can’t

[find](https://index.discord.red) the cog you’re looking for,

consult our [guide](https://docs.discord.red/en/stable/guide_cog_creation.html) on

building your own cogs!

Join us on our [Official Discord Server](https://discord.gg/red)!

# License

Released under the [GNU GPL v3](https://www.gnu.org/licenses/gpl-3.0.en.html) license.

Red is named after the main character of "Transistor", a video game by

[Super Giant Games](https://www.supergiantgames.com/games/transistor/).

Artwork created by [Sinlaire](https://sinlaire.deviantart.com/) on Deviant Art for the Red Discord

Bot Project.

This project vendors [discord.ext.menus](https://github.com/Rapptz/discord-ext-menus) package made by Danny Y. (Rapptz) which is distributed under MIT License.

A copy of this license can be found in the [discord-ext-menus.LICENSE](redbot/vendored/discord-ext-menus.LICENSE) file in the [redbot/vendored](redbot/vendored) folder of this repository.