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

# Getting started

> Invite Lucie to your server and learn the basics to start using her.

Lucie is a Discord bot with music, moderation, giveaways, roleplay, and much more. This guide takes you from zero to having her up and running on your server in just a few minutes.

<Steps>
  <Step title="Invite her to your server">
    Open the official invite link and choose the server where you want to add her:

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

    You need the **Manage Server** permission on that server to invite bots. If Lucie is already in a server with you, you can also ask her for the link directly with `!invite`.
  </Step>

  <Step title="Grant the recommended permissions">
    The official link requests **Administrator** permissions. This is the recommended option: it guarantees that all of Lucie's features work smoothly from the very start.

    <Note>
      During the invite you can uncheck permissions if you prefer something more limited, but some features may stop working properly.
    </Note>
  </Step>

  <Step title="Talk to her however you like">
    Lucie understands three ways of being invoked:

    * **Prefix** — `!` by default. Type `!help` in any channel to see her command menu.
    * **Mention** — mentioning her also works as a <Tooltip tip="The character you type before a command name so Lucie recognizes it.">prefix</Tooltip>: `@Lucie help`. Perfect if you don't remember the server's prefix.
    * **<Tooltip tip="Commands that show up in Discord’s menu when you type “/”, with no prefix needed.">Slash commands</Tooltip>** — type `/` in the chat and browse her commands. They work even if you install her as a user app, without her needing to be in the server.

    <Tip>
      `!help` opens an interactive menu with every category, and `!help <command>` shows you the documentation for a specific command, including its usage, examples, and aliases.
    </Tip>
  </Step>

  <Step title="Customize the prefix (optional)">
    Does `!` clash with another bot on your server? Change it with `!setprefix`:

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

    The change only affects that server, the new prefix can be at most **5 characters** long, and you need to be an **Administrator** to use the command.
  </Step>

  <Step title="Explore the web dashboard and support">
    A good part of the configuration also lives in your browser. Go to [https://lucie.elxy.dev](https://lucie.elxy.dev), sign in with Discord, and manage the servers where you have the **Manage Server** permission. And if you get stuck, the support server is always open.

    <Columns cols={2}>
      <Card title="Web dashboard" icon="layout-dashboard" href="https://lucie.elxy.dev">
        Configure Lucie from your browser and browse the full command list.
      </Card>

      <Card title="Support server" icon="life-buoy" href="https://discord.gg/VqyAZJ2mFc">
        Direct support, bug reports, and bot news.
      </Card>
    </Columns>
  </Step>
</Steps>

***

## !invite

Generates the official invite link to add Lucie to other servers, with a safe button that opens Discord's authorization flow.

**Usage:** `!invite`

**Aliases:** `inv`, `addbot`

**Examples**

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

## !setprefix

Changes Lucie's prefix exclusively for the server where you run it. Other servers are not affected.

**Usage:** `!setprefix <new_prefix>`

**Aliases:** `prefix`, `sp`

**Permissions:** Administrator

<Note>
  The new prefix cannot exceed **5 characters**. If you don't provide one, Lucie will reply with a usage example.
</Note>

**Examples**

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

## !dashboard

Shows the link to Lucie's web dashboard, with buttons to open the dashboard and view the command list at [lucie.elxy.dev/commands](https://lucie.elxy.dev/commands). From the dashboard you configure the bot on the servers where you have **Manage Server**, signing in with your Discord account.

**Usage:** `!dashboard`

**Aliases:** `panel`, `dash`, `web`

**Examples**

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

## !soporte

Shows the link to Lucie's official support server, with a button to join directly. There you'll find help, can report bugs, and stay up to date with the latest news.

**Usage:** `!soporte`

**Aliases:** `support`, `servidor`

**Examples**

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