> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flarebot.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# VoiceMaster

> Dynamic, user-managed temporary voice channels for your server.

## Overview

VoiceMaster eliminates voice channel clutter. Instead of having dozens of empty voice channels sitting in your server, VoiceMaster uses a **"Join to Create"** system.

When a user joins the Hub channel, Flare instantly creates a brand-new, temporary voice channel just for them, moves them into it, and gives them full control over it. When the channel becomes empty, Flare automatically deletes it.

### Why use VoiceMaster?

* **Cleaner Server:** No more scrolling past 30 empty voice channels.
* **User Autonomy:** Members can lock, hide, or rename their own channels without needing moderator assistance.
* **Performance:** Flare handles channel creation and deletion in milliseconds.

***

## Requirements

<Warning>
  Flare must have the `Manage Channels`, `Manage Roles`, and `Move Members` permissions in the category where VoiceMaster is created.
</Warning>

***

## Configuration

Setting up VoiceMaster takes less than 10 seconds.

<Tabs>
  <Tab title="Dashboard">
    1. Navigate to **Modules > VoiceMaster**.
    2. Click the **Setup VoiceMaster** button.
    3. Flare will automatically create a new Category, a Hub voice channel, and a Control Panel text channel.
    4. (Optional) Customize the default name for new channels (e.g., `{user}'s Lounge`).
  </Tab>

  <Tab title="Commands">
    Run the setup command anywhere in your server:

    ```bash theme={null}
    /voicemaster setup
    ```

    Flare will create the necessary channels. You can move the Hub channel to any category you prefer later.
  </Tab>
</Tabs>

***

## The Control Panel

When Flare sets up VoiceMaster, it creates a text channel containing the **Control Panel**. This is an interactive message with buttons that channel owners use to manage their temporary voice channel.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/flare-e0820f7d/images/voicemaster-panel.png" alt="VoiceMaster Control Panel" className="rounded-xl border border-gray-800" />
</Frame>

### Available Controls

| Button | Action            | Description                                                           |
| ------ | ----------------- | --------------------------------------------------------------------- |
| 🔒     | **Lock / Unlock** | Toggles whether the `@everyone` role can connect to the channel.      |
| 👁️    | **Hide / Unhide** | Toggles whether the channel is visible in the server list.            |
| ✏️     | **Rename**        | Prompts the owner to enter a new name for the channel.                |
| 👥     | **Set Limit**     | Prompts the owner to set a maximum user limit (1-99).                 |
| 👑     | **Transfer**      | Gives ownership of the channel to another user currently in the call. |
| 👢     | **Kick / Ban**    | Removes a specific user from the channel or bans them from rejoining. |

***

## Best Practices

<CardGroup cols={2}>
  <Card title="Pin the Control Panel" icon="thumbtack">
    Ensure the Control Panel message is pinned in its text channel so users can always find it.
  </Card>

  <Card title="Set Default Limits" icon="users">
    If your server hosts games like Valorant or League of Legends, change the default channel limit to 5.
  </Card>
</CardGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Flare isn't creating channels when I join the Hub">
    Ensure Flare has the `Manage Channels` permission. Also, check that the Category limit (50 channels max) hasn't been reached.
  </Accordion>

  <Accordion title="Users can't lock their channels">
    Flare achieves locking by denying the `Connect` permission for `@everyone`. Ensure that no other roles in your server have `Administrator` or `Connect` explicitly granted in the channel overrides, as they will bypass the lock.
  </Accordion>

  <Accordion title="The Control Panel buttons say 'Interaction Failed'">
    This usually means Flare doesn't have the `Send Messages` or `Embed Links` permissions in the text channel where the panel is located.
  </Accordion>
</AccordionGroup>

## Related Pages

* [Setup VoiceMaster Recipe](/recipes/setup-voicemaster)
* [Voice Logs](/logging/voice-logs)