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

# Permisos

> Headless VC separa los permisos de quien configura el módulo, del propietario de cada sala y del propio bot. Los comandos de sala se limitan al servidor y comprueban el ownership actual.

## Permisos del usuario que configura

Los subcomandos `lobby`, `category`, `on`, `off`, `panel`, `afk` y `afk-time` aceptan el permiso nativo Manage Channels o el permiso virtual compatible de Headless. `role` acepta Manage Roles nativo o virtual. No se exige Administrator. El grupo raíz comprueba directamente Manage Channels de Discord para mostrar el panel; el panel global no convierte a otros usuarios en propietarios.

### `.privatevc lobby`

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

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

### `.privatevc panel`

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

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

## Permisos del propietario de sala

`lock`, `unlock`, `hide`, `show`, `permit`, `deny`, `kick`, `name`, `limit`, `delete`, `region` y `transfer` requieren estar dentro de una sala registrada y ser su propietario actual. `claim` es la excepción: puede usarlo un ocupante si el propietario actual ya salió. Tener Manage Channels no permite administrar la sala de otra persona.

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

## Permisos del bot y jerarquía

El bot necesita Manage Channels para crear, editar overwrites y eliminar canales. Al crear la sala debe poder mover al miembro desde el lobby; `kick` y la desconexión intentada por `deny` también dependen de Move Members. El panel requiere View Channel y Send Messages en su canal. La creación/eliminación de un rol temporal requiere Manage Roles y jerarquía suficiente.

## Pasos

**1. Asigna permisos mínimos al bot**

Concede Manage Channels y Move Members para la función de voz; habilita Manage Roles solo si se usarán roles temporales.

**2. Restringe la configuración**

Reserva los comandos de configuración a quienes tengan Manage Channels o Manage Roles según la tabla.

**3. Prueba como usuario y propietario**

Valida la configuración con un administrador y después confirma que una persona ajena a la sala no pueda cambiarla, incluso si tiene Manage Channels.

## Quién necesita cada permiso

* **Configurador** — **Permiso o condición:** Manage Channels de Discord o permiso virtual compatible · **Acciones:** Lobby, categoría, activar/desactivar, publicar panel y opciones AFK heredadas.
* **Configurador** — **Permiso o condición:** Manage Roles de Discord o permiso virtual compatible · **Acciones:** Guardar el rol de acceso opcional.
* **Propietario de sala** — **Permiso o condición:** Dentro de su sala activa y owner actual · **Acciones:** Cambios de acceso, visibilidad, bloqueo, nombre, capacidad, región, transferencia y borrado.
* **Ocupante** — **Permiso o condición:** Dentro de la sala; el owner anterior ya no está · **Acciones:** Reclamar ownership con `claim`.
* **Bot** — **Permiso o condición:** Manage Channels y Move Members · **Acciones:** Crear y ajustar la sala, mover a quien entra al lobby y expulsar/desconectar miembros.
* **Bot** — **Permiso o condición:** View Channel y Send Messages · **Acciones:** Publicar o actualizar el panel en el canal de texto escogido.
* **Bot** — **Permiso o condición:** Manage Roles y jerarquía suficiente · **Acciones:** Crear/asignar y después quitar roles de acceso temporales cuando corresponda.

> [!WARNING]
>
> No otorgues Administrator al bot para resolver errores de voz. Revisa el permiso concreto, los overwrites del canal y la posición jerárquica del rol del bot.

**Nota:**

Fake Permissions puede satisfacer los checks decorados de subcomandos administrativos, pero no el check nativo directo del panel raíz. En ningún caso otorga permisos de Discord al bot ni cambia overwrites.

## Páginas relacionadas

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


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