Primeiros Passos: Instalação e Configuração de Scripts FiveM

Configure seu servidor FiveM do zero com nossos scripts — do download ao primeiro teste, com dicas para evitar os erros mais comuns.

Este guia é para quem está usando nossos scripts pela primeira vez. Em poucos minutos você terá o ambiente configurado, o script rodando no servidor e entenderá o fluxo básico para adicionar novos recursos no futuro.

O que você vai precisar

Antes de começar, tenha em mãos:

• Um servidor FiveM ativo com acesso root ou painel de hospedagem
• Framework instalado (ESX 1.9+ ou QBCore)
• Banco de dados MySQL com oxmysql configurado
• O arquivo do script (obtido após a compra ou download)

Configuração Inicial

1. Organize a pasta resources

   Crie uma pasta de organização dentro de resources para manter seus scripts separados dos recursos padrão:

   resources/
   ├── [system]/          # Recursos do FiveM
   ├── [framework]/       # ESX ou QBCore
   └── [meus-scripts]/    # Seus scripts aqui
       └── meu-script/
   
2. Instale o script

   Copie a pasta do script para resources/[meus-scripts]/. Confirme que a estrutura contém pelo menos o fxmanifest.lua:

   ls resources/meu-script/
   # fxmanifest.lua  config.lua  client/  server/  html/
   
3. Configure antes de iniciar

   Abra o config.lua e ajuste pelo menos as configurações essenciais antes de iniciar o script pela primeira vez:

   config.lua

   Config.Framework = 'auto'   -- Detecta ESX ou QBCore automaticamente
   Config.Debug = true         -- Ative durante os testes iniciais
   Config.Locale = 'pt-BR'
   
4. Adicione ao server.cfg

   Registre o script no server.cfg, após o framework:

   server.cfg

   # Framework
   ensure es_extended  # ou qb-core
   
   # Meus scripts
   ensure meu-script
   
5. Teste no servidor

   Inicie o servidor e conecte. Abra o console do cliente (F8) e verifique se há erros. Teste o comando ou funcionalidade principal do script para confirmar que tudo está funcionando.

Dicas para Evitar Problemas

O script não inicia (erro no console do servidor)

Verifique:

• O nome na linha ensure bate exatamente com o nome da pasta
• O arquivo fxmanifest.lua existe na raiz do recurso
• Todas as dependências listadas no fxmanifest.lua estão instaladas e iniciadas antes deste script

Erros de banco de dados

Se aparecer Database error ou erros relacionados ao MySQL:

• Confirme que o arquivo SQL foi importado corretamente
• Verifique se o oxmysql está configurado e rodando
• Ative Config.Debug = true para ver os queries executados

Script inicia mas nada funciona no cliente

• Verifique o console F8 por erros de Lua no cliente
• Confirme que o framework correto está detectado — ative debug para ver a mensagem de inicialização
• Certifique-se de que o script carrega depois do framework no server.cfg

Próximos Passos

Configuração Avançada

Explore todas as opções disponíveis no config.lua.

Permissões

Configure quem pode usar quais comandos e funcionalidades.