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

# Permissões

> De quais permissões a Lucie precisa para cada função e como resolver as falhas mais comuns.

Quase todo "não está funcionando" de um bot é permissão. Aqui você tem do que a Lucie precisa para cada coisa e como diagnosticar isso em um minuto.

<Note>
  O link oficial de convite já solicita tudo o que é necessário. Esta página serve se você desmarcou permissões ao convidá-la, se o seu servidor as restringe por canal ou se você quer dar a ela só o indispensável.
</Note>

## O mínimo para ela responder

Sem estes três, a Lucie não consegue nem responder a você:

<Columns cols={3}>
  <Card title="Ver Canal" icon="eye">
    Se ela não vê o canal, não lê os seus comandos.
  </Card>

  <Card title="Enviar Mensagens" icon="message-square">
    Para responder a você, obviamente.
  </Card>

  <Card title="Inserir Links" icon="link">
    Quase todas as respostas dela são embeds. Sem isso, elas saem vazias.
  </Card>
</Columns>

<Tip>
  As permissões do Discord se aplicam por canal. Se a Lucie funciona em um canal e não no de ao lado, quase sempre significa que esse canal tem uma substituição de permissões para o cargo dela.
</Tip>

## Por função

| Função                          | Permissão de que a Lucie precisa                                        |
| ------------------------------- | ----------------------------------------------------------------------- |
| Música (`!play`, `!join`…)      | **Conectar** e **Falar** no canal de voz                                |
| Snipes (`!snipe`)               | **Ver Histórico de Mensagens** e **Anexar Arquivos**                    |
| `!clearsnipe`                   | **Gerenciar Mensagens** (para apagar o comando e a confirmação dele)    |
| `!purge`                        | **Gerenciar Mensagens**                                                 |
| Advertências, mute, fichas      | **Moderar Membros**                                                     |
| `!kick`                         | **Expulsar Membros**                                                    |
| `!ban`, `!softban`, `!unban`    | **Banir Membros**                                                       |
| `!lock`, `!unlock`, `!slowmode` | **Gerenciar Canais** (e **Gerenciar Cargos** no canal para lock/unlock) |
| VoiceMaster                     | **Gerenciar Canais** e **Mover Membros**                                |
| Sorteios                        | **Adicionar Reações** e **Inserir Links**                               |
| Anti-raid e quarentena          | **Gerenciar Cargos**, **Expulsar** e **Banir Membros**                  |
| Convites                        | **Gerenciar Servidor** (para ler os códigos do servidor)                |

<Warning>
  A Lucie respeita a hierarquia de cargos do Discord: ela não pode punir, mover nem mudar o cargo de alguém que esteja acima dela. Se um comando de moderação falhar com um usuário específico, suba o cargo da Lucie acima do dessa pessoa.
</Warning>

## Permissões de que você precisa

Outro assunto: além do que a Lucie pode fazer, existe o que você pode pedir a ela. Os comandos de moderação exigem a permissão nativa correspondente **ou** um cargo de moderação autorizado pelo [painel web](https://lucie.elxy.dev).

Duas exceções feitas de propósito, porque são os seus próprios dados:

* `!purge -p` — apaga as suas mensagens sem exigir permissões de moderação.
* `!clearsnipe` — limpa o seu rastro dos snipes sem permissões. Só `!clearsnipe all` exige **Gerenciar Mensagens**.

## Diagnóstico rápido

<Steps>
  <Step title="Ela responde à menção?">
    Digite `@Lucie help`. Se ela não responder nada, é porque não vê o canal ou não consegue enviar mensagens ali.
  </Step>

  <Step title="Ela responde, mas a mensagem sai vazia?">
    Falta **Inserir Links**: as respostas dela são embeds.
  </Step>

  <Step title="Um comando específico falha?">
    Veja a tabela acima e confira essa permissão no canal, não só no cargo.
  </Step>

  <Step title="Falha só com certas pessoas?">
    É a hierarquia de cargos. Suba o cargo da Lucie acima do delas.
  </Step>
</Steps>

Se nada disso explicar, passe no [servidor de suporte](https://discord.gg/VqyAZJ2mFc) e conte para a gente qual comando e qual canal.