Skip to main content

​
🔧 Erros e Soluções

Encontrou um problema? Esta página contém as soluções para os erros mais comuns do dk_races.

​
🔐 Problemas de Autenticação

Erro: Script não autenticado

​
Problema

O console exibe mensagem de que o script não foi autenticado, ou aparece erro no F8.

​
Causas Possíveis

  • IP do servidor não cadastrado na licença
  • Licença expirada ou inválida
  • Problemas de conexão com o servidor de autenticação

​
Soluções

1

Verifique o IP

Confirme se o IP atual do seu servidor está cadastrado na licença.
2

Altere o IP

Acesse a sala 💻・comandos no Discord e use o comando para alterar o IP.
3

Reinicie o servidor

Após alterar o IP, reinicie completamente o servidor FiveM.
4

Abra um ticket

Se o problema persistir, abra um ticket no Discord com os logs do console.

​
🎮 Problemas de Gameplay

​
Problema

Mensagem aparece ao tentar acessar o painel da corrida.

​
Solução

  • Entre em um veículo antes de se aproximar do ponto de corrida
  • Certifique-se de estar no banco do motorista
  • Veículos de passageiro não são aceitos

​
Problema

O veículo atual não é aceito na corrida selecionada.

​
Solução

Verifique quais classes de veículos são permitidas na corrida:
ClasseTipos de Veículos
carsCompactos, Sedans, SUVs, Coupes, Muscle, Sports, Super
trucksCaminhões, Utilitários
motorcyclesMotos, Quadriciclos
bicyclesBicicletas
boatsBarcos
helicoptersHelicópteros
planesAviões
O administrador pode configurar as classes permitidas ao criar a corrida.

​
Problema

A corrida exige um item específico para participar.

​
Solução

  • Verifique qual item é necessário no painel da corrida
  • Obtenha o item através do sistema do seu servidor
  • Certifique-se de ter a quantidade necessária
Itens comuns: credential, raceticket, ticket

​
Problema

Não há mais vagas na fila de espera da corrida.

​
Solução

  • Aguarde a corrida atual terminar
  • Tente novamente quando houver vagas
  • O administrador pode aumentar o limite de pontos na fila

​
Problema

O servidor está configurado para permitir apenas uma corrida por vez.

​
Solução

  • Aguarde a corrida atual terminar
  • Esta é uma configuração do servidor (Config.singleRace = true)

​
Problema

Não havia corredores suficientes quando a corrida deveria iniciar.

​
Solução

  • Certifique-se de ter o mínimo de corredores exigido
  • Verifique a configuração min_runners da corrida
  • Convide mais jogadores para participar

​
🛠️ Problemas de Configuração

​
Problema

Os blips das corridas não estão visíveis no mapa do jogo.

​
Soluções

  1. Verifique se a corrida está ativada (active = true)
  2. Confirme que o startBlip foi configurado corretamente
  3. Reinicie o script:
refresh
start dk_races
  1. Verifique se há erros no console F8

​
Problema

Durante a corrida, os checkpoints não são exibidos.

​
Soluções

  1. Verifique a configuração em Config.checkpointsParams
  2. Confirme que a rota tem checkpoints definidos
  3. Verifique se o checkpoint.model é um modelo válido
  4. Consulte os modelos em: FiveM Checkpoints

​
Problema

Os sons de checkpoint, vitória ou contagem regressiva não funcionam.

​
Soluções

  1. Verifique se os sons estão habilitados em Config.Sounds
  2. Confirme que enabled = true para cada som
  3. Verifique se os nomes dos sons são válidos
  4. Consulte: Sons do GTA V

​
Problema

As notificações não chegam no Discord.

​
Soluções

  1. Verifique se a URL do webhook está correta em Config.Webhooks
  2. Confirme que o webhook está ativo no Discord
  3. Teste a URL manualmente com uma ferramenta como Postman
  4. Verifique permissões do canal do webhook

​
Problema

Os power-ups não aparecem ou não funcionam durante a corrida.

​
Soluções

  1. Verifique se Config.CollectableItems.enabled = true
  2. Confirme que a corrida tem collectable_items = true
  3. Verifique a chanceToHaveItem (0-100)
  4. Certifique-se de que há itens na lista com enabled = true

​
🔧 Problemas Técnicos

​
Problema

Erro Lua indicando tentativa de acessar valor nulo.

​
Causas Comuns

  • Configuração incompleta ou inválida
  • Arquivo de configuração corrompido
  • Dependência não carregada

​
Soluções

  1. Verifique se dk_snippets está iniciado antes do dk_races
  2. Revise os arquivos de configuração por erros de sintaxe
  3. Restaure o arquivo original e reconfigure

​
Problema

O script não consegue identificar o framework do servidor.

​
Solução

O script é STANDALONE e funciona sem framework. Porém, para recompensas funcionarem:
  1. Verifique a integração em server/functions/framework.lua
  2. Implemente as funções necessárias para seu framework
  3. Configure Config.dirtyDollarItem para frameworks VRP

​
Problema

Quedas de performance durante as corridas.

​
Soluções

  1. Reduza a quantidade de partículas:
    • Em Config.checkpointsParams, defina particles = nil
  2. Desative props nos checkpoints:
    • Defina prop.enabled = false
  3. Reduza a escala dos checkpoints
  4. Limite o número de jogadores por corrida

​
Problema

Rankings, estatísticas ou corridas não são salvos.

​
Soluções

  1. Verifique o caminho em Config.noSqlPath
  2. Confirme permissões de escrita na pasta
  3. Verifique se a pasta existe no servidor
  4. Reinicie o servidor para forçar salvamento

​
📝 Erros de Permissão

​
Problema

Ação bloqueada por falta de permissão.

​
Soluções

  1. Verifique sua permissão no framework (ADMIN/USER)
  2. Revise Config.Permissions no arquivo de configuração:
Config.Permissions = {
    ["race_management"] = "ADMIN",  -- Apenas admins
    ["routes_creation"] = "USER",   -- Todos podem criar rotas
    -- ...
}
  1. Para dar acesso a todos, mude de "ADMIN" para "USER"

​
🆘 Ainda Precisa de Ajuda?

Se você não encontrou a solução para seu problema:
1

Colete informações

  • Prints do erro no console (F8)
  • Logs do servidor
  • Configurações alteradas
2

Abra um ticket

Acesse nosso Discord e abra um ticket no canal de suporte.
3

Descreva o problema

Explique detalhadamente o que acontece, quando acontece e os passos para reproduzir.

Abrir Ticket de Suporte

Nossa equipe está pronta para ajudar você a resolver qualquer problema!