# Tempy 2.0

Give your members their own place to talk.

## 📚  Welcome to the Tempy Bot Documentation!

Tempy is a Discord bot for creating temporary voice channels. If a user joins the so-called Creating channel, a Tempy voice channel is automatically created; if the user leaves it, it is automatically deleted again. Result: Your Discord server will look a lot nicer and tidier!


# Change log

All changes for Tempy, including bug fixes, as well as new features and new commands

<details>

<summary>Tempy 2.0.5</summary>

*Published at: 16.01.2023*

Below you can see all the changes made with the above mentioned version of Tempy.

* Tempy's performance has been improved for a faster and more efficient experience.

</details>

<details>

<summary>Tempy 2.0.4</summary>

*Published at: 15.01.2023*

Below you can see all the changes made with the above mentioned version of Tempy.

* Many processes were outsourced that slowed down Tempy, these processes are now running on other bot instances as *Tempy Community*.
* Command mentions in response texts are now clickable.
* The status page for Tempy officially launched, it updates every 10 seconds for every single shard and bot instance of Tempy. Check it out [here](http://status.arealwant.com/)!

</details>

<details>

<summary>Tempy 2.0.3</summary>

*Published at: 05.01.2023*

Below you can see all the changes made with the above mentioned version of Tempy.

* From now on, the password command is only visible to the person who executed it, thus protecting the password that was entered.
* All commands from now on have a **loading indicator**, this allows the request more time and prevents the often occurring "The application did not respond" error.
* Manual command not responding successfully fixed.
* As far as someone reaches the highest vote tier (currently tier 3) they'll get the message "You have reached the maximum number of votes for this tier" instead of how many votes they need to reach the next tier.
* Fixed the bug that Tempy wouldn't create Tempy channels after setting a global or local configuration of a category
* Tempy now will take the Tempy channel count and the voice channel count as arguments for the Tempy tags

</details>

<details>

<summary>Tempy 2.0.2</summary>

*Published at: 04.01.2023*

Below you can see all the changes made with the above mentioned version of Tempy.

* Rewritten the Tempy cache system from synchronous, to asynchronous processing of requests\
  \
  The implementation of asynchronous processing for the Tempy cache system represents a significant optimization of the application's request handling capabilities. By leveraging the inherent concurrency of asynchronous programming, we are able to significantly improve the speed and responsiveness of Tempy, resulting in a superior user experience.
* We have fixed a bug that prevented the creation of Tempy channels upon entering them, allowing users to create channels at any time. This improvement to the Tempy cache system enhances the user experience.

</details>

<details>

<summary>Tempy 2.0.1</summary>

*Published at: 04.01.2023*

Below you can see all the changes made with the above mentioned version of Tempy.

* Added /server autoremove\
  With this command Tempy searches for unused Tempy channels and creating-channels and deletes them from the database and the Discord server.
* Removed task to search for unused creating-channels\
  It didn't work as it was intended
* Changed /global remove to /server remove

</details>


# Setup Tempy

Here you will learn how to easily set up Tempy

## 1. Select the setup of your choice

The setup sets up the channel that your server members can later join to create their Tempy channels. With Tempy you can choose between two different setups.

* **/setup automatic**: Tempy creates and configures a creating-channel for you&#x20;
* **/setup manual**: You can give Tempy a channel which will be used as creating-channel

<figure><img src="https://3484465713-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQXCa0y4TfBUa5KVrZ4zD%2Fuploads%2FyraE4rt6V1hJ2sF6SUf6%2Fimage.png?alt=media&amp;token=a764d5ff-ad19-4ab6-996b-22b2efe7e30b" alt=""><figcaption></figcaption></figure>

From here on, Tempy setup is very self-explanatory. For Tempy to work you just need to start the automatic setup.

{% hint style="info" %}
If you want Tempy to apply specific settings to newly created Tempy channels or to set a specific voice channel as a creating channel,  click on the button below to get to the global or local commands.
{% endhint %}

{% content-ref url="/pages/2L0blf1IDKG9ZXQTaGEL" %}
[Set Settings while setup](/getting-started/setup-tempy/set-settings-while-setup)
{% endcontent-ref %}


# Set Settings while setup

Here you will learn how to set local or global settings already during the setup of Tempy.

## 1. Automatic setup: Set global settings

The global settings describe the settings that Tempy applies to each Tempy channel created by every Creating-channel you have setup on your Discord server.

<figure><img src="https://3484465713-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQXCa0y4TfBUa5KVrZ4zD%2Fuploads%2Fil9IyyvGGYbIzOTn17jg%2Fimage.png?alt=media&amp;token=2cf55131-fbc2-4e0c-a3b8-6c42d2e403ae" alt=""><figcaption></figcaption></figure>

## 2. Manual Setup: Set local settings

The local settings describe the settings Tempy adopts for all Tempy channels created\
by one certain Creating-channel. Local settings are hierarchically over global settings.

<figure><img src="https://3484465713-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQXCa0y4TfBUa5KVrZ4zD%2Fuploads%2FycZrj0B8m4ZjfT8MWkWS%2Fimage.png?alt=media&amp;token=39d41aba-b492-4b4f-8f84-e2d3581beb1d" alt=""><figcaption></figcaption></figure>


# Server Commands

Customize roles that manage Tempy's settings on your server. Fine-tune Tempy's behavior and ensure the correct permissions for role management.

Using following features, you can fine-tune the way Tempy works on your server and ensure that only the roles you choose have the necessary permissions to manage Tempy's settings. Whether you want to give certain users more control over Tempy's behavior or simply want to make it easier for users to create and join temporary channels, these features have you covered.

So, without further ado, let's dive into the documentation and learn how to use these powerful features to their full potential on your Discord server!

<details>

<summary>/server defaultrole</summary>

The "defaultrole" command in the Tempy Discord bot allows users to set a specific role as the replacement for the @everyone role in the server. This can be useful for customizing group communication within the server. To use this command, users must have the appropriate permissions and/or the "manager" role.

</details>

<details>

<summary>/server managerrole</summary>

As the administrator of your Discord server, it is important to designate a specific role that has the ability to manage the settings of the Tempy bot. By assigning the role of Tempy manager, you can ensure that the management of the bot is organized and efficient, and that any changes or updates to its settings are handled in a controlled and responsible manner.

</details>


# Global Commands

Learn how to customize and manage Tempy's temporary voice channels with a variety of commands. Keep your server organized and make it easier for users to join channels.

In this section, we will describe the various commands available for managing Tempy's settings. These commands allow you to customize the behavior and appearance of Tempy's temporary voice channels, as well as the welcome messages and permissions applied to them. Whether you want to fine-tune the way Tempy works on your server or simply want to make it easier for users to create and join temporary channels, these commands have you covered.

So, without further ado, let's dive into the documentation and learn how to use these powerful commands to their full potential!

<details>

<summary>/global limit</summary>

The /global limit command allows you to manage the default channel limit for all new created Tempy channels on your Discord server. This limit determines the maximum number of users that can join a Tempy channel at any given time. Setting a default channel limit can help to ensure that these channels are used efficiently and effectively, and can help to keep the server organized and tidy.

</details>

<details>

<summary>/global voicecreation</summary>

"The "/global voicecreation" command allows you to control whether the bot creates voice channels or not. By default, the bot will create voice channels as specified. However, you have the option to disable this feature using this command. To enable or disable the feature, type "/global voicecreation" followed by "enable" or "disable". This can be useful if you want to temporarily disable the creation of voice channels on your server, or if you want to have more control over the creation process.

</details>

<details>

<summary>/global name</summary>

"The "/global name" command allows you to customize the default naming scheme for all newly created channels on your server. This can be useful if you want to give your channels a more organized and consistent appearance, or if you want to differentiate them from other channels on your server. To use this command, type "/global name" followed by the desired text to be used as the channel name.

</details>

<details>

<summary>/global position</summary>

"The "/global position" command gives you the ability to determine the position of new channels in the channel list on your server. With this command, you can specify the position number for new channels, allowing you to control where they appear in the list. This can be useful if you want to keep certain types of channels grouped together, or if you want to ensure that important channels are easy to find. To use this command, type "/global position" followed by the desired position number.

</details>

<details>

<summary>/global category</summary>

"The "/global category" command allows you to specify the default category for all newly created channels on your server. With this command, you can determine the category that new channels should be placed in. This can be useful if you want to keep certain types of channels organized, or if you want to make it easier for users to find specific channels. To use this command, type "/global category" followed by the desired category.

</details>

<details>

<summary>/global bitrate</summary>

"The "/global bitrate" command gives you the ability to customize the default bitrate for all newly created channels on your server. With this command, you can specify the desired bitrate for new channels in kilobits per second. This can be useful if you want to ensure that channels have sufficient audio quality for specific uses, or if you want to conserve bandwidth on your server. To use this command, type "/global bitrate" followed by the desired bitrate.&#x20;

</details>

<details>

<summary>/global nsfw</summary>

"The "/global nsfw" command allows you to control whether new channels are marked as NSFW or not. With this command, you can toggle the NSFW status of new channels on your server. This can be useful if you want to ensure that sensitive content is only visible to users who have chosen to view it, or if you want to prevent accidental exposure to inappropriate material. To use this command, type "/global nsfw" followed by "enable" or "disable" to enable or disable the NSFW status of new channels.

</details>

<details>

<summary>/global welcome</summary>

"The "/global welcome" command allows you to control whether a welcome message is sent when a new channel is created on your server. With this command, you can toggle the sending of welcome messages for new channels. This can be useful if you want to provide users with information about the purpose or rules of a channel, or if you want to make them feel more welcome on your server. To use this command, type "/global welcome" followed by "enable" or "disable" to enable or disable the sending of welcome messages for new channels.

</details>


# Local Commands

Learn how to customize and manage Tempy's temporary voice channels with a variety of commands. Keep your server organized and make it easier for users to join channels.

In this section, we will describe the various commands available for managing Tempy's settings. These commands allow you to customize the behavior and appearance of Tempy's temporary voice channels, as well as the welcome messages and permissions applied to them. Whether you want to fine-tune the way Tempy works on your server or simply want to make it easier for users to create and join temporary channels, these commands have you covered.

So, without further ado, let's dive into the documentation and learn how to use these powerful commands to their full potential!

<details>

<summary>/local limit</summary>

This command allows you to manage the default channel limit for all new created Tempy channels using a specific creating channel. With this feature, you can set the maximum number of users that can join a Tempy channel at any given time. By setting the limit to a reasonable number, you can ensure that your Tempy channels don't get too crowded or cluttered, helping you to keep your server organized and tidy.

</details>

<details>

<summary>/local voicecreation</summary>

This command allows you to fine-tune the way Tempy works on your server by choosing whether or not it should create voice channels using a specific creating channel. With this feature, you can customize the behavior of Tempy's temporary voice channels to fit your specific needs.

</details>

<details>

<summary>/local name</summary>

"The "/global name" command allows you to customize the default naming scheme for all newly created channels on your server. This can be useful if you want to give your channels a more organized and consistent appearance, or if you want to differentiate them from other channels on your server. To use this command, type "/global name" followed by the desired text to be used as the channel name.

</details>

<details>

<summary>/local position</summary>

This command allows you to manage the channel position for all new created Tempy channels using a specific creating channel. With this feature, you can ensure that Tempy's channels appear in the desired location on your server, helping you to keep your server organized and tidy.

</details>

<details>

<summary>/local category</summary>

This command lets you customize the default category for all new created Tempy channels using a specific creating channel. By choosing the right category for your Tempy channels, you can ensure that they are easy to find and access for your users.

</details>

<details>

<summary>/local bitrate</summary>

This command lets you set the default bitrate for all new created Tempy channels using a specific creating channel. With this feature, you can ensure that your Tempy channels have the best possible audio quality for your users.

</details>

<details>

<summary>/local nsfw</summary>

This command allows you to choose whether or not new creation Tempy channels should be marked as NSFW using a specific creating channel. With this feature, you can ensure that your Tempy channels are only accessible to users who are appropriate for their content.

</details>

<details>

<summary>/local welcome</summary>

This command lets you choose whether or not a welcome message should be sent for all new created Tempy channels using a specific creating channel. With this feature, you can greet your users and provide them with important information as soon as they join a Tempy channel.

</details>


# Channel Commands

Discover the powerful channel commands for managing your Tempy voice channels. Customize channel behavior, appearance, welcome messages, and permissions to fine-tune your server experience.

With these commands, you have full control over your Tempy voice channels. Whether you want to lock your channel to prevent unwanted users from joining, block certain members or roles from entering, or customize the name, user limit, or bitrate of your channel, these commands have you covered.

You can also invite, kick, and mute or deafen members in your channel, or even claim the channel as your own if the original owner has left. With these powerful features at your disposal, you can customize your Tempy channels to suit your needs and ensure a seamless experience for your users.

So, without further ado, let's dive into the documentation and learn how to use these powerful channel commands to their full potential on your Discord server!

<details>

<summary>NEW: Make your Tempy channels exclusive with password protection!</summary>

### The password commands

1. The /channel password join command allows you to enter a locked Tempy channel by providing the correct password. Simply type /password join followed by the password, and you'll be able to join the locked channel.
2. The /channel password remove command allows you to remove the password from a locked Tempy channel, making it open to all users again. Simply type /password remove to remove the password from the channel you're currently in.
3. The /channel password set command allows you to lock a Tempy channel with a password, so only users who know the password can join. Simply type /password set followed by the desired password to lock the channel you're currently in. You can use the password parameter to specify the password you want to use for the lock.

</details>

<details>

<summary>/channel lock</summary>

The "lock" command allows you to make your Tempy voice channel appear locked to all users. This means that other users will not be able to join your channel, even if they are given an invitation or have the necessary permissions. Use this command to restrict access to your channel and keep it private.

</details>

<details>

<summary>/channel unlock</summary>

The "unlock" command allows you to make your Tempy voice channel joinable for everyone again. This means that other users will be able to join your channel as usual, provided they have the necessary permissions or are given an invitation. Use this command to restore the default behavior of your channel and make it open to everyone.

</details>

<details>

<summary>/channel block</summary>

The "block" command allows you to block a specific member or role from your Tempy voice channel. This means that the blocked member or role will not be able to join your channel, even if they have the necessary permissions or are given an invitation. Use this command to prevent specific users or groups from accessing your channel.

</details>

<details>

<summary>/channel unblock</summary>

The "unblock" command allows you to unblock a member or role that was previously blocked from your Tempy voice channel. This means that the unblocked member or role will be able to join your channel as usual, provided they have the necessary permissions or are given an invitation. Use this command to restore the default behavior of your channel and allow access to previously blocked members or roles.

</details>

<details>

<summary>/channel hide</summary>

The "hide" command allows you to hide your Tempy voice channel from other members. This means that your channel will not appear in the server's channel list and will not be accessible to other users, even if they have the necessary permissions or are given an invitation. Use this command to make your channel private and hidden from view.

</details>

<details>

<summary>/channel unhide</summary>

The "unhide" command allows you to make your Tempy voice channel visible for other members again. This means that your channel will appear in the server's channel list and will be accessible to other users, provided they have the necessary permissions or are given an invitation. Use this command to restore the default behavior of your channel and make it visible to everyone.

</details>

<details>

<summary>/channel limit</summary>

Adjust the user limit of your Tempy voice channel, setting the maximum number of users that can join the channel at any given time. This command is useful for when you want to control the number of users that can join your channel, whether to prevent overcrowding or to create a more exclusive experience.

</details>

<details>

<summary>/channel name</summary>

Change the name of your Tempy voice channel, giving it a new and unique identity. This command is useful for when you want to personalize your channel or simply want to give it a new name.

</details>

<details>

<summary>/channel reset</summary>

Reset all settings of your Tempy voice channel, returning it to its default state. This command is useful for when you want to start fresh with your channel or simply want to restore it to its original settings.

</details>

<details>

<summary>/channel bitrate</summary>

Adjust the bitrate of your Tempy voice channel, setting the audio quality of the channel. This command is useful for when you want to optimize the audio quality of your channel for different purposes or simply want to adjust it to your liking.

</details>

<details>

<summary>/channel onlyfor</summary>

Allow only certain users or roles to join your Tempy voice channel, restricting access to a select group of users. This command is useful for when you want to create a private or exclusive channel for a specific group of users.

</details>

<details>

<summary>/channel request</summary>

Request the owner of your Tempy voice channel to join, inviting them to join the channel. This command is useful for when you want to invite the owner of the channel to join, whether to collaborate or simply to chat.

</details>

<details>

<summary>/channel kick</summary>

The /channel kick command allows you to kick a member from your Tempy voice channel. This is a useful feature if you want to remove a user from your channel or enforce rules and regulations.

</details>

<details>

<summary>/channel claim</summary>

The /channel claim command allows you to claim the Tempy voice channel you are currently in, if the owner has left. This is a useful feature if you want to take control of a channel that has been abandoned or left unoccupied.

</details>

<details>

<summary>/channel invite</summary>

The /channel invite command allows you to invite a member to your Tempy voice channel. This is useful if you want to invite someone to join your channel and participate in the conversation.

</details>

<details>

<summary>/channel mute</summary>

The /channel mute command allows you to mute a member in your Tempy voice channel. This means that the member will not be able to speak in the channel until they are unmuted.

</details>

<details>

<summary>/channel unmute</summary>

The /channel unmute command allows you to unmute a member in your Tempy voice channel. This command can be useful if you want to give a member the ability to speak again after they have been muted.

</details>

<details>

<summary>/channel deafen</summary>

The /channel deafen command allows you to deafen a member in your Tempy voice channel. This command can be useful if you want to prevent a member from hearing audio in the channel.

</details>

<details>

<summary>/channel undeafen</summary>

The /channel undeafen command allows you to undeafen a member in your Tempy voice channel. This command can be useful if you want to give a member the ability to hear audio again after they have been deafened.

</details>


# Session Commands

Manage your Tempy voice channel sessions with these commands. Customize your temporary channels and make them easy to recreate with these powerful tools.

These commands allow you to save, load, and delete the settings of your Tempy voice channels. With the /session save command, you can save the current permissions, name, and other settings of your Tempy channel in the database, to be used later on. The /session load command allows you to apply a previously saved session to your current Tempy channel, while the /session delete command removes a stored session from the database.

Using these powerful commands, you can easily customize and manage the settings of your Tempy channels, without having to manually set up each channel every time. Whether you want to save your favorite configurations for later use or simply want to quickly change the settings of your Tempy channels, these commands have you covered. So, let's dive into the documentation and learn how to use these powerful session management commands to their full potential on your Discord server.

<details>

<summary>/session save</summary>

This command allows you to save or update the current settings of your Tempy voice channel in the database. This includes the channel name, permissions, user limit, and more. You can use this command to create a session that you can later load into a new voice channel, allowing you to easily replicate your channel's settings.

</details>

<details>

<summary>/session load</summary>

This command allows you to load a previously saved Tempy session into your current voice channel. Simply specify the name of the session you want to load, and all of the saved settings will be applied to your current channel. This is a convenient way to quickly set up a new channel with the same settings as a previous channel.

</details>

<details>

<summary>/session delete</summary>

This command allows you to delete a previously saved Tempy session from the database. Simply specify the name of the session you want to delete, and it will be permanently removed from the database. This is useful if you no longer need a particular session or want to free up space in the database.

</details>

With these commands, you can easily save, load, and delete Tempy sessions, allowing you to customize your temporary voice channels with ease and flexibility. Whether you want to save a set of permissions for future use or simply want to keep your saved sessions organized, these commands have you covered.


# Info Commands

These commands allow you to view the version, uptime, memory usage, guilds, users, and latency of your Discord bot.

In this section, we will describe the various commands available for getting information about the bot. These commands allow you to check the current version and status of the bot, as well as other important details about its operation. Whether you want to check the uptime of the bot, see how much memory it is using, or just want to know how many guilds and users it is currently connected to, these commands have you covered. So, without further ado, let's dive into the documentation and learn how to use these powerful commands to their full potential on your Discord server. With just a simple command prefix, you can easily access a wealth of information about the bot's operation and performance, all at your fingertips.

<details>

<summary>/help</summary>

Shows you all Tempy commands and important forwardings.

</details>

<details>

<summary>/info version</summary>

The /info version command allows you to view the current version of the Tempy Discord bot.

</details>

<details>

<summary>/info status</summary>

The /info status command provides information about the current status of the bot, including its uptime, memory usage, number of guilds it is a part of, number of users it can see, and latency. This information can be helpful for debugging and understanding the performance of the bot on your Discord server.

</details>

<details>

<summary>/info overview</summary>

See an overview of all Tempy channels and creating-channels on your server, including the amount of channels, the amount of users in each channel and the owner of each Tempy channel.

</details>


# FAQ and more

Below you can see the most frequently asked or the most important hints when using Tempy.

### How to invite Tempy correctly? <a href="#invite" id="invite"></a>

Please make sure that when you invite Tempy, you leave the permissions Tempy requires untouched. As a rule, Tempy asks for administrator permissions in addition to the necessary permissions. It is best to leave this permission enabled as well, since role permissions can be overridden by channel permissions, it could be that one of Tempy's important permissions will be overwritten this way.

### Why does it say "..." at the end of my channel name?

This happens when you have a channel name that is too long. Tempy recognizes since version 2.0 too long channel names and shortens them with three dots at the end.

### **Why is my channel bitrate lower than I configured?**

This happens when the bitrate you have stored is higher than what your server allows according to its boost level. Tempy detects since version 2.0 too high bitrates and truncates them to the next highest one that is selectable for your server.

### What is the difference between global and local settings? <a href="#difference" id="difference"></a>

**Global settings** = Settings for *every* creating-channel\
**Local settings** = Settings for *only one* specific creating-channel\
If you have set a local setting, it'll be used over the global setting, you can see the default global settings for every Discord server by clicking following button:

{% content-ref url="/pages/43kRVb9eNRUt3fepkGLL" %}
[Default variables for channel creation](/faq-and-more/default)
{% endcontent-ref %}

### The restriction to vote is extremely annoying, why don't you just remove it? <a href="#annoying-votes" id="annoying-votes"></a>

We fully understand how annoying it can be to have to vote so many times for Tempy to be able to use commands. But exactly this for many annoying restriction is for us the most important way to reach many people with our project. We hope that you can understand this somehow.

To make the restriction at least fairer we have done the following:

* We have developed vote tiers, the more often you vote the less often you have to wait for certain commands, by advancing a tier the time how long a vote is valid increases by 6 hours (Example: you have voted over 40 times, so you only have to vote every 24 hours).

<table><thead><tr><th width="172.33333333333331">The vote tier</th><th width="293">How many votes are needed</th><th>How long one vote is valid</th></tr></thead><tbody><tr><td>Tier 0</td><td>-</td><td>Valid for 12+ hours</td></tr><tr><td>Tier 1</td><td>20 or more votes are needed</td><td>Valid for 16+ hours</td></tr><tr><td>Tier 2</td><td>40 or more votes are needed</td><td>Valid for 24+ hours</td></tr><tr><td>Tier 3</td><td>60 or more votes are needed</td><td>Valid for 30+ hours</td></tr></tbody></table>

* We round up the time difference to the last vote
* You get a role listed separately from others and a role according to your tier on our server


# Understanding the Functionality of Tempy Tags

The Tempy tag is a tool that allows users to reference dynamic information within the Tempy Bot. Understanding its functionality is key to effectively using the bot and customizing its behavior.

## What are Tempy Tags?

The Tempy tag is a special tool that can be used within the Tempy Discord bot to reference information about a user or guild. By using the Tempy tag in a specific format, the bot is able to replace the tag with the corresponding information at runtime. This allows users to customize the behavior of Tempy and tailor it to their specific needs. In this documentation, we will be discussing the functionality of the Tempy tag and how it can be effectively used within the Tempy Discord bot. Understanding the use and capabilities of the Tempy tag is essential for making the most of the features offered by Tempy.

## How Do Tempy Tags Work?

{% hint style="success" %}
Copy and paste the Tempy tag(s) shown in the table to customize the Tempy channel names during setup or configuration.
{% endhint %}

<details>

<summary>Examples</summary>

* `/global name {user}'s Channel`\
  Any temporary channels created will be named after the user who created them, followed by "'s Channel". So if a user with the name "ARealWant" and the descriminator "0001" creates a new channel, the channel will be named **"ARealWant#0001's Channel"**.
* `/global name {user.name}'s Channel`\
  Any temporary channels created will be named after the user who created them, followed by "'s Channel". So if a user with the name "ARealWant" creates a new channel, it will be named **"ARealWant's Channel"**.
* `/global name #{tempy_count} | {user.name}'s Channel`\
  Any temporary channels created will be named with a number representing the order in which they were created, followed by a pipe symbol "|" and the name of the user who created them, followed by "'s Channel". So if a user with the name "ARealWant" creates a new channel, it will be named **"#1 | ARealWant's Channel"** if it is the first channel created, "#2 | ARealWant's Channel" if it is the second channel created, and so on.

</details>

| Tempy Tag             | Description                                                | Replaced Examples      |
| --------------------- | ---------------------------------------------------------- | ---------------------- |
| {tempy\_count}        | References the amount of Tempy voice channels              | *14*                   |
| {voice\_count}        | References the amount of all voice channels                | *14*                   |
|                       |                                                            |                        |
| {user}                | References the user object.                                | *ARealWant#0001*       |
| {user.name}           | References the name of the user.                           | *ARealWant*            |
| {user.discriminator}  | References the discriminator of the user.                  | *0001*                 |
| {user.id}             | References the unique ID of the user.                      | *754634421457387670*   |
| {user.created}        | References the date and time the user account was created. | *2022-05-31 18:35:21*  |
|                       |                                                            |                        |
| {guild.name}          | References the name of the guild.                          | *My favourite server!* |
| {guild.id}            | References the unique ID of the guild.                     | *787660599826972683*   |
| {guild.member\_count} | References the number of members in the guild.             | *100*                  |
| {guild.created}       | References the date and time the guild was created.        | *2022-05-31 18:35:21*  |


# Server permissions Tempy needs for proper functioning

Learn about the server permissions that Tempy requires in order to function properly.

In order for Tempy to function properly on your server, there are certain permissions that it requires. These permissions allow Tempy to perform all of its intended tasks and provide the best possible experience for your server. In this section, you can learn more about the specific permissions that Tempy needs, and how to ensure that it has them.

### Why granting Tempy the 'Administrator' permission is recommended

It is strongly recommended to give Tempy the "Administrator" permission because it gives Tempy the highest level of access and control on your server. With the "Administrator" permission, Tempy will be able to perform all of its intended tasks and functions without any restrictions or limitations.

Additionally, giving Tempy the "Administrator" permission allows it to override any conflicting permissions that may prevent it from functioning properly. This ensures that Tempy is able to provide the best possible experience for your server.

{% hint style="success" %}
Overall, granting Tempy the "Administrator" permission is the best way to ensure that it can operate smoothly and effectively on your server.
{% endhint %}

Following permissions are not only necessary in the category where the channel is being created, but also for the channel itself, and ideally for the role as well. In this way, you can ensure that Tempy has the necessary access to perform all of its intended tasks and provide the best possible experience for your server.

| Permission      | Description                                                                                                                                                                                                                       |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Manage Channels | This permission allows Tempy to create, delete, and manage temporary voice channels on your server. Without this permission, Tempy would not be able to fulfill its primary function of creating temporary voice channels.        |
| Manage Roles    | This permission allows Tempy to assign and remove roles from users on your server. This is necessary for Tempy to be able to grant and revoke access to the temporary voice channels that it creates.                             |
| View Channel    | This permission allows Tempy to see the temporary voice channels that it has created on your server. Without this permission, Tempy would not be able to monitor or manage the channels that it has created.                      |
| Connect         | This permission allows Tempy to connect to the temporary voice channels that it has created. Without this permission, users would not be able to use the temporary voice channels that Tempy creates.                             |
| Move Members    | This permission allows Tempy to move users between the temporary voice channels that it has created. This is necessary for Tempy to be able to manage the users in the temporary channels and ensure that they are used properly. |


# Default variables for channel creation

Here are shown the settings that are used by default for the creation of Tempy voice channels

If no specific configurations have been set for a particular Discord channel, the global settings will be applied as the default settings for that channel. This allows for consistent behavior and appearance across all of the temporary voice channels on the server, while still allowing for the option to customize individual channels as needed. By utilizing the global settings feature, it is possible to easily maintain a cohesive and organized server without having to manually set up each channel individually.

<table><thead><tr><th>CREATION</th><th>CATEGORY</th><th>NAME</th><th>LIMIT</th><th>POSITION</th><th>BITRATE</th><th>NSFW</th><th>WELCOME</th></tr></thead><tbody><tr><td>True</td><td>None</td><td>{user.name}'s Tempy</td><td>0</td><td>0</td><td>64000</td><td>False</td><td>False</td></tr><tr><td><pre><code>boolean
</code></pre></td><td><pre><code>discord.CategoryChannel
</code></pre></td><td><pre><code>string
</code></pre></td><td><pre><code>integer
</code></pre></td><td><pre><code>integer
</code></pre></td><td><pre><code>integer
</code></pre></td><td><pre><code>boolean
</code></pre></td><td><pre><code>boolean
</code></pre></td></tr><tr><td><em>The creation of a Tempy channel can be controlled through this boolean setting. It determines whether a temporary voice channel should be created or not.</em></td><td><em>This setting determines the category in which the Tempy channel will be placed. It can be used to specify the organization of the temporary voice channel on the Discord server.</em></td><td><em>This setting determines the name of the Tempy channel that is created. It allows you to customize the label of the temporary voice channel to your liking.</em></td><td>This setting determines the maximum number of users allowed in a Tempy channel at any given time. It can be used to control the size of the channel.</td><td><em>This setting determines the position of the Tempy channel in the channel list. It allows you to specify where in the channel hierarchy the Tempy channel should be placed.</em></td><td><em>This setting determines the audio bitrate of the Tempy channel, which determines the quality and clarity of the audio transmitted in the channel.</em></td><td><em>This setting determines whether a Tempy channel is marked as NSFW (Not Safe For Work). This can be useful for servers that want to restrict access to certain types of content in certain channels.</em></td><td><em>The welcome setting determines whether a welcome message should be sent to users when they join a Tempy channel. This message can be customized and can contain information about the channel and its rules.</em></td></tr></tbody></table>


# Tempy Bot

Start the conversation with a Tempy!

## ✨ Welcome to the Tempy Bot Documentation!

Tempy is a Bot which can create Temp Channels within seconds. A Temp Channel is a Voice Channel (we call them Tempies) which will be deleted, after everybody left the Voice Channel. So you never have to create tons of Voice Channels and spam your server with useless stuff again. Add Tempy to your Discord Server today and benefit from a feature-rich, easy to use and completly free Temp Channel Discord Bot.\
\
**You want to invite Tempy?**\
Invite Tempy by clicking here: [**https://tempybot.me/invite**](https://tempybot.me/invite)

## 🐤 Getting started in under 30 seconds with Tempy!

You can read our detailed and extensive Documentation to get started with Tempy by clicking on *Getting started with Tempy*, as far as you got any questions you can contact us everytime and benefit from a fast and friendly Support, you can find the redirect to our Discord Server by clicking *Discord Server* at the top.\
\
**Any other questions/requests?**\
Feel free to send me an E-Mail: <support@arealwant.tech>


# Tempy Changelog

All changes and updates of Tempy!

## Tempy Version 1.1.2

{% hint style="info" %}
The Tempy Version **1.1.2** is not published yet. This hint will be removed as far as all changes/updates/fixes down below are pushed and available to every Discord server.
{% endhint %}

* **Fix**: Text channel is not being deleted after the Tempy voice channel is empty

## Tempy Version 1.1.1

* **Update**: Tempy User Tags are finally here! [Read more ...](https://docs.tempybot.me/troubleshooting/faq/tempy-user-tags)
* **Update**: The configname command has been revamped and reworked [Read more ...](https://docs.tempybot.me/getting-started-with-tempy/configuration/name)
* **Update**: Channel names are supported by user tags now, you are now able to set a config-channel-name with user tags, should someone create a channel, the user tag will be applied to the name

## Tempy Version 1.1.0

* **Update**: We did improve the performance of Tempy and reduced the restart time by a lot.
* **Update**: We added command that are vote-only locked, read more by clicking [here](https://docs.tempybot.me/troubleshooting/faq/vote-only-locked).
* **Update**: Voting for Tempy gives you a role on our Discord support server.

## Tempy Version 1.0.9

* **Update**: The unlock command has been added to the changes applied with version 1.0.8.
* **Update** (to 1.0.8)**:** Also True overwrites will be applied from the read\_messages permission.
* **Fix**: Sessions are not being restored after saving and recreating a channel.
* **Fix**: Lock command no longer changes the connection permission, using a default-role.

## Tempy Version 1.0.8

* **Update**: Using the *lock* and *onlyfor* command will check if the default-role (everyone role) had read\_messages enabled/disabled, thus before from the category applied, if so, the read\_messages permission will not be set to None anymore, but still be set to True/False.\*

*\** Only the mentioned both commands are affected because they are the only commands changing the read\_message permission for the default role. Before this update the read\_messages was set to None after using the lock or the onlyfor command, which is obviously not wanted in many cases.

## Tempy Version 1.0.7

* **Update**: If your Discord server reached the maximum of Discord invites and you're trying to send a Join Request, Tempy will tell you that the maximum is reached (1000) and how many invites should be deleted.
* **Update**: Added the alias "knock" for Join Requests.
* **Changed**: The error message for Join Requests have a new and better text now.

## Tempy Version 1.0.6

* **Update**: Now you can finally set the bitrate to **up to 384 kbps** if the boost-level allows it.
* **Update**: If the boost-level drops the bitrate will be changed to the **next high** you can reach.
* **Update**: Instead of showing the bitrate as *xx.0* it will be shown directly as *xx* now.

## Tempy Version 1.0.5

* **Update**: Tempy Patches, a channel where all patches are posted in
* **Update**: Random automatic reactions to patch messages posted in the above mentioned channel
* **Fix**: Trying to create a Channel with a saved Tempy Session will skip the channel Creation sometimes
* **Typo Correction**: Corrected a typo at the unsave error embed, changed *cancreate* to *can create*

## Tempy Version 1.0.4

* **Fix**: Text channels and voice channels not being deleted if textcreation is turned on
* **Fix**: Welcome-message after text channel creation was not being sent.

## Tempy Version 1.0.3

* **Fix**: Tempy doesn't delete the created Text and voice channel after creation.
* **Fix**: Tempy doesn't grant new joined users permissions for the Tempy text channel.
* **Added**: Tempy will check if all needed permissions are granted from the role and category permissions, shouldn't this be the case the Text channel won't be deleted. Read more [here](https://docs.tempybot.me/troubleshooting/faq#why-is-tempy-not-creating-a-text-channel-after-joining-the-creation).

## Tempy Version 1.0.2

* **Fix**: Tempy doesn't deny the ([if setup](https://docs.tempybot.me/getting-started-with-tempy/configuration)) *default\_role* to see newly created text channels.
* **Fix**: The Tempy text channels were still visible to the user, that left the (to the text channel) conencted voice channel, after rejoining the permissions were granted again, but never removed at all.

## Tempy Version 1.0.1.

* Added *discord.py logs* errors and debug information via. the [Python logging module](https://docs.python.org/3/library/logging.html)
* Updated info commands links containing arealwant.tech to [arealwant.com](https://arealwant.com)
* Updated linking in [Sessions FAQ](https://docs.tempybot.me/troubleshooting/sessions-faq) from blog.arealwant.tech to **blog.**[arealwant.com](https://arealwant.com)
* Change to avoid ratelimits from the Discord gateaway / http

## Tempy Version 1.0.0. \[Official Release]

### All Bot Changes and Innovations:

* **New Feature:**[ **Click here** ](https://blog.arealwant.tech/tempy/sessions/)**to learn about TEMPY SESSIONS.**
* **Performance**: The Performance got increased a lot. We've changed our Database to a faster one, we tested a lot things and worked very hard to get a faster channel creation.
* **Easier Usage**: We have heard that many find it difficult to use Tempy. Due to that we have changed all embeds, changed the design and made the help-embed only showing you, what you really need right now. We give a high value to the user experience - which got highly improved now.
* **New Feature**: Now you have the possibility to manage your Channel with commands and decide even better who is allowed to join, who not and who is allowed to see your channel and who not.
* **Reworked Feature**: [We've reworked the whole design and functionality of the Setup Command.](https://blog.arealwant.tech/tempy/setup-rework/)
* **Mention Tempy**: You can mention Tempy to get some infos, the prefix and all set Creation channels.
* **Feature Update**: All voice-channel infos have been replaced with Discord's new voice mentioning.
* **New Command**: You can **hide/unhide** your channel for everybody now.
* **New Command**: You can **block/unblock** a user from your channel now.
* **New Command**: You can **lock/unlock** your channel, so nobody can enter it.
* **New Command**: With the **onlyfor** command you can make your channel only accedable for a user.
* **New Command**: With the **rename** command you can change the name of your channel.
* **New Command**: With the **reset** command you can reset all made changes easily.
* **New Command**: With the **overview** command you get an overview of all Tempy\
  Channels created on your server, every Creaton Channel and more.
* **Bug-Fix**: Trying to remove a Creation Channel, which isn't one - isn't possible anymore.
* **Feature Update**: People who got blocked out of a channel, will be kicked from the channel, if they are in the channel. As well as kicking all users out of a channel, if you force grant someone permissions with the onlyfor command for example.
* **New Command**: With the **nocamping** command you can force your members to have the userlimit of their channel on two or higher. Userlimit of one will be changed back to the previous userlimit.
* **New Command**: With the **defaultrole** command you can change the role which is getting used by managing the channel permissions of every Tempy channel.
* **Feature Update**: You can now also block several users at the same time, you can also block several roles at the same time from now on.
* **New Command**: With the **NSFW** command Tempy will enable NSFW for every new textchannel.
* **Bug-Fix**: Resetting a channel's settings also removes Tempy all permissions, which causes errors after using the channel commands again - however, bug has been fixed now.
* **New Feature**: The [Permissions Tab](https://docs.tempybot.me/permissions) which explains what permissions are needed to use Tempy, also why Tempy is asking for specific permissions.
* **New Bug-Prevention**: You will get an error embed if you try to setup Tempy (use any startsettings commands), while Tempy doesn't have enough permissions to create/manage channels.&#x20;
* **New Bug-Prevention**: Tempy needs certain permissions on creating a textchannel, should Tempy doesn't have this permissions, no textchannel will be created. [Read more about Textchannel Perms](https://docs.tempybot.me/permissions#needed-permissions-for-textchannel-creation).
* **Bug-Fix**: It was possible to use onlyfor/block/unblock on random letters (not on a real user/user id) - however, not possible anymore.
* **Command Name Changes**: The Command "name" is now [configname](https://docs.tempybot.me/getting-started-with-tempy/configuration/name), the Command "limit" is now [configlimit](https://docs.tempybot.me/getting-started-with-tempy/configuration/userlimit) and the Command "channellimit" is now [certainlimit](https://docs.tempybot.me/getting-started-with-tempy/configuration/channellimit).
* **New Command**: With the **Bitrate** command you can pre-set the bitrate for new created channels.

### All Website Changes and Innovations:

* **Loading Speed**: The Website is loading 7 seconds faster as before. We're very proud that we got our\
  website being finally fast again. The Tempy website was very slow and loaded very clunky before.
* **Live Support**: The Website have a support feature at the lower right corner now. You can chat with us\
  everytime and tell us your questions. You are able to chat 24/7 with our Developers now.
* **Dashboard**: We have also started programming the backend of our dashboard. #soon
* **Design**: We have added two new headers showing the creation speed and the mulitple creation channel feature.
* \#**VoteForTempy**: We have added a Sub Site which shows you all Botsites Tempy is on.\
  Clicking on one of the website will give you the possibility to vote for Tempy.
* **Our Team**: We have also added a website which shows you our team.
* **New Footer**: The website have also a new footer now, with more\
  information and an increased dark-mode.
* **Scrollbar**: The website have a new and way--- nicer scrollbar, we hope you like it!

### All Support Server Changes and Innovations:

* **Role for using Tempy**: You get a role if you're an owner of a server Tempy is in.
* **Stats Channels**: At the top of our server you can see all live Stats of Tempy now.
* **New Roles**: You can now start getting the **Tempy Ideagiver** and **Tempy Bug Hunter**.\
  You don't know how to get them? No Problem - [Check this](https://discord.com/channels/787660599826972683/787661130322935818/793905868466683986)!

### Tempy Pre-Update 0.9.0. - 0.9.9

This Version contains the **Major Update of Tempy**, this is packed a Pre-Update to secure that all changes coming with the Major Update are working perfectly, with the final Update we're going to tell you all changes. The website got changed a lot - the bot and our Discord Support Server. We wan't to reach a higher amount of servers and people. With the Release of the Major Update Tempy will leave the BETA.

### Tempy Version Patch 0.4.2. - 0.8.9

Setup Command Bugs has been fixed, some colors are also new now, Tempy reply to commands now and the maximum time of the spam detection has been changed a bit. Our website is mobile-responsive now.

## Tempy Version Update 0.4.0.

### Changes with this update:

* Save messages in a text channel with Tempy:\
  Now you're able to **save the last 500 messages** in a .txt file by using `-save`
* The down below mentioned slowdown and spam prevention was associated with getting notified about the spam as a private message. **We reworked that.** You won't get messages anymore
* Instead of the above mentioned messaging, fast channel-creation will be [**punished** with a disconnect](https://docs.tempybot.me/troubleshooting/faq#why-do-i-always-get-kicked-after-joining-a-creation-channel)
* Channels didn't get deleted after leaving them or fast creating new ones, **this has been also fixed**
* We will now also upload **all further versions of Tempy** without taking the bot offline

## Tempy Version Update 0.2. - 0.3.7

### Changes with this update:

* Now Tempy has a **slowmode to prevent the fast and useless creation** of voice channels\
  Should someone create channels very fast, they will get a reminder in their DMs and a\
  cooldown which will prevent them creating new channels for a certain time again.
* We **improved the performance** of Tempy extremly, creating channels is faster now and the deletion isn't that buggy anymore, deleting channels was an often reported problem with Tempy.
* Now you can set welcome messages\
  Welcome message are messages which'll be sent in a Tempy, as far as someone joined/left the Tempy. You can turn this messages on and off, they're turned off default.
* Now Tempy has a report command, you can use it on our [Discord-Server](https://tempybot.me/support) in tempy-commands
* Now Tempy has a feedback command, you can use it on our [Discord-Server](https://tempybot.me/support) in tempy-commands
* Now Tempy has a suggestion command, you can use it on our [Discord-Server](https://tempybot.me/support) in tempy-commands


# Permissions

What permissions does Tempy need and why does it need them?

Down below you can see the minimum permissions Tempy needs for use, if the permissions are not against Tempy will not create a channel or will indicate during setup that these permissions are missing. Click here to get to the troubleshooting for missing permissions.

### Needed Permissions for Voice Creation:

| The Permission             | Tempy's Usage                                                                                                                                                                                                                                                                                                              |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>View</p><p>Channels</p> | <p>Tempy needs this permission to be able to see all channels and to be able to do the things mentioned below at all, without seeing a channel none can be created, neither</p><p>can they be managed then.</p>                                                                                                            |
| Manage Channels            | <p>Tempy needs this permission to create and manage the Temp channels,<br>as it is the main feature of the bot.</p>                                                                                                                                                                                                        |
| Manage Roles               | Tempy needs this permission to be able to set advanced permissions in the newly created channels, these overwrites are necessary for the channel commands and more. This permission is also being used on the channel creation to set overwrites, due to people gets the permission to manage the channel they've created. |
| Move Members               | Tempy needs this permission to be able to move members from the Creation Channel to their Temp Channel, this permission is also necessary for the Channel Commands (e.g. the *block* command would kick the blocked user out of the channel, this can only be managed with Move Members being enabled.)                    |
| Connect                    | Tempy needs this permission to be able to perform the above mentioned overwrites, this permission serves the channel commands and is required to give Tempy the permission itself.                                                                                                                                         |

{% hint style="info" %}
All permissions will also be given to owners of Temp channels (as an overwrite).
{% endhint %}

###

### Needed Permissions for Textchannel Creation:

{% hint style="warning" %}
Should one of the following permissions be missing, no text channels will be created.
{% endhint %}

| The Permission                 | Tempy's Usage                                                                                                                                                                   |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Send Message&#x73;**\***       | This permission will be given to the owner as an overwrite in their Tempy Textchannel, since you can't grant permissions without having the permission itself this is required. |
| Read Messages                  | This permission will be given to the owner as an overwrite in their Tempy Textchannel, since you can't grant permissions without having the permission itself this is required. |
| Add Reactions                  | This permission will be given to the owner as an overwrite in their Tempy Textchannel, since you can't grant permissions without having the permission itself this is required. |
| Embed Links                    | This permission will be given to the owner as an overwrite in their Tempy Textchannel, since you can't grant permissions without having the permission itself this is required. |
| Attach Files                   | This permission will be given to the owner as an overwrite in their Tempy Textchannel, since you can't grant permissions without having the permission itself this is required. |
| <p>Read Message<br>History</p> | This permission will be given to the owner as an overwrite in their Tempy Textchannel, since you can't grant permissions without having the permission itself this is required. |
| External Emojis                | This permission will be given to the owner as an overwrite in their Tempy Textchannel, since you can't grant permissions without having the permission itself this is required. |
| <p>Manage</p><p>Messages</p>   | This permission will be given to the owner as an overwrite in their Tempy Textchannel, since you can't grant permissions without having the permission itself this is required. |

**\*** This permission can be turned off if you don't want Tempy to have access in every text channel.


# Commands

Here you see all commands with a detailed explanation for usage, for the required permissions and more.

### The default prefix of Tempy is `-`, but you can change it any time.

{% tabs %}
{% tab title="Startsettings Commands" %}

|                                                       Command                                                      | Needed Permission |           Description          |
| :----------------------------------------------------------------------------------------------------------------: | :---------------: | :----------------------------: |
|                       [startsetup](https://docs.tempybot.me/getting-started-with-tempy/setup)                      |   Manage Server   |        Starts the setup        |
|  [tempvoice \[add/remove\] \[Voice ID\]](https://docs.tempybot.me/getting-started-with-tempy/setup/voice-channel)  |   Manage Server   | Set the Voice Creation Channel |
| [temptext \[add/remove\] \[Category ID\]](https://docs.tempybot.me/getting-started-with-tempy/setup/text-category) |   Manage Server   |  Set the Text Creation Channel |

#### Need help by using one of the mentioned commands?

{% content-ref url="/pages/-MNsMJN95eWtsLjb9aq6" %}
[Reworked: Setup Tempy](/tempy-bot/getting-started-with-tempy/setup)
{% endcontent-ref %}
{% endtab %}

{% tab title="Config Commands" %}

|                                                                       Command                                                                      | Needed Permission |                                                           Description                                                          |
| :------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------: | :----------------------------------------------------------------------------------------------------------------------------: |
|                                                                 nocamping \[on/off]                                                                |   Manage Server   | <p>Force a higher user-limit than one user,</p><p>a user-limit of one will cause a change</p><p>to the previous user limit</p> |
|                                                                 defaultrole \[role]                                                                |   Manage Server   |                                               Change the channel permission role                                               |
|                                                                   nsfw \[on/off]                                                                   |   Manage Server   |                              <p>Enabling this will turn NSFW on for<br> new Tempy textchannels</p>                             |
| [configbitrate \<low/default/high/kbps>](https://docs.tempybot.me/getting-started-with-tempy/configuration/change-the-bitrate-of-the-new-channels) |   Manage Server   |                                           <p>Manage the bitrate<br>of new Tempies</p>                                          |
|               [certainlimit \[channel-id\] \[limit\]](https://docs.tempybot.me/getting-started-with-tempy/configuration/channellimit)              |   Manage Server   |                          <p>Manage the userlimit of<br>a <strong>certain</strong> Creation Channel</p>                         |
|                     [voicecreation \[on/off\]](https://docs.tempybot.me/getting-started-with-tempy/configuration/voicecreation)                    |   Manage Server   |                                                    Manage the Voice Creation                                                   |
|                      [textcreation \[on/off\]](https://docs.tempybot.me/getting-started-with-tempy/configuration/textcreation)                     |   Manage Server   |                                                    Manage the Voice Creation                                                   |
|                     [position \[up/down/default\]](https://docs.tempybot.me/getting-started-with-tempy/configuration/position)                     |   Manage Server   |                                             Manage the position of **new** Tempies                                             |
|                        [configlimit \[number\]](https://docs.tempybot.me/getting-started-with-tempy/configuration/userlimit)                       |   Manage Server   |                                             Manage the userlimit of **new** Tempies                                            |
|                            [configname \[name\]](https://docs.tempybot.me/getting-started-with-tempy/configuration/name)                           |   Manage Server   |                                               Manage the name of **new** Tempies                                               |
|                                                               prefix \[custom-prefix]                                                              |   Manage Server   |                                                 Manage the custom server prefix                                                |

#### Need help by using one of the mentioned commands?

{% content-ref url="/pages/-MNsNDJLA13axpDGdOWX" %}
[Configuration](/tempy-bot/getting-started-with-tempy/configuration)
{% endcontent-ref %}
{% endtab %}

{% tab title="Info Commands" %}

|         Command        | Needed Permission |           Description           |
| :--------------------: | :---------------: | :-----------------------------: |
| channelinfo \[channel] |   Send messages   | Shows you infos about a channel |
|        overview        |   Send messages   |  Shows you all Tempies and more |
|         botinfo        |   Send messages   | Shows you some bot informations |
|         pingbot        |   Send messages   |    Shows the latency of Tempy   |
|        commands        |   Send messages   |     Shows all Tempy commands    |
|      {% endtab %}      |                   |                                 |

{% tab title="Channel Commands" %}

> The down below mentioned commands are only available if you own a Temp Channel

|        Command        | Needed Permission |                                             Description                                             |
| :-------------------: | :---------------: | :-------------------------------------------------------------------------------------------------: |
|        onlyfor        |   Send Messages   |                          <p>Allows only certain<br>users/roles to join</p>                          |
| session \<save/reset> |   Send Messages   | <p><em>Never set up your Tempy channel again.</em><br><em>Just take the settings with you!</em></p> |
|         claim         |   Send Messages   |                 <p>Claim the permissions of a Tempy<br>channel if the owner left</p>                |
|                       |                   |                                                                                                     |
|          lock         |   Send Messages   |                                     Locks a channel for everyone                                    |
|         unlock        |   Send Messages   |                                    Unlocks a channel for everyone                                   |
|                       |                   |                                                                                                     |
|          hide         |   Send Messages   |                            <p>Makes channel invisible<br>for everyone</p>                           |
|         unhide        |   Send Messages   |                          <p>Makes channel visible<br>for everyone again</p>                         |
|                       |                   |                                                                                                     |
|     block \[user]     |   Send Messages   |                               <p>Blocks a user from<br>the channel</p>                              |
|    unblock \[user]    |   Send Messages   |                              <p>Unblocks a user from<br>the channel</p>                             |
|                       |                   |                                                                                                     |
|     rename \<name>    |   Send Messages   |                              <p>Changes the Name<br>of your channel</p>                             |
|     limit \[user]     |   Send Messages   |                          <p>Changes the User Limit <br>for your channel</p>                         |
|          save         |   Send Messages   |                                <p>Saves the last<br>500 messages</p>                                |
|                       |                   |                                                                                                     |
|         reset         |   Send Messages   |                                       Resets all made changes                                       |
|      {% endtab %}     |                   |                                                                                                     |
|     {% endtabs %}     |                   |                                                                                                     |


# Aliases

Aliases of the Tempy Bot

|    Command    |                            Alias                           |
| :-----------: | :--------------------------------------------------------: |
|   startsetup  |                       setup, start, s                      |
|   tempvoice   |                             tv                             |
|    temptext   |                             tt                             |
|               |                                                            |
|      name     | <p>tempname, voicename,<br>changename, creationname, n</p> |
|  channellimit |                   userlimit\_channel, uc                   |
| voicecreation |                  voice, voicecreation, vc                  |
|  textcreation |                    text, textswitch, ts                    |
|    position   |          <p>tempposition,<br>voiceposition, ps</p>         |
|   userlimit   |                    limit, voicelimit, lm                   |
|               |                                                            |
|  channelinfo  |                  channel, aboutchannel, ci                 |
|    overview   |                         // No Alias                        |
|    botinfo    |                   info, bot, aboutbot, i                   |
|    pingbot    |                latency, ping, botlatency, p                |
|    commands   |                        help, cmds, h                       |


# The Prefix

Here you will be shown step by step how to change the prefix of the Tempy bot.

## Set a custom prefix for your Discord server!

You can change the prefix of Tempy for your Discord server everytime, by copy-pasting the line down below you can easily change the prefix, just replace `<new-prefix>` to the prefix you would like to set.\
You can replace the Tempy mention with the current prefix of the bot as well.

```
@Tempy#8370 prefix <new-prefix>
```

## See which prefix is set for your Discord server!

You can see the current set prefix for your Discord server by copy-pasting the line down below. You can replace the Tempy mention with the current prefix of the bot as well. You can see how to change the prefix of Tempy above.

```
@Tempy#8370 prefix
```

##


# Why Tempy?

Reasons why you should use the Tempy Bot.

## Individuality & Experience

There are no limits, you can block people from your channel, lock, hide and make your channel only accessible for certain users, certain user or certain roles. Tempy got you covered in every situation.

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVrTkV8b42texHnBY7R%2F-MVrUeXBXtT3Da1Nnvul%2FBlockWithRoles.gif?alt=media\&token=c7effee5-4650-4da1-8485-f1d4380e9772)

## Configuration & Possibilities&#x20;

Tempy has thousands of possibilities to make the new Temp Channels as\
individual as possible. You will have no more wishes, we promise.

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVrWdGPmQs5nnEjEXYz%2F-MVrWxR8xDXpD7GyraPi%2FConfigNameTeam.gif?alt=media\&token=29341835-a882-4826-b260-c6ab5c62e123)

{% content-ref url="/pages/-MNtIMMDcAVSIK3V2oum" %}
[Commands](/tempy-bot/commands)
{% endcontent-ref %}

Tempy takes an average of one second to create a voice channel and a text channel,\
cache them, assign permissions and welcome you!

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP-rgKV4QFj-gsAyN4d%2F-MP-rpBVu6Jnov_Nhmha%2Fdf6ebb993e4421439629a74c3dabe67a.png?alt=media\&token=289baf5b-312a-4cc1-8437-73b5ebe62af7)

## Development & Safety

Tempy has been tested and developed over a long period of time and is now\
prepared for anything, for any dropouts and errors.

![Spam-Joining a Tempy Creation Channel](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP-rgKV4QFj-gsAyN4d%2F-MP-t6aiK8Tqd8bxBbDb%2F519e319cf5373e01ea387f0057810f40.gif?alt=media\&token=b3209f55-df28-422b-a47f-116d11fe5129)

## Community Care & Support

We care a lot about our community, our support will help you as good as they can. We can even join your Discord server and setup everything for you, free and fast. We post updates and changes in our Discord server and you decide when or if you want to get pinged at all.

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVrV6jFVZuRCoKhWIRG%2F-MVrW-NLVUltvaES737Y%2FSupportTempy.gif?alt=media\&token=c08b4128-2c0e-41f3-93db-d0ae49701263)

## Fast & Easy Setup and Use

We have worked for a long time to make the use and control of the Tempy Bot as simple as possible.\
Setuping Tempy takes \~10 seconds (We've counted the seconds).

![The Tempy Setup](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP-tNjLf5r6rJogz_Ph%2F-MP-u8lBW0n4WqAE69NR%2F31ed79a6215d808839c18d680f7d22b8.png?alt=media\&token=eeb47c7a-583f-4ea0-99eb-abf4752f20d8)


# Tempy+ is coming soon!


# Reworked: Setup Tempy

Here you will be shown step by step how to use the Tempy Setup Feature.

## 1. Start the Tempy Setup

As far as you didn't set a custom prefix you can use `-setup` to start the Tempy setup. If you didn't setup any Creation channels already you will only see the two options down below, this makes it easier for you.

![The setup embed after you've started the setup.](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MXOon8bRQ67ODNg7gEQ%2F-MXOv9H_C-vOTyFwkTBA%2FSetupDocs_1.gif?alt=media\&token=f2d9a553-ee6c-4bd0-b7dc-a668509be623)

## 2. Choose an option you'd like to manage

You can choose between two options at the beginning, wether you already have a channel and you'd like to turn it into a Creation channel or you want Tempy to create a Voice channel which will be automatically a Creation channel then. **In this example we want Tempy to create a Voice channel.**

![The setup embed on choosing one of the mentioned options.](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MXOon8bRQ67ODNg7gEQ%2F-MXPOajOIy18n2gPuxVr%2FSetupDocs_4.gif?alt=media\&token=a496738d-a14c-4538-b279-97b4023a4e8d)

## 3. Choose wether you want or don't want Text channels too

As far as someone joins the above set voice channel, Tempy will create a Text Channel, only people who are in the Voice Channel are able to see the new Text Channel. You have the option between creating Text channels too or not. **In this example we don't want to create Text channels too.**

![The setup embed after the setup is finished.](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MXOon8bRQ67ODNg7gEQ%2F-MXPO4aSRcCAk5OtOhv3%2FSetupDocs_5.gif?alt=media\&token=0fa5ded1-14e9-4ce6-8fcd-45a0cf5f5f3a)

{% content-ref url="/pages/-MNsNUK1Lx8UwnMin5l\_" %}
[Turn the Text Creation on/off](/tempy-bot/getting-started-with-tempy/configuration/textcreation)
{% endcontent-ref %}

## We have successfully set up Tempy. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0iK87qbYXxDlj4QoN%2F-MP0iYRgmEU9c6zmGOrj%2Fgiphy%20\(15\).gif?alt=media\&token=816ad803-9359-4773-91b7-c5c215faef9d)


# Setup/Remove a Voice Channel

Here you will be shown step by step how to set up the Temporary Voice Channel with the Tempy Bot.

## 1. Send the Voice Channel

Which should create new Voice Channels by joining it, we also call this Channels\
the **Creation Channels**, to create new Voice Channels - also known as (new) **Tempies**.&#x20;

The Command Usage: **`-tempvoice <add/remove> <channel>`**

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0e_jqzX3hoKC1IT-q%2F-MP0fiiAmt-LebZKnl7O%2FVoiceChannelAdd.gif?alt=media\&token=5c24eec9-9783-49dd-ba8b-4f5a5b74fcd8)

{% content-ref url="/pages/-MNsNNOOUs1Z35C9MrBd" %}
[Turn the Voice Creation on/off](/tempy-bot/getting-started-with-tempy/configuration/voicecreation)
{% endcontent-ref %}

## We have successfully set up the Voice Channel. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0gQ7LBGUjwjgJjIS9%2F-MP0gjXQxVQF055fdGdJ%2Fgiphy%20\(11\).gif?alt=media\&token=8262173b-2582-46df-a2bc-0ed5f71de8fd)


# Setup/Remove the Text Category

Here you will be shown step by step how to set up the Temporary Text Channel with the Tempy Bot.

## 1. Send the **Category**

As far as someone joins the above set voice channel, Tempy will create a Text Channel, only people who are in the Voice Channel are able to see the new Text Channel.&#x20;

The Command Usage: **`-temptext <add/remove> <category>`**

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0i_mglb2T8hEDgTSE%2F-MP0jAISji1ZfO8_K7XX%2FCategoryAdd.gif?alt=media\&token=560966de-bb2f-4623-b76a-fb92715e567b)

{% content-ref url="/pages/-MNsNUK1Lx8UwnMin5l\_" %}
[Turn the Text Creation on/off](/tempy-bot/getting-started-with-tempy/configuration/textcreation)
{% endcontent-ref %}

## We have successfully set up the Voice Channel. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0hUIsMT_REV73nAnb%2F-MP0i3TjLvNYyZj-_jZh%2Fgiphy%20\(13\).gif?alt=media\&token=08b8ca5a-e63e-43ea-acf2-5dec70292781)


# Configuration

You can easily pick one of the Configuration Articles down below.


# Change the Name of new Tempy channels

Here you will be shown step by step how your change the Name of new Temp Channels/Tempies.

## Command to manage this feature

The command arguments to manage the new Name are: **`-configname <user-tag> <name>`**

### What exactly is a user tag?

A user tag is later converted into a real username e.g. ARealWant or ARealWant#0001.\
With this command you can use the user tag **{user.name} or {user.allname}**.

{% content-ref url="/pages/-Me1nDUF1WnvAXYdihXf" %}
[Tempy User Tags](/tempy-bot/troubleshooting/faq/tempy-user-tags)
{% endcontent-ref %}

### How would the use of this command look then?

Since user tags are a thing it's possible to decide where the username should be shown.\
A simple example would be: **`-configname {user.name}'s Channel`**.\
You can also move the tag: **`-configname Channel of {user.name}`**.

### How would it look if a channel has been created?

![After applying the first example](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-Me1jnBpCSrqqt-4bsZG%2F-Me1mqZmRi0iuBEQdjgp%2Fimage.png?alt=media\&token=9a9022a9-50bb-4793-882f-030dbcabe1d7)

![After applying the second example](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-Me1jnBpCSrqqt-4bsZG%2F-Me1mzLFXLGi4ijbL73S%2Fimage.png?alt=media\&token=c019a531-841b-491b-86a0-e4c91f354861)

## We have successfully changed the name for new channels.

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0iF4N1e7QWiAi08xr%2F-MP0iIaFf6dlaVgYlFoa%2Fgiphy%20\(13\).gif?alt=media\&token=cc9948aa-b55c-4a7e-8321-33c05d5881db)

## ***DEPRECATED:*** Command to manage this feature

The command arguments to manage the new Name are: **`-configname <new-name>`**

![Screenshot of how to change the name of new Tempy channels](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVqyNn6X1uhXxx_4BgD%2F-MVr-5XuSUmgLfh5pHlC%2FConfigNameTeam.gif?alt=media\&token=235f5e7c-b235-4226-929c-e6c8874c5628)


# Change the User-Limit of a certain Creation Channel

Here you will be shown step by step how your change the User-Limit of a certain Creation Channel.

## Command to manage this feature

The command arguments to manage the new Certainlimit are: **`-certainlimit <channel-id> <limit>`**

{% hint style="info" %}
Note: Don't forget to set a channel as a Creation Channel. [Learn More](https://docs.tempybot.me/getting-started-with-tempy/setup/voice-channel)
{% endhint %}

![Screenshot of how to change the userlimit for a certain creation channel](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVr4xatS8fj0Y2omwbr%2F-MVr4zgc9TtC1s0VbaRI%2FCertainLimit25.gif?alt=media\&token=20e43b6f-572f-4c85-aea4-c20a041d6d6e)

## We have successfully changed the user limit for a certain channel. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0iF4N1e7QWiAi08xr%2F-MP0iIaFf6dlaVgYlFoa%2Fgiphy%20\(13\).gif?alt=media\&token=cc9948aa-b55c-4a7e-8321-33c05d5881db)


# Change the User-Limit of new Tempy Channels

Here you will be shown step by step how your change the User-Limit of new Tempies.

## Command to manage this feature

The command arguments to manage the new Configlimit are: **`-configlimit <number>`**

![Screenshot of how to change the userlimit of new Tempy channels](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVr-Z9uLgQHtunS7UQd%2F-MVr03nQD8z65n4TjgF0%2FConfigLimit.gif?alt=media\&token=332c5366-b192-4d0d-bac4-e20bc0ae280f)

### You want to change the User-Limit of a specific Creation Channel?

{% content-ref url="/pages/-MP4t3wrwmAM1grE0si9" %}
[Change the User-Limit of a certain Creation Channel](/tempy-bot/getting-started-with-tempy/configuration/channellimit)
{% endcontent-ref %}

## We have successfully changed the user limit for new channels. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0iF4N1e7QWiAi08xr%2F-MP0iIaFf6dlaVgYlFoa%2Fgiphy%20\(13\).gif?alt=media\&token=cc9948aa-b55c-4a7e-8321-33c05d5881db)


# Change the Position of the new Channels

Here you will be shown step by step how your change the Position of new Temp Channels/Tempies.

## Command to manage this feature

The command arguments to manage the new Position are: **`-position <default/down/up>`**

**Default**: The new Tempy will be created directly under the Creation Channel\
**Down**: The new Tempy will be created at the bottom of the Category the Creation Channel is in\
**Up**: The new Tempy will be created directly up to the Creation Channel

![Screenshot of how to change the position of new Tempy channels](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVr-CKbsKvxtMV4RznD%2F-MVr-T-heB3zMwRVtVMI%2FPositionChange.gif?alt=media\&token=bcbd91c8-e098-4eba-adc2-783ba9b8fcd5)

## We have successfully changed the position for new channels. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0iF4N1e7QWiAi08xr%2F-MP0iIaFf6dlaVgYlFoa%2Fgiphy%20\(13\).gif?alt=media\&token=cc9948aa-b55c-4a7e-8321-33c05d5881db)


# Change the Bitrate of new Tempy Channels

Here you will be shown step by step how your change the Bitrate of new Temp Channels/Tempies.

## Command to manage this feature

The command arguments to manage the new Bitrate are: **`-configbitrate <kbps/low/default/high>`**

**Low**: This pre-set will set the bitrate for new channels to 08 kbps.\
**Default**: This pre-set will set the bitrate for new channels to 64 kbps.\
**High**: This pre-set will set the bitrate for new channels to 96 kbps.\
**Kbps (Custom)**: You can decide the amount of Kbps.

![Screenshot of how to change the bitrate for a certain creation channel](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVr5ELaJOn_mvlE1wfb%2F-MVr7jIkBXjPZ710IsaA%2FBitrate.gif?alt=media\&token=62aea9aa-4e35-4289-9c07-488a6c3d1626)

## We have successfully changed the bitrate for new channels. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0iF4N1e7QWiAi08xr%2F-MP0iIaFf6dlaVgYlFoa%2Fgiphy%20\(13\).gif?alt=media\&token=cc9948aa-b55c-4a7e-8321-33c05d5881db)


# Turn the Voice Creation on/off

Here you will be shown step by step how to turn on and turn off the Voice Creation with the Tempy Bot.

## Command to manage this feature

The command arguments to manage the Voice Creation are: **`-voicecreation <on/off>`**

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVr0nCmx8rGD6x8wjVr%2F-MVr4HWytG_Pwu8saF29%2FTextCreation.gif?alt=media\&token=ae5bab08-aeeb-42fb-b264-362cb0366c7f)

## We have successfully managed the Voice Creation. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0i7UjqHMY75fRSwWM%2F-MP0iCeWba6n1cXspqKH%2Fgiphy%20\(12\).gif?alt=media\&token=b2c3b279-c2d2-4148-b252-e14f8295bf72)


# Turn the Text Creation on/off

Here you will be shown step by step how to turn on and turn off the Text Creation with the Tempy Bot.

## Command to manage this feature

The command arguments to manage the Text Creation are: **`-textcreation <on/off>`**

![Screenshot of how to mange the text creation](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVr0nCmx8rGD6x8wjVr%2F-MVr4K8JvFBfUDfDP6DR%2FTextCreation.gif?alt=media\&token=91092d19-8c5f-4047-8a69-faf2be7e2ade)

## We have successfully managed the Text Creation. <a href="#setup-done" id="setup-done"></a>

![Have fun using Tempy! <3](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MP0iF4N1e7QWiAi08xr%2F-MP0iIaFf6dlaVgYlFoa%2Fgiphy%20\(13\).gif?alt=media\&token=cc9948aa-b55c-4a7e-8321-33c05d5881db)


# Troubleshooting

Here you will see how you can fix bugs or get answers to frequently asked questions.


# Tempy Bot (FAQ)

All frequently asked questions

## There is missing an option in the Tempy Setup, why? <a href="#setup-options-disabled" id="setup-options-disabled"></a>

The option of choosing an own creation channel AND the option of letting Tempy to create a creation channel are both disabled if you reached the maximum of creation channels, this channel maximum is at **three voice channels**, please [remove](https://docs.tempybot.me/getting-started-with-tempy/setup/voice-channel) one creation channel to setup a new one.

The same is for removing a channel. The third reaction won't appear if you didn't setup any channel.

## Why is Tempy not creating a Text channel after joining the Creation?

Should Tempy has not every single needed permission no Text channels will be created, Tempy will use the category (where Text channels should normally being created) and the role permissions, should a permission be missing the Text channel creation will be skipped.

You can see which permissions Tempy needs for a successful Text channel creation by clicking [**here**](https://docs.tempybot.me/permissions#needed-permissions-for-textchannel-creation).\
This check has been added with the Tempy Version 1.0.3, see other changes [here](https://docs.tempybot.me/changelog#tempy-version-1-0-3).

## Why is Tempy not creating a Channel after joining the Creation?

We are **blocking** every voice-action when Tempy is **missing only one** permission.\
We want to avoid useless errors - that's why Tempy will compare it's needed permissions and the\
permissions it got. Should a permission be missing Tempy will immediately cancel the creation.\
Please also don't forget that I need them as a voice and role permission.

{% content-ref url="/pages/-MVMY0NL-0viIQ-FpPy4" %}
[Permissions](/tempy-bot/permissions)
{% endcontent-ref %}

![Example](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MU-P5K7MwZEsYC_ZesC%2F-MU-PJBzhnP1VxzGwylN%2Fc3c9979e9005be4540777b5d708be45f.gif?alt=media\&token=c8e5cb4a-9ff7-49cf-9911-65d3717310a7)

## Why couldn't I setup Tempy?

The startsettings-commands are disabled when I'm missing out essential permissions.\
You can see which voice-permissions I need to have down belo&#x77;**,** I need them as a voice and role permission.

{% content-ref url="/pages/-MVMY0NL-0viIQ-FpPy4" %}
[Permissions](/tempy-bot/permissions)
{% endcontent-ref %}

## Why do I always get kicked after joining a creation channel?

What does it mean if you get kicked everytime you try to join a creation channel:

![Example](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MPw9O1D_tOzUrXPHdrX%2F-MPwA-9C81vpe3Z4_6-E%2F9699c577697508662ad0847675b32587.gif?alt=media\&token=a3695e7d-0074-4715-94a7-0be2f1300832)

Getting kicked after joining a creation channel means, that **you're ratelimited** by using Tempy.\
To provide fast channel hopping and **fast channel creation** you won't be able to join a creation channel\
for around **max.** **10 seconds**. But no worries! You can still join other already created tempchannels.

## How do I set the voice-channel, which create new channels?

Head over to **Getting Started with Tempy** to **Setup/Remove a Voice Channel**.

{% content-ref url="/pages/-MNsMWFAoQ76QhujJ5ui" %}
[Setup/Remove a Voice Channel](/tempy-bot/getting-started-with-tempy/setup/voice-channel)
{% endcontent-ref %}

## I set a text-category for new text-channels, but they aren't appearing!

The default settings of Tempy are that the text-creation is set to off, ***til*** you set it to on.\
Learn how by heading over to **Getting Started with Tempy** to **Turn the Text Creation on/off**.

{% content-ref url="/pages/-MNsNUK1Lx8UwnMin5l\_" %}
[Turn the Text Creation on/off](/tempy-bot/getting-started-with-tempy/configuration/textcreation)
{% endcontent-ref %}

## How do I get the ID of channels - there's no Copy ID for me?

You have to enable the **Developer Mode** - we'll show you how down below.<br>

![1. Open the User Settings](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MOR4_3IBvnp7uIPRacS%2F-MOR5LwUHVHcaMc_yM6Q%2Fe583dff35cc1d25f38556a376b9ccb2b.png?alt=media\&token=b2f98a5d-0332-40e0-8736-45c1316b2223)

![2. Head over to Appearance > Advanced > Developer Mode](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MOR4_3IBvnp7uIPRacS%2F-MOR60GRVtuXaEC0ZPOy%2Fa7c67c17edfe265b1b8053edc7624e47.png?alt=media\&token=0fb87b1a-d6f0-47b7-b552-e0ddc99a4d40)

![3. Turn Developer Mode on](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MOR4_3IBvnp7uIPRacS%2F-MOR64z60uT0vmN8n6BR%2Fd14502d7ec32a3d3d0a94f3fa3b4dd54.gif?alt=media\&token=3a65bf51-7ed2-4a96-84ef-c46eb5a8d3c0)

## After leaving a voice-channel, nothing is getting deleted, why?

Doublecheck the bot-permissions and the channel-permissions for every new created channel.\
Tempy needs enough permissions to delete or even create voice-channels & text-channels.\
If it's still not working, add the administration permissions to the Tempy bot role.


# Vote-Only Locked

What is vote-only locked and what do I have to do to use commands that are decalred as vote-only and more importantly - why do I have to do that at all?

## Why exactly do we have to vote now?

We can understand that it's a bit surprising now that you have to vote for certain commands instead of just being able to use them as before. However, we have no income with Tempy and have to pay the costs for the server, domains and especially the advertising, for months. With vote-only commands, at least the costs for advertising can be reduced, since you are displayed higher on botlists with many votes.

{% hint style="info" %}
Since the Tempy version 1.1.0 some commands are locked and only usable by voting.
{% endhint %}

## Are all commands only usable by voting now?

No. All config commands, all start commands and all info commands can be used without voting for Tempy. You can also see your saved session settings (-session) without voting for Tempy. Every other command requires you to vote for Tempy, every 12 hours.

## On which site do we have to vote?

The biggest Discord botlist is Top.gg, you've surely heard of it as most of Tempy's servers come through this botlist. This website offers bots, as well as servers to be listed there.

Please keep in mind that the ads that are placed before voting are from Top.gg's advertisers. We make revenue through votes, for the first 100 votes we are credited with 15 credits, we can't pay them out in real money, we can only use them for advertising on the botlist. For each additional vote after the first 100 we will be credited exactly 0.001 credits.

## After voting, can I use the commands as before again?

If your vote was successful you will be able to use all commands of Tempy without any limitation, for over 12 hours, if your vote expired and you are able to vote again you'll see that if you try to run a command that's part of the vote-only limitation. You'll get instant access to the command after voting.

![Version 1.1.0 - Before voting and after voting for Tempy](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MdukRiGWxm9nKPrIU8A%2F-MdulCR4bJE5C3SsEiaZ%2Fimage.png?alt=media\&token=3dc7eb46-a419-44c7-83a7-3665b10eac6b)


# Tempy User Tags

What are Tempy user tags? How do I use them and with which commands can I use them at all?

## What is a Tempy user tag?

A Tempy user tag can be defined using a command e.g. the configname command does support user tags, later then e.g. after creating a Tempy voice channel this user tag will be changed into the real name of the user. For example the user tag **{user.allname}** changes to **ARealWant#0001**.

## Which Tempy user tags are available?

Currently, they are only two user tags available to use. Tempy user tags are a very new feature, thus we're waiting for feedback and suggestions to know exactly how to improve tags, their usage and design.

| Tempy user tags | Available for commands                                                               |
| --------------- | ------------------------------------------------------------------------------------ |
| {user.name}     | [configname](https://docs.tempybot.me/getting-started-with-tempy/configuration/name) |
| {user.allname}  | [configname](https://docs.tempybot.me/getting-started-with-tempy/configuration/name) |


# Tempy Sessions (FAQ)

Learn all about Tempy Sessions, how to save, delete and view your Tempy Channel settings.

## What is a Tempy Session? <a href="#definition" id="definition"></a>

A Tempy session is a database entry that Tempy creates with all the settings you have made on your Tempy channel. When you create a new Tempy channel, Tempy remembers your settings and applies them to the new channel. So you never have to set up Tempy channels again.

## How can I create a Tempy Session? <a href="#creation" id="creation"></a>

As soon as you're in your Tempy channel you send the command **`-session save`** into any channel of the server, all settings will be saved and taken over *immediately* when creating a new Tempy channel.&#x20;

## How can I see my Tempy Session? <a href="#overview" id="overview"></a>

As soon as you created a Tempy session you send the command **`-session`** and all in the Tempy Session saved settings/overwrites will be shown in an embed. If there's no Tempy Session you'll see a note.

## How can I update the Tempy Session? <a href="#update" id="update"></a>

You made changes to your Tempy channel and want the changes to be applied into your Tempy Session? Easily use the command **`-session update`** again and the settings will be overwritten in our database.\
You can also use the regular "save" subcommand, both will do the same in this case.

## How can I delete the Tempy Session? <a href="#delete" id="delete"></a>

You can reset all changes by using **`-session reset`**, creating a new Tempy channel will no longer take the setting of your before created Tempy session. Note that the pre-defined settings of the server you are in may be still applied to your Tempy channel.&#x20;

## How can I learn more about Tempy Session? <a href="#more" id="more"></a>

Under ARealWant's blog you can read about the development of this feature, about the design and more the functionality of the new Tempy Sessions, [click here](https://blog.arealwant.com/tempy/sessions) to get to the blog.


# YouTube Together (FAQ)

Here you can read about the new YouTube Together Sessions, currently they are still in Discord's BETA, but you already get exclusive access to them with Tempy!

## What is YouTube Together? <a href="#definition" id="definition"></a>

YouTube Together is similar to Watch 2 Gether, only in Discord! This feature is currently still in the BETA of Discord and can therefore only be used by very few people. However, Tempy offers anyone using Discord on the desktop to watch YouTube videos with their friends via YouTube Together.

## How do I start YouTube Together? <a href="#start" id="start"></a>

You can start YouTube Together with the command **`-youtube`** or **`-youtubetogether`**.\
Note that you can also mention Tempy, if you forgot your prefix check [this](https://docs.tempybot.me/commands/the-prefix).

## How does YouTube Together look after started? <a href="#screenshot" id="screenshot"></a>

It looks pretty similiar as watch2gether, but fully implemented in Discord, the control possibilities you know from watch2gether are even better built in into YouTube Together. Screenshot down below.

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-Mc97QMahl698DnT2xHI%2F-Mc98m2BJMyKtNAsYTlz%2Fbfa2cb01b91357a72ded59cbdac0b5db.jpg?alt=media\&token=7b1053a6-6db9-4149-8b43-ea802d6c8f85)

## Can I use it in any Voice channel? <a href="#usage" id="usage"></a>

No. You get exclusive access to YouTube Together with Tempy, but please note that this is only available in Voice channel that are registered in Tempy's Voice-channel database (Tempy Voice channels).

## How to join the created YouTube Together session? <a href="#join" id="join"></a>

After using the above mentioned command you will receive a link, once embedded and once sent as a single link/invitation. You have to use the link for joining the YouTube Together session. Please note that YouTube Together is only for desktop users, thus users on mobile can't use this for now.

## Who can use this feature in a Tempy channel? <a href="#whocanuseit" id="whocanuseit"></a>

Everybody. All members in a Tempy channel can run the command and thus join the YouTube Together session, everybody can also manage the videos and the playlist in YouTube Together as well.\
If you don't want that you have to [block the user](https://docs.tempybot.me/experience/block) from your Tempy channel.


# How to create a join request to someone

Here you will be shown how you can ask someone for an channel invitation.

**You want to join a Tempy channel of someone? Just create a join request!** If you create a join request the channel owner of the channel you want to join gets pinged and asked if they want you to join, if so, you get an unique invite link to the channel and permissions to join.

> **How to use**: **`-joinrequest <user>`**

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MZ7_pEbw8ZZE83oFowL%2F-MZ7a0JWaahfv5R4nW_j%2Fjoinrequest.gif?alt=media\&token=59c02731-0b8a-408d-b543-0703f4c73029)

You don't have to be the owner of the channel to use this feature.\
Please note that this command has a **cooldown of 60 seconds** to avoid spam and abuse.


# How to block someone from your channel

Here you will be shown how you can block someone from your Tempy channel.

You don't want a person/people or people with a certain role to join your channel?\
No problem, we've got you covered with the Tempy **block command**.

> **How to use**: **`-block <user/role>`**

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVrNa8lPbw7vi4ZUTEZ%2F-MVrPvkoWTPuVNoQHoJj%2FBlockUser.gif?alt=media\&token=8f789541-bc67-4d14-985e-d40106f81692)

{% hint style="info" %}
You have to be the owner of the channel to manage this feature.
{% endhint %}


# How to make your channel only accessible for someone

Here you will be shown how you can block someone from your Tempy channel.

You only want a person/people or people with a certain role to join your channel?\
No problem, we've got you covered with the Tempy **onlyfor command**.

> **How to use**: **`-onlyfor <user/role>`**

![](https://474812072-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MNryqhD-5aTXkGTAXg-%2F-MVrPzL2WBWjyAd6aUB_%2F-MVrTc8dy0sbr4pqM5Hx%2FOnlyFor.gif?alt=media\&token=4b462106-45f3-4660-8be8-c4e247c0c0c1)

{% hint style="info" %}
You have to be the owner of the channel to manage this feature.
{% endhint %}


