> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dkscripts.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeiros Passos

> Instale o dk_dances, confira a autenticação e toque a sua primeira dança em poucos minutos

Este guia leva o **dk\_dances** do download até a primeira dança tocando no servidor. Ele vale para quem **adquiriu o script**; se ainda não, acesse a [loja](https://shop.dkscripts.com.br).

> [!WARNING]
>
> **Instale e teste em um servidor de desenvolvimento antes de subir para produção.** A configuração, o uso e o ambiente onde o script roda são de responsabilidade do servidor. A DK Development **não se responsabiliza** por problemas decorrentes de instalação feita direto em produção: confira os [termos de serviço](https://docs.dkscripts.com.br/terms-of-service.md).

## 1. Baixando os arquivos

**1. Acesse o painel do cliente**

Entre no [painel do cliente](https://panel.dkscripts.com.br) com a conta usada na compra.

**2. Vá até a aba Downloads**

Acesse a aba **Downloads** e localize **Danças**.

**3. Baixe os arquivos**

Faça o download do script.

O script requer o **dk\_snippets**: [baixe no GitHub](https://github.com/potter7k/dk_snippets/releases/latest).

## 2. Instalar no servidor

**1. Crie a pasta \[dk]**

Dentro de `resources`, para manter os scripts da DK organizados.

**2. Extraia os arquivos**

Extraia `dk_dances` e `dk_snippets` dentro de **\[dk]**. Mantenha o `license.lua` que veio com o produto: sem ele o script não autentica.

```
resources/
└── [dk]/
    ├── dk_dances/
    └── dk_snippets/
```

**3. Inicie no server.cfg**

```cfg theme={null}
ensure [dk]
```

O `dk_snippets` é dependência do manifesto e inicia antes do `dk_dances`. Para iniciar um a um, mantenha `ensure dk_snippets` antes de `ensure dk_dances`. Não há SQL para importar.

**4. Reinicie o servidor**

Depois de reiniciar, siga para a verificação.

## 3. Verificando a instalação

Ao iniciar o servidor, o console verifica a licença e confirma a autenticação:

```
dk_dances » verifying license... (attempt 1/3)
 DK DEVELOPMENT » dk_dances authenticated » v1.0.0 | LIFETIME (discord.gg/NJjUn8Ad3P)
```

No lugar de `LIFETIME`, uma licença com prazo mostra os dias restantes (`30 days left`). Cada jogador também recebe a confirmação no console **F8** ao entrar:

```
 DK DEVELOPMENT » dk_dances authenticated
```

A licença é exigida até para as danças que ficam na `stream/` do seu servidor. Se a mensagem não aparecer, confira se o IP do servidor está autorizado na sua licença e se o `license.lua` está no lugar: a lista completa de mensagens está em [Erros e Soluções](https://docs.dkscripts.com.br/scripts/dances/errors.md).

Se o catálogo tiver alguma entrada inválida, o console lista cada uma com o motivo logo depois da inicialização. Essas entradas ficam de fora do menu, e as demais seguem normalmente.

## 4. Tocando a primeira dança

[Primeira dança com o dk\_dances](https://www.youtube.com/embed/AB5ntNNaLXo)

**1. Entre no servidor**

Nenhuma configuração é necessária: o pacote do GTA já vem ligado e sem download.

**2. Abra o menu**

Pressione <kbd>F5</kbd> ou digite no chat:

```
/dancas
```

**3. Escolha uma dança**

Use a busca (<kbd>/</kbd> foca o campo) ou o filtro **Origem**, selecione uma dança e dê um **duplo clique** ou aperte <kbd>Enter</kbd>.

**4. Pare**

Pressione <kbd>X</kbd> ou digite:

```
/parardanca
```

Para tocar sem abrir o menu, use o id da dança: `/danca <id>`. As danças do pacote do GTA têm ids como `gta-shuffle-high-left-up`.

### Testando uma exclusiva

O catálogo de exemplo traz uma dança exclusiva, a **Passinho I LOVE U FUNK** (`passinho_i_love_u_funk`). Toque-a com:

```
/danca passinho_i_love_u_funk
```

Na primeira vez o arquivo é baixado dos servidores da DK. Se a dança não tocar, veja [Erros e Soluções](https://docs.dkscripts.com.br/scripts/dances/errors.md).

## 5. Cadastrando as suas danças

As danças do GTA já estão prontas. As **suas** entram de duas formas:

> **[No catálogo](https://docs.dkscripts.com.br/scripts/dances/configs/catalog.md)**
>
> Para danças que você cadastra à mão em `config/shared/config.lua`, com `.ycd` baixado da DK ou na sua `stream/`.

> **[Injetando](https://docs.dkscripts.com.br/scripts/dances/dev/inject.md)**
>
> Para as animações que o seu servidor já tem em outro menu ou recurso, sem reescrever a lista.

Para dar uma imagem a cada dança, solte o arquivo em `web/public/previews/` com o **id** da dança como nome (`meu-samba.webp`) e rode `restart dk_dances`. Veja [Miniaturas](https://docs.dkscripts.com.br/scripts/dances/configs/catalog.md#miniaturas).

## 6. Ajustes recomendados

Antes de abrir para os jogadores, vale revisar:

> **[Quem pode dançar o quê](https://docs.dkscripts.com.br/scripts/dances/dev/hooks.md#server)**
>
> O `onBeforePlay` do servidor libera danças só para VIPs, por categoria ou por situação.

> **[Categorias do GTA](https://docs.dkscripts.com.br/scripts/dances/configs/gta-pack.md#esconder-categorias)**
>
> Esconda pole dance, lap dance ou o que não combina com o seu servidor.

> **[Cooldowns](https://docs.dkscripts.com.br/scripts/dances/configs/sv-config.md#cooldowns)**
>
> O tempo mínimo entre duas danças do mesmo jogador.

> **[Logs no Discord](https://docs.dkscripts.com.br/scripts/dances/configs/sv-config.md#logs-e-webhook)**
>
> Webhook para acompanhar acessos ao serviço, compartilhamentos e injeções.

> [!NOTE]
>
> Mudanças nos arquivos de `config/` só valem **depois de reiniciar o recurso**. As cores da interface (`theme.css`) e as miniaturas também pedem um `restart dk_dances`.

## Problemas comuns

> **O recurso não inicia e acusa falta de dk\_snippets**
>
> O `dk_snippets` é dependência do manifesto. Confirme que ele está instalado com **exatamente esse nome**.

> **A mensagem de autenticação não aparece**
>
> Verifique se o IP do servidor está autorizado na sua licença e se o `license.lua` continua na raiz do recurso. Para trocar o IP, use o comando na sala **💻・comandos** do Discord. O console diz o motivo (`NOT authenticated » ...`): veja a lista completa em [Erros e Soluções](https://docs.dkscripts.com.br/scripts/dances/errors.md).

> **Uma faixa avisa que as danças exclusivas estão indisponíveis**
>
> O serviço de animações ainda está conectando ou fora do ar. O menu abre normalmente e as danças do GTA e as da `stream/` continuam funcionando. Use o botão **Tentar de novo** da faixa.

> **A dança que eu cadastrei não aparece**
>
> Olhe o console do servidor logo depois de iniciar o recurso: cada entrada recusada vem com o motivo (id repetido, categoria inexistente, `dict` sem `clip`).

> **[Precisa de ajuda?](https://dkscripts.com.br/discord)**
>
> Abra um ticket no nosso Discord para suporte técnico.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.