Resource do FiveM não inicia: corrija o erro pela mensagem do console

Um resource do FiveM não inicia quando o servidor não o encontra, não consegue ler o manifesto, inicia o resource antes de uma dependência, encontra um erro de Lua ou nega o direito de uso (entitlement). Encontre o primeiro erro que cita o resource e depois use a seção correspondente abaixo.

As mensagens só são citadas quando uma página da Cfx.re, a documentação de um framework ou biblioteca, a documentação de um vendedor ou uma publicação do fórum da Cfx.re as mostra; a fonte aparece ao lado de cada uma. Onde não foi possível verificar uma mensagem exata, a seção avisa. Esta é uma revisão de documentação datada de 2026-10-13, não um teste prático: nada aqui foi reproduzido em um servidor.

Leia o console primeiro

1. Reinicie o servidor e procure o nome do resource no console do servidor (ou no Live Console do txAdmin, veja Como encontrar e ler os logs do txAdmin).
2. Pegue o primeiro erro que o menciona. As linhas seguintes costumam ser consequências: uma dependência que falhou faz falhar todos os resources que precisam dela.
3. Copie essa linha com o caminho do arquivo e o número da linha, e anote a versão do resource, o framework, o número do artifact do FXServer e a edição do GTA V.

O testador de scripts FiveM tem um explicador de erros que roda no seu navegador; oculte chaves de licença e IPs antes de compartilhar qualquer log.

Qual mensagem você está vendo?

1. O servidor não encontra o resource

Significado: a introdução ao scripting da Cfx.re diz que um resource precisa de um manifesto para ser detectado. Se não houver uma pasta com esse nome contendo um fxmanifest.lua legível, não há nada para iniciar.

Confirmar: liste o caminho. O esperado é resources/[optional_group]/resource_name/fxmanifest.lua. Arquivos zip podem ser extraídos como resource_name/resource_name/fxmanifest.lua. Compare o nome após ensure com o nome da pasta, incluindo -, _ e, no Linux, maiúsculas e minúsculas. Para uma pasta adicionada enquanto o servidor está rodando, o refresh varre resources de novo e carrega os manifestos (comandos do servidor).

Corrigir: mova a pasta interna um nível acima, corrija o nome, execute refresh e depois ensure resource_name. Se todos os resources personalizados somem enquanto os padrão funcionam, verifique também o upload: no tópico do fórum citado acima, quem postou relatou que trocar de cliente FTP (do WinSCP para o FileZilla) resolveu, sem saber por quê. É um caso isolado, e as documentações de vendedores citadas na seção 5 relatam o oposto para arquivos protegidos (o FileZilla os corrompe). Reenviar o arquivo compactado e extraí-lo no servidor é o teste mais seguro.

2. O manifesto está ausente, errado ou novo demais

Significado: a referência do manifesto diz que um resource precisa especificar uma versão de manifesto, e que resources sem ela recebem atualmente um padrão que está previsto para ser removido. Ela lista cerulean, bodacious e adamant como valores de fx_version, e gta5 e rdr3 entre os valores de game.

Confirmar: abra o fxmanifest.lua e verifique se ele tem fx_version e game. No tópico do fórum, as respostas divergem: uma diz que o valor bodacious exige uma build de servidor mais nova (foi adicionado na 2207), outra diz para baixar o artifact mais recente, e uma terceira teve o mesmo erro em todas as builds. Trate um artifact desatualizado como uma causa possível. Verifique também se cada arquivo listado em client_script, server_script, shared_script e files existe. Não encontrei uma fonte da Cfx.re para a mensagem exata que um arquivo listado ausente produz, então confirme comparando o manifesto com o conteúdo da pasta.

Corrigir: restaure o manifesto original do download ou atualize o artifact. Para escrever um: Como escrever e conferir um fxmanifest.lua do FiveM.

3. Uma dependência não iniciou

Significado: a diretiva dependency do manifesto exige que o resource indicado seja carregado antes do atual. No tópico do fórum, o log mostra a dependência falhando com o próprio aviso, seguido de Could not start dependency essentialmode for resource esplugin_mysql. O resource dependente é só o sintoma.

Confirmar: role para cima até o primeiro erro sobre a dependência e leia-o. Depois verifique se a dependência está com ensure no server.cfg (por convenção, acima do seu resource) e se o nome no manifesto corresponde ao nome da pasta da dependência.

Corrigir: conserte a dependência; veja as outras seções para a mensagem dela. Referências sobre a ordem de inicialização: QBCore, ESX, Qbox e Configurar o server.cfg do FiveM e verificar suas alterações.

4. No such export

Significado: a documentação do ox_inventory lista três causas prováveis para No such export * in resource ox_inventory: ocorreu um erro ao iniciar o ox_inventory ou uma dependência como o ox_lib; o resource que faz a chamada inicia antes do ox_inventory; ou o export chamado não existe. O mesmo padrão, no such export getPlayerData in resource mumble-voip, aparece em um tópico do fórum da Cfx.re que não tem resposta.

Confirmar: (1) o resource citado iniciou sem erros, (2) a linha ensure dele está acima da de quem chama, (3) o nome do export em quem chama corresponde ao código e ao manifesto do provedor. A página do runtime Lua acrescenta que os exports de manifesto só ficam disponíveis após o primeiro tick do scheduler, então trate como suspeito um código que chama um deles muito cedo.

Corrigir: corrija primeiro o erro do próprio provedor, depois a ordem, depois o nome. Nunca crie um export vazio para silenciar a linha.

5. Erros de Lua ao carregar um script

Duas formas aparecem nos tópicos do fórum: Error parsing script ... in resource ...: ... unexpected symbol (o arquivo não é interpretado) e Error loading script ... in resource ...: ... attempt to index a nil value (global 'ESX') (o arquivo foi interpretado, mas falhou ao ser executado), cada uma geralmente seguida de Failed to load script ....

• Objeto do framework nil. No tópico do es_extended, Failed to load script @es_extended/imports.lua veio junto com global 'ESX' sendo nil. As respostas sugeriam verificar como o manifesto inclui o imports.lua e usar um ESX mais novo; o tópico não registra nenhuma correção confirmada. Verifique se o framework inicia primeiro e se o script é feito para a versão do framework que você usa.
• Erro de interpretação perto de um byte estranho. O tópico do Config mostra unexpected symbol near '<\239>' em config.lua, depois global 'Config' sendo nil em server/main.lua. O tópico não dá explicação. Minha leitura, não uma causa documentada: \239 é o decimal de 0xEF, o primeiro byte de uma marca de ordem de bytes (BOM) UTF-8, e o segundo erro parece consequência do primeiro. Salve o arquivo novamente como UTF-8 sem BOM e teste outra vez.
• Um erro de sintaxe em um arquivo que você nunca editou. As documentações de vendedores (Lation, JG Scripts) listam syntax error near <\1> para arquivos protegidos e o associam a correções sobre transferências corrompidas ou incompletas e servidores desatualizados. Reenvie o arquivo original, extraia-o no servidor e atualize o artifact.

Corrigir: vá ao arquivo e à linha da primeira mensagem, compare com o seu backup e desfaça sua última edição nos arquivos de config ou de itens. Não edite arquivos protegidos.

6. O banco de dados não está conectado

Não consegui verificar uma mensagem de falha universal do oxmysql, então procure o primeiro erro de banco de dados impresso pelo oxmysql ou pelo script. A documentação do oxmysql diz para definir mysql_connection_string com set (“only ever use set”) antes de iniciar os resources, iniciar o oxmysql perto do topo e evitar ; , / ? : @ & = + $ # nos valores de conexão, porque podem não ser suportados. A página de solução de problemas do ESX cita “ESX Multicharacter couldn't connect to the database” e atribui isso a uma connection string errada no server.cfg ou a uma conexão com o banco de dados que não está funcionando.

Confirmar: o servidor de banco de dados está rodando, as credenciais funcionam em uma ferramenta de banco de dados e as tabelas de que o script precisa existem. Detalhes: arquivos SQL e erros de banco de dados e Migrar resources do mysql-async para o oxmysql com segurança.

7. Asset Escrow e a chave do servidor

Segundo a documentação do Asset Escrow, um resource sem entitlement não inicia e o console mostra You lack the required entitlement. As documentações de vendedores acrescentam que o resource fica vinculado à conta Cfx.re que o possui, então a chave de registro do servidor precisa vir dessa conta, e pode ser necessária uma reinicialização completa após a primeira instalação. Outra mensagem documentada por vendedores é [svadhesive] Failed to verify protected resource ..., que os vendedores associam a reinicializações incompletas, uploads corrompidos ou um arquivo .fxap ausente. Passos: Como corrigir o erro de Required Entitlement do FiveM e O que é um arquivo .fxap em um resource do FiveM?

8. Incompatibilidade entre Legacy e Enhanced

Não encontrei nenhuma mensagem de erro documentada específica para uma incompatibilidade de edição. A comparação da Cfx.re documenta diferenças que podem impedir um resource de funcionar: alguns arquivos de servidor do Enhanced têm nomes diferentes (por exemplo, cfx-server.exe em vez de FXServer.exe), resources podem trazer stream_enhanced ao lado de stream, e o Asset Escrow aparece como ainda não implementado para o Enhanced. Se você usa o Enhanced, confirme que o criador oferece suporte a essa versão exata; veja FiveM Standard vs Enhanced: qual versão você deve usar?

O que enviar ao suporte

A primeira linha de erro, o nome e a versão do resource, o framework e a versão, o número do artifact, a edição e as linhas relevantes do server.cfg sem chaves e senhas. Veja erros de inicialização e o que o suporte precisa.

FAQ

O que significa “Couldn't start resource” no FiveM?

É o servidor dizendo que o resource não iniciou. O motivo está nas linhas anteriores, por exemplo um aviso do manifesto. Leia o primeiro erro que cita o resource.

O que causa “No such export”?

O resource que fornece o export não iniciou, iniciou depois de quem chama, ou não tem esse export. A documentação do ox_inventory lista essas três causas.

O que significa “Failed to load script”?

Um arquivo não pôde ser carregado. As linhas de erro ao redor dela dizem qual é o problema de verdade, como um erro de sintaxe ou um objeto do framework nil. Corrija esse erro, não a linha genérica.

A ordem das linhas ensure importa?

Sim, quando os resources dependem uns dos outros: inicie um resource depois do framework, das bibliotecas e de qualquer resource cujos exports ele chama (a documentação do ox_inventory lista uma ordem de inicialização por esse motivo).