Como instalar resources e scripts no servidor FiveM

Resources são os pacotes que adicionam funcionalidades ao servidor FiveM. Eles podem incluir mapas, carros, roupas, inventário, empregos, hud, sistema policial, garagens, lojas, banco, anticheat, voice, animações e frameworks completos. Instalar resources parece simples: copiar uma pasta e adicionar ensure no server.cfg. Porém, na prática, muitos problemas de cidade vêm de instalação desorganizada, dependências ignoradas, banco não importado, versão errada ou scripts incompatíveis entre si.

Entendendo a pasta resources

Na VPS, a pasta resources guarda os scripts carregados pelo FXServer. É comum organizar por categorias, usando colchetes no nome das pastas, como [core], [jobs], [maps], [cars] e [standalone]. Essa organização ajuda a equipe a encontrar arquivos, mas o nome real do resource é a pasta interna que contém o manifesto, como fxmanifest.lua ou __resource.lua. O comando ensure normalmente aponta para essa pasta interna.

Passo a passo seguro

1. Faça backup antes de instalar qualquer pacote.
2. Leia a documentação do resource.
3. Verifique dependências obrigatórias.
4. Copie a pasta para o local correto.
5. Importe arquivos SQL se o script usar banco.
6. Adicione ensure nome_do_resource na ordem certa.
7. Reinicie o servidor ou use refresh e ensure.
8. Teste com poucos jogadores antes de liberar.

fxmanifest e dependências

O arquivo fxmanifest.lua descreve o resource. Ele informa scripts client, server, shared, arquivos de interface e dependências. Se faltar dependência, o resource pode iniciar sem funcionar, ou gerar erro no console. Antes de culpar a VPS, confira se o pacote exige ox_lib, mysql-async, oxmysql, qb-core, es_extended ou qualquer outro recurso base.

Ordem de inicialização

A ordem no server.cfg deve respeitar a lógica do servidor. Primeiro recursos nativos e bibliotecas, depois banco, framework, sistemas centrais, inventário, jobs, mapas, veículos e extras. Se um emprego usa inventário, o inventário precisa iniciar antes. Se uma loja consulta banco, a conexão com MySQL precisa estar pronta. Ordem errada costuma aparecer no console como export inexistente, nil value, tabela não encontrada ou evento não registrado.

ensure oxmysql
ensure ox_lib
ensure framework_base
ensure inventory
ensure garage
ensure jobs_police
ensure jobs_mechanic

Scripts com banco de dados

Muitos scripts vêm com arquivo .sql. Esse arquivo cria tabelas, colunas ou registros iniciais. Importe no banco correto antes de iniciar o script. Se o resource iniciar sem as tabelas, pode gerar erro em loop e consumir CPU. Também confira se o banco configurado no server.cfg aponta para host, usuário, senha e database corretos.

Cuidados com scripts pagos

Scripts pagos podem usar escrow, licença ou verificação externa. Baixe apenas de fontes confiáveis e mantenha comprovantes. Evite pacotes vazados, porque além de risco legal, eles podem conter backdoors, mineradores, webhooks escondidos ou comandos abusivos. Uma cidade profissional protege seus jogadores e sua reputação usando recursos legítimos.

Como testar sem derrubar a cidade

O ideal é ter um ambiente de testes em outra pasta ou VPS menor. Instale o resource, rode com banco separado e chame alguns membros da equipe para testar. Verifique console, F8 do cliente, consumo de CPU, erros ao entrar, compra, venda, morte, desconexão e restart. Só depois leve para produção. Se não houver ambiente separado, faça manutenção em horário de baixo movimento e tenha backup pronto para rollback.

Problemas comuns

• Resource compactado com pasta dupla, como script/script/fxmanifest.lua.
• Nome da pasta diferente do nome usado no ensure.
• SQL importado no banco errado.
• Dependência ausente ou versão incompatível.
• Script antigo em artifact novo, ou script novo em artifact muito antigo.
• Conflito entre dois recursos que alteram a mesma função.

Conclusão

Instalar resources no FiveM exige método. Copiar arquivos sem entender dependências pode até funcionar no começo, mas vira dor de cabeça quando a cidade cresce. Organize pastas, leia documentação, respeite ordem de inicialização, teste em ambiente controlado e mantenha backup. Em VPS com NVMe e boa CPU, scripts bem instalados carregam melhor, mas a estabilidade depende principalmente de organização técnica.