{"id":162266,"date":"2024-10-11T19:42:29","date_gmt":"2024-10-11T17:42:29","guid":{"rendered":"https:\/\/hifivem.com\/?p=162266"},"modified":"2026-07-20T12:36:25","modified_gmt":"2026-07-20T10:36:25","slug":"configurando-fxmanifest-lua-fivem","status":"publish","type":"post","link":"https:\/\/fivemx.com\/pt\/configurando-fxmanifest-lua-fivem\/","title":{"rendered":"Configurando fxmanifest.lua para FiveM (Exemplos para Copiar e Colar)"},"content":{"rendered":"<p><strong>Resposta r\u00e1pida:<\/strong> todo recurso FiveM precisa de um <code>fxmanifest.lua<\/code> arquivo na pasta de recursos. Ele informa ao FXServer qual jogo o recurso suporta, quais scripts carregar e quais arquivos v\u00e3o para os clientes. Abaixo est\u00e3o exemplos para copiar e colar para um recurso de script padr\u00e3o, scripts compartilhados\/cliente\/servidor, recursos NUI (<code>p\u00e1gina_ui<\/code> + <code>arquivos<\/code>), e mapas (<code>este_\u00e9_um_mapa &#039;sim&#039;<\/code> ) com streams de ymap), al\u00e9m de corre\u00e7\u00f5es para erros comuns no manifesto.<\/p>\n<p><em>\u00daltima atualiza\u00e7\u00e3o: 25 de junho de 2026<\/em><\/p>\n<h2>Fxmanifest.lua m\u00ednimo<\/h2>\n<pre><code>fx_version &#039;cerulean&#039; game &#039;gta5&#039; client_script &#039;client.lua&#039; server_script &#039;server.lua&#039;'<\/code><\/pre>\n<p>A documenta\u00e7\u00e3o oficial do manifesto de recursos do Cfx.re identifica <code>fxmanifest.lua<\/code> como o arquivo de manifesto atual e observa que o antigo <code>__recurso.lua<\/code> Os manifestos est\u00e3o obsoletos. Use <code>fx_version &#039;cer\u00faleo&#039;<\/code> para recursos FiveM modernos, a menos que o autor do recurso documente um requisito diferente.<\/p>\n<h2>Exemplo completo com metadados<\/h2>\n<pre><code>fx_version 'cerulean'\ngame 'gta5'\n\nauthor 'Seu Nome'\ndescription 'Exemplo de recurso FiveM'\nversion '1.0.0'\n\nlua54 'yes'\n\nshared_script 'config.lua'\nclient_script 'client.lua'\nserver_script 'server.lua'<\/code><\/pre>\n<p>O <code>autor<\/code>, <code>descri\u00e7\u00e3o<\/code>, e <code>vers\u00e3o<\/code> os campos s\u00e3o metadados: eles n\u00e3o alteram como os scripts s\u00e3o executados, mas o FXServer imprime um aviso no console como \u201cversion is required. please specify a version in your fxmanifest.lua.\u201d quando <code>vers\u00e3o<\/code> est\u00e1 faltando. Adicione uma <code>vers\u00e3o &#039;1.0.0&#039;<\/code> linha para limp\u00e1-lo. A linha opcional <code>lua54 &#039;sim&#039;<\/code> habilita o Lua 5.4 para o recurso e \u00e9 necess\u00e1ria por muitos frameworks e bibliotecas atuais.<\/p>\n<h2>Scripts de cliente, servidor e compartilhados<\/h2>\n<pre><code>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}<\/code><\/pre>\n<p>Usar <code>scripts compartilhados<\/code> Use apenas arquivos seguros para ambas as partes. N\u00e3o inclua segredos de servidor, chaves de licen\u00e7a, senhas de banco de dados ou URLs de webhook em arquivos compartilhados.<\/p>\n<h2>Exemplo de recurso NUI<\/h2>\n<pre><code>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'<\/code><\/pre>\n<p>Se a interface do usu\u00e1rio estiver em branco no jogo, verifique se todos os arquivos HTML, CSS, JavaScript, fontes e imagens est\u00e3o listados em <code>arquivos<\/code>. Arquivos ausentes s\u00e3o uma causa comum de telas quebradas no modelo NUI.<\/p>\n<h2>Exemplo de mapa ou recurso MLO<\/h2>\n<pre><code>fx_version 'cerulean'\\ngame 'gta5'\\n\\nthis_is_a_map 'yes'\\n\\nfiles {\\n 'stream\\\/*.ymap',\\n 'stream\\\/*.ytyp'\\n}<\/code><\/pre>\n<p>Para mapas e interiores, mantenha os arquivos transmitidos em um <code>fluxo<\/code> Acesse a pasta e verifique se o recurso inicia sem avisos no console. Se um mapa n\u00e3o carregar, use o console FiveM e os logs do txAdmin antes de editar recursos n\u00e3o relacionados.<\/p>\n<h2>Erros comuns<\/h2>\n<ul>\n<li>Usando <code>__recurso.lua<\/code> em um novo recurso.<\/li>\n<li>Colocando <code>servidor.lua<\/code> sob <code>scripts do cliente<\/code>.<\/li>\n<li>Esquecendo arquivos NUI em <code>arquivos<\/code>.<\/li>\n<li>Guardando segredos <code>scripts compartilhados<\/code>.<\/li>\n<li>Pastas com erros ortogr\u00e1ficos, especialmente <code>cliente<\/code>, <code>servidor<\/code>, e <code>fluxo<\/code>.<\/li>\n<\/ul>\n<h2>Lista de verifica\u00e7\u00e3o de valida\u00e7\u00e3o<\/h2>\n<ol>\n<li>A pasta de recursos cont\u00e9m <code>fxmanifest.lua<\/code> no n\u00edvel mais alto.<\/li>\n<li><code>jogo &#039;gta5&#039;<\/code> est\u00e1 presente para FiveM.<\/li>\n<li>Os arquivos do cliente s\u00e3o carregados no cliente, os arquivos do servidor s\u00e3o carregados no servidor.<\/li>\n<li>Todos os arquivos NUI\/est\u00e1ticos est\u00e3o listados em <code>arquivos<\/code>.<\/li>\n<li><code>servidor.cfg<\/code> inclui <code>garantir nome do recurso<\/code>.<\/li>\n<\/ol>\n<h2>Guias relacionados<\/h2>\n<ul>\n<li><a href=\"https:\/\/fivemx.com\/pt\/introducao-lua-scripting\/\">Introdu\u00e7\u00e3o \u00e0 linguagem de script Lua para FiveM<\/a><\/li>\n<li><a href=\"https:\/\/fivemx.com\/pt\/escrever-scripts-fivem-usando-ia\/\">Como escrever scripts FiveM usando IA<\/a><\/li>\n<li><a href=\"https:\/\/fivemx.com\/pt\/como-verificar-se-ha-erros-nos-logs-do-txadmin\/\">Como verificar os logs do txAdmin<\/a><\/li>\n<\/ul>\n<section data-fivemx-rework-extra=\"2026-06-25\">\n<h2>Ordem de depend\u00eancia no arquivo server.cfg<\/h2>\n<p>O manifesto informa ao FiveM quais arquivos pertencem a um recurso, mas <code>servidor.cfg<\/code> Ainda controla a ordem de inicializa\u00e7\u00e3o. Inicie as bibliotecas compartilhadas e as depend\u00eancias do framework antes dos recursos que as utilizam.<\/p>\n<pre><code>garantir oxmysql garantir ox_lib garantir qb-core garantir meu-script<\/code><\/pre>\n<p>Se um recurso gerar erros de exporta\u00e7\u00e3o na inicializa\u00e7\u00e3o, verifique se a depend\u00eancia est\u00e1 instalada, nomeada corretamente e garantida antes do script que a chama.<\/p>\n<h2>Notas espec\u00edficas da estrutura<\/h2>\n<p>Os recursos ESX, QBCore e Qbox geralmente precisam de importa\u00e7\u00f5es de frameworks, bibliotecas de banco de dados e arquivos de configura\u00e7\u00e3o. Mantenha a configura\u00e7\u00e3o do framework em arquivos documentados. N\u00e3o oculte configura\u00e7\u00f5es importantes em arquivos aleat\u00f3rios do cliente. Um manifesto limpo facilita o suporte, pois a equipe pode ver todos os arquivos carregados.<\/p>\n<h2>Revise a lista de verifica\u00e7\u00e3o antes de publicar um roteiro.<\/h2>\n<ul>\n<li>N\u00e3o h\u00e1 segredos em arquivos compartilhados ou de clientes.<\/li>\n<li>N\u00e3o h\u00e1 arquivos de teste n\u00e3o utilizados listados no manifesto.<\/li>\n<li>Todos os ativos NUI listados em <code>arquivos<\/code>.<\/li>\n<li>As depend\u00eancias est\u00e3o documentadas no arquivo README ou na descri\u00e7\u00e3o do produto.<\/li>\n<li>O recurso inicia corretamente ap\u00f3s uma reinicializa\u00e7\u00e3o completa do servidor.<\/li>\n<\/ul>\n<\/section>\n<section data-fivemx-quality-wave=\"2026-07-01:162266\">\n<h2>A ordem das depend\u00eancias ainda \u00e9 importante<\/h2>\n<p>O manifesto informa ao FXServer quais arquivos pertencem a um recurso, mas <code>servidor.cfg<\/code> ainda controla a ordem de inicializa\u00e7\u00e3o. Inicie bibliotecas compartilhadas, frameworks e depend\u00eancias de banco de dados antes dos scripts que os chamam. Se um recurso gerar erros de exporta\u00e7\u00e3o na inicializa\u00e7\u00e3o, verifique o nome e a ordem da depend\u00eancia antes de editar o script em si.<\/p>\n<pre><code>garantir oxmysql garantir ox_lib garantir qb-core garantir meu-script<\/code><\/pre>\n<h2>Revise antes de enviar um recurso<\/h2>\n<p>Verifique se os arquivos do cliente n\u00e3o cont\u00eam segredos, os arquivos do servidor n\u00e3o s\u00e3o enviados ao cliente, os ativos NUI est\u00e3o listados em <code>arquivos<\/code>, e as depend\u00eancias s\u00e3o nomeadas exatamente como est\u00e3o instaladas. Um manifesto funcional deve tornar o recurso compreens\u00edvel para outro desenvolvedor sem abrir cada arquivo Lua.<\/p>\n<p>Se um script usa exports de framework, bibliotecas de banco de dados ou configura\u00e7\u00e3o compartilhada, documente isso no README ou nas notas do produto. A maioria dos problemas de instala\u00e7\u00e3o vem de depend\u00eancias ausentes ou ordem de inicializa\u00e7\u00e3o incorreta, e n\u00e3o da sintaxe do manifesto em si.<\/p>\n<p>Ap\u00f3s editar o manifesto, reinicie o servidor completo uma vez. Recarregamentos a quente podem ocultar arquivos ausentes ou problemas de ordem que s\u00f3 aparecem em uma inicializa\u00e7\u00e3o limpa.<\/p>\n<p>Se a inicializa\u00e7\u00e3o limpa falhar, leia o primeiro erro, n\u00e3o a \u00faltima cascata de erros depois que as depend\u00eancias j\u00e1 est\u00e3o quebradas.<\/p>\n<\/section>\n<section data-fivemx-layout-content-perfection=\"2026-07-11\">\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" src=\"https:\/\/fivemx.com\/wp-content\/uploads\/2026\/07\/162266-fxmanifest-anatomy.webp\" alt=\"camadas fxmanifest.lua para metadados, scripts, depend\u00eancias e arquivos\" width=\"1600\" height=\"900\"><figcaption>Um manifesto de recurso declara metadados, scripts execut\u00e1veis, depend\u00eancias e arquivos empacotados.<\/figcaption><\/figure>\n<h2>Leia um fxmanifest em quatro camadas<\/h2>\n<ul>\n<li><strong>Metadados:<\/strong> declarar a vers\u00e3o do FX, jogo suportado e detalhes \u00fateis do autor, descri\u00e7\u00e3o e vers\u00e3o.<\/li>\n<li><strong>Roteiros:<\/strong> separar a execu\u00e7\u00e3o do cliente, servidor e compartilhada deliberadamente; n\u00e3o exponha a l\u00f3gica exclusiva do servidor para os clientes.<\/li>\n<li><strong>Depend\u00eancias:<\/strong> estado de recursos ou restri\u00e7\u00f5es de tempo de execu\u00e7\u00e3o que devem existir antes que este recurso possa ser executado.<\/li>\n<li><strong>Arquivos:<\/strong> incluir NUI e ativos de dados que os clientes precisam. Cfx.re observa que um local <code>p\u00e1gina_ui<\/code> e suas depend\u00eancias devem ser referenciados em <code>arquivos<\/code>.<\/li>\n<\/ul>\n<p>O manifesto \u00e9 Lua semi-declarativo executado separadamente dos scripts do recurso. Mantenha-o expl\u00edcito, remova entradas obsoletas e verifique cada caminho referenciado em um sistema de arquivos de produ\u00e7\u00e3o sens\u00edvel a mai\u00fasculas e min\u00fasculas.<\/p>\n<p><a href=\"https:\/\/docs.fivem.net\/docs\/scripting-reference\/resource-manifest\/\" rel=\"nofollow noopener\" target=\"_blank\">Refer\u00eancia de manifesto de recurso Cfx.re<\/a><\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Fast answer: every FiveM resource needs an fxmanifest.lua file in the resource folder. It tells FXServer which game the resource supports, which scripts to load, and which files go to clients. Below are copy-paste examples for a standard script resource, shared\/client\/server scripts, NUI resources (ui_page + files), and maps (this_is_a_map &#8216;yes&#8217; with ymap streams), plus [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":162267,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2340,1899],"tags":[3001],"class_list":["post-162266","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-lua-scripting","category-tutorials","tag-fivem-script"],"_links":{"self":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/162266","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/comments?post=162266"}],"version-history":[{"count":6,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/162266\/revisions"}],"predecessor-version":[{"id":213809,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/posts\/162266\/revisions\/213809"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/media\/162267"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/media?parent=162266"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/categories?post=162266"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/pt\/wp-json\/wp\/v2\/tags?post=162266"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}