Atualizado em julho de 2026

Como instalar um script FiveM

Instalação

Instalar um script FiveM não é complicado. Mas, se você nunca fez isso antes, vale a pena entender como o servidor carrega os scripts antes de colocar a mão na massa.

O que é um script FiveM?

No FiveM, os scripts são chamados de recursos (resources). Um recurso é uma pasta com tudo o que o script precisa para rodar: arquivos do client, arquivos do server, arquivos de config e qualquer asset de UI.

Toda pasta de recurso precisa de um arquivo chamado fxmanifest.lua. É ele que diz ao servidor o que carregar. Sem ele, o servidor ignora a pasta por completo.

Passo 1: baixe e extraia o script

Os scripts normalmente vêm em um arquivo .zip ou .rar. Extraia com o 7-Zip ou o WinRAR.

Lá dentro você vai encontrar a pasta do recurso. Ela deve ter, no mínimo:

fxmanifest.lua
Um ou mais arquivos de script (client.lua, server.lua, config.lua etc.)

Não renomeie o conteúdo da pasta, a não ser que a documentação diga que pode. Os caminhos de arquivo dentro do fxmanifest.lua diferenciam maiúsculas de minúsculas e precisam bater exatamente com os nomes reais dos arquivos.

Passo 2: envie o recurso para o seu servidor

Os recursos ficam dentro da pasta resources/, no diretório de dados do servidor. Uma estrutura típica fica assim:

server-data/
└── resources/
    └── [scripts]/
        └── your-script/
            ├── fxmanifest.lua
            ├── client.lua
            └── server.lua

Pastas entre colchetes, como [scripts], servem só como categorias para organizar. Elas não são recursos. Os scripts dentro delas funcionam normalmente.

Envie a pasta do recurso por FTP, SFTP ou pelo gerenciador de arquivos do painel da sua hospedagem.

Passo 3: configure o script

A maioria dos scripts vem com um arquivo config.lua. Abra o arquivo e ajuste os valores para o seu servidor. Normalmente isso inclui coisas como o tipo de framework, os nomes dos empregos e os nomes dos itens.

Leia a documentação antes de iniciar o script. Pular essa etapa é o motivo mais comum de um script não funcionar depois da instalação.

Passo 4: adicione o script ao server.cfg

Abra o server.cfg e adicione esta linha:

ensure your-script

Troque your-script pelo nome exato da pasta do recurso. Maiúsculas e minúsculas fazem diferença.

Se o script depende de outros recursos, como ESX, QBCore ou ox_lib, garanta que eles estejam listados mais acima no server.cfg para carregarem primeiro.

ensure é o padrão atual. Ele inicia o recurso e o reinicia automaticamente se ele travar. A diretiva antiga start ainda funciona, mas o ensure é o recomendado.

Passo 5: inicie o recurso

Você não precisa reiniciar o servidor inteiro. Existem duas formas de iniciar um recurso:

txAdmin: vá até o painel Resources, encontre o script e clique em Start.
Console do servidor: digite start your-script direto no console.

Confira a saída do console para ver se apareceu algum erro. Se o script carregou certinho, você vai ver:

Started resource your-script

Problemas comuns

Problema	Causa provável
Recurso não encontrado	O nome da pasta no `server.cfg` não bate com o nome real da pasta
Aviso de `fxmanifest.lua` ausente	O arquivo está faltando ou foi colocado no diretório errado
O script inicia, mas não funciona	A config não foi ajustada corretamente, ou está faltando alguma dependência
Erros de framework ao iniciar	O script foi feito para um framework diferente do que o seu servidor usa