Bumbling Bard 🎶

A musical companion for Discord, bringing the spirit of a tavern bard to your voice channels!

Overview

Bumbling Bard is a Discord bot designed to enhance your server with a variety of entertainment and utility features. It allows users to:

• Play music: Search for and play songs from YouTube and Spotify directly into voice channels.
• Manage Playlists: Create, save, and manage song queues.
• Dice Rolling: Roll various types of dice for tabletop-style games or random outcomes.
• NPC Generation: Generate random non-player characters with basic traits.
• Loot Tables: Generate loot based on specified rarity or a general table.
• Interactive Menus: Use engaging interactive menus for certain commands, enhancing the user experience.

Features

Here's a taste of what Bumbling Bard can do:

• Music Magic:

  • Use b!sing <song name/URL> to play songs from YouTube or Spotify.
  • Manage playback using queueing, pausing, and skipping commands.

  

• Tavern Time:

  • Use b!tavern to access an interactive menu for exploring taverns, getting drinks, and interacting with your surroundings.

  

• Dice Rolls:

  • Use b!roll <dice notation> (e.g., b!roll 1d20, b!roll 2d6+2) to roll various dice combinations.

  

• NPC Generator:

  • Use b!npc to generate a random non-player character.

  

• Loot Generation:

  • Use b!loot to generate a random loot table.

  

Getting Started

Follow these instructions to get Bumbling Bard running on your Discord server:

Prerequisites

• Python 3.7 or higher: Make sure you have a compatible version of Python installed.
• Discord Bot Token: Create a Discord bot application on the Discord Developer Portal and obtain its bot token.
• Spotify API Credentials: Create a Spotify developer application and obtain its Client ID and Client Secret.

Cloning the Repository

1. Clone the repository:

   git clone https://github.com/Yoguti/hosting-bardbot.git

2. Navigate to the project directory:

   cd hosting-bardbot

Installation

1. Create a virtual environment (optional, but recommended):

   python3 -m venv venv

2. Activate the virtual environment:
   • On Linux/macOS:

     source venv/bin/activate

   • On Windows:

     venv\Scripts\activate

3. Install the requirements:

   pip install -r requirements.txt

Configuration

1. Create a .env file: Create a .env file in the project root.

2. Add your secrets: Add the following content to the .env file, replacing the placeholders with your actual tokens and credentials:

   DISCORD_TOKEN=YOUR_DISCORD_BOT_TOKEN
   SPOTIFY_CLIENT_ID=YOUR_SPOTIFY_CLIENT_ID
   SPOTIFY_CLIENT_SECRET=YOUR_SPOTIFY_CLIENT_SECRET

Running the Bot

1. Run the bot:

   python bard.py

   The bot should now be online and ready to receive commands in your Discord server.

Contributing

Contributions to this project are welcome! If you have any feature requests or bug reports, please submit them as issues or pull requests.

License

This project is licensed under the MIT License. You are free to use, copy, modify, and distribute this software as long as you include the original copyright notice and license in any copies. For more details, see the LICENSE file.