https://github.com/henkelmax/simple-voice-chat-bot
The Simple Voice Chat Discord Bot.
https://github.com/henkelmax/simple-voice-chat-bot
bot discord discord-bot simple-voice-chat
Last synced: about 2 months ago
JSON representation
The Simple Voice Chat Discord Bot.
- Host: GitHub
- URL: https://github.com/henkelmax/simple-voice-chat-bot
- Owner: henkelmax
- Created: 2022-08-14T08:43:57.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2026-04-10T18:05:17.000Z (3 months ago)
- Last Synced: 2026-04-10T19:29:17.880Z (3 months ago)
- Topics: bot, discord, discord-bot, simple-voice-chat
- Language: Java
- Homepage:
- Size: 245 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Simple Voice Chat Discord Support Bot
The Simple Voice Chat Discord Bot.
## Functionality
The bot initially sends a message in the support channel (This will get deleted and re-sent after the bot restarted).
Users can then press the `Get Support` button and the bot will create a thread and notifies the user.
In the meantime users get prompted to enter a support key in their support thread.
After providing the support key, the user gets prompted to choose their issue.
After selecting an issue from the dropdown, the user gets additional information about the selected issue,
as well as a set of questions, specifically tailored for the chosen issue.
Until now the user wasn't able to write any messages in the thread.
After answering the questions, the user needs to press the `Confirm` button.
This will trigger a message in the **notification channel**.
Now support staff can join the thread and answer the questions.
In the case, the user selected the wrong issue,
support can change the questions by typing the command `/issue `.
This will trigger the same messages, that would have been sent when a user selects an issue from the dropdown.
If you want the user to be able to write messages before completing the process, you can enter the `/unlock` command.
You can lock threads by entering the `/close` command
(This does the same thing as the user pressing the `I don't need support anymore` button).
This will create a message in the thread, letting the user know who locked the thread.
There will also be an update of the original message in the **notification channel**,
notifying staff that the thread doesn't need looking into again.
Admins can also clean up the thread database by locking all threads that are older than a week
by entering the `/cleanup` command.
## Additional Notes
- The bot doesn't keep track of locked threads anymore, so please don't re-open them.
- Normal users shouldn't have permission to write messages in the support channel.
## Environment Variables
| Variable | Default value | Description |
|-----------------------------------|---------------|------------------------------------------------------------------------------|
| `TOKEN` | *Required* | The discord bot token |
| `DB_PATH` | `database.db` | The path to the sqlite database |
| `SERVER_ID` | *Required* | The server ID |
| `SUPPORT_CHANNEL_ID` | *Required* | The support channel ID |
| `SUPPORT_THREAD_CHANNEL_ID` | *Required* | The support thread channel ID |
| `SUPPORT_NOTIFICATION_CHANNEL_ID` | *Required* | The notification channel ID |
| `LOGS_CHANNEL_ID` | *Required* | The log channel ID |
| `SUPPORT_ROLE` | *Required* | The support role |
| `NO_PING_ROLE` | *Required* | The role that shouldn't be pinged |
| `DEFAULT_VOICE_CHAT_PORT` | `24454` | The default voice chat port |
| `PORT_CHECKER_ATTEMPTS` | `10` | The number of attempts to check the port |
| `PORT_CHECKER_TIMEOUT` | `1000` | The timeout in milliseconds to check the port |
| `SUPPORT_STALE_DAYS` | `3` | The number of days after which a support thread is considered stale |
| `SUPPORT_UNINITIALIZED_HOURS` | `3` | The number of hours after which a support thread is considered uninitialized |