Economize 20% com WELCOMEVer ofertas
Configurando fxmanifest.lua (FiveM)

Configurando fxmanifest.lua para FiveM (Exemplos para Copiar e Colar)

Resposta rápida: todo recurso FiveM precisa de um fxmanifest.lua arquivo na pasta de recursos. Ele informa ao FXServer qual jogo o recurso suporta, quais scripts carregar e quais arquivos vão para os clientes. Abaixo estão exemplos para copiar e colar para um recurso de script padrão, scripts compartilhados/cliente/servidor, recursos NUI (página_ui + arquivos), e mapas (este_é_um_mapa 'sim' ) com streams de ymap), além de correções para erros comuns no manifesto.

Última atualização: 25 de junho de 2026

Fxmanifest.lua mínimo

fx_version 'cerulean' game 'gta5' client_script 'client.lua' server_script 'server.lua''

A documentação oficial do manifesto de recursos do Cfx.re identifica fxmanifest.lua como o arquivo de manifesto atual e observa que o antigo __recurso.lua Os manifestos estão obsoletos. Use fx_version 'cerúleo' para recursos FiveM modernos, a menos que o autor do recurso documente um requisito diferente.

Exemplo completo com metadados

fx_version 'cerulean'
game 'gta5'

author 'Seu Nome'
description 'Exemplo de recurso FiveM'
version '1.0.0'

lua54 'yes'

shared_script 'config.lua'
client_script 'client.lua'
server_script 'server.lua'

O autor, descrição, e versão os campos são metadados: eles não alteram como os scripts são executados, mas o FXServer imprime um aviso no console como “version is required. please specify a version in your fxmanifest.lua.” quando versão está faltando. Adicione uma versão '1.0.0' linha para limpá-lo. A linha opcional lua54 'sim' habilita o Lua 5.4 para o recurso e é necessária por muitos frameworks e bibliotecas atuais.

Scripts de cliente, servidor e compartilhados

fx_version 'cerulean'\ngame 'gta5'\n\nshared_scripts {\n 'config.lua',\n '@ox_lib\/init.lua'\n}\n\nclient_scripts {\n 'client\/*.lua'\n}\n\nserver_scripts {\n '@oxmysql\/lib\/MySQL.lua',\n 'server\/*.lua'\n}

Usar scripts compartilhados Use apenas arquivos seguros para ambas as partes. Não inclua segredos de servidor, chaves de licença, senhas de banco de dados ou URLs de webhook em arquivos compartilhados.

Exemplo de recurso NUI

fx_version 'cerulean'\ngame 'gta5'\n\nui_page 'web\/index.html'\n\nfiles {\n 'web\/index.html',\n 'web\/style.css',\n 'web\/app.js'\n}\n\nclient_script 'client.lua'

Se a interface do usuário estiver em branco no jogo, verifique se todos os arquivos HTML, CSS, JavaScript, fontes e imagens estão listados em arquivos. Arquivos ausentes são uma causa comum de telas quebradas no modelo NUI.

Exemplo de mapa ou recurso MLO

fx_version 'cerulean'\ngame 'gta5'\n\nthis_is_a_map 'yes'\n\nfiles {\n 'stream\/*.ymap',\n 'stream\/*.ytyp'\n}

Para mapas e interiores, mantenha os arquivos transmitidos em um fluxo Acesse a pasta e verifique se o recurso inicia sem avisos no console. Se um mapa não carregar, use o console FiveM e os logs do txAdmin antes de editar recursos não relacionados.

Erros comuns

  • Usando __recurso.lua em um novo recurso.
  • Colocando servidor.lua sob scripts do cliente.
  • Esquecendo arquivos NUI em arquivos.
  • Guardando segredos scripts compartilhados.
  • Pastas com erros ortográficos, especialmente cliente, servidor, e fluxo.

Lista de verificação de validação

  1. A pasta de recursos contém fxmanifest.lua no nível mais alto.
  2. jogo 'gta5' está presente para FiveM.
  3. Os arquivos do cliente são carregados no cliente, os arquivos do servidor são carregados no servidor.
  4. Todos os arquivos NUI/estáticos estão listados em arquivos.
  5. servidor.cfg inclui garantir nome do recurso.

Guias relacionados

Ordem de dependência no arquivo server.cfg

O manifesto informa ao FiveM quais arquivos pertencem a um recurso, mas servidor.cfg Ainda controla a ordem de inicialização. Inicie as bibliotecas compartilhadas e as dependências do framework antes dos recursos que as utilizam.

garantir oxmysql garantir ox_lib garantir qb-core garantir meu-script

Se um recurso gerar erros de exportação na inicialização, verifique se a dependência está instalada, nomeada corretamente e garantida antes do script que a chama.

Notas específicas da estrutura

Os recursos ESX, QBCore e Qbox geralmente precisam de importações de frameworks, bibliotecas de banco de dados e arquivos de configuração. Mantenha a configuração do framework em arquivos documentados. Não oculte configurações importantes em arquivos aleatórios do cliente. Um manifesto limpo facilita o suporte, pois a equipe pode ver todos os arquivos carregados.

Revise a lista de verificação antes de publicar um roteiro.

  • Não há segredos em arquivos compartilhados ou de clientes.
  • Não há arquivos de teste não utilizados listados no manifesto.
  • Todos os ativos NUI listados em arquivos.
  • As dependências estão documentadas no arquivo README ou na descrição do produto.
  • O recurso inicia corretamente após uma reinicialização completa do servidor.

A ordem das dependências ainda é importante

O manifesto informa ao FXServer quais arquivos pertencem a um recurso, mas servidor.cfg ainda controla a ordem de inicialização. Inicie bibliotecas compartilhadas, frameworks e dependências de banco de dados antes dos scripts que os chamam. Se um recurso gerar erros de exportação na inicialização, verifique o nome e a ordem da dependência antes de editar o script em si.

garantir oxmysql garantir ox_lib garantir qb-core garantir meu-script

Revise antes de enviar um recurso

Verifique se os arquivos do cliente não contêm segredos, os arquivos do servidor não são enviados ao cliente, os ativos NUI estão listados em arquivos, e as dependências são nomeadas exatamente como estão instaladas. Um manifesto funcional deve tornar o recurso compreensível para outro desenvolvedor sem abrir cada arquivo Lua.

Se um script usa exports de framework, bibliotecas de banco de dados ou configuração compartilhada, documente isso no README ou nas notas do produto. A maioria dos problemas de instalação vem de dependências ausentes ou ordem de inicialização incorreta, e não da sintaxe do manifesto em si.

Após editar o manifesto, reinicie o servidor completo uma vez. Recarregamentos a quente podem ocultar arquivos ausentes ou problemas de ordem que só aparecem em uma inicialização limpa.

Se a inicialização limpa falhar, leia o primeiro erro, não a última cascata de erros depois que as dependências já estão quebradas.

camadas fxmanifest.lua para metadados, scripts, dependências e arquivos
Um manifesto de recurso declara metadados, scripts executáveis, dependências e arquivos empacotados.

Leia um fxmanifest em quatro camadas

  • Metadados: declarar a versão do FX, jogo suportado e detalhes úteis do autor, descrição e versão.
  • Roteiros: separar a execução do cliente, servidor e compartilhada deliberadamente; não exponha a lógica exclusiva do servidor para os clientes.
  • Dependências: estado de recursos ou restrições de tempo de execução que devem existir antes que este recurso possa ser executado.
  • Arquivos: incluir NUI e ativos de dados que os clientes precisam. Cfx.re observa que um local página_ui e suas dependências devem ser referenciados em arquivos.

O manifesto é Lua semi-declarativo executado separadamente dos scripts do recurso. Mantenha-o explícito, remova entradas obsoletas e verifique cada caminho referenciado em um sistema de arquivos de produção sensível a maiúsculas e minúsculas.

Referência de manifesto de recurso Cfx.re

Deixe um comentário