Como Instalar Scripts FiveM: Guia Completo do Servidor

Guia passo a passo para instalar scripts FiveM no seu servidor, configurar o server.cfg e verificar se o recurso está funcionando corretamente.

Instalar um script FiveM é um processo direto: você baixa o recurso, coloca na pasta correta, registra no server.cfg e reinicia o servidor. Este guia cobre cada etapa com detalhes para que você possa ter o script rodando sem problemas.

Pré-requisitos

Antes de começar, verifique se você tem:

• Acesso à pasta resources do servidor (via FTP, SFTP ou acesso direto)
• Permissão para editar o arquivo server.cfg
• Os requisitos de sistema listados na página de introdução

Instalação Passo a Passo

1. Baixe o arquivo do script

   Após a compra ou download, você receberá um arquivo .zip contendo o recurso. Extraia o conteúdo — você terá uma pasta com o nome do script (ex: meu-script).

2. Envie para a pasta resources

   Copie a pasta do script para o diretório resources do seu servidor FiveM. A estrutura deve ficar assim:

   resources/
   └── [meu-script]/
       ├── fxmanifest.lua
       ├── config.lua
       ├── client/
       └── server/
   

   Organize seus scripts em subpastas como resources/[scripts-customizados]/ para facilitar o gerenciamento.

3. Registre no server.cfg

   Abra o arquivo server.cfg e adicione a linha de ensure para o seu script:

   server.cfg

   ensure meu-script
   

   Coloque o ensure do script depois do ensure do framework (ESX ou QBCore) para garantir a ordem de carregamento correta.

4. Configure o banco de dados

   Se o script utiliza banco de dados, importe o arquivo SQL incluído no pacote. Geralmente ele se chama meu-script.sql ou está na pasta database/.

   mysql -u usuario -p nome_do_banco < meu-script.sql
   

   Alternativamente, use uma interface como phpMyAdmin ou HeidiSQL para importar o arquivo.

5. Reinicie o servidor

   Reinicie o servidor completo ou, se preferir, use os comandos no console:

   refresh
   restart meu-script
   

Verificando a Instalação

Após reiniciar, confirme que o script está rodando:

1. No console do servidor, procure por mensagens de inicialização do script (ex: [meu-script] Iniciado com sucesso)
2. Conecte ao servidor e teste o funcionamento básico
3. Verifique o console do F8 no cliente por erros de Lua

Se aparecer Couldn't start resource meu-script, verifique se a pasta está com o nome correto e se o fxmanifest.lua existe dentro dela.

Atualizando um Script

1. Faça backup

   Antes de atualizar, salve uma cópia do config.lua atual para não perder suas configurações.

2. Substitua os arquivos

   Substitua todos os arquivos da pasta do script pelos novos, exceto o config.lua se você não quiser perder as configurações.

3. Revise o config.lua

   Compare seu config.lua com o novo config.lua fornecido para verificar se há novas opções de configuração.

4. Reinicie o recurso

   Use restart meu-script no console do servidor.