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

# Sorteios

> Crie sorteios com requisitos que a Lucie verifica ao vivo — voz, status personalizado, cargos e antiguidade — com participação por botões.

A Lucie organiza sorteios em que não basta apertar um botão: você pode exigir requisitos que ela **verifica ao vivo**, com contadores de *desde quando* eles são cumpridos. Tudo é gerenciado com `!sorteo`; digitá-lo sem argumentos mostra a ajuda do sistema.

**Atalhos:** `sorteos`, `giveaway`, `gw`

<Note>
  Criar e gerenciar sorteios (`crear`, `fin`, `reroll`, `cancelar`, `track`) exige ser dono do servidor ou ter **Administrador** ou **Gerenciar Servidor**. Consultar (`lista`, `info`, `req` sobre você mesmo) está aberto a todo mundo.
</Note>

## !sorteo crear

Publica um sorteio no canal atual (ou no que você indicar com `--canal`).

**Uso:** `!sorteo crear <duração> [vencedores] <prêmio> [opções]`

**Atalhos:** `create`

**Permissões:** Gerenciar Servidor

* **duração** — de **1 minuto a 60 dias**, no formato `s`/`m`/`h`/`d`/`w` (ex.: `30m`, `12h`, `2d`, `1w`).
* **vencedores** — número opcional de 1 a 20 logo depois da duração. Se você não colocar, há 1 vencedor.
* **prêmio** — texto livre.

<Tip>
  Se o prêmio começar com um número (ex.: "10€ na Steam"), sempre indique antes o número de vencedores, ou a Lucie interpretará esse número como a quantidade de vencedores.
</Tip>

### Requisitos

Adicione as opções que quiser ao final do comando. Quem não cumpri-las não poderá participar, e a Lucie dirá exatamente o que está faltando.

| Opção                    | Requisito                                                                                                                                                                                                                                                                      |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--voz [mín]`            | Estar conectado a um canal de voz do servidor (o canal AFK não conta). Com um mínimo (ex.: `--voz 1h`), exige estar conectado há esse tempo.                                                                                                                                   |
| `--estado <texto> [mín]` | Ter um texto no status personalizado (ex.: `--estado /lucie`). O texto vai sem espaços (máx. 60 caracteres), não diferencia maiúsculas e basta que apareça dentro do status. Aceita um tempo mínimo (ex.: `--estado /lucie 1d`). Máximo de 2 requisitos de status por sorteio. |
| `--rol @cargo`           | Ter o cargo indicado (menção ou ID).                                                                                                                                                                                                                                           |
| `--dias N`               | Estar no servidor há pelo menos N dias (1–3650).                                                                                                                                                                                                                               |
| `--cuenta N`             | Conta do Discord com pelo menos N dias de antiguidade (1–3650) — útil contra contas recém-criadas.                                                                                                                                                                             |

### Extras

| Opção               | Efeito                                                                                                                                                    |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--bonus @cargo x2` | Entradas extras para esse cargo (multiplicador de ×2 a ×10). Se alguém tiver vários cargos com bônus, aplica-se o multiplicador mais alto (não se somam). |
| `--veto @cargo`     | Os membros com esse cargo não podem participar.                                                                                                           |
| `--canal #canal`    | Publica o sorteio em outro canal de texto.                                                                                                                |
| `--sinrevalidar`    | Desativa a reverificação de requisitos ao escolher os vencedores (veja [como os vencedores são escolhidos](#como-os-vencedores-são-escolhidos)).          |

**Exemplos**

```text theme={"dark"}
!sorteo crear 2d Nitro 1 mes
!sorteo crear 12h 3 Tarjeta regalo
!sorteo crear 2d 1 Nitro 1 mes --voz --estado /lucie 1d --dias 7
!sorteo crear 1w Nitro --rol @Nivel10 --bonus @Booster x3 --veto @Sancionado --canal #sorteos
```

<Note>
  Pode haver até **10 sorteios ativos** ao mesmo tempo por servidor, e a Lucie precisa de **Enviar Mensagens** e **Inserir Links** no canal onde ele for publicado.
</Note>

<Warning>
  Em servidores muito grandes não há varredura inicial de status: o contador de `--estado` de cada membro começa a correr na próxima mudança de presença dele. Se você for exigir um tempo mínimo, ative antes o [pre-tracking](#sorteo-track).
</Warning>

## !sorteo lista

Mostra os sorteios ativos do servidor: ID, prêmio, participantes, quando terminam e link para a mensagem.

**Uso:** `!sorteo lista`

**Atalhos:** `list`, `activos`

## !sorteo info

Mostra os detalhes de um sorteio pelo ID: prêmio, requisitos, participantes e, se já terminou, seus vencedores (ou se foi cancelado). Os sorteios finalizados continuam consultáveis por 30 dias.

**Uso:** `!sorteo info <id>`

**Exemplos**

```text theme={"dark"}
!sorteo info 4
```

## !sorteo fin

Finaliza um sorteio agora mesmo e escolhe os vencedores, sem esperar a data prevista.

**Uso:** `!sorteo fin <id>`

**Atalhos:** `end`

**Permissões:** Gerenciar Servidor

## !sorteo reroll

Sorteia de novo um sorteio **já finalizado** entre quem participava e ainda cumpre os requisitos. Os vencedores anteriores ficam excluídos para sempre: um <Tooltip tip="Sortear de novo entre os participantes para escolher outro ganhador.">reroll</Tooltip> nunca pode repetir vencedor.

**Uso:** `!sorteo reroll <id>`

**Permissões:** Gerenciar Servidor

<Note>
  As participações são mantidas por **24 horas** depois que o sorteio termina. Passado esse prazo, não restam candidatos para o reroll.
</Note>

## !sorteo cancelar

Cancela um sorteio ativo sem vencedores. As participações são apagadas na hora, então um sorteio cancelado não admite reroll.

**Uso:** `!sorteo cancelar <id>`

**Atalhos:** `cancel`

**Permissões:** Gerenciar Servidor

## !sorteo req

Consulta quais requisitos um usuário cumpre e **desde quando**, sorteio por sorteio, além de se ele participa e com quantas entradas. Sem argumentos, consulta você nos sorteios ativos (até 3); com um ID, consulta esse sorteio específico.

**Uso:** `!sorteo req [@usuário] [id]`

**Atalhos:** `requisitos`, `estado`

**Permissões:** qualquer um pode consultar a si mesmo; consultar outras pessoas exige Gerenciar Servidor.

**Exemplos**

```text theme={"dark"}
!sorteo req
!sorteo req 4
!sorteo req @usuario
```

## !sorteo track

<Tooltip tip="Começar a contar o tempo em voz ou o status antes de o sorteio existir.">Pre-tracking</Tooltip> de textos de status: coloque um texto em acompanhamento **antes** de criar o sorteio e a Lucie começará a contar desde quando cada membro o tem no status. Imprescindível se você for exigir mínimos como `--estado /lucie 1d` — senão, o contador de todo mundo partiria do zero ao criar o sorteio.

**Uso:** `!sorteo track [texto]` · `!sorteo track off <texto>`

**Atalhos:** `seguimiento` (e `quitar` como alternativa a `off`)

**Permissões:** Gerenciar Servidor

* Sem argumentos, lista os textos em acompanhamento.
* `track <texto>` adiciona um (máximo de **5** por servidor).
* `track off <texto>` o remove.

**Exemplos**

```text theme={"dark"}
!sorteo track /lucie
!sorteo track
!sorteo track off /lucie
```

## Como participar

Cada sorteio é publicado com dois botões. Todas as respostas são privadas: só quem aperta as vê.

<Columns cols={2}>
  <Card title="Participar" icon="gift">
    Se você cumprir tudo, entra no sorteio (com suas entradas extras se tiver cargo com bônus). Se não, a Lucie responde em privado com a lista exata do que está faltando — por exemplo, "você está há 3 h em voz, precisa de 1 d". Corrija e aperte de novo. Se você já participava, apertar de novo atualiza suas entradas caso seus cargos tenham mudado.
  </Card>

  <Card title="Meu status" icon="ticket">
    Resumo privado da sua situação: cada requisito marcado como cumprido ou não, desde quando você o cumpre, e se está participando (com suas entradas e quando entrou).
  </Card>
</Columns>

Se você participa, na resposta privada aparece também um botão **Abandonar sorteio** para sair quando quiser. Há um pequeno intervalo anti-spam entre os cliques, e bots não podem participar.

## Como as sequências contam

<AccordionGroup>
  <Accordion title="Voz">
    Mover-se entre canais de voz mantém a sua sequência. Entrar no canal AFK conta como desconectar.
  </Accordion>

  <Accordion title="Status personalizado">
    Tirar o texto do status enquanto está online **quebra** a sequência e o contador volta a zero. Ficar offline no Discord só a **pausa** — dormir não penaliza você. A Lucie guarda apenas se você tem o texto e desde quando, nunca o conteúdo completo do seu status.
  </Accordion>
</AccordionGroup>

## Como os vencedores são escolhidos

* O sorteio é aleatório e **ponderado por entradas**: um cargo com bônus ×3 triplica as suas chances.
* Ao sortear, a Lucie **revalida** os candidatos: quem deixou de cumprir os requisitos (ou saiu do servidor) fica de fora, e as entradas de bônus são recalculadas com os cargos atuais. Desativa-se com `--sinrevalidar` na criação.
* Os vencedores são anunciados com menção no canal do sorteio e a mensagem original é atualizada como finalizada. Se ninguém participava (ou ninguém continuava cumprindo), o sorteio termina sem vencedor.

<Tip>
  Dúvidas ou algo não funciona como esperado? Passe no [servidor de suporte](https://discord.gg/VqyAZJ2mFc) ou gerencie seu servidor pelo [painel web](https://lucie.elxy.dev).
</Tip>