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

# Música

> Comandos de música da Lucie: reprodução, fila, canal de voz, favoritos, playlists e modo DJ.

A Lucie toca música no seu canal de voz a partir de buscas por texto ou links do **YouTube** e do **SoundCloud**, incluindo playlists completas.

<Note>
  Os exemplos usam o prefixo padrão `!` (configurável com `!setprefix`). A Lucie também responde à menção dela e aos slash commands (`/comando`).
</Note>

<Note>
  Para controlar a reprodução (pular, pausar, mover a <Tooltip tip="A lista de músicas em espera: tocam em ordem quando a atual termina.">fila</Tooltip>, etc.) você precisa estar **no mesmo canal de voz** que a Lucie. Comandos somente de leitura, como `!queue` ou `!nowplaying`, não exigem isso.
</Note>

## Reprodução

## !play

Toca uma música ou a adiciona à fila. Aceita o nome da música ou um link direto.

**Uso:** `!play <nome ou link>`

**Atalhos:** `p`

* Se não houver nada tocando, a música começa na hora.
* Se já houver música, ela entra na fila e a Lucie mostra a posição dela e o tempo estimado até tocar.
* Com um link de playlist, todas as músicas são adicionadas de uma vez, com o total de faixas e a duração somada.

**Exemplos**

```text theme={"dark"}
!play bad bunny diles
!play https://youtu.be/dQw4w9WgXcQ
```

## !pause

Pausa a reprodução atual.

**Uso:** `!pause`

**Atalhos:** `pausa`

**Exemplos**

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

## !resume

Retoma a reprodução pausada.

**Uso:** `!resume`

**Atalhos:** `continuar`, `unpause`

**Exemplos**

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

## !stop

Para a música e esvazia a fila. A Lucie permanece no canal de voz.

**Uso:** `!stop`

**Atalhos:** `parar`

**Exemplos**

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

## !skip

Pula para a próxima música da fila. Se não sobrar nada, a reprodução para.

**Uso:** `!skip`

**Atalhos:** `s`, `next`, `saltar`

**Exemplos**

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

## !seek

Pula para um ponto específico da música atual. Aceita segundos ou o formato `m:ss`. Se o ponto passar da duração da música, a Lucie avisa.

**Uso:** `!seek <segundos|m:ss>`

**Atalhos:** `ir`

**Exemplos**

```text theme={"dark"}
!seek 90
!seek 1:30
```

## !nowplaying

Mostra a música que está tocando agora: artista, barra de progresso, tempo decorrido e total, estado (tocando ou pausado), volume e modo de repetição.

**Uso:** `!nowplaying`

**Atalhos:** `np`, `sonando`

**Exemplos**

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

## !lyrics

Busca a letra da música que está tocando. Você também pode pedir uma letra específica no formato `artista - título`. Letras muito longas são cortadas.

**Uso:** `!lyrics [artista - título]`

**Atalhos:** `letra`

**Exemplos**

```text theme={"dark"}
!lyrics
!lyrics queen - bohemian rhapsody
```

<Tip>
  Se a Lucie não encontrar a letra da música atual (títulos de vídeo às vezes trazem texto extra), tente `!lyrics artista - título` digitado à mão.
</Tip>

## Fila

## !queue

Mostra a fila de reprodução: a música atual e as 10 seguintes (se houver mais, indica quantas restam), junto com o total na fila, o volume e o modo de repetição.

**Uso:** `!queue`

**Atalhos:** `q`, `cola`

**Exemplos**

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

## !remove

Tira uma música da fila pelo número dela. Consulte os números com `!queue`.

**Uso:** `!remove <número>`

**Atalhos:** `rm`, `quitar`

**Exemplos**

```text theme={"dark"}
!remove 3
```

## !clear

Esvazia a fila sem parar a música que está tocando.

**Uso:** `!clear`

**Atalhos:** `cls`, `limpiar`

**Exemplos**

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

## !move

Move uma música da fila de uma posição para outra.

**Uso:** `!move <de> <para>`

**Atalhos:** `mover`, `mv`

**Exemplos**

```text theme={"dark"}
!move 5 1
```

## !shuffle

Embaralha aleatoriamente as músicas da fila.

**Uso:** `!shuffle`

**Atalhos:** `mix`, `mezclar`

**Exemplos**

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

## !loop

Muda o modo de repetição:

* `off` — sem repetição.
* `track` — repete a música atual (também aceita `song`, `cancion`, `one`).
* `queue` — repete a fila inteira (também aceita `cola`, `all`).

Sem argumento, alterna para o próximo modo no ciclo `off → track → queue → off`.

**Uso:** `!loop [off|track|queue]`

**Atalhos:** `repeat`, `l`

**Exemplos**

```text theme={"dark"}
!loop track
!loop queue
!loop off
```

## !autoplay

Ativa ou desativa o <Tooltip tip="Quando a fila acaba, a Lucie continua sozinha com músicas parecidas.">autoplay</Tooltip>: quando a fila acaba, a Lucie continua tocando faixas parecidas por conta própria. Precisa de um player já ativo (coloque algo com `!play` antes).

**Uso:** `!autoplay`

**Atalhos:** `radio`

**Exemplos**

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

## Canal de voz

## !join

Faz a Lucie entrar no seu canal de voz.

**Uso:** `!join`

**Atalhos:** `summon`, `venir`

**Exemplos**

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

## !leave

Desconecta a Lucie do canal de voz.

**Uso:** `!leave`

**Atalhos:** `dc`, `disconnect`, `salir`

**Exemplos**

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

## !volume

Ajusta o volume entre 0 e 150 (valores fora do intervalo são ajustados ao limite). Sem argumento, mostra o volume atual.

**Uso:** `!volume [0-150]`

**Atalhos:** `vol`, `v`

**Exemplos**

```text theme={"dark"}
!volume 50
!volume 100
```

## Pessoal

## !favorite

Adiciona a música que está tocando aos seus favoritos. Os favoritos são pessoais e ficam salvos por servidor.

**Uso:** `!favorite [play|list]`

**Atalhos:** `fav`, `like`, `favorito`

* `!favorite` — salva a música atual nos seus favoritos (se já estava lá, ela avisa).
* `!favorite play` (ou `load`) — adiciona todos os seus favoritos à fila e começa a tocá-los se não havia nada tocando.
* `!favorite list` — mostra seus favoritos (até 20).

**Exemplos**

```text theme={"dark"}
!favorite
!fav play
!fav list
```

## !playlist

Gerencia as playlists salvas do servidor: salve a fila atual com um nome e recupere-a quando quiser.

**Uso:** `!playlist <list|save|load|delete> [nome]`

**Atalhos:** `pl`

* `!playlist list` (ou `lista`) — mostra as playlists do servidor com o número de faixas de cada uma. É a ação padrão se você não indicar nada.
* `!playlist save <nome>` (ou `guardar`) — salva a música atual e toda a fila com esse nome (máximo de 80 caracteres).
* `!playlist load <nome>` (ou `cargar`) — adiciona todas as faixas da playlist à fila e começa a tocar se não havia nada tocando.
* `!playlist delete <nome>` (ou `borrar`, `del`) — apaga a playlist.

**Exemplos**

```text theme={"dark"}
!playlist list
!playlist save favoritas
!playlist load favoritas
!playlist delete favoritas
```

<Tip>
  Montou uma boa sessão? `!playlist save <nome>` salva a fila inteira do jeito que está, incluindo a música que está tocando.
</Tip>

## DJ

## !dj

Ativa ou desativa o **DJ com IA**: a Lucie apresenta com voz cada música antes de tocá-la. Vale para as músicas que você colocar depois de ativar. Precisa que já haja música tocando.

**Uso:** `!dj`

**Atalhos:** `djmode`, `djia`

**Exemplos**

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

## !crossfade

Ativa ou desativa o <Tooltip tip="Transição entre músicas: o fim de uma se mistura com o começo da seguinte.">crossfade</Tooltip>: uma transição suave entre uma música e outra. Sem argumento, alterna o estado. A mudança vale para a música que você colocar a partir daquele momento.

**Uso:** `!crossfade [on|off]`

**Atalhos:** `xfade`, `fundido`

**Exemplos**

```text theme={"dark"}
!crossfade on
!crossfade off
```

<Warning>
  Se você notar cortes ou algo estranho com o crossfade ativado, desative-o com `!crossfade off` e a reprodução voltará ao modo normal.
</Warning>

***

Dúvidas ou problemas com a música? Passe no [servidor de suporte](https://discord.gg/VqyAZJ2mFc) ou gerencie a Lucie pelo [painel web](https://lucie.elxy.dev).