Temporary channels

Allow users to quickly create voice channels by joining a voice channel.

Temporary channels

hfgd

Allow users to quickly create voice channels by joining a voice channel

This module is open-source.

This module is storing data in your bot's database.

This module has one configuration file.

This module is being actively used on over 6700 other servers on SCNX.

This module is included for free in every plan. Learn more about prices.

Enable module on SCNX

Features

• Users can create a personal voice channel by joining a designated "creation" voice channel.
• Temporary voice channels are automatically deleted when all members leave (with a configurable delay).
• Optionally create a "no-mic" text channel alongside each voice channel, visible only to users currently in the voice channel.
• Channel owners can change the access mode (public/private), add or remove users, and edit channel settings (name, bitrate, user limit, NSFW).
• Settings can be managed via slash commands, a settings panel with buttons, or Discord's built-in channel editing.
• Configurable channel name format with support for username, nickname, tag, and channel number.
• Optionally send a DM to users when their temporary channel is created.
• If a user already has an active temporary channel, joining the creation channel moves them to their existing channel instead of creating a new one.
• Orphaned or empty channels are automatically cleaned up on bot startup.

Setup

1. Create a voice channel that users will join to create their temporary channel. Configure it in the module configuration.
2. Create a category where temporary channels will be created and configure it in the module configuration.
3. Make sure the bot has View Channel, Manage Channels, Move Members, and Connect permissions in both the creation channel and the target category.
4. If using no-mic channels, the bot additionally needs Send Messages, Embed Links, and Manage Roles permissions on the category.
5. Optionally configure a settings channel where the bot will post a settings panel with buttons for users to manage their channels.

Usage

Creating a temporary channel: Join the configured creation voice channel. The bot will create a new voice channel (and optionally a no-mic text channel) and move you into it.

Managing your channel: While in your temporary channel, you can:

• Use /temp-channel mode to switch between public and private access.
• Use /temp-channel add-user to grant a user access to your private channel.
• Use /temp-channel remove-user to revoke a user's access.
• Use /temp-channel list-users to view who has access.
• Use /temp-channel edit to change the channel name, bitrate, user limit, or NSFW setting.

Alternatively, if a settings channel or no-mic channel is configured, you can use the button-based interface to manage your channel.

Channel deletion: When all members leave a temporary channel, it will be automatically deleted after the configured timeout (default: 3 seconds).

Commands

Understand the documentation

In these docs, name:<Type> is an option of a slash-command with name name and the type Type. Options that not required, are described as [name:<Type>]. If the action of a command is vastly different between required and not-required options, we might list them separately.

Examples

• /moderate ban user:<Member>: This command (/moderate ban) has an required option with the name "user" that only accepts one member as a value.
• /moderate ban victim:<Member> reason:<Text>: This command (/moderate ban) has an required option with the name "victim" that only accepts one member as a value and another required option with the name "reason" that accepts any text as an value.
• /moderate ban victim:<Member> reason:<Text> [proof:<Attachment>]: This command (/moderate ban) has an required option with the name "victim" that only accepts one member as a value, another required option with the name "reason" that accepts any text as an value and a not-required option with the name "proof" which allows one attachment as its value.

Command	Description
/temp-channel mode public:<Boolean>	Switch your channel between public and private mode. Only available if "Allow change of channel mode" is enabled.
/temp-channel add-user user:<User>	Grant a user access to your temporary channel (relevant for private channels). Only available if "Allow change of channel mode" is enabled.
/temp-channel remove-user user:<User>	Revoke a user's access to your temporary channel. Only available if "Allow change of channel mode" is enabled.
/temp-channel list-users	View a list of users who have been granted access to your channel. Only available if "Allow change of channel mode" is enabled.
/temp-channel edit [user-limit:<Integer>] [bitrate:<Integer>] [name:<Text>] [nsfw:<Boolean>]	Edit your temporary channel's settings. Only available if "Allow editing the channel" is enabled.

Configuration

In this configuration file, you can configure the module. Open it in your dashboard.

Field	Description
Channel	The voice channel users must join to create a new temporary channel.
Allow editing the channel	If enabled, channel creators can change the name and settings of their voice channel via commands and Discord's built-in menus.
Deletion timeout	The number of seconds the bot waits after all members leave before deleting the temporary channel.
Category	The category where new temporary channels will be created.
Channel name	The format for temporary channel names. Supports %username%, %nickname%, %number%, and %tag% variables.
Create no-mic-channel	If enabled, a text channel will be created alongside each voice channel that is only visible to users currently in the voice channel.
no-mic-channel-message	The message sent in the no-mic text channel when it is created.
Send DM	If enabled, the bot sends a direct message to the user when their temporary channel is created.
DM	The direct message content sent to users when their channel is created.
Public channels	If enabled, newly created channels will sync their permissions with the category (making them visible to everyone).
Allow change of channel mode	If enabled, channel creators can switch between public and private modes and manage user access.
Settings channel	A text channel where the bot posts a settings panel with buttons for managing temporary channels. Leave empty to disable.
No-Mic-Channel for settings	If enabled, the settings panel is sent into the no-mic channel (or Discord's text-in-voice channel if no-mic channels are disabled).
Settings message	The message displayed in the settings panel.

Troubleshooting

Temporary channels are not being created

• Make sure the creation voice channel and category are correctly configured.
• Ensure the bot has Manage Channels, Move Members, View Channel, and Connect permissions in the category.
• Check if the user already has an active temporary channel -- in that case, they will be moved to their existing channel instead.

Channels are not being deleted when empty

• Ensure the bot has Manage Channels permission.
• The bot waits for the configured timeout before deleting a channel. If someone joins within that window, the channel is preserved.

No-mic channels are not visible to voice channel members

• Make sure the bot has Manage Roles permission on the category where channels are created.
• Verify that "Create no-mic-channel" is enabled in the configuration.

Stored data

The following data is being stored about every temporary channel:

• The Discord Channel ID of the temporary voice channel
• The Discord User ID of the channel creator
• The Discord Channel ID of the associated no-mic text channel (if applicable)
• The list of users with access to the channel
• Whether the channel is public or private
• Metadata about the entry (date when created and last updated)

To remove all data stored by this module, purge the module database.