Private rooms

This module allows server members to create temporary voice channels for communication on their own. The room owner receives full control over it through 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 private 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, accesses) as your personal preset. Next time you create a room, it will be created with these settings immediately.
Boost room	Raise the room in the channel list. Cooldown for use is 5 minutes.
Transfer rights	Transfer control 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	Forbid or allow all users (roles @everyone) to enter your room.
Rename	Change the name of your room.
Hide/Show	Make the room invisible (or visible) to all users on the server.
Kick 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.
Forbid/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

Simple way to start: One-click setup

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

1. Enter the command /settings private.

2. Click the button "Install 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 setup

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

Managing triggers

A trigger is a pairing "trigger-channel -> category". When a user joins the trigger channel, the bot creates a private room for them inside the specified category. You can create multiple such pairings.

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

• Remove: Removes existing pairings.

• Change format: Allows you to set a naming 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 prohibited words separated by commas, in addition to the standard list. If a user tries to rename a room to a prohibited name, the action will be canceled.

• 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.