summaryrefslogtreecommitdiff
path: root/README.markdown
blob: 1183fc25427dcb1f9bb652c7ad68471c1a4a91e3 (plain)
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
32
33
34
35
## privateroombot

this bot allows you to automatically create private voice chats. per person.

simply join a voice channel and get redirected to your own private channel where you can move all your friends in.

### setup

download a [![Github Releases](https://img.shields.io/github/downloads/romangraef/privateroombot/latest/total.svg)][2] and put in a separate folder.
also add a file called `config.json` with the following content:

```json
{
  "token": "TOKEN",
  "from_channel_id": "the channel you want people to join in order to get an own channel. see ID's",
  "category_id": "the channel category you want all channels to be collected in. see ID's",
  "format": "(optional). put the name of the private room channel in here. %s will be replaced with the name."
}
```
you can get your bots token from [the discord developers page][1]
there create an application with botuser associated. paste the bot users token in the config.

#### on your server

create a channel category for all private channels. put the "get private channel"-channel in there, but NOT the "wait for move"-channel. disallow connecting for the category, but explicitly reallow it for the "get private room"-channel. create a "waiting for move"-channel and allow moving others for @everyone and disallow speaking. done.


#### ids
discord ids identify a channel/user. you can view them by 

- going to your settings -> appearance -> developer mode
- right-click on the channel -> copy id. then paste in the `config.json`

[1]: https://discordapp.com/developers/applications/me
[2]: https://github.com/romangraef/privateroombot/releases/latest