> For the complete documentation index, see [llms.txt](https://mythicalbot.gitbook.io/arklynn-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mythicalbot.gitbook.io/arklynn-docs/server-configuration/voicemaster/commands.md).

# Commands

***

### User Commands

These commands are available to any user who owns or has permission to manage a temporary voice channel.\
\&#xNAN;*Owner* = the person who created the channel or claimed it. *Co-owner* = users added by the owner.

| Command             | Description                                      | Prefix Usage                        | Slash Usage                       | Required Role                         |
| ------------------- | ------------------------------------------------ | ----------------------------------- | --------------------------------- | ------------------------------------- |
| **Lock**            | Locks your channel – no one else can join        | `.voicemaster lock`                 | `/vm_lock`                        | Owner / Co‑owner                      |
| **Unlock**          | Unlocks your channel                             | `.voicemaster unlock`               | `/vm_unlock`                      | Owner / Co‑owner                      |
| **Ghost**           | Hides your channel from the public list          | `.voicemaster ghost`                | `/vm_ghost`                       | Owner / Co‑owner                      |
| **Reveal**          | Makes your channel visible again                 | `.voicemaster reveal`               | `/vm_reveal`                      | Owner / Co‑owner                      |
| **Claim**           | Claims ownership if the original owner left      | `.voicemaster claim`                | `/vm_claim`                       | Any member inside                     |
| **Info**            | Shows detailed channel information               | `.voicemaster info`                 | `/vm_info`                        | Owner / Co‑owner / Member (view only) |
| **Limit Increase**  | Increases user limit by 1                        | `.voicemaster limit_increase`       | `/vm_limit_increase`              | Owner / Co‑owner                      |
| **Limit Decrease**  | Decreases user limit by 1                        | `.voicemaster limit_decrease`       | `/vm_limit_decrease`              | Owner / Co‑owner                      |
| **Rename**          | Renames your channel                             | `.voicemaster rename <new name>`    | `/vm_rename name:<new name>`      | Owner / Co‑owner                      |
| **Disconnect**      | Disconnects a specific member                    | `.voicemaster disconnect <@member>` | `/vm_disconnect member:<@member>` | Owner / Co‑owner                      |
| **Activity**        | Starts a voice activity (e.g., YouTube Together) | `.voicemaster activity`             | `/vm_activity`                    | Owner / Co‑owner                      |
| **Add Co‑owner**    | Grants another user co‑owner permissions         | `.voicemaster add <@user>`          | `/vm_add user:<@user>`            | Owner only                            |
| **Remove Co‑owner** | Revokes co‑owner permissions                     | `.voicemaster remove <@user>`       | `/vm_remove user:<@user>`         | Owner only                            |

***

#### Detailed Command Descriptions

**Lock / Unlock**

* **Lock** prevents new users from joining your channel. Existing members stay unaffected.
* **Unlock** reopens the channel, allowing anyone to join.

**Ghost / Reveal**

* **Ghost** hides your channel from the voice channel list. Users already inside can still see and use it – perfect for private conversations.
* **Reveal** makes the channel visible again.

**Info**

Displays an embed with:

* Owner and co-owners
* Current user limit
* Channel creation time
* Lock / ghost status
* Channel ID

**+ / -  Limit Increase / Decrease**

* Adjusts the maximum number of users allowed in your channel. Each click changes the limit by 1.
* *Minimum: 1 | Maximum: Server limit (usually 99).*

**Add / Remove Co‑owner**

* **Add** grants another user full control over your channel (lock, rename, disconnect, etc.).
* **Remove** revokes co‑owner status – the user becomes a regular member again.

**Claim**

> If the original owner leaves the server or the voice channel, anyone currently inside can claim ownership. This transfers full control to the claimant.

**Rename**

> Opens a prompt (prefix) or modal (slash) to enter a new name for your channel. Names must follow Discord's guidelines.

**Disconnect**

> Select a member from the dropdown (slash) or mention them (prefix) to forcefully remove them from your channel. They can rejoin if the channel is unlocked.

**Activity**

> Launches a selection menu of Discord's built‑in voice activities (YouTube Together, Poker Night, Chess, etc.). Once selected, an activity invite is created in your voice channel.

***

### Admin Commands

These commands require **Administrator** permission (or a configured admin role).

| Command           | Description                                      | Prefix Usage                                        | Slash Usage                                                         |
| ----------------- | ------------------------------------------------ | --------------------------------------------------- | ------------------------------------------------------------------- |
| **Setup**         | Configures join‑to‑create and panel channels     | `.setup_voicemaster <join-channel> <panel-channel>` | `/setup_voicemaster join_channel:<channel> panel_channel:<channel>` |
| **Remove Config** | Deletes all VoiceMaster settings for this server | `.voicemaster remove_config`                        | `/vm_remove_config`                                                 |

#### Setup

**Must be run first** to enable VoiceMaster on your server.

* **join-channel:** The voice channel users join to create a temporary channel.
* **panel-channel:** The text channel where the control interface (buttons) will be sent.

After successful setup, the bot automatically posts a panel message in the panel-channel. If the panel is accidentally deleted, you can rerun setup to regenerate it.

#### Remove Config

{% hint style="warning" %}
**Warning:** This command permanently deletes all VoiceMaster configuration for the current server. All temporary channels will stop being managed by the bot. Use only if you want to completely disable VoiceMaster.
{% endhint %}

***

### Notes & Tips

* **Prefix commands** use the bot’s default prefix (`.`). If your server uses a different prefix, replace `.` accordingly.
* **Slash commands** are prefixed with `/vm_` – they appear automatically as you type `/vm` in the chat.
* Most commands only work while you are inside **your own temporary voice channel**. Using them elsewhere will result in an error.
* Co‑owners have the same permissions as the owner, **except** they cannot add or remove other co‑owners.

***

### Example Usage

**Prefix examples:**

text

```
.voicemaster rename My Cool Channel
.voicemaster add @Friend
.voicemaster disconnect @Troll
```

**Slash examples:**

text

```
/vm_rename name:My Cool Channel
/vm_add user:@Friend
/vm_disconnect member:@Troll
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mythicalbot.gitbook.io/arklynn-docs/server-configuration/voicemaster/commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
