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

# Permisos

> Qué permisos necesita Lucie para cada función y cómo resolver los fallos más típicos.

Casi todos los "no me funciona" de un bot son permisos. Aquí tienes qué necesita Lucie para cada cosa y cómo diagnosticarlo en un minuto.

<Note>
  El enlace oficial de invitación ya solicita todo lo necesario. Esta página te sirve si desmarcaste permisos al invitarla, si tu servidor los restringe por canal o si quieres darle solo lo justo.
</Note>

## Lo mínimo para que responda

Sin estos tres, Lucie no puede ni contestarte:

<Columns cols={3}>
  <Card title="Ver canal" icon="eye">
    Si no ve el canal, no lee tus comandos.
  </Card>

  <Card title="Enviar mensajes" icon="message-square">
    Para responderte, obviamente.
  </Card>

  <Card title="Insertar enlaces" icon="link">
    Casi todas sus respuestas son embeds. Sin esto, salen vacías.
  </Card>
</Columns>

<Tip>
  Los permisos de Discord se aplican por canal. Que Lucie funcione en un canal y no en el de al lado casi siempre significa que ese canal tiene una anulación de permisos para su rol.
</Tip>

## Por función

| Función                         | Permiso que necesita Lucie                                                 |
| ------------------------------- | -------------------------------------------------------------------------- |
| Música (`!play`, `!join`…)      | **Conectar** y **Hablar** en el canal de voz                               |
| Snipes (`!snipe`)               | **Ver historial de mensajes** y **Adjuntar archivos**                      |
| `!clearsnipe`                   | **Gestionar mensajes** (para borrar el comando y su confirmación)          |
| `!purge`                        | **Gestionar mensajes**                                                     |
| Advertencias, mute, expedientes | **Moderar miembros**                                                       |
| `!kick`                         | **Expulsar miembros**                                                      |
| `!ban`, `!softban`, `!unban`    | **Banear miembros**                                                        |
| `!lock`, `!unlock`, `!slowmode` | **Gestionar canales** (y **Gestionar roles** en el canal para lock/unlock) |
| VoiceMaster                     | **Gestionar canales** y **Mover miembros**                                 |
| Sorteos                         | **Añadir reacciones** y **Insertar enlaces**                               |
| Anti-raid y cuarentena          | **Gestionar roles**, **Expulsar** y **Banear miembros**                    |
| Invitaciones                    | **Gestionar servidor** (para leer los códigos del servidor)                |

<Warning>
  Lucie respeta la jerarquía de roles de Discord: no puede sancionar, mover ni cambiar el rol de alguien que esté por encima de ella. Si un comando de moderación falla con un usuario concreto, sube el rol de Lucie por encima del de esa persona.
</Warning>

## Permisos que necesitas tú

Distinto asunto: además de lo que puede hacer Lucie, está lo que puedes pedirle tú. Los comandos de moderación exigen el permiso nativo correspondiente **o** un rol de moderación autorizado desde el [panel web](https://lucie.elxy.dev).

Dos excepciones pensadas a propósito, porque son tus propios datos:

* `!purge -p` — borra tus mensajes sin pedirte permisos de moderación.
* `!clearsnipe` — limpia tu rastro de los snipes sin permisos. Solo `!clearsnipe all` exige **Gestionar mensajes**.

## Diagnóstico rápido

<Steps>
  <Step title="¿Responde a la mención?">
    Escribe `@Lucie help`. Si no contesta nada, es que no ve el canal o no puede enviar mensajes ahí.
  </Step>

  <Step title="¿Responde pero el mensaje sale vacío?">
    Le falta **Insertar enlaces**: sus respuestas son embeds.
  </Step>

  <Step title="¿Un comando concreto falla?">
    Mira la tabla de arriba y comprueba ese permiso en el canal, no solo en el rol.
  </Step>

  <Step title="¿Falla solo con ciertas personas?">
    Es la jerarquía de roles. Sube el rol de Lucie por encima del de ellas.
  </Step>
</Steps>

Si nada de esto lo explica, pásate por el [servidor de soporte](https://discord.gg/VqyAZJ2mFc) y cuéntanos qué comando y qué canal.