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

> Guia completo de instalação e configuração inicial do dk_races

# 🚀 Primeiros Passos com o DK Races

Bem-vindo! Este guia vai te ajudar a baixar, instalar e configurar o script **dk\_races** no seu servidor FiveM.

<Warning>
  Estas instruções são apenas para quem **adquiriu o script**. Caso ainda não tenha adquirido, acesse nosso [Discord](https://discord.gg/NJjUn8Ad3P) para mais informações.
</Warning>

***

## 1. Baixando os Arquivos

<Steps>
  <Step title="Acesse o Discord" icon="discord">
    Entre no nosso servidor do Discord através do [link de convite](https://discord.gg/NJjUn8Ad3P).
  </Step>

  <Step title="Encontre o canal do script" icon="folder">
    Após a compra, você terá acesso ao canal **races**. Localize-o na lista de canais.
  </Step>

  <Step title="Baixe os arquivos" icon="download">
    Abra o tópico **📁 Arquivos** e faça o download do script.
  </Step>
</Steps>

<Tip>
  **Caminho no Discord:** <Icon icon="discord" /> **races** → **📁 Arquivos**
</Tip>

<Note>
  Este script requer a instalação das seguintes dependências:

  * **dk\_snippets**: [Baixar no GitHub](https://github.com/potter7k/dk_snippets/releases/latest)
  * **dk\_coords**: [Baixar no GitHub](https://github.com/potter7k/dk_coords/releases/latest)
</Note>

***

## 2. Instalação no Servidor

### 2.1 Organize os Arquivos

<Steps>
  <Step title="Crie a pasta de organização">
    Crie uma pasta chamada **\[dk]** na pasta `resources` do seu servidor para manter os scripts organizados.
  </Step>

  <Step title="Extraia os arquivos">
    Extraia os arquivos baixados na pasta **\[dk]**:

    * `dk_races`
    * `dk_snippets`
    * `dk_coords`
  </Step>
</Steps>

```
resources/
└── [dk]/
    ├── dk_races/
    ├── dk_snippets/
    └── dk_coords/
```

### 2.2 Configure o server.cfg

Adicione o seguinte comando no seu arquivo `server.cfg`:

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

<Warning>
  Use **start \[dk]** em vez de **ensure \[dk]** para evitar conflitos de ordem de inicialização.
</Warning>

***

## 3. Verificando a Instalação

### 3.1 Autenticação

Ao iniciar o servidor, você deve ver no console uma confirmação de autenticação, exemplo:

```
[dk_races] ✓ Script autenticado com sucesso!
```

Ao entrar no jogo, a mesma mensagem deve aparecer no console **F8**.

### 3.2 Teste Inicial

<Steps>
  <Step title="Entre no servidor">
    Conecte-se ao seu servidor FiveM.
  </Step>

  <Step title="Execute o comando de admin">
    Digite no chat:

    ```
    /rcadmin
    ```
  </Step>

  <Step title="Verifique o painel">
    O painel administrativo deve abrir, permitindo criar e gerenciar corridas.
  </Step>
</Steps>

<Tip>
  Se o comando não funcionar, verifique se você tem a permissão de **ADMIN** configurada no seu framework.
</Tip>

***

## 4. Configuração Inicial

### 4.1 Criando sua Primeira Corrida

<Steps>
  <Step title="Abra o painel admin" icon="terminal">
    Use o comando `/rcadmin` para abrir o painel administrativo.
  </Step>

  <Step title="Crie uma nova corrida" icon="plus">
    Vá em **GERENCIAMENTO** -> **Gerenciar Corridas** e clique em **Adicionar**.
  </Step>

  <Step title="Configure os detalhes" icon="gear">
    Defina as configurações solicitadas, e marque a opção **Ativada**.

    <Tip>
      Para poder ativar uma corrida, é necessário definir pelo menos **1 ponto de fila**.
    </Tip>
  </Step>

  <Step title="Salve a corrida" icon="floppy-disk">
    Clique em **Salvar** para ativar a corrida.
  </Step>

  <Step title="Abra o painel da corrida" icon="map">
    Aproxime-se do blip da corrida no mapa e pressione **E** para abrir o painel.
  </Step>

  <Step title="Crie uma rota" icon="route">
    * Vá em **GERENCIAMENTO** -> **Criação de Rotas** e clique em **Adicionar**.
    * Siga as instruções na tela para definir os checkpoints da rota.
  </Step>

  <Step title="Aprove a rota" icon="check">
    As rotas criadas por players, são recebidas pela administração para aprovação.

    * Vá em **GERENCIAMENTO** -> **Gerenciamento de Rotas**, selecione a corrida e aprove.
    * Configure a rota, se necessário, em seguida salve-a.
  </Step>
</Steps>

### 4.2 Testando a Corrida

<Steps>
  <Step title="Vá até o blip da corrida">
    No mapa, localize o blip da corrida que você criou.
  </Step>

  <Step title="Entre em um veículo">
    A corrida só pode ser acessada estando dentro de um veículo.
  </Step>

  <Step title="Abra o painel">
    Aproxime-se do blip e pressione **E** para abrir o painel da corrida.
  </Step>

  <Step title="Entre na fila">
    Clique em **Entrar** para entrar na fila de espera.
  </Step>
</Steps>

***

## 5. Estrutura de Permissões

O script possui um sistema de permissões configurável em `config/shared/config.lua`:

```lua theme={null}
Config.Permissions = {
    ["race_management"] = "ADMIN",    -- Gerenciamento de corridas
    ["routes_creation"] = "USER",     -- Criação de rotas
    ["routes_statistics"] = "ADMIN",  -- Estatísticas de rotas
    ["routes_management"] = "ADMIN",  -- Gerenciamento de rotas
    ["race_rankings"] = "USER",       -- Acesso ao ranking
    ["race_main"] = "USER",           -- Menu principal
    ["race_race"] = "USER",           -- Participar de corridas
    ["settings"] = "USER",            -- Configurações
}
```

<Info>
  * **USER**: Qualquer jogador pode acessar
  * **ADMIN**: Apenas administradores do framework
</Info>

***

## 6. Próximos Passos

Agora que o script está instalado, explore as configurações avançadas:

<CardGroup cols={2}>
  <Card title="Configurações Client" icon="display" href="./configs/client-config">
    Personalize checkpoints, câmera, sons e visual.
  </Card>

  <Card title="Configurações Server" icon="server" href="./configs/server-config">
    Configure recompensas, webhooks e integrações.
  </Card>

  <Card title="Configurações Compartilhadas" icon="share-nodes" href="./configs/shared-config">
    Itens coletáveis, permissões e estatísticas.
  </Card>

  <Card title="Handlers & Funções" icon="code" href="./configs/handlers">
    Customize os eventos e comportamentos do script.
  </Card>
</CardGroup>

***

## ❓ Problemas Comuns

<AccordionGroup>
  <Accordion title="Script não autentica">
    1. Verifique se o IP do servidor está cadastrado na licença
    2. Acesse a sala **💻・comandos** no Discord para alterar o IP
    3. Reinicie o servidor após a alteração
  </Accordion>

  <Accordion title="Comando /rcadmin não funciona">
    1. Verifique se você tem permissão de **ADMIN** no framework
    2. Confira a configuração `Config.Permissions["race_management"]`
    3. Verifique os logs do servidor para erros
  </Accordion>

  <Accordion title="Blips não aparecem no mapa">
    1. Certifique-se de que a corrida está **ativa**
    2. Verifique se o blip de início foi configurado
    3. Reinicie o script com `refresh` e `start dk_races`
  </Accordion>
</AccordionGroup>

<Card title="Precisa de ajuda?" icon="life-ring" href="https://discord.gg/NJjUn8Ad3P">
  Abra um ticket no nosso Discord para suporte técnico.
</Card>