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

# Auto Voice Channels for Discord with XRYPTON VoiceMaster

> Let members instantly spawn and fully control their own temporary voice channels using XRYPTON's VoiceMaster system — no staff involvement required.

VoiceMaster lets every member of your server create their own private voice channel on demand. When someone joins the designated **Join-to-Create** channel, XRYPTON automatically creates a personal voice channel for them. The channel is deleted automatically once it becomes empty, keeping your channel list clean without any manual housekeeping.

<Note>
  All VoiceMaster commands are **prefix-only** — they are not available as slash commands. The default prefix is `,`, so every command starts with `,voicemaster` (or the shorter aliases `,voice`, `,vm`, or `,vc`).
</Note>

***

## Setup Guide

<Steps>
  <Step title="Run the setup command">
    ```bash theme={null}
    ,voicemaster setup
    ```

    **Permission:** Manage Server\
    XRYPTON creates three things for you:

    * A **"Voice Channels"** category
    * An **"interface"** text channel with a button panel
    * A **"Join to Create"** voice channel

    You can rename or move these freely after setup. The `@everyone` role is automatically prevented from sending messages in the interface channel.
  </Step>

  <Step title="(Optional) Customise default settings">
    Set server-wide defaults that apply to every new channel created by VoiceMaster:

    ```bash theme={null}
    ,voicemaster category "My Category"   # redirect new channels to a different category
    ,voicemaster defaultrole @Role        # assign a role to members while they're in any VM channel
    ,voicemaster defaultregion us-east    # set the default voice region
    ,voicemaster defaultbitrate 96000     # set the default bitrate (in bps)
    ```
  </Step>

  <Step title="Tell your members how to use it">
    When a member joins the **Join-to-Create** channel, their personal voice channel is created immediately. They can then use the buttons in the interface channel or the `,voicemaster` commands to manage it.
  </Step>
</Steps>

***

## Admin Commands

These commands require **Manage Server** (and **Manage Roles** for `defaultrole`).

| Command                               | Description                                                     |
| ------------------------------------- | --------------------------------------------------------------- |
| `,voicemaster setup`                  | First-time setup — creates category, interface, and JTC channel |
| `,voicemaster reset`                  | Wipe the configuration and delete the created channels          |
| `,voicemaster category <category>`    | Change the category where new VC channels are created           |
| `,voicemaster defaultrole @Role`      | Role assigned to members while in any VM voice channel          |
| `,voicemaster defaultregion <region>` | Default server region for new channels                          |
| `,voicemaster defaultbitrate <bps>`   | Default audio bitrate for new channels                          |

***

## Member Controls

Once a member has a voice channel, they can manage it using the **buttons in the interface channel** or the following commands. You must be in your own VoiceMaster channel to use these.

<CardGroup cols={2}>
  <Card title="Lock / Unlock" icon="lock">
    ```bash theme={null}
    ,voicemaster lock
    ,voicemaster unlock
    ```

    Prevents or allows anyone from joining your channel.
  </Card>

  <Card title="Ghost / Unghost" icon="eye-slash">
    ```bash theme={null}
    ,voicemaster ghost
    ,voicemaster unghost
    ```

    Hides or reveals your channel from the channel list. `ghost` also accepts the alias `hide`; `unghost` also accepts `reveal` and `unhide`.
  </Card>

  <Card title="Permit / Reject" icon="user-check">
    ```bash theme={null}
    ,voicemaster permit @User
    ,voicemaster reject @User
    ```

    Grant or revoke connect permission for a specific member or role. Rejecting a member who is currently in the channel also disconnects them.
  </Card>

  <Card title="Name" icon="pen">
    ```bash theme={null}
    ,voicemaster name My Channel
    ```

    Rename your voice channel. Limited to 100 characters and rate-limited to 2 renames per minute by Discord. Alias: `rename`.
  </Card>

  <Card title="Bitrate" icon="signal">
    ```bash theme={null}
    ,voicemaster bitrate 128000
    ```

    Change the audio quality of your channel (in bps). Alias: `quality`.
  </Card>

  <Card title="Limit" icon="users">
    ```bash theme={null}
    ,voicemaster limit 5
    ```

    Set the maximum number of members (0–99). Use `0` to remove the limit. Alias: `userlimit`.
  </Card>

  <Card title="Claim" icon="flag">
    ```bash theme={null}
    ,voicemaster claim
    ```

    Claim ownership of an abandoned channel whose owner has left.
  </Card>

  <Card title="Transfer" icon="arrow-right-arrow-left">
    ```bash theme={null}
    ,voicemaster transfer @User
    ```

    Hand ownership of your channel to another member who is currently in it.
  </Card>
</CardGroup>

***

## Viewing Channel Info

```bash theme={null}
,voicemaster configuration   # aliases: config, show, view, info
```

Displays your current channel's name, lock status, creation time, bitrate, and member count.

***

## Resetting VoiceMaster

```bash theme={null}
,voicemaster reset
```

**Permission:** Manage Server\
Deletes the saved configuration and removes the category, interface, and Join-to-Create channels created during setup. Run `,voicemaster setup` again to start fresh.

<Warning>
  Resetting VoiceMaster permanently deletes the channels XRYPTON created. Move or back up anything important before running this command.
</Warning>