Private rooms

This module allows server members to create temporary voice channels for communication themselves. The room owner gets full control over it via a convenient control panel.

For users

How to create your room?

1. Find a special voice channel on the server called "〔➕〕Create a room" (or similar).

2. Just join that channel.

3. The bot will instantly create a personal voice channel for you and move you there. Your control panel will appear in the text chat of that channel.

Managing your room

The room owner (and their co-owners) can fully customize it using the control panel.

Name	Description
Preset	Save the current room settings (name, limit, permissions) as your personal preset. Next time you create a room, it will be created with these settings immediately.
Boost the room	Raise the room in the channel list. Cooldown for use is 5 minutes.
Transfer rights	Transfer management rights of the room to another member who is in it or grant/revoke co-owner rights.
Participant limit	Set the maximum number of participants in the room (from 0 to 99). 0 — no limit.
Close/Open	Prohibit or allow all users (the role @everyone) to enter your room.
Rename	Change your room's name.
Hide/Show	Make the room invisible (or visible) to all users on the server.
Kick a participant	Remove a user from your voice channel.
Grant/Revoke access	Grant a personal permission to enter a closed room to a specific user or role.
Prohibit/Allow speaking	Mute or unmute selected participants inside your room.

Automatic transfer of rights

If the room owner leaves it, they have 30 secondsto return. If they do not return, the room rights will be automatically transferred according to the following priority:

1. To the first assigned co-owner who is in the room.

2. If there are no co-owners, then to the first other participant in the room.

---

For administrators

Easy way to start: One-click setup

The fastest way to launch the system is to use the automatic installation.

1. Enter the command /settings private.

2. Click the button "Set up the system".

3. Confirm the action.

The bot will automatically create a category Private rooms and a trigger voice channel 〔➕〕Create a room. The system will be fully ready to work.

Advanced configuration

The panel /settings private provides full control over the module.

Managing triggers

A trigger is a "trigger-channel -> category" pair. When a user enters the trigger channel, the bot creates a private room for them inside the specified category. You can create several such pairs.

• Add: Allows you to create a new pair by selecting a channel and a category.

• Remove: Deletes existing pairs.

• Change format: Allows you to configure the name template for created rooms.

  • Variables: You can use variables that the bot will automatically replace when creating a room:

    • {username} — the user's nickname.

    • {count} — the sequential number of the created room on the server.

  • Examples: 👾 {username}, Private #{count}, Room #{count} | {username}.

Filters and protection

• Unwanted words filter:

  • Enable/disable the filter for room names.

  • You can add your forbidden words separated by commas, in addition to the standard list. If a user tries to rename a room to a forbidden name, the action will be cancelled.

• Channels protected from deletion:

  • Select voice channels that should not be automatically deleted by the bot, even if they are empty. Trigger channels are protected by default.