{"id":162266,"date":"2024-10-11T19:42:29","date_gmt":"2024-10-11T17:42:29","guid":{"rendered":"https:\/\/hifivem.com\/?p=162266"},"modified":"2026-08-29T08:59:30","modified_gmt":"2026-08-29T06:59:30","slug":"configurando-fxmanifest-lua-fivem","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/pt\/setting-up-fxmanifest-lua-fivem\/","title":{"rendered":"Configurando fxmanifest.lua para FiveM (Exemplos para Copiar e Colar)"},"content":{"rendered":"<p>Um fxmanifest.lua pertence \u00e0 raiz de um recurso FiveM. Ele declara o jogo suportado, scripts, depend\u00eancias e arquivos entregues ao cliente. Escolha o exemplo que corresponde ao seu recurso e substitua cada nome de arquivo de exemplo por um arquivo que realmente exista.<\/p>\n<p>A configura\u00e7\u00e3o e os exemplos de c\u00f3digo aqui s\u00e3o voltados ao FiveM para GTA V Legacy. O Enhanced tem regras diferentes de runtime e de compatibilidade; verifique <a href=\"https:\/\/docs.fivem.net\/docs\/developers\/legacy-vs-enhanced\/\">as altera\u00e7\u00f5es de Legacy para Enhanced do Cfx.re<\/a> antes de aplic\u00e1-las a um servidor Enhanced.<\/p>\n<h2 id=\"a-minimal-script-resource\">Um recurso de script m\u00ednimo<\/h2>\n<pre data-no-translation=\"\" translate=\"no\"><code data-no-translation=\"\" translate=\"no\">fx_version 'cerulean'\ngame 'gta5'\n\nclient_script 'client.lua'\nserver_script 'server.lua'<\/code><\/pre>\n<p>Use client_script para c\u00f3digo executado no cliente de cada jogador e server_script para c\u00f3digo FXServer. Adicione metadados de autor, descri\u00e7\u00e3o e vers\u00e3o quando \u00fatil. Uma depend\u00eancia pode inspecionar sua vers\u00e3o, mas os metadados de vers\u00e3o n\u00e3o alteram a execu\u00e7\u00e3o. O CfxLua atual usa Lua 5.4; a chave lua54 est\u00e1 obsoleta.<\/p>\n<h2 id=\"shared-files-and-dependencies\">Arquivos compartilhados e depend\u00eancias<\/h2>\n<pre data-no-translation=\"\" translate=\"no\"><code data-no-translation=\"\" translate=\"no\">fx_version 'cerulean'\ngame 'gta5'\n\ndependencies { 'ox_lib', 'oxmysql' }\nshared_scripts { '@ox_lib\/init.lua', 'config.lua' }\nclient_scripts { 'client\/*.lua' }\nserver_scripts { '@oxmysql\/lib\/MySQL.lua', 'server\/*.lua' }<\/code><\/pre>\n<p>Este exemplo requer as bibliotecas nomeadas; omita-as quando seu recurso n\u00e3o as usar. Scripts compartilhados s\u00e3o entregues aos clientes, ent\u00e3o mantenha credenciais, webhooks e verifica\u00e7\u00f5es de autoridade apenas do servidor fora dos arquivos compartilhados. Declare as depend\u00eancias que seu c\u00f3digo realmente precisa e siga sua ordem de inicializa\u00e7\u00e3o documentada.<\/p>\n<h2 id=\"a-browser-interface-with-nui\">Uma interface de navegador com NUI<\/h2>\n<pre data-no-translation=\"\" translate=\"no\"><code data-no-translation=\"\" translate=\"no\">fx_version 'cerulean'\ngame 'gta5'\n\nui_page 'web\/index.html'\nfiles { 'web\/index.html', 'web\/style.css', 'web\/app.js' }\nclient_script 'client.lua'<\/code><\/pre>\n<p>Liste todos os ativos de UI locais necess\u00e1rios, incluindo fontes e imagens. Uma interface em branco requer a verifica\u00e7\u00e3o tanto do caminho da p\u00e1gina quanto dos ativos ausentes. Uma tela de carregamento usa loadscreen e seu pr\u00f3prio ciclo de vida em vez deste exemplo de ui_page.<\/p>\n<h2 id=\"maps-and-additional-archetypes\">Mapas e arqu\u00e9tipos adicionais<\/h2>\n<pre data-no-translation=\"\" translate=\"no\"><code data-no-translation=\"\" translate=\"no\">fx_version 'cerulean'\ngame 'gta5'\n\nthis_is_a_map 'yes'\nfiles { 'stream\/example.ytyp' }\ndata_file 'DLC_ITYP_REQUEST' 'stream\/example.ytyp'<\/code><\/pre>\n<p>Coloque os ativos streamable em stream. O registro YTYP mostrado aqui \u00e9 para um recurso que cont\u00e9m esse arquivo; um recurso simples apenas YMAP n\u00e3o precisa de um YTYP fict\u00edcio. Use a declara\u00e7\u00e3o de data-file exigida pelo tipo de ativo real.<\/p>\n<h2 id=\"start-and-verify\">Iniciar e verificar<\/h2>\n<ol>\n<li>Verifique se a pasta cont\u00e9m fxmanifest.lua diretamente e se todos os caminhos correspondem aos nomes de arquivo reais, incluindo mai\u00fasculas e min\u00fasculas.<\/li>\n<li>Instale as depend\u00eancias declaradas. Adicione ensure seguido pelo nome da pasta de recursos ao server.cfg ap\u00f3s as depend\u00eancias documentadas.<\/li>\n<li>Execute refresh e ensure resource-name no console do servidor de desenvolvimento, substituindo o nome da sua pasta. Leia o primeiro erro de inicializa\u00e7\u00e3o.<\/li>\n<li>Conecte-se, exercite o recurso e inspecione F8, bem como o console do servidor. Teste uma reinicializa\u00e7\u00e3o completa do servidor para detectar erros de depend\u00eancia e empacotamento ocultos por recarregamentos a quente.<\/li>\n<\/ol>\n<h2 id=\"common-errors\">Erros comuns<\/h2>\n<p>Arquivo ausente: compare o caminho exato do manifesto e o nome do arquivo. Exporta\u00e7\u00e3o ausente: verifique a vers\u00e3o da depend\u00eancia e a ordem de inicializa\u00e7\u00e3o. Segredos vis\u00edveis para clientes: mova-os para fora dos arquivos compartilhados\/cliente e substitua os valores expostos por novos valores.<\/p>\n<p>N\u00e3o encurte um manifesto de fornecedor copiando este tutorial sobre ele. Use a <a href=\"https:\/\/docs.fivem.net\/docs\/scripting-reference\/resource-manifest\/\">refer\u00eancia oficial do manifesto<\/a> e <a href=\"https:\/\/docs.fivem.net\/docs\/game-references\/data-files\/\">refer\u00eancia de arquivo de dados<\/a> para entender cada declara\u00e7\u00e3o antes de alter\u00e1-la.<\/p>\n<section id=\"buyer-installation-check\">\n<h2>O que conferir no manifesto de um recurso comprado?<\/h2>\n<p>Compare as depend\u00eancias e os builds declarados com seu servidor antes de iniciar o recurso. Confira se os scripts e arquivos de interface referenciados est\u00e3o presentes. Um manifesto v\u00e1lido descreve o que carregar; n\u00e3o certifica gameplay, desempenho ou integra\u00e7\u00e3o com o framework.<\/p>\n<p><a href=\"https:\/\/docs.fivem.net\/docs\/scripting-reference\/resource-manifest\/\">Refer\u00eancia de manifestos Cfx.re<\/a><\/p>\n<p><a href=\"https:\/\/rpcrate.com\/pt\/loja\/ribsosay-esx\/\">Ver os requisitos do pacote ESX Server Base (by RibSosay)<\/a><\/p>\n<\/section>","protected":false},"excerpt":{"rendered":"<p>Um fxmanifest.lua pertence \u00e0 raiz de um recurso FiveM. Ele declara o jogo suportado, scripts, depend\u00eancias e arquivos entregues ao cliente. Escolha o exemplo que corresponde ao seu recurso e substitua cada nome de arquivo de exemplo por um arquivo que realmente exista.<\/p>","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:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/162266","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/comments?post=162266"}],"version-history":[{"count":7,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/162266\/revisions"}],"predecessor-version":[{"id":217315,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/posts\/162266\/revisions\/217315"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media\/162267"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/media?parent=162266"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/categories?post=162266"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/pt\/wp-json\/wp\/v2\/tags?post=162266"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}