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

# Comandos y controles

> Headless VC registra un grupo de prefijo con los alias `vcprivado` y `pc`; el prefijo predeterminado es `.` y puede cambiar por servidor. Las 22 entradas siguientes corresponden al grupo raíz y a sus subcomandos reales.

## Configurar el módulo

El grupo raíz comprueba directamente el permiso nativo Manage Channels para mostrar el panel de estado/configuración; dentro de una sala activa indica cómo abrir el panel global. Los subcomandos `lobby`, `category`, `panel`, `on` y `off` aceptan Manage Channels nativo o el permiso virtual compatible de Headless; `role` acepta Manage Roles nativo o virtual.

### `.privatevc lobby`

```headless-command Syntax theme={null}
.privatevc lobby <channel>
```

```headless-command Example theme={null}
.privatevc lobby #Crear-VC
```

### `.privatevc category`

```headless-command Syntax theme={null}
.privatevc category <name>
```

```headless-command Example theme={null}
.privatevc category Privados
```

### `.privatevc role`

```headless-command Syntax theme={null}
.privatevc role <role>
```

```headless-command Example theme={null}
.privatevc role @VC-Access
```

### `.privatevc on`

```headless-command Syntax theme={null}
.privatevc on
```

```headless-command Example theme={null}
.privatevc on
```

## Controles de sala

Salvo `claim`, los controles de sala requieren que el actor esté dentro de una sala registrada y sea su propietario actual. `claim` permite a un ocupante asumirla solo cuando el propietario anterior ya no está presente. Las modificaciones actualizan los overwrites de Discord y se guardan por servidor.

### `.privatevc panel`

```headless-command Syntax theme={null}
.privatevc panel
```

```headless-command Example theme={null}
.privatevc panel
```

### `.privatevc permit`

```headless-command Syntax theme={null}
.privatevc permit <member>
```

```headless-command Example theme={null}
.privatevc permit @Member
```

### `.privatevc deny`

```headless-command Syntax theme={null}
.privatevc deny <member>
```

```headless-command Example theme={null}
.privatevc deny @Member
```

### `.privatevc kick`

```headless-command Syntax theme={null}
.privatevc kick <member>
```

```headless-command Example theme={null}
.privatevc kick @Member
```

### `.privatevc transfer`

```headless-command Syntax theme={null}
.privatevc transfer <member>
```

```headless-command Example theme={null}
.privatevc transfer @Member
```

### `.privatevc limit`

```headless-command Syntax theme={null}
.privatevc limit [limit=0]
```

```headless-command Example theme={null}
.privatevc limit 5
```

### `.privatevc lock`

```headless-command Syntax theme={null}
.privatevc lock
```

```headless-command Example theme={null}
.privatevc lock
```

### `.privatevc delete`

```headless-command Syntax theme={null}
.privatevc delete
```

```headless-command Example theme={null}
.privatevc delete
```

## Argumentos y resultados

Menciona miembros y roles con sus menciones reales. `category` exige el nombre exacto; `limit` se limita a 0–99 y 0 equivale a sin límite; `name` se limpia y limita a 90 caracteres. `region auto` restablece la región automática; una región no admitida puede ser rechazada por Discord.

## Pasos

**1. Confirma el canal actual**

Entra a la sala que quieres gestionar antes de ejecutar un control de dueño.

**2. Usa el comando específico**

Aplica una sola acción y confirma sus argumentos, en especial el miembro de `deny`, `kick` o `transfer`.

**3. Comprueba el estado**

Verifica el canal, sus permisos, el límite y el propietario actualizado en Discord.

## Referencia completa de comandos

> **Detalles de referencia**
>
> * **`.privatevc`** — **Acceso del usuario:** Servidor; Manage Channels nativo para el panel raíz · **Comportamiento real:** Muestra el panel de configuración o dirige a miembros de una sala activa al panel global.
> * **`.privatevc afk [state]`** — **Acceso del usuario:** Manage Channels nativo o Fake Permissions compatible · **Comportamiento real:** `on` no activa desconexiones; `off` y `status` dejan AFK apagado.
> * **`.privatevc afk-time [minutes]`** — **Acceso del usuario:** Manage Channels nativo o Fake Permissions compatible · **Comportamiento real:** Guarda 5–240 minutos (predeterminado 20); valor heredado, no inicia desconexiones.
> * **`.privatevc category <nombre exacto>`** — **Acceso del usuario:** Manage Channels nativo o Fake Permissions compatible · **Comportamiento real:** Selecciona una categoría existente del mismo servidor.
> * **`.privatevc claim`** — **Acceso del usuario:** Ocupante de sala activa · **Comportamiento real:** Reclama la sala solo si el propietario actual ya no está presente.
> * **`.privatevc delete`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Elimina la sala activa e intenta quitar el rol temporal asociado.
> * **`.privatevc deny @miembro`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Bloquea acceso y quita permiso previo; intenta desconectar al miembro si ya está dentro.
> * **`.privatevc hide`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Oculta el canal mediante overwrites de Discord.
> * **`.privatevc kick @miembro`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Mueve fuera de la sala al miembro seleccionado.
> * **`.privatevc limit [0–99]`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Cambia la capacidad; `0` quita el límite.
> * **`.privatevc lobby #canal-voz`** — **Acceso del usuario:** Manage Channels nativo o Fake Permissions compatible · **Comportamiento real:** Guarda el lobby de voz y habilita Headless VC.
> * **`.privatevc lock`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Impide nuevas conexiones mediante overwrites.
> * **`.privatevc name <nombre>`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Renombra la sala; el texto queda sanitizado y limitado a 90 caracteres.
> * **`.privatevc off`** — **Acceso del usuario:** Manage Channels nativo o Fake Permissions compatible · **Comportamiento real:** Deshabilita creación automática y pausa limpieza de salas vacías; no borra salas existentes.
> * **`.privatevc on`** — **Acceso del usuario:** Manage Channels nativo o Fake Permissions compatible · **Comportamiento real:** Habilita el módulo y el ciclo automático del lobby.
> * **`.privatevc panel`** — **Acceso del usuario:** Manage Channels nativo o Fake Permissions compatible · **Comportamiento real:** Publica o actualiza el panel global en el canal configurado o el canal de texto actual.
> * **`.privatevc permit @miembro`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Permite al usuario y quita una denegación anterior; la lista conserva hasta 40 IDs.
> * **`.privatevc region [región]`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Establece una región RTC o usa `auto` para restablecer selección automática.
> * **`.privatevc role @rol`** — **Acceso del usuario:** Manage Roles nativo o Fake Permissions compatible · **Comportamiento real:** Guarda el rol opcional que recibe acceso a las salas.
> * **`.privatevc show`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Vuelve visible la sala mediante overwrites.
> * **`.privatevc transfer @miembro`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Transfiere ownership y añade al nuevo propietario a la lista permitida.
> * **`.privatevc unlock`** — **Acceso del usuario:** Propietario actual dentro de su sala · **Comportamiento real:** Vuelve a permitir conexiones mediante overwrites.

> [!WARNING]
>
> `deny` puede quitar acceso y tratar de desconectar a una persona; `kick` la mueve fuera; `delete` elimina tu sala. Confirma el canal y la persona antes de ejecutarlos. La limpieza automática se pausa con `off`.

**Nota:**

Todos son comandos de prefijo del bot, no comandos slash. `privatevc` también acepta los alias raíz `vcprivado` y `pc`; varios subcomandos tienen alias adicionales en español.

Las etiquetas y confirmaciones predeterminadas que genera el panel interactivo de Headless están en inglés. Los nombres de canales, categorías, roles y miembros siguen siendo los definidos en Discord.

## Páginas relacionadas

* [Resumen de Headless VC](/docs/voice/overview.md)
* [Permisos de voz](/docs/voice/permissions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.