Skip to content

A versatile, open-source Discord bot with welcome messages, role management, leveling, moderation, and YouTube notifications. Built in Python, deployable on Heroku, and uses Firestore for data management.

Notifications You must be signed in to change notification settings

pratyanj/discord-bot

Repository files navigation

Here is a draft README.md file for your open source Discord bot repository:

Discord Bot

This is an open-source Discord bot project developed using Python and Discord.py. The bot includes various features and integrations to enhance the functionality and user experience on Discord servers.

Features

  • Welcome and Leave Messages: Greets new members and bids farewell to leaving members.
  • Customizable Prefix: Allows setting a custom prefix for bot commands on each server.
  • Role Management: Assigns roles to members based on reactions or commands.
  • Leveling System: Tracks and displays user levels based on activity.
  • Moderation: Implements image and link moderation, member count tracking, and more.
  • YouTube Notifications: Notifies about new videos from specified YouTube channels.

Setup

  1. Clone the repository:
  2. Create and activate a virtual environment
    • python -m venv venv
    • source venv/bin/activate (Linux/MacOS) or venv\Scripts\activate (Windows)
  3. Install requirements: pip install -r requirements.txt
  4. Set up Firebase:
    • Obtain the Firebase service account key file (TO_bot.json) and place it in the project directory.
    • Make sure to set up Firestore according to the bot's database requirements.
  5. Add your bot token in config.py
  6. Run the bot: python main.py

Commands

  • $setwelcomechannel - Set the welcome channel
  • $setleavechannel - Set the leave channel
  • $setprefix - Set custom prefix
  • $createCAT - Create a category
  • $clear - Clear messages
  • $checkpermissions - Check bot permissions
  • $lvl - Check your level
  • $rank - Check your rank
  • $lvlsys enable - Enable leveling system
  • $lvlsys disable - Disable leveling system

Database

The bot uses Firestore for:

  • Storing server prefixes
  • Level system data
  • Welcome/leave channels
  • Other data

Deployment

The bot can be deployed to Heroku or any other hosting platform that supports Python applications.

Contributing

Contributions are welcome! Please open an issue or submit a pull request if you would like to contribute to this open source project.

Credits

Let me know if you would like me to expand or modify anything in this open source README draft. I'd be happy to help further polish it for your repository!

About

A versatile, open-source Discord bot with welcome messages, role management, leveling, moderation, and YouTube notifications. Built in Python, deployable on Heroku, and uses Firestore for data management.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages