> ## 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.

# Resumen

> Headless VC crea una sala temporal al entrar de verdad al lobby configurado, registra el canal para ese servidor y mueve allí a la persona. El propietario actual controla su sala activa; el valor inicial hace las salas visibles.

## Cómo se crea la sala

Elige un canal de voz lobby y, opcionalmente, una categoría. Solo la transición hacia el lobby crea una sala; cambios de mute o audio no crean duplicados. Headless reutiliza una sala activa del mismo propietario si llegan eventos repetidos. La plantilla puede usar `{user}`, `{username}` y `{server}`; el nombre se limpia y se limita a 90 caracteres.

### `.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 on`

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

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

## Acceso y límites

La configuración por servidor guarda lobby, categoría, canal del panel, rol de acceso, plantilla, límite y bitrate. El límite admite 0–99; `0` significa ilimitado. Un rol de acceso opcional obtiene acceso mediante overwrites. Las salas nuevas son públicas por defecto; `hide` y `show` cambian la visibilidad de una sala concreta.

### `.privatevc permit`

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

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

### `.privatevc limit`

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

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

## Controles del propietario

Los controles de sala requieren estar dentro de una sala activa registrada y ser su propietario actual. Puedes bloquear o abrir conexiones, ocultar o mostrar el canal, permitir o denegar usuarios, expulsar, cambiar nombre/límite/región, transferir ownership, reclamar una sala sin propietario presente o eliminarla. Manage Channels del usuario no sustituye la comprobación de propietario.

### `.privatevc region`

```headless-command Syntax theme={null}
.privatevc region [region=auto]
```

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

> [!WARNING]
>
> No actives `.privatevc off` mientras haya salas que dependan de la limpieza automática. `afk-time` no expulsa miembros y Headless no desconecta a nadie por inactividad.

**Nota:**

Los ajustes operativos se guardan por servidor en el almacén existente de Headless. El panel se publica en el canal de panel configurado o, si no hay uno válido, en el canal de texto actual.

## Ciclo de vida y AFK

Headless elimina las salas vacías registradas mientras Headless VC está habilitado. Desactivar el módulo detiene la creación automática y también pausa la limpieza; vacía o elimina manualmente las salas existentes antes de usar `.privatevc off`. La desconexión automática AFK está desactivada: `.privatevc afk` solo confirma el estado y `afk-time` conserva un valor heredado sin activar esa automatización.

## Pasos

**1. Prepara el lobby**

Crea un canal de voz dedicado y decide si las salas deben quedar bajo una categoría existente.

**2. Configura y habilita**

Con Manage Channels de Discord o un permiso virtual compatible de Headless, ejecuta `.privatevc lobby #Crear-VC`. La operación habilita el módulo. Ajusta la categoría y publica el panel si tu comunidad usará controles interactivos.

**3. Verifica permisos del bot**

Confirma Manage Channels y Move Members para crear la sala y mover al miembro. El bot debe poder enviar mensajes en el canal del panel; si se crean roles temporales, también necesita Manage Roles y jerarquía suficiente.

**4. Prueba entrada y limpieza**

Entra al lobby con una cuenta de prueba, prueba un control como dueño y sal de la sala. Confirma que la sala vacía se elimine mientras el módulo siga habilitado.

## Qué ofrece el panel global

> **Controles interactivos**
>
> El panel persistente tiene diez botones principales: bloquear, desbloquear, ocultar, mostrar, desconectar a un usuario, reclamar, renombrar, ver información y aumentar o disminuir el límite. Las acciones sensibles vuelven a comprobar el propietario en cada interacción. `transfer`, `permit`, `deny`, `region` y `delete` también están disponibles mediante comandos de prefijo.

### `.privatevc panel`

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

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

## Páginas relacionadas

* [Comandos de voz](/docs/voice/commands.md)
* [Permisos de voz](/docs/voice/permissions.md)


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