Skip to content

Latest commit

 

History

History
117 lines (77 loc) · 2.76 KB

README.md

File metadata and controls

117 lines (77 loc) · 2.76 KB

Discord Poll Bot

Table of Contents

Introduction

The Discord Poll Bot is designed to address the limitations of built-in Discord polls, which restrict the poll duration to a maximum of one week and limit the number of options to ten. This bot allows you to create polls with an indefinite duration and without a limit on the number of options, providing greater flexibility and utility for your Discord server.

Features

  • Create polls with an indefinite duration
  • No limit on the number of options
  • Vote casting through button interactions
  • Anonymous voting
  • Real-time vote counting
  • Admins can delete polls using the poll ID

Installation

Prerequisites

  • Python (v3.7 or higher)
  • Required Python packages listed in requirements.txt

Steps

  1. Clone the repository:

    git clone https://github.com/pdiegel/Discord-Poll-Bot.git
  2. Navigate to the project directory:

    cd Discord-Poll-Bot
  3. Install the required Python packages:

    pip install -r requirements.txt

Configuration

  1. Create a .env file in the root directory of the project.

  2. Add your Discord bot token to the .env file:

    BOT_TOKEN=your_discord_bot_token

Usage

  1. Ensure you have a .env file in the root directory with the following content:

    BOT_TOKEN=your_discord_bot_token
  2. Start the bot:

    python bot.py
  3. Invite the bot to your Discord server.

  4. Use the bot commands to create and manage polls.

Commands

/createpoll

This command creates a poll using a question string and an options string. The options string should be a comma-delimited set of poll options. If there are less than 2 options, the bot will raise a warning.

Example

/createpoll "What's your favorite color?" "Red,Blue,Green"

/deletepoll

This command deletes a poll using the Poll ID. If the poll ID is found, it will create a modal for deletion confirmation and then delete the poll.

Example

/deletepoll 12345

Each Poll ID is shown at the end of each poll message from the bot.

Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/your-feature).
  3. Make your changes.
  4. Commit your changes (git commit -m 'Add some feature').
  5. Push to the branch (git push origin feature/your-feature).
  6. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.