FiveM

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.

Equipe NeonHost14 de novembro de 20263 min de leitura
O que você vai aprender

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.

  1. Identifique o primeiro erro no console.
  2. Verifique fxmanifest.lua e os arquivos referenciados.
  3. Confirme nomes e versões das dependências.
  4. 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.

Próximo passo

Hospede sua cidade com acesso para configurar

Compare a linha FiveM e escolha recursos conforme a carga medida da sua cidade.

Ver VPS FiveM

Fontes oficiais

Confira as publicações usadas neste artigo:

Continue lendo

Mais sobre FiveM

FAQ do artigo

Dúvidas sobre FiveM

Os dois iniciam um resource; ensure também pode reiniciá-lo se já estiver em execução. Confira os comandos atuais no manual da Cfx.re.
Confira os erros gerados durante o uso, as permissões, as configurações e as dependências externas. A mensagem de início, sozinha, não comprova que todas as funções estão corretas.