Skip to main content
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:
2

Instale o script

Copie a pasta do script para resources/[meus-scripts]/. Confirme que a estrutura contém pelo menos o fxmanifest.lua:
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
4

Adicione ao server.cfg

Registre o script no server.cfg, após o framework:
server.cfg
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

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