Skip to main content

​
🚀 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.
Estas instruções são apenas para quem adquiriu o script. Caso ainda não tenha adquirido, acesse nosso Discord para mais informações.

​
1. Baixando os Arquivos

Acesse o Discord

Entre no nosso servidor do Discord através do link de convite.

Encontre o canal do script

Após a compra, você terá acesso ao canal races. Localize-o na lista de canais.

Baixe os arquivos

Abra o tópico 📁 Arquivos e faça o download do script.
Caminho no Discord: races → 📁 Arquivos
Este script requer a instalação das seguintes dependências:

​
2. Instalação no Servidor

​
2.1 Organize os Arquivos

1

Crie a pasta de organização

Crie uma pasta chamada [dk] na pasta resources do seu servidor para manter os scripts organizados.
2

Extraia os arquivos

Extraia os arquivos baixados na pasta [dk]:
  • dk_races
  • dk_snippets
  • dk_coords
resources/
└── [dk]/
    ├── dk_races/
    ├── dk_snippets/
    └── dk_coords/

​
2.2 Configure o server.cfg

Adicione o seguinte comando no seu arquivo server.cfg: 
start [dk]
Use start [dk] em vez de ensure [dk] para evitar conflitos de ordem de inicialização.

​
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

1

Entre no servidor

Conecte-se ao seu servidor FiveM.
2

Execute o comando de admin

Digite no chat:
/rcadmin
3

Verifique o painel

O painel administrativo deve abrir, permitindo criar e gerenciar corridas.
Se o comando não funcionar, verifique se você tem a permissão de ADMIN configurada no seu framework.

​
4. Configuração Inicial

​
4.1 Criando sua Primeira Corrida

Abra o painel admin

Use o comando /rcadmin para abrir o painel administrativo.

Crie uma nova corrida

Vá em GERENCIAMENTO -> Gerenciar Corridas e clique em Adicionar.

Configure os detalhes

Defina as configurações solicitadas, e marque a opção Ativada.
Para poder ativar uma corrida, é necessário definir pelo menos 1 ponto de fila.

Salve a corrida

Clique em Salvar para ativar a corrida.

Abra o painel da corrida

Aproxime-se do blip da corrida no mapa e pressione E para abrir o painel.

Crie uma rota

  • Vá em GERENCIAMENTO -> Criação de Rotas e clique em Adicionar.
  • Siga as instruções na tela para definir os checkpoints da rota.

Aprove a rota

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.

​
4.2 Testando a Corrida

1

Vá até o blip da corrida

No mapa, localize o blip da corrida que você criou.
2

Entre em um veículo

A corrida só pode ser acessada estando dentro de um veículo.
3

Abra o painel

Aproxime-se do blip e pressione E para abrir o painel da corrida.
4

Entre na fila

Clique em Entrar para entrar na fila de espera.

​
5. Estrutura de Permissões

O script possui um sistema de permissões configurável em config/shared/config.lua: 
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
}
  • USER: Qualquer jogador pode acessar
  • ADMIN: Apenas administradores do framework

​
6. Próximos Passos

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

Configurações Client

Personalize checkpoints, câmera, sons e visual.

Configurações Server

Configure recompensas, webhooks e integrações.

Configurações Compartilhadas

Itens coletáveis, permissões e estatísticas.

Handlers & Funções

Customize os eventos e comportamentos do script.

​
❓ Problemas Comuns

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

Precisa de ajuda?

Abra um ticket no nosso Discord para suporte técnico.