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

> Fake Permissions asigna capacidades virtuales a un rol para las comprobaciones compatibles de comandos Headless. No cambia los permisos nativos de Discord ni convierte el rol en administrador del servidor.

## Quién puede administrarlo

Solo el owner del servidor o el owner de Headless puede consultar, conceder, retirar y reiniciar la configuración. Ser administrador de Discord o tener permisos virtuales no autoriza a gestionar Fake Permissions. Los comandos solo funcionan dentro de un servidor.

## Catálogo y alcance

Se pueden conceder estas claves: `administrator`, `ban_members`, `mention_everyone`, `kick_members`, `moderate_members`, `manage_guild`, `manage_channels`, `manage_roles`, `view_audit_log`, `manage_webhooks`, `manage_expressions`, `manage_nicknames` y `manage_messages`. El valor virtual `administrator` es amplio; concede únicamente los permisos puntuales necesarios cuando sea posible. Una protección propia del comando, una comprobación de owner, la jerarquía y los permisos que necesita el bot siguen aplicándose.

### `.fakepermissions list`

```headless-command Syntax theme={null}
.fakepermissions list [role]
```

```headless-command Example theme={null}
.fp list
```

También funciona: `.fp list @Moderator`

### `/fakepermissions list`

```headless-command Syntax theme={null}
/fakepermissions list [role:<role>]
```

```headless-command Example theme={null}
/fakepermissions list role:@Moderator
```

## Alias de claves

Las claves aceptan alias: `admin` → `administrator`, `ban` → `ban_members`, `kick` → `kick_members`, `timeout` y `mute` → `moderate_members`, `channels` → `manage_channels`, `roles` → `manage_roles`, `messages` → `manage_messages`, `nicknames` → `manage_nicknames`, `server` → `manage_guild`, `webhooks` → `manage_webhooks`, `emojis` → `manage_expressions` y `audit` → `view_audit_log`. `history` solo se reconoce al retirar el permiso heredado `read_message_history`; no permite concederlo.

## Configuración y cambios

La asignación se guarda por servidor y por ID de rol en la configuración persistente de Headless. Puedes introducir varias claves separadas por espacios o comas; Headless normaliza alias, elimina duplicados y rechaza la operación si incluyes una clave desconocida. No uses `@everyone` ni roles administrados por integraciones. El listado puede mostrar todas las asignaciones o las de un rol concreto.

### `.fakepermissions add`

```headless-command Syntax theme={null}
.fakepermissions add <role> <permissions>
```

```headless-command Example theme={null}
.fp add @Moderator manage_messages, kick_members
```

También funciona: `.fp grant @Moderator manage_messages`

### `.fakepermissions remove`

```headless-command Syntax theme={null}
.fakepermissions remove <role> <permissions>
```

```headless-command Example theme={null}
.fp remove @Moderator manage_messages
```

## Permisos heredados

`read_message_history` ya no pertenece al catálogo asignable. Si aparece en una configuración antigua, se conserva para no retirar comportamiento sin aviso y puede eliminarse con `remove`; no se puede volver a conceder.

### `/fakepermissions grant`

```headless-command Syntax theme={null}
/fakepermissions grant role:<role> permissions:<permissions>
```

```headless-command Example theme={null}
/fakepermissions grant role:@Moderator permissions:manage_messages
```

### `/fakepermissions revoke`

```headless-command Syntax theme={null}
/fakepermissions revoke role:<role> permissions:<permissions>
```

```headless-command Example theme={null}
/fakepermissions revoke role:@Moderator permissions:manage_messages
```

## Reinicio protegido

`.fp reset` muestra una confirmación temporal de 90 segundos. Solo puede confirmarla quien inició la solicitud, en el mismo servidor, y Headless vuelve a comprobar que siga siendo owner autorizado. Confirmar elimina todas las asignaciones virtuales de ese servidor; cancelar o dejar vencer la solicitud no las cambia.

### `.fakepermissions reset`

```headless-command Syntax theme={null}
.fakepermissions reset
```

```headless-command Example theme={null}
.fp reset
```

### `/fakepermissions reset`

```headless-command Syntax theme={null}
/fakepermissions reset
```

```headless-command Example theme={null}
/fakepermissions reset
```

> [!NOTE]
>
> No concede permisos nativos de Discord, acceso a la configuración de Anti-Nuke ni una excepción de su whitelist. La capacidad virtual `administrator` sigue limitada a comprobaciones compatibles de Headless y no sustituye los controles propios de un comando.

**Nota:**

Los comandos de prefijo responden en el canal donde se ejecutan; los comandos slash responden de forma privada. Conceder y retirar registra el cambio en los registros de sistema de Headless.

## Pasos

**1. Elige un rol normal**

Crea o selecciona un rol administrable del staff; no uses `@everyone` ni un rol gestionado por una integración.

**2. Concede el mínimo necesario**

Agrega solo las capacidades que un comando Headless compatible requiere. Por ejemplo, `manage_messages` y `kick_members` son entradas independientes.

**3. Revisa el alcance**

Usa `.fp list` o consulta un rol específico y confirma que la concesión no se confunda con la whitelist o los administradores de Anti-Nuke.

**4. Prueba el comando protegido**

Ejecuta una acción permitida en un contexto de ensayo. Una capacidad virtual no concede al bot los permisos de Discord que necesita para realizarla.

## Páginas relacionadas

* [Permisos de Headless](/docs/permissions.md)
* [Anti-Nuke](/docs/security/anti-nuke.md)
* [Moderación](/docs/security/moderation.md)


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