Resource do FiveM não inicia? Verifique fxmanifest, dependências e ordem
Um roteiro para encontrar o motivo de um resource FiveM não carregar, ler o console e testar a correção sem interromper a cidade.
Quando um resource FiveM não inicia, confira primeiro a mensagem no console do FXServer. Verifique se a pasta contém um fxmanifest.lua válido, se as dependências estão presentes e se o resource é iniciado depois delas no server.cfg. Corrija uma causa por vez e teste numa cópia da cidade.
Passo 1: Leia o primeiro erro, não apenas o último
Um erro de dependência pode produzir outras mensagens em sequência. Anote o nome da pasta, o horário e a primeira falha no console. Se o problema começou após uma atualização, compare o pacote instalado com a versão anterior e faça backup antes de alterar arquivos da cidade. Aumentar RAM não corrige um manifesto ausente nem um nome de resource errado.
Passo 2: Confirme a estrutura e o manifesto
Segundo a documentação da Cfx.re, um resource fica numa pasta própria e é identificado pelo arquivo fxmanifest.lua. Confira o nome exato da pasta, a grafia do manifesto e as referências a scripts e arquivos. Nomes de arquivos com diferenças de maiúsculas e minúsculas merecem atenção especial em um servidor Linux. Não substitua o manifesto por um exemplo genérico: ele precisa refletir os arquivos reais do resource.
Passo 3: Confira as dependências e a ordem de início
A diretiva dependency do manifesto declara um resource necessário. Se a dependência estiver ausente, desativada ou com outro nome, instale ou ajuste a referência antes de iniciar o dependente. No server.cfg, mantenha o ensure da dependência antes do ensure do resource que a utiliza. Após adicionar uma pasta nova, use refresh no console para atualizar a lista de resources; depois execute ensure com o nome correto.
- Identifique o primeiro erro no console.
- Verifique fxmanifest.lua e os arquivos referenciados.
- Confirme nomes e versões das dependências.
- Ajuste a ordem dos comandos ensure e teste novamente.
Passo 4: Valide em ambiente de teste
Entre na cidade e teste a função afetada, não apenas a mensagem de inicialização. Se o resource manipula inventário, veículos ou banco, verifique uma operação real e acompanhe novos erros. Guarde o pacote anterior para reverter caso a atualização quebrou a compatibilidade. Em produção, combine uma janela de manutenção se o teste puder afetar jogadores conectados.
Hospede sua cidade com acesso para configurar
Compare a linha FiveM e escolha recursos conforme a carga medida da sua cidade.
Fontes oficiais
Confira as publicações usadas neste artigo: