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

# Primeiros passos

> Convide a Lucie para o seu servidor e aprenda o básico para começar a usá-la.

A Lucie é um bot do Discord com música, moderação, sorteios, roleplay e muito mais. Este guia leva você do zero até tê-la funcionando no seu servidor em poucos minutos.

<Steps>
  <Step title="Convide-a para o seu servidor">
    Abra o link oficial de convite e escolha o servidor onde você quer adicioná-la:

    [https://lucie.elxy.dev/invite](https://lucie.elxy.dev/invite)

    Você precisa da permissão **Gerenciar Servidor** nesse servidor para poder convidar bots. Se a Lucie já estiver em algum servidor com você, também pode pedir o link diretamente a ela com `!invite`.
  </Step>

  <Step title="Conceda as permissões recomendadas">
    O link oficial solicita permissões de **Administrador**. É a opção recomendada: garante que todas as funções da Lucie funcionem sem tropeços desde o primeiro momento.

    <Note>
      Durante o convite você pode desmarcar permissões se preferir algo mais restrito, mas algumas funções podem deixar de operar corretamente.
    </Note>
  </Step>

  <Step title="Fale com ela como preferir">
    A Lucie entende três formas de ser invocada:

    * **Prefixo** — por padrão `!`. Digite `!help` em qualquer canal para ver o menu de comandos dela.
    * **Menção** — mencioná-la também funciona como <Tooltip tip="O caractere que vai antes do nome do comando para a Lucie reconhecê-lo.">prefixo</Tooltip>: `@Lucie help`. Perfeito se você não lembra o prefixo do servidor.
    * **<Tooltip tip="Comandos que aparecem no menu do Discord ao digitar “/”, sem precisar de prefixo.">Slash commands</Tooltip>** — digite `/` no chat e procure os comandos dela. Funcionam até mesmo se você a instalar como app de usuário, sem que ela precise estar no servidor.

    <Tip>
      `!help` abre um menu interativo com todas as categorias, e `!help <comando>` mostra a documentação de um comando específico, com uso, exemplos e atalhos.
    </Tip>
  </Step>

  <Step title="Personalize o prefixo (opcional)">
    O `!` entra em conflito com outro bot do seu servidor? Mude-o com `!setprefix`:

    ```text theme={"dark"}
    !setprefix .
    ```

    A mudança afeta apenas esse servidor, o novo prefixo pode ter no máximo **5 caracteres** e é preciso ser **Administrador** para usar o comando.
  </Step>

  <Step title="Explore o painel web e o suporte">
    Boa parte da configuração também vive no navegador. Acesse [https://lucie.elxy.dev](https://lucie.elxy.dev), faça login com o Discord e administre os servidores onde você tem a permissão **Gerenciar Servidor**. E se você travar em algo, o servidor de suporte está sempre aberto.

    <Columns cols={2}>
      <Card title="Painel web" icon="layout-dashboard" href="https://lucie.elxy.dev">
        Configure a Lucie pelo navegador e consulte a lista completa de comandos.
      </Card>

      <Card title="Servidor de suporte" icon="life-buoy" href="https://discord.gg/VqyAZJ2mFc">
        Suporte direto, reporte de erros e novidades do bot.
      </Card>
    </Columns>
  </Step>
</Steps>

***

## !invite

Gera o link oficial de convite para adicionar a Lucie a outros servidores, com um botão seguro que abre o fluxo de autorização do Discord.

**Uso:** `!invite`

**Atalhos:** `inv`, `addbot`

**Exemplos**

```text theme={"dark"}
!invite
```

## !setprefix

Muda o prefixo da Lucie exclusivamente no servidor onde você executa o comando. Os demais servidores não são afetados.

**Uso:** `!setprefix <novo_prefixo>`

**Atalhos:** `prefix`, `sp`

**Permissões:** Administrador

<Note>
  O novo prefixo não pode passar de **5 caracteres**. Se você não indicar nenhum, a Lucie responderá com um exemplo de uso.
</Note>

**Exemplos**

```text theme={"dark"}
!setprefix !
!setprefix .
```

## !dashboard

Mostra o link do painel web da Lucie, com botões para abrir o dashboard e ver a lista de comandos em [lucie.elxy.dev/commands](https://lucie.elxy.dev/commands). Pelo painel você configura o bot nos servidores onde tem **Gerenciar Servidor**, fazendo login com a sua conta do Discord.

**Uso:** `!dashboard`

**Atalhos:** `panel`, `dash`, `web`

**Exemplos**

```text theme={"dark"}
!dashboard
```

## !soporte

Mostra o link do servidor de suporte oficial da Lucie, com um botão para entrar diretamente. Lá você encontra ajuda, pode reportar erros e ficar por dentro das novidades.

**Uso:** `!soporte`

**Atalhos:** `support`, `servidor`

**Exemplos**

```text theme={"dark"}
!soporte
```