index — Deutsche-Haus-Bot @ 726b961544d678516d96d4f5966add831ae866c2

Discord bot to dynamically create voice chats for clubs that boosters can create

README.md (view raw)

 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
# Deutsche Haus Bot

This was just supposed to be a quick "script" of a bot, so the code is in no way anywhere close to readable.
At some point after 4 or so refactors, I just decided to finish the bot no matter how ugly the code is and then potentially fix it up later.

## Functionality

- boosters can create a club (role with name and color, channel name adhering the dh channel naming scheme)
- club owners can add members to their club
- club members can join a join-to-create voice channel
    - they can select one of their clubs in a message interaction with the bot in the text channel of said voice channel
    - upon selecting one, a voice channel, only accessible to its club's members is created
    - they are moved to the new voice channel
    - once the created voice channel is empty, it is deleted

## Deployment
Create a bot applicationon on https://discord.com/developers/applications and give the bot read message intents.
Add the bot to your server and give it at least `Manage Channels`, `Manage Roles`, `Move Members`, `Mute Members`, `Deafen Members`, `Send Messages` and `View Channels` permissions

Add your bot's token into a bot_token.py file in a format of `token = ""`

Replace the ID in the `dm()` function in the `bot.py` with your own UID (or remove the calls to it if you don't want it)

Install the necessary **dependencies** with `pip install -r requirements.txt`

Run the bot with `python bot.py`

## ToDo
- implement role headers properly
- allow to remove members from club
- don't create several channels, if two people open the same club