Como instalar um script (recurso) de FiveM passo a passo

Para instalar um script de FiveM, copie a pasta do recurso (aquela que contém o fxmanifest.lua) para o diretório resources do seu servidor, inicie primeiro as dependências dele, configure-o, adicione uma linha ensure depois delas no server.cfg e leia o console. Faça um backup antes.

Revisado com base na documentação da Cfx.re e dos frameworks linkada aqui, em 2026-10-13. Isto é uma revisão de documentação, não um teste prático: a RPScripts não executou estes passos em um ambiente de teste isolado. Os passos assumem GTA V Legacy; o Enhanced só é sinalizado no passo 1. Tudo que está escrito em monospace, como resource_name, é um marcador para o seu próprio valor.

Passo 1: Verifique a edição, o framework e as dependências

Leia a página do produto ou o readme e anote: o framework (ESX, QBCore, Qbox ou standalone), as bibliotecas necessárias, os recursos de inventário e target, e a edição do GTA V compatível. Um selo de framework não informa a edição.

A página Legacy/Enhanced da Cfx.re descreve um servidor Enhanced com arquivos de servidor de nomes diferentes, uma pasta stream_enhanced para assets que diferem de stream, e lista o Asset Escrow como “Not implemented yet” para o Enhanced. Pergunte ao criador qual é a versão exata se você usa Enhanced. Contexto: FiveM Standard vs Enhanced: qual versão você deve usar?.

Verificação de sucesso: você consegue listar framework, edição e dependências a partir do texto do próprio criador. Se não conseguir: pare e pergunte ao vendedor antes de instalar.

Passo 2: Faça backup para poder reverter

Copie o server.cfg, as pastas de recursos que você vai alterar e quaisquer arquivos compartilhados de itens ou empregos, e exporte o banco de dados. Teste a instalação primeiro em um servidor de teste com um banco de dados de teste. Veja Como fazer backup e restaurar um servidor FiveM.

Verificação de sucesso: você sabe onde estão as cópias e qual arquivo restauraria primeiro.

Passo 3: Extraia e encontre a pasta do recurso

Extraia o arquivo compactado. Um recurso é uma pasta com o fxmanifest.lua diretamente dentro dela; a introdução a recursos da Cfx.re diz: “Every resource is required to contain a resource manifest by the name of fxmanifest.lua”. Um mesmo download pode conter vários recursos, e um zip pode incluir uma pasta extra envolvendo tudo.

Verificação de sucesso: toda pasta que você vai copiar tem o fxmanifest.lua no nível superior, e não uma pasta mais abaixo. Evidência se estiver errado: uma listagem da pasta mostrando onde o manifesto está.

Baixe o build correto. Dois exemplos documentados dizem para usar uma release, e não o arquivo de código-fonte do repositório: a documentação do QBCore diz para usar o build de release do oxmysql, e a documentação do ox_inventory diz que a UI precisa estar empacotada (bundled) e recomenda a release já empacotada (ox_inventory.zip).

Passo 4: Coloque em resources e mantenha o nome da pasta

Mova cada pasta de recurso para resources, ou para uma pasta com colchetes, como resources/[scripts]. Os comandos de servidor da Cfx.re aceitam nomes entre colchetes como categorias, por exemplo start [cars].

Na árvore de exemplo da Cfx.re, o recurso tem o nome da sua pasta, então o nome da pasta é o nome que você passa ao ensure; os scripts que dependem dele normalmente o referenciam por esse nome. A página da Cfx.re diz que você é livre para nomear as pastas como quiser, mas renomear um script comprado é um risco que a RPScripts desaconselha, a menos que o criador diga para fazer isso.

Verificação de sucesso: o caminho fica assim: resources/[optional_group]/resource_name/fxmanifest.lua. No Linux, maiúsculas e minúsculas importam.

Passo 5: Leia o manifesto

Abra o fxmanifest.lua sem alterá-lo. A referência do manifesto lista fx_version e game (gta5 roda no FiveM, rdr3 no RedM) e diz sobre dependency: “Requires the specified resource to load before the current resource.” Todo arquivo citado em client_script, server_script, shared_script ou files deve existir na pasta. Para escrever um você mesmo, veja Como escrever e conferir um fxmanifest.lua do FiveM e o gerador de fxmanifest.

Verificação de sucesso: você sabe nomear cada dependência e cada arquivo listado existe.

Passo 6: Instale e inicie as dependências

Dependência	Por que importa	Fonte
oxmysql	Acesso ao banco de dados. Defina mysql_connection_string com set antes de qualquer recurso iniciar e inicie o oxmysql no topo da lista.	documentação do oxmysql
ox_lib	Usada por meio de shared_scripts { '@ox_lib/init.lua' } no manifesto de um recurso, então a biblioteca precisa estar instalada.	documentação do ox_lib
Framework	es_extended, qb-core ou qbx_core precisam estar rodando antes dos scripts que os usam.	Veja a tabela de frameworks no passo 12
Inventário e target	Precisam corresponder às opções da config do script (por exemplo, ox_inventory versus qb-inventory).	O readme do script

Listar você mesmo cada dependência no server.cfg, em ordem, é uma precaução da RPScripts, não um requisito documentado.

Verificação de sucesso: cada dependência está instalada e já roda sozinha.

Passo 7: Importe o SQL com cuidado

Só alguns scripts trazem um arquivo .sql. Leia-o antes de executar: DROP TABLE, TRUNCATE, DELETE, REPLACE e ALTER TABLE podem remover ou alterar dados existentes, e CREATE TABLE IF NOT EXISTS não verifica se uma tabela existente tem as colunas certas. Um arquivo de instalação nova não é uma atualização. Importe no banco de dados indicado na sua connection string, primeiro no banco de teste. Detalhes e erros comuns: arquivos SQL e erros de banco de dados.

A página de instalação do Qbox exige MariaDB 10.9.0 ou mais recente, não MySQL. Confira o seu mecanismo de banco de dados com o requisito do framework antes de importar.

Verificação de sucesso: a importação não reporta erros e as tabelas esperadas existem. Evidência se falhar: o comando que falhou e o erro exato, sem as senhas.

Passo 8: Configure

Edite o config.lua (ou a pasta config) para que as opções de framework, inventário, target e notificação apontem para recursos que você realmente executa. Registre os itens de que o script precisa no sistema de itens do seu framework. As observações por framework estão na tabela do passo 12.

Verificação de sucesso: todo nome de recurso na config existe na sua pasta resources.

Passo 9: Adicione a linha ensure na ordem certa

# server.cfg (placeholders: use your own framework and resources)
set mysql_connection_string "..."   # your own value, keep it private
ensure oxmysql
ensure ox_lib
ensure your_framework
ensure your_inventory_and_target

ensure resource_name

A documentação do oxmysql diz para adicionar start oxmysql “to the top of your resource list” e a página do ox_inventory para Qbox diz para iniciá-lo “immediately after qbx_core”, então a ordem importa. Seu script vai depois de tudo de que ele depende. Ordem de inicialização por framework: QBCore, ESX, Qbox; referência geral: Configure o server.cfg do FiveM e confira suas alterações e o gerador de server.cfg. Comentários no server.cfg começam com #, como no modelo do QBCore.

Verificação de sucesso: sua linha fica abaixo da linha de cada dependência.

Passo 10: Inicie e confira o resultado

A página de comandos de servidor da Cfx.re documenta o refresh, que verifica resources de novo e carrega os manifestos para que recursos novos possam ser iniciados, e o ensure, que inicia um recurso ou o reinicia se ele já estiver rodando. No console do servidor, execute refresh e depois ensure resource_name; reiniciar o servidor também o carrega. Depois de adicionar itens, empregos ou SQL, a RPScripts sugere um reinício completo como precaução (conselho editorial, não uma afirmação da Cfx.re).

1. Nenhuma linha de erro menciona resource_name no console do servidor.
2. Entre com uma conta de teste e pressione F8: nenhuma linha de erro para o recurso.
3. Use a funcionalidade (abra o menu, use o item, entre no mapa).
4. Reconecte e reinicie uma vez para confirmar que os dados salvos continuam lá.

Evidências a reunir se alguma verificação falhar: a primeira linha de erro após a inicialização (não a última), o nome do recurso, seu framework e a versão dele, o número do artifact do FXServer, a edição e o bloco de ensure acima e abaixo da sua linha. Se ele não iniciar, continue com Recurso do FiveM não inicia: corrija os erros pela mensagem do console.

Passo 11: Reverta de forma limpa

Execute stop resource_name, coloque um # antes da linha ensure dele e restaure os arquivos de config e o banco de dados a partir do backup do passo 2. Guarde a exportação do banco de dados do passo 2, porque um arquivo SQL importado só em parte não é desfeito ao parar o recurso.

Passo 12: Diferenças entre frameworks

Framework	Recurso principal	Itens e dados	Fonte
ESX	es_extended	Itens e empregos ficam em tabelas do banco de dados, a menos que você use o ox_inventory (veja as notas de ESX da RPScripts). A página de solução de problemas do ESX lista “Error ESX = nil” com a correção “update your es_extended to the latest version”.	documentação do ESX
QBCore	qb-core	O modelo inicia ensure qb-core, depois ensure [qb] e [standalone].	documentação do QBCore
Qbox	qbx_core	Usa o ox_inventory: adicione setr inventory:framework "qbx" antes de os recursos iniciarem e inicie o ox_inventory logo depois do qbx_core.	configuração do ox_inventory para Qbox
Standalone	nenhum	Precisa apenas do que o readme dele cita.	Criador

Um script feito para um framework não funciona em outro só copiando; veja Converta scripts de FiveM entre ESX, QBCore e Qbox. A RPScripts vende scripts, então este link de categoria é comercial: Scripts QBCore. Os passos aqui valem para um recurso de qualquer origem.

Recursos protegidos por escrow

Recursos protegidos pelo Cfx.re Asset Escrow geralmente contêm um arquivo .fxap; veja O que é um arquivo .fxap em um recurso do FiveM?. Não edite, mescle nem exclua os arquivos protegidos. De acordo com a documentação do Cfx.re Asset Escrow, um servidor sem a permissão (entitlement) correta não consegue iniciar o recurso e exibe “You lack the required entitlement” no console; as correções estão em Como corrigir o erro de entitlement necessário do FiveM. A documentação descreve uma diretiva escrow_ignore que permite ao criador deixar arquivos escolhidos, como uma config, sem proteção; edite apenas os arquivos que o criador indicar. As documentações de vendedores relatam que transferências de arquivos corrompidas quebram recursos com escrow. A JG Scripts diz para enviar o .zip como está e extraí-lo depois da transferência, em vez de transferir os arquivos um por um, e que o FileZilla pode corromper arquivos (tente o WinSCP); a Lation diz que o FileZilla corrompe com frequência arquivos com escrow e recomenda o WinSCP. Isso é orientação de fornecedores, não uma afirmação da Cfx.re.

FAQ

Preciso reiniciar o servidor depois de adicionar um script?

Nem sempre. refresh e depois ensure resource_name carrega um recurso novo, segundo a documentação da Cfx.re. Depois de adicionar itens, empregos ou alterações de SQL, um reinício completo é uma precaução da RPScripts.

Posso instalar um script de QBCore no ESX ou no Qbox?

Não só copiando. Confira a página do produto para o seu framework; um script que chama o inventário ou as funções principais de outro framework precisa de conversão ou de uma bridge documentada pelo criador.