# Introduction Welcome to the official EmpyManager's Docs Here you will find everything you need to properly configure [EmpyManager](https://empymanager.com/) Discord Bot. ### What is EmpyManager? It's a Discord bot that allows your users to create and manage temporary channels by simply joining a channel. You can fully customise about everything of EmpyManager. ### Where to get started? {% content-ref url="/pages/-MUEJC3B-N1VcksBJ-wl" %} [How to Create Temporary Channels on Discord (Quick Start)](/getting-started/create-temporary-channels) {% endcontent-ref %} {% content-ref url="/pages/-MUEMX\_uozCR6IjiYll1" %} [Master Channels](/master-channels/creating-a-master-channel) {% endcontent-ref %} {% content-ref url="/pages/-MUV4BTS7pCXnpZTkcWl" %} [Server Configuration](/server/configuration) {% endcontent-ref %} # How to Create Temporary Channels on Discord (Quick Start) You can use **EmpyManager** to allow your users to create **temporary channels** on **Discord**. 1. [Click on this link](https://empymanager.com/invite) to add EmpyManager bot to your server 2. Type `/setup` to create a **Master Channel** 3. **Done**! Now you or your users can join the channel to create **your own temporary channels**! ### Extra: customize much more! Now that you have your **Master Channel:** * You can simply **change its name**, **change user limit** and **change permissions** as you would do with any Discord channel. * Choose more advanced permissions on the [dashboard](https://dashboard.empymanager.com/). * [Configure your server.](/getting-started/basic-configuration) # Basic Configuration ### Global Server Configs * Go to the [dashboard](https://dashboard.empymanager.com/guilds) * Click your server in the list and click *Edit Settings* under *General Settings*. * Change what you want, like: ![The prefix the bot will use](/files/ZZuoqNE8qx1Du9mk39Kq) ![Whether the bot should create text channels for normal channels](/files/uiFQTfMBLa4dqoa5ldWx) ### Master Channel Configs The first thing to have temporary channels is to create a **Master Channel**: * Type `/setup` in your server * Or go to the [dashboard](https://dashboard.empymanager.com/guilds), select your server and create your Master Channel there To edit your Master Channel: * Go to the [dashboard](https://dashboard.empymanager.com/guilds) * Click your server in the list and select your *Master Channel* in the main page. * Change what you want, like: ![The name of the created channels](/files/EFZuBJziZZkfHfMFb8Zd) ![What the channel owner should be able to do](/files/Chvb7WQhFBlM4DAbeMeT) {% content-ref url="/pages/-MUENRCswpPsrVGjS0YZ" %} [Master Channel's Settings](/master-channels/settings) {% endcontent-ref %} {% content-ref url="/pages/-MUV4BTS7pCXnpZTkcWl" %} [Server Configuration](/server/configuration) {% endcontent-ref %} # Commands These are all the commands available for EmpyManager. ## For Normal Users {% hint style="warning" %} EmpyManager is now migrating to Discord's [**Slash Commands**](https://support.discord.com/hc/it/articles/1500000368501-Slash-Commands-FAQ), which are commands that start with a `/` and will appear in the dropdown list as hints. If you don't see them, please tell your server admin to [update EmpyManager's permissions](https://empymanager.com/invite). {% endhint %} | Command | Description | Requirement | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- | | `/help` | Shows all the commands available to the user. | | | `/private` \| `/public` | Turn your room private / public. A private room means you that no one will be able to enter unless you invite them with `/invite @user` or you add them in the permissions window. | Must be owner of the channel. | | `/hide` \| `/show` | Hide or show your room. A hidden room will not be seen by normal users outside of it unless they are invited by the owner. | Must be owner of the channel. | | `/kick @user` | Kick @user from your channel. | Must be owner of the channel. | | `/claim` | Become the new owner of the channel. | The owner of the channel must have left the room. | | `/invite @user` | Get an invite to the channel. If a user is specified, they will get a DM with a link to the channel + they will gain access if the room is private. | Must be owner of the channel. | | `/rename ` | Rename your current channel. | Must be owner of the channel. | | `/limit ` | Set the user limit of your current channel. | Must be owner of the channel. | | `/bitrate ` | Set the birate of your current channel. | Must be owner of the channel. | ## For Server Admins Server admins can perform these commands which are mostly used to configure the bot. Instead of these commands, we suggest to use the [Dashboard](https://dashboard.empymanager.com), which is easier to configure. | Command | Description | More Info | | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | `v/setup` | Start the guided setup of a Master Channel. | [More Info](/master-channels/creating-a-master-channel#how-to-create-a-master-channel). | | `/permanent` |

Make a temporary channel permanent or turn a permanent channel into temporary.

Permanent channels behave like temporary channels (they have a owner, etc.), but they won't be deleted once everyone leaves.

| | | `v/dashboard` | Get a link to the EmpyManager's Dashboard. | | | `v/settings master on` | Turn a normal channel into a Master Channel. | [More info.](/master-channels/creating-a-master-channel#what-is-a-master-channel) | | `v/settings master off` | Turn a Master Channel into a normal channel. | | | `v/masterlist` | See a list of all the master channels. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). | | `v/resetmasters` | Turn all your master channels into normal channels | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). | | `v/settings prefix ` | Change EmpyManager's commands prefix. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). | ### Settings This section is meant for a more advanced use of EmpyManager. #### Master Channels These options are set for each Master Channel. | Command | Description | More Info | | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `v/settings master ` | Get info about a Master Channel. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Access the **Master Channel**'s page. | | `v/settings master ` | Enable / Disable a Master Channel. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). | | `v/settings template ` | Set a new `voice`or `text`template for the channels created from this Master Channel. The template will be used to choose the name of the channel. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Access the **Master Channel**'s page and go under *Voice / Text Channel Names*. | | `v/settings category ` | All the channels from the specified Master Channel will be created inside the specified category. \[Premium only] | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). | #### General Settings These are settings that are valid in your whole server. | Command | Description | More Info | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `v/settings invites` | You will be prompted with a dialog asking whether to enable/disable invites for the server. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Go to the **General** settings. | | `v/settings waitingroom ` | Set a new template for the waiting rooms in your server. You can use these variables: `%owner%` and `%channel%.` | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Go to the **General** settings. | | `v/settings channelSync ` | With `on` channels will inherit permissions from the category they are created in \[Premium only]. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Go to the **General** settings. | #### Text Channels | Command | Description | More Info | | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `v/settings userchanneltext ` | Same to `userChannelText` but for only one specific master channel (`default` will use same option as server) \[Premium only] | | | `v/settings normalchanneltext ` | With `on` the bot wil create a text channel for every normal channel. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Go to the **General** settings. | | `v/settings userchanneltext ` | With `on` bot will create a text channel for every temporary channel. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Go to the **General** settings. | | `v/settings logging ` | Bot will send a text file in the `logChannel`, logging messages and actions. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Go to the **General** settings. | | `v/settings logChannel ` | Bot will send there logs if `logging` is enabled | Deprecated, use the [dashboard](https://dashboard.empymanager.com/). Go to the **General** settings. | #### Temporary Channel Permissions | Command | Description | More Info | | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `v/settings managechannel ` | With `on` channel owners can edit their channels (name, user limit, bitrate). | Deprecated, use the [dashboard](https://dashboard.empymanager.com/) (Access the master channel and go to the **Permissions** tab). | | `v/settings quickCommands ` | With `on` channel owners can edit their channels through quick commands (private, lock, etc.). | Deprecated, use the [dashboard](https://dashboard.empymanager.com/) (Access the master channel and go to the **Permissions** tab). | | `v/settings quickCommand ` | Enable or disable a specific `quickCommand` for a Master Channel (`private`, `lock` or `waitingroom`). Available quick commands are listed [here](/master-channels/settings#quick-commands). \[Premium] | Deprecated, use the [dashboard](https://dashboard.empymanager.com/) (Access the master channel and go to the **Permissions** tab). | | `v/settings manageRoles ` | Choose whether the user has the `Manage Roles` permissions (change user's access to the room, edit their permissions, etc...) on its channel created from the `master` channel. | Deprecated, use the [dashboard](https://dashboard.empymanager.com/) (Access the master channel and go to the **Permissions** tab). | # Frequently Asked Questions ## Why does EmpyManager have Admin permissions by default? {% content-ref url="/pages/MEAIB4YajilCfb3sCrOl" %} [Admin Permissions](/admin-permissions) {% endcontent-ref %} ## How can I allow only certain roles to join temporary channels? There are different solutions to this: #### Default settings Without changing any bot option: simply open the Master Channel's settings on Discord. In the **Permissions** tab, add the role you want and give it the `Connect` permission. Secondly, edit the `@everyone` role and make sure `Connect` is denied. #### Change permission syncing to category In the [dashboard](https://dashboard.empymanager.com/), select your server -> select your Master Channel. Here, find `Permissions Syncing` and set it to `Sync permissions from the category`. On Discord, you can now edit the category where the channels are created: in the permissions tab, add the role you want and give it the `Connect` permission. Secondly, edit the `@everyone` role and make sure `Connect` is denied. With this method, you can configure the bot so that only some roles can join the temporary channels, **but you can also choose different roles that can create the temporary channel** by editing the Master Channel's permissions on Discord. # Admin Permissions ## Are admin permissions for the bot required? No, you can use the command `/setup` without admin permissions and the bot will explain how to configure it without admin permissions. ## Why does the bot ask for admin perms? EmpyManager requires the `Manage Permissions` permission inside the category in order to properly create channels there. For some reasons, creating a category with such permissions can only be done with admin permissions. Therefore, the bot asks for admin permissions by default to directly create the category without any effort by the user. ## How to use the bot without admin perms? * Create a category * Add full permissions to the bot in the category * Complete the creation with the slash command `/setup-category ` # Premium System **Premium** is a subscription-based model to support the bot while getting more features. There are two premium tiers: **Premium** and **Premium+**. Both tiers unlock all the settings and commands, but Premium+ has fewer limits (it has unlimited Master Channels, for example). These limits are listed [here](https://dashboard.empymanager.com/premium). If you are looking for how to enable premium in your server, see the guide below: {% content-ref url="/pages/-MZZpdI8\_a3C7ClLwrqc" %} [How to enable Premium](/guides/enable-premium) {% endcontent-ref %} ### Premium Provider Once a user is subscribed to premium, they will be able to enable it on one or more servers they choose (1 for Premium, 3 for Premium+). When a server becomes premium, the user that enabled it is called **premium provider** of the server. A premium subscription for a server is strictly linked to the premium provider's subscription; if the premium provider unsubscribes, the server will stop being premium. #### Enable Premium A premium user can enable premium on one or more servers of their choice with the command `/premium enable`. The user will become **premium provider** of the server. #### Disable Premium The server's premium provider or the server's administrators can disable premium for the server with the command `/premium disable [server-id]`. The premium provider will stop being provider for this server and will be able to enable their subscription on another server. #### Inactive Premium A premium subscription for a server is strictly linked to the premium provider's subscription; as such, it will become inactive if: * the premium provider unsubscribes; * the premium provider downgrades from Premium+ to Premium and the server exceeds the available slots. If the conditions above stop subsisting, the server will become premium again until it is disabled. # Creating a Master Channel ## What is a Master Channel? A **Master Channel** is a special channels your users can use in order to create their own temporary rooms. Creating a Master Channel is as easy as typing one command. ## How to create a Master Channel ### The command There are two commands to create a Master Channel: with the `em!setup`comand, the bot will guide you through a setup process to configure your channel. ``` /setup ``` ### Customization Now that you have your **Master Channel**, you can simply **change its name**, **change user limit** and **change permissions** as you would do with any Discord channel. Read the other pages of this guide to see how to further customize your master channel. # Master Channel's Settings 1. Go to the [dashboard](https://dashboard.empymanager.com). 2. Select your server. 3. Select your Master Channel under "Master Channels". ![](/files/jeYD8lgnp9IcnkTEOuVI) 4\. You may now edit your Master Channel! ![](/files/sRdGsQLJSX2tvY54nLyn) ## General Settings ### Voice channel names ![](/files/huSGbO0t9LXQlbkzySeu) Under "General" tab, you can choose what name temporary voice channels will have once created. You can use these variables that will be replaced: | Variable name | What will be replaced with | | ------------- | ------------------------------------- | | `%owner%` | The name of the owner of the channel. | | `%counter%` | The number of the channel. | ### Permissions Syncing ![](/files/khmOeqHN4oveNh2VkpVX) Under "General" tab, find permissions syncing option. This option decides how temporary channels' permissions should be. Available choices are: * ***No permissions synced*** * ***Sync permissions from Master Channel***: Master Channel's permissions will be copied into temporary channels. * ***Sync permissions from the category***: category's permissions will be copied to temporary channels. ## Permissions Settings Find these settings under *Permissions* tab. ![](/files/HK4EAHgsNuzu9onuBbzo) ### Linked Roles ![](/files/3gl4dD0xKNZUGwyArxi9) *Linked Roles* will be assigned when a user is connected to a temporary channel and will be removed when they leave. ### Owner's Permissions ![](/files/iGIBymwjZYG7qR3pe7Nu) With *Basic Editing Mode* enabled, you get the following options: * ***Manage Channel***: the ability of the users to edit channel names, bitrate, limit. Includes some commands like `/rename`, `/bitrate`, `/kick`, `/ban`, etc. * ***Manage Roles***: will give the users the Discord's *Manage Permissions* permissions, allowing them to edit permissions in their channels. **Warning**: with this enabled, users may give themselves dangerous permissions such as *mute* and *deafen*. Use at discretion. * ***Quick Commands***: the ability of users to use quick commands such as `/private`, `/public`, `/hide`, etc. ## More permissions There are much more options to edit. Find them in the same page! # Server Configuration Apart from Master Channels' settings, you can also customise your server globally with some simple commands. ### Prefix Change the prefix (default: `em!`) with the command: ``` em!settings prefix ``` ### Invites You can enable/disable invites for your users' channel with the following command: ``` em!settings invites ``` You will be asked if you want to enable or disable invites; respond with the reactions. ### Channel Sync The **channel sync** option (off by default) will make all temporary channels inherit permissions from the category they are created in. Change it with the command: ``` em!settings channelsync ``` ### Normal Channel Text The **normal channel** **text** option (on by default) will make all of your normal channels create a temporary text channel linked to them, which will be deleted when everyone leaves the channel. Change the option with: ``` em!settings normalChannelText ``` ### User Channel Text The **user channel text** option (on by default) will make all of your normal channels create a temporary text channel linked to them, which will be deleted when everyone leaves the channel. Change the option with: ``` em!settings userChannelText ``` You can disable one single master channel's user channel text option with the command: ``` em!settings userChannelText ``` ### Waiting Room Name The **waiting room** option will allow you to decide the name of the waiting rooms in your server. Change it with: ``` em!settings waitingRoom ``` You can use these variables in your waiting room's names: `%owner%` and `%channel%.` ### Logging The **logging** options allow you to customise how the bot will log your user's actions. Enable/Disable logging with: ``` em!settings logging ``` You'll also need to choose where logs should be sent with: ``` em!settings logChannel #your-channel ``` EmpyManager will send notifications (channel creation and channel destruction) in the selected channel + a plain text file containing all text channel's messages and actions (user joining, user leaving, user editing a message, user deleting a message, etc). # How to enable Premium **Premium** subscription is a way to support EmpyManager and get extra features with it. More information [here](https://dashboard.empymanager.com/premium). ### How to subscribe and enable Premium 1. Subcribe on [Patreon](https://www.patreon.com/Nexgan). 2. Join the [official Discord server](https://discord.gg/gtqu2T6). 3. Connect your Patreon account to your Discord account: [guide here](https://support.patreon.com/hc/en-us/articles/212052266). 4. Use slash command `/premium enable` where you want to enable Premium (remember: 1 server for Premium and 3 for Premium+). Remember: you can change your premium servers at any time. Just type `/premium disable ` to disable it and then enable it in another server with `/premium enable`. ### Troubleshooting #### I didn't receive my role on the Discord server Make sure you properly connected your Patreon account to your Discord account as explained [here](https://support.patreon.com/hc/en-us/articles/212052266). If this didn't work, please try to disconnect and connect back your accounts. If this hasn't worked yet, join our [official Discord server](https://discord.com/invite/gtqu2T6) here to get support. # How to implement a verification system There are more options to make EmpyManager compatibly to a verification system. ### Channel Syncing (Premium) [Channel Syncing ](https://docs.empymanager.com/server/configuration#channel-sync)will make all your channels inherit from the category they are created in. In this way you can give permissions only to certain users to view/join the Temporary Channels. ### Discord's Verification System Instead of using channel syncing, we suggest to free users to enable Discord's verification system. It is safer than any other bot's system and users won't be able to join channels without being verified. ### Remove Global Permissions If none of the above solutions fits you, you can always remove the "View Channel" permissions from @everyone in your server's global settings and then add it only in the channels that non-approved users should be able to see. Then, you should grant the "View Channel" permissions to your **Verified** role. In this way, all the non-specified channels (including EmpyManager's channels) will be hidden by default to non-verified users.