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

# VoiceMaster

> Create and manage temporary voice channels with join-to-create functionality

## Overview

VoiceMaster enables users to create their own temporary voice channels by joining a designated join-to-create channel. Users get full control over their created channels through an interactive interface with buttons for locking, hiding, managing users, and more.

<Info>
  When a user joins the join-to-create channel, a new voice channel is automatically created for them with ownership permissions.
</Info>

***

## Commands

<AccordionGroup>
  <Accordion title="voicemaster setup" icon="wrench">
    Set up the VoiceMaster system in your server by creating the join-to-create channel and control interface.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~voicemaster setup
      ```

      ```bash Example theme={null}
      ~voicemaster setup
      ~vm setup
      ```
    </CodeGroup>

    **What This Creates:**

    * **Category:** "Celestia VoiceMaster" category
    * **Voice Channel:** "join-to-create" channel that users join to create their own VC
    * **Text Channel:** "interface" channel with control panel buttons
    * **Interface Panel:** Interactive buttons for voice channel management

    **Aliases:** `vm setup`\
    **Permissions:** Manage Server
  </Accordion>

  <Accordion title="voicemaster interface" icon="grid-2">
    Replace or regenerate the VoiceMaster control panel interface if it was deleted or needs updating.

    <CodeGroup>
      ```bash Syntax theme={null}
      ~voicemaster interface
      ```

      ```bash Example theme={null}
      ~voicemaster interface
      ~vm interface
      ```
    </CodeGroup>

    **Use When:**

    * The interface message was accidentally deleted
    * Buttons stopped working
    * You need to refresh the control panel

    **Aliases:** `vm interface`\
    **Permissions:** Manage Server

    <Note>
      This command requires that you've already run `voicemaster setup` first.
    </Note>
  </Accordion>
</AccordionGroup>

***

## Control Panel Features

The VoiceMaster interface provides users with powerful controls over their temporary voice channels:

<Tabs>
  <Tab title="Channel Security">
    **Lock/Unlock Controls:**

    * 🔒 **Lock** — Prevent new users from joining your voice channel
    * 🔓 **Unlock** — Allow anyone to join your voice channel
    * 👁️ **Hide** — Hide your channel from other members
    * 👁️‍🗨️ **Reveal** — Make your channel visible to everyone
  </Tab>

  <Tab title="User Management">
    **Member Controls:**

    * 👢 **Kick** — Remove a specific user from your voice channel
    * 👑 **Claim** — Take ownership of an abandoned voice channel

    <Tip>
      The claim feature is useful when the original owner leaves their channel with others still inside.
    </Tip>
  </Tab>

  <Tab title="Channel Settings">
    **Customization Options:**

    * ➖ **Decrease Limit** — Lower the maximum number of users allowed
    * ➕ **Increase Limit** — Raise the maximum number of users allowed
    * ✏️ **Rename** — Change your voice channel's name
    * ℹ️ **Info** — View details about your voice channel
  </Tab>
</Tabs>

***

## How It Works

<Steps>
  <Step title="Initial Setup">
    Server administrators run `~voicemaster setup` to create the system:

    * Creates a "Celestia VoiceMaster" category
    * Adds a "join-to-create" voice channel
    * Sets up an "interface" text channel with control buttons
  </Step>

  <Step title="User Joins JTC Channel">
    When any user joins the join-to-create voice channel:

    * A new temporary voice channel is automatically created
    * The user is moved to their new channel
    * The user becomes the channel owner with full control
  </Step>

  <Step title="Channel Control">
    Channel owners can use the interface buttons to:

    * Lock/unlock their channel
    * Hide/reveal from other members
    * Kick unwanted users
    * Adjust user limits
    * Rename their channel
    * View channel information
  </Step>

  <Step title="Automatic Cleanup">
    When the last user leaves a temporary voice channel:

    * The channel is automatically deleted
    * Resources are freed up for new channels
    * The system stays clean and organized
  </Step>
</Steps>

***

## Interface Layout

The control panel in the interface channel displays all available features:

```
# VoiceMaster Control Panel
Control the voice channels created from #join-to-create.

───────────────────────────────────

Features:
🔒 - Lock the voice channel
🔓 - Unlock the voice channel
👁️ - Hide the voice channel
👁️‍🗨️ - Reveal the voice channel
👢 - Kick a user from your voice channel
➖ - Decrease the user limit
➕ - Increase the user limit
ℹ️ - View voice channel info
✏️ - Rename the voice channel
👑 - Claim ownership of the voice channel

───────────────────────────────────

[🔒] [🔓] [👁️] [👁️‍🗨️] [👢]
[➖] [➕] [ℹ️] [✏️] [👑]
```

***

## Permission Requirements

<CardGroup cols={2}>
  <Card title="Bot Permissions" icon="robot">
    The bot needs these permissions in the VoiceMaster category:

    * Manage Channels
    * Connect
    * Move Members
    * View Channel
    * Send Messages (in interface channel)
  </Card>

  <Card title="User Permissions" icon="user">
    Setup Requirements:

    * **Manage Server** — Required to run setup/interface commands

    Usage Requirements:

    * **Connect** — To join the join-to-create channel
  </Card>
</CardGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Setup says channel already exists" icon="triangle-exclamation">
    **Problem:** A join-to-create channel already exists

    **Solution:**

    * Check for existing "join-to-create" voice channel
    * Delete the old channel if it's no longer working
    * Run `~voicemaster setup` again

    <Note>
      The system checks for any voice channel named "join-to-create" (case-insensitive).
    </Note>
  </Accordion>

  <Accordion title="Interface buttons not working" icon="hand-pointer">
    **Problem:** Clicking buttons has no effect

    **Solution:**

    1. Run `~voicemaster interface` to refresh the control panel
    2. Ensure the bot is online and has proper permissions
    3. Check that you're currently in a VoiceMaster-created channel

    <Warning>
      Buttons only work for users who are in a temporary voice channel they own or have claimed.
    </Warning>
  </Accordion>

  <Accordion title="Channels not auto-deleting" icon="trash">
    **Problem:** Empty temporary channels remain after everyone leaves

    **Solution:**

    * Ensure the bot has "Manage Channels" permission
    * Check bot's role position is high enough
    * Verify the bot is online and functioning
    * Manually delete stuck channels if needed
  </Accordion>

  <Accordion title="Cannot join join-to-create channel" icon="door-closed">
    **Problem:** Users get an error when trying to join

    **Solution:**

    * Verify the bot has "Move Members" permission
    * Check if the user has "Connect" permission
    * Ensure the bot is online
    * Try rejoining after a few seconds
  </Accordion>

  <Accordion title="Interface channel not found" icon="magnifying-glass">
    **Problem:** `~voicemaster interface` says interface channel not found

    **Solution:**

    1. Run `~voicemaster setup` to create a new interface channel
    2. This will set up the entire system fresh
    3. The old JTC channel reference will be updated

    <Tip>
      If you want to keep your existing join-to-create channel, manually create a text channel with "interface" in the name first.
    </Tip>
  </Accordion>

  <Accordion title="Permission denied error" icon="ban">
    **Problem:** Cannot run voicemaster commands

    **Solution:**

    * Verify you have the **Manage Server** permission
    * Check your role has sufficient permissions
    * Ensure you're not using the command in DMs
  </Accordion>

  <Accordion title="Buttons show wrong channel" icon="link-slash">
    **Problem:** Interface references wrong join-to-create channel

    **Solution:**

    ```bash theme={null}
    ~voicemaster interface
    ```

    This regenerates the interface with the current JTC channel reference.
  </Accordion>
</AccordionGroup>

***

## Feature Breakdown

| Button   | Function                                  | Requires          |
| -------- | ----------------------------------------- | ----------------- |
| Lock     | Blocks new users from joining             | Channel ownership |
| Unlock   | Allows anyone to join                     | Channel ownership |
| Hide     | Makes channel invisible to @everyone      | Channel ownership |
| Reveal   | Makes channel visible to @everyone        | Channel ownership |
| Kick     | Removes a user from the channel           | Channel ownership |
| Decrease | Lowers user limit (minimum 0 = unlimited) | Channel ownership |
| Increase | Raises user limit (maximum 99)            | Channel ownership |
| Info     | Shows channel stats and settings          | Being in channel  |
| Rename   | Changes channel name                      | Channel ownership |
| Claim    | Takes ownership of abandoned channel      | Being in channel  |

***

## Aliases

Quick access shortcuts for VoiceMaster commands:

<CardGroup cols={2}>
  <Card title="vm" icon="v">
    Main alias for voicemaster
  </Card>

  <Card title="vm setup" icon="wrench">
    Quick setup
  </Card>

  <Card title="vm interface" icon="grid-2">
    Quick interface refresh
  </Card>
</CardGroup>

***

## Related Features

<CardGroup cols={2}>
  <Card title="Voicemaster Commands" icon="shield-check" href="/voicemaster-commands">
    Learn how to use commands of the VoiceMaster system in your server
  </Card>

  <Card title="Antinuke" icon="shield-halved" href="/antinuke">
    Explore the various antinuke protection systems that admins can configure
  </Card>
</CardGroup>