> ## 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.
# Apresentação
> Sistema completo de corridas para FiveM com rotas personalizáveis, itens coletáveis e ranking
# 🏁 DK RACES - Sistema de Corridas
Transforme seu servidor FiveM em um verdadeiro circuito de adrenalina! O **dk\_races** é um sistema de corridas completo e altamente personalizável, desenvolvido para proporcionar a melhor experiência de competição para seus jogadores.
***
## 🎬 Demonstração
***
## ✨ Recursos Principais
Crie corridas ilimitadas com rotas personalizadas, checkpoints visuais, contagem regressiva cinematográfica e muito mais.
Sistema de power-ups durante a corrida: **Nitro**, **Reparo**, **Escudo**, **Fantasma** e **Impulso de Velocidade**.
Sistema completo de ranking por rota, estatísticas detalhadas e histórico de corridas.
Corridas ilegais alertam automaticamente os policiais online com a localização em tempo real.
***
## 🎮 Funcionalidades Detalhadas
* **Múltiplas corridas simultâneas** ou modo de corrida única
* **Fila de espera** com posições configuráveis
* **Contagem regressiva** com animação cinematográfica de câmera
* **Checkpoints visuais** com partículas, blips e props personalizáveis
* **Modo Preview** para visualizar rotas antes de competir
* **Cooldown configurável** entre participações
* **Requisitos de entrada**: itens, veículos específicos, permissões
Sistema inspirado em jogos de corrida clássicos:
| Item | Raridade | Efeito |
| ---------------------------------------------- | -------- | --------------------------------- |
| **Nitro** | Comum | Boost de velocidade temporário |
| **Impulso de Velocidade** | Raro | Aumenta velocidade máxima |
| **Fantasma** | Épico | Atravessa outros veículos |
| **Escudo** | Lendário | Proteção contra colisões |
| **Reparo** | Mítico | Repara o veículo instantaneamente |
Os itens são sorteados ao passar pelos checkpoints, com algoritmo configurável (aleatório ou por peso).
* **Ranking por rota** com melhores tempos
* **Sistema de nicknames** para identificação
* **Estatísticas do servidor** nos últimos X dias (configurável)
* **Histórico completo** de corridas realizadas
* **Alertas automáticos** para policiais quando corridas ilegais iniciam
* **Rastreamento em tempo real** da posição dos corredores
* **Blips no mapa** para perseguição policial
* **Compatível com múltiplos frameworks**
* **Checkpoints personalizáveis**: modelo, cor, escala, partículas
* **Props nos checkpoints**: pneus, cones, barreiras
* **Sons configuráveis**: checkpoint, vitória, contagem regressiva
* **Câmera cinematográfica** no início da corrida
* **Modo fantasma - opcional** (sem colisões entre jogadores)
Notificações automáticas no Discord:
* Início de corridas
* Finalização com resultados
* Dados completos dos participantes
***
## 🛠️ Compatibilidade
O script é **STANDALONE** mas possui integração nativa com:
* **ESX** (todas as versões)
* **QBCore**
* **vRP** (todas as versões)
* **Qualquer outro framework** (via funções personalizáveis)
* Sistema NoSQL integrado (sem dependências externas)
* Caminho configurável para o banco de dados
* **dk\_snippets** (obrigatório) - [Download](https://github.com/potter7k/dk_snippets)
* **dk\_coords** (obrigatório) - [Download](https://github.com/potter7k/dk_coords)
* FiveM Server atualizado
***
## 📋 Estrutura do Script
```
dk_races/
├── config/
│ ├── client/
│ │ ├── config.lua # Configurações do cliente
│ │ ├── main.lua # Lógica principal do cliente
│ │ ├── collectable_items.lua
│ │ └── functions/
│ │ ├── blips.lua # Gerenciamento de blips
│ │ ├── camera.lua # Animações de câmera
│ │ ├── checkpoints.lua # Sistema de checkpoints
│ │ ├── ghost.lua # Modo fantasma
│ │ ├── handlers.lua # Event handlers
│ │ ├── particles.lua # Efeitos de partículas
│ │ ├── props.lua # Props dos checkpoints
│ │ ├── queue.lua # Sistema de fila
│ │ ├── ranking.lua # Sistema de ranking
│ │ ├── sounds.lua # Sistema de sons
│ │ ├── ui.lua # Interface do usuário
│ │ └── validators.lua # Validações
│ ├── server/
│ │ ├── config.lua # Configurações do servidor
│ │ ├── main.lua # Lógica principal do servidor
│ │ ├── collectable_items.lua
│ │ └── functions/
│ │ ├── framework.lua # Integração com frameworks
│ │ ├── handlers.lua # Event handlers
│ │ ├── items.lua # Sistema de itens
│ │ ├── permissions.lua # Sistema de permissões
│ │ ├── police.lua # Integração com polícia
│ │ ├── rewards.lua # Sistema de recompensas
│ │ ├── validators.lua # Validações
│ │ ├── vehicles.lua # Validação de veículos
│ │ └── webhooks.lua # Integração Discord
│ └── shared/
│ ├── config.lua # Configurações compartilhadas
│ ├── utils.lua # Utilitários
│ └── locale/ # Traduções
│ ├── en.lua
│ └── ptbr.lua
├── web/ # Interface NUI
├── src/ # Arquivos fonte (ofuscados)
└── nosql/ # Banco de dados NoSQL (mantenha o backup)
```
***
## 🔒 Segurança
O script é **ofuscado e protegido por licença**. Cada licença dá acesso a **1 endereço de IP**, que pode ser alterado quando desejado.
* Proteção contra exploits
* Validações server-side
* Sistema de permissões robusto
***
## 💰 Adquira Agora
Acesse nosso Discord e adquira o script com suporte completo e atualizações gratuitas!
A instalação é oferecida **gratuitamente** para todos os compradores. Confira os [termos e condições](/terms-of-service).