Skip to main content
Esta página cobre os erros mais comuns ao usar os scripts FiveM e como resolvê-los. Para cada problema, siga os passos em ordem até encontrar a solução. Ative Config.Debug = true no config.lua para obter mais detalhes nos logs.

​
Problemas de Inicialização

Este erro aparece no console do servidor quando o recurso não pode ser carregado.Causas e soluções:
  1. Nome da pasta incorreto — O nome na linha ensure deve ser exatamente igual ao nome da pasta em resources/. Verifique maiúsculas/minúsculas.
  2. fxmanifest.lua ausente — A pasta do script deve conter o arquivo fxmanifest.lua na raiz.
  3. Dependência não encontrada — Verifique o fxmanifest.lua do script para a lista de dependencies. Todos os recursos listados devem estar instalados e iniciados antes deste script.
Erros de Lua geralmente indicam um problema de configuração.Passos:
  1. Leia a mensagem de erro completa — ela indica o arquivo e a linha exata do problema
  2. Verifique se o config.lua está com a sintaxe correta (sem vírgulas faltando, aspas abertas, etc.)
  3. Ative Config.Debug = true para mais detalhes
  4. Confirme que o framework correto foi detectado
Validar sintaxe Lua:
Se o log mostrar Framework: nil ou o script se comportar como se não houvesse framework:
  1. Confirme que o ESX ou QBCore está iniciado antes do script no server.cfg
  2. Force o framework manualmente: Config.Framework = 'esx' ou Config.Framework = 'qbcore'
  3. Verifique se o recurso do framework está ativo com GetResourceState('es_extended') ou GetResourceState('qb-core')

​
Problemas de Banco de Dados

  1. Verifique se o oxmysql está instalado e iniciado antes de todos os outros scripts
  2. Confirme as credenciais do banco de dados no server.cfg:
  3. Confirme que o banco de dados existe e o usuário tem permissões
  4. Verifique se o arquivo SQL foi importado corretamente — tabelas ausentes causam erros
O arquivo SQL do script não foi importado.
  1. Localize o arquivo .sql na pasta do script (geralmente database/nome-script.sql)
  2. Importe via phpMyAdmin, HeidiSQL ou linha de comando:
  3. Reinicie o script após importar

​
Problemas de Interface (UI)

Se o HUD do script se sobrepõe a outro HUD no servidor:
  1. Ajuste a posição: Config.UI.HUDPosition = 'bottom-right'
  2. Adicione offset: Config.UI.HUDOffset = { x = 20, y = 80 }
  3. Ou desative o HUD nativo: Config.UI.ShowHUD = false se você usa outro sistema de HUD
  1. Verifique Config.UI.ShowNotifications = true
  2. Se usa sistema externo, confirme que o recurso está instalado e o nome correto está em Config.UI.NotificationSystem
  3. Verifique o console do cliente (F8) por erros relacionados ao sistema de notificação

​
Problemas de Permissões

  1. Confirme que o identificador do Steam/Discord está correto no server.cfg
  2. Verifique a sintaxe do add_ace e add_principal:
  3. Reinicie o servidor após alterações no server.cfg
  4. Use test_ace no console para testar permissões:

​
Obtendo Suporte

Se o problema persistir após seguir os passos acima:

FAQ

Consulte as perguntas frequentes para respostas rápidas sobre instalação, configuração e uso.
Para suporte direto, entre em contato pelo nosso servidor do Discord e abra um ticket. Ao solicitar ajuda, inclua sempre: versão do script, framework utilizado, mensagem de erro completa do console e o conteúdo do seu config.lua (remova dados sensíveis como URLs de webhooks antes de compartilhar).