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

# Primeiros Passos com o Script **Animações em Dupla - Extended**

Bem-vindo(a)! Este guia vai te ajudar a baixar, instalar e configurar o script **dk\_animations\_ext** no seu servidor FiveM, incluindo os testes básicos para garantir que tudo está funcionando corretamente.

<Warning>
  Estas instruções são apenas para quem adquiriu o script. Caso ainda não tenha adquirido, acesse nosso **Discord** para mais informações.
</Warning>

***

## 1. Baixando os Arquivos

O primeiro passo é garantir que você tem todos os arquivos necessários.

<Steps>
  <Step title="Passo 1">
    Acesse o nosso **Discord**.
  </Step>

  <Step title="Passo 2">
    Vá até o canal **animations** (acesso liberado após a compra).
  </Step>

  <Step title="Passo 3">
    Abra o tópico **📁 Arquivos** e faça o download dos seguinte script:

    * `dk_animations_ext`
  </Step>

  <Step title="Passo 4">
    Baixe também o script auxiliar `dk_snippets`, que é necessário para o funcionamento do Extended.
  </Step>
</Steps>

<Tip>
  **Caminho no Discord:**\
  <Icon icon="discord" iconType="solid" /> **animations** > **📁 Arquivos**
</Tip>

***

## 2. Adicionando ao Servidor

Agora que os arquivos estão com você, é hora de colocá-los na estrutura correta.

### Organização dos Arquivos:

1. Crie uma pasta chamada **\[dk]** no seu servidor, caso ainda não exista.
2. Mova os scripts para dentro da pasta `[dk]`:

```
Estrutura final dos arquivos:

[dk]/
├── dk_animations_ext
└── dk_snippets
```

### Configuração no server.cfg:

No seu `server.cfg`, adicione as seguintes linhas:

```plaintext theme={null}
start [dk]
```

<Warning>
  Ambos os scripts devem ser iniciados com `start` invés de `ensure`, ou o sistema não irá funcionar corretamente.
</Warning>

***

## 3. Testando o Script

Após iniciar o servidor, é essencial realizar os testes básicos para confirmar que o script está funcionando.

### Etapas de Teste:

<Steps>
  <Step title="Passo 1">
    Inicie seu servidor e entre com um personagem normalmente.
  </Step>

  <Step title="Passo 2">
    Verifique se a autenticação foi feita corretamente (mensagens no console e F8).
  </Step>

  <Step title="Passo 3">
    Pressione a tecla padrão `J` e veja se a interface de **atalhos de animações** aparece.\
    Se abrir, significa que o script foi carregado corretamente.
  </Step>

  <Step title="Passo 4">
    Digite o comando `/animadmin` no chat e verifique se a **aba administrativa** é exibida, permitindo cadastrar Peds por idade.
  </Step>
</Steps>

<Warning>
  Se a tecla `J` não abrir nada, certifique-se de que:

  * O `dk_snippets` está iniciado corretamente.
  * Nenhum outro script está usando a tecla `J`.
</Warning>

***

## 4. Explorando o Extended

Agora que está tudo funcionando, explore as funcionalidades exclusivas da versão **Extended**, como:

* Atalhos de animação por tecla e cliques rápidos;
* Interface intuitiva para busca e filtragem por tipo ou idade;
* Sistema de favoritos;
* Painel para administradores cadastrarem animações personalizadas.

Confira as próximas seções da documentação para aproveitar ao máximo o seu script.
