> ## 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 de Lucie: reproducción, cola, canal de voz, favoritos, playlists y modo DJ.

Lucie reproduce música en tu canal de voz a partir de búsquedas por texto o enlaces de **YouTube** y **SoundCloud**, incluidas playlists completas.

<Note>
  Los ejemplos usan el prefijo por defecto `!` (configurable con `!setprefix`). Lucie también responde a su mención y a los slash commands (`/comando`).
</Note>

<Note>
  Para controlar la reproducción (saltar, pausar, mover la <Tooltip tip="La lista de canciones en espera: suenan en orden cuando termina la actual.">cola</Tooltip>, etc.) debes estar **en el mismo canal de voz** que Lucie. Los comandos de solo lectura como `!queue` o `!nowplaying` no lo requieren.
</Note>

## Reproducción

## !play

Reproduce una canción o la añade a la cola. Acepta el nombre de la canción o un enlace directo.

**Uso:** `!play <nombre o enlace>`

**Alias:** `p`

* Si no hay nada sonando, la canción empieza de inmediato.
* Si ya hay música, se añade a la cola y Lucie te muestra su posición y el tiempo estimado hasta que suene.
* Con un enlace de playlist se añaden todas sus canciones de golpe, con el total de temas y la duración conjunta.

**Ejemplos**

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

## !pause

Pausa la reproducción actual.

**Uso:** `!pause`

**Alias:** `pausa`

**Ejemplos**

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

## !resume

Reanuda la reproducción pausada.

**Uso:** `!resume`

**Alias:** `continuar`, `unpause`

**Ejemplos**

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

## !stop

Detiene la música y vacía la cola. Lucie permanece en el canal de voz.

**Uso:** `!stop`

**Alias:** `parar`

**Ejemplos**

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

## !skip

Salta a la siguiente canción de la cola. Si no queda nada más, detiene la reproducción.

**Uso:** `!skip`

**Alias:** `s`, `next`, `saltar`

**Ejemplos**

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

## !seek

Salta a un punto concreto de la canción actual. Acepta segundos o el formato `m:ss`. Si el punto supera la duración de la canción, Lucie te avisa.

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

**Alias:** `ir`

**Ejemplos**

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

## !nowplaying

Muestra la canción que suena ahora: artista, barra de progreso, tiempo transcurrido y total, estado (reproduciendo o pausado), volumen y modo de repetición.

**Uso:** `!nowplaying`

**Alias:** `np`, `sonando`

**Ejemplos**

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

## !lyrics

Busca la letra de la canción que está sonando. También puedes pedir una letra concreta con el formato `artista - título`. Las letras muy largas se recortan.

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

**Alias:** `letra`

**Ejemplos**

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

<Tip>
  Si Lucie no encuentra la letra de la canción actual (los títulos de vídeo a veces llevan texto extra), prueba con `!lyrics artista - título` escrito a mano.
</Tip>

## Cola

## !queue

Muestra la cola de reproducción: la canción actual y las 10 siguientes (si hay más, se indica cuántas quedan), junto con el total en cola, el volumen y el modo de repetición.

**Uso:** `!queue`

**Alias:** `q`, `cola`

**Ejemplos**

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

## !remove

Quita una canción de la cola por su número. Consulta los números con `!queue`.

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

**Alias:** `rm`, `quitar`

**Ejemplos**

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

## !clear

Vacía la cola sin detener la canción que está sonando.

**Uso:** `!clear`

**Alias:** `cls`, `limpiar`

**Ejemplos**

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

## !move

Mueve una canción de la cola de una posición a otra.

**Uso:** `!move <desde> <hasta>`

**Alias:** `mover`, `mv`

**Ejemplos**

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

## !shuffle

Mezcla aleatoriamente las canciones de la cola.

**Uso:** `!shuffle`

**Alias:** `mix`, `mezclar`

**Ejemplos**

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

## !loop

Cambia el modo de repetición:

* `off` — sin repetición.
* `track` — repite la canción actual (también acepta `song`, `cancion`, `one`).
* `queue` — repite toda la cola (también acepta `cola`, `all`).

Sin argumento, alterna al siguiente modo en el ciclo `off → track → queue → off`.

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

**Alias:** `repeat`, `l`

**Ejemplos**

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

## !autoplay

Activa o desactiva el <Tooltip tip="Cuando la cola se queda vacía, Lucie sigue sola con canciones parecidas.">autoplay</Tooltip>: al acabar la cola, Lucie sigue poniendo temas similares por su cuenta. Necesita que ya haya un reproductor activo (pon algo con `!play` primero).

**Uso:** `!autoplay`

**Alias:** `radio`

**Ejemplos**

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

## Canal de voz

## !join

Hace que Lucie entre a tu canal de voz.

**Uso:** `!join`

**Alias:** `summon`, `venir`

**Ejemplos**

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

## !leave

Desconecta a Lucie del canal de voz.

**Uso:** `!leave`

**Alias:** `dc`, `disconnect`, `salir`

**Ejemplos**

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

## !volume

Ajusta el volumen entre 0 y 150 (los valores fuera de rango se ajustan al límite). Sin argumento, muestra el volumen actual.

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

**Alias:** `vol`, `v`

**Ejemplos**

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

## Personal

## !favorite

Añade la canción que está sonando a tus favoritos. Los favoritos son personales y se guardan por servidor.

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

**Alias:** `fav`, `like`, `favorito`

* `!favorite` — guarda la canción actual en tus favoritos (si ya estaba, te lo dice).
* `!favorite play` (o `load`) — añade todos tus favoritos a la cola y empieza a reproducirlos si no había nada sonando.
* `!favorite list` — muestra tus favoritos (hasta 20).

**Ejemplos**

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

## !playlist

Gestiona las playlists guardadas del servidor: guarda la cola actual con un nombre y recupérala cuando quieras.

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

**Alias:** `pl`

* `!playlist list` (o `lista`) — muestra las playlists del servidor con su número de temas. Es la acción por defecto si no indicas nada.
* `!playlist save <nombre>` (o `guardar`) — guarda la canción actual y toda la cola con ese nombre (máximo 80 caracteres).
* `!playlist load <nombre>` (o `cargar`) — añade todos los temas de la playlist a la cola y empieza a reproducir si no había nada sonando.
* `!playlist delete <nombre>` (o `borrar`, `del`) — borra la playlist.

**Ejemplos**

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

<Tip>
  ¿Montaste una buena sesión? `!playlist save <nombre>` guarda la cola entera tal cual está, con la canción que suena incluida.
</Tip>

## DJ

## !dj

Activa o desactiva el **DJ con IA**: Lucie presenta con voz cada canción antes de reproducirla. Aplica a las canciones que pongas después de activarlo. Necesita que ya haya música sonando.

**Uso:** `!dj`

**Alias:** `djmode`, `djia`

**Ejemplos**

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

## !crossfade

Activa o desactiva el <Tooltip tip="Fundido entre canciones: el final de una se mezcla con el principio de la siguiente.">crossfade</Tooltip>: un fundido suave entre canción y canción. Sin argumento, alterna el estado. El cambio aplica a la música que pongas a partir de ese momento.

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

**Alias:** `xfade`, `fundido`

**Ejemplos**

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

<Warning>
  Si notas cortes o algo raro con el crossfade activado, desactívalo con `!crossfade off` y la reproducción volverá al modo normal.
</Warning>

***

¿Dudas o problemas con la música? Pásate por el [servidor de soporte](https://discord.gg/VqyAZJ2mFc) o gestiona a Lucie desde el [panel web](https://lucie.elxy.dev).