{"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-09T12:55:29","modified_gmt":"2026-08-09T10:55:29","slug":"configuracion-de-fxmanifest-lua-fivem","status":"publish","type":"post","link":"https:\/\/fivemx.com\/es\/configuracion-de-fxmanifest-lua-fivem\/","title":{"rendered":"Configuraci\u00f3n de fxmanifest.lua para FiveM (Ejemplos de copia y pegado)"},"content":{"rendered":"<p><strong>Respuesta r\u00e1pida:<\/strong> cada recurso FiveM necesita un <code data-no-translation=\"\">fxmanifest.lua<\/code> archivo en la carpeta de recursos. Le indica a FXServer a qu\u00e9 juego apoya el recurso, qu\u00e9 scripts cargar y qu\u00e9 archivos van a los clientes. A continuaci\u00f3n se presentan ejemplos para copiar y pegar para un recurso de script est\u00e1ndar, scripts compartidos\/cliente\/servidor, recursos NUI (<code data-no-translation=\"\">ui_page<\/code> + <code data-no-translation=\"\">files<\/code>), y mapas (<code data-no-translation=\"\">this_is_a_map 'yes'<\/code> con flujos de ymap), adem\u00e1s de correcciones para errores comunes del manifiesto.<\/p>\n<p><em>\u00daltima actualizaci\u00f3n: 25 de junio de 2026<\/em><\/p>\n<h2>fxmanifest.lua m\u00ednimo<\/h2>\n<pre data-no-translation=\"\"><code data-no-translation=\"\">fx_version 'cerulean'\ngame 'gta5'\n\nclient_script 'client.lua'\nserver_script 'server.lua'<\/code><\/pre>\n<p>La documentaci\u00f3n oficial de manifiesto de recursos de Cfx.re identifica <code data-no-translation=\"\">fxmanifest.lua<\/code> como el archivo de manifiesto actual y se\u00f1ala que los <code data-no-translation=\"\">__resource.lua<\/code> manifiestos antiguos est\u00e1n obsoletos. Usa <code data-no-translation=\"\">fx_version 'cerulean'<\/code> para recursos modernos de FiveM a menos que el autor del recurso documente un requisito diferente.<\/p>\n<h2>Ejemplo completo con metadatos<\/h2>\n<pre data-no-translation=\"\"><code data-no-translation=\"\">fx_version 'cerulean'\ngame 'gta5'\n\nauthor 'Your Name'\ndescription 'Example FiveM resource'\nversion '1.0.0'\n\nlua54 'yes'\n\nshared_script 'config.lua'\nclient_script 'client.lua'\nserver_script 'server.lua'<\/code><\/pre>\n<p>El <code data-no-translation=\"\">author<\/code>, <code data-no-translation=\"\">description<\/code>, y <code data-no-translation=\"\">version<\/code> los campos son metadatos: no cambian c\u00f3mo se ejecutan los scripts, pero FXServer imprime una advertencia en la consola como \u201cversion es requerido. por favor especifica una versi\u00f3n en tu fxmanifest.lua.\u201d cuando <code data-no-translation=\"\">version<\/code> falta. Agrega una <code data-no-translation=\"\">version '1.0.0'<\/code> l\u00ednea para eliminarlo. La l\u00ednea opcional <code data-no-translation=\"\">lua54 'yes'<\/code> habilita Lua 5.4 para el recurso y es requerida por muchos frameworks y bibliotecas actuales.<\/p>\n<h2>Scripts de cliente, servidor y compartidos<\/h2>\n<pre data-no-translation=\"\"><code data-no-translation=\"\">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 data-no-translation=\"\">shared_scripts<\/code> solo para archivos que sean seguros en ambos lados. No pongas secretos del servidor, claves de licencia, contrase\u00f1as de bases de datos ni URLs de webhook en archivos compartidos.<\/p>\n<h2>Ejemplo de recurso NUI<\/h2>\n<pre data-no-translation=\"\"><code data-no-translation=\"\">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>Si un UI aparece en blanco en el juego, verifica que cada archivo HTML, CSS, JavaScript, fuente e imagen est\u00e9 listado bajo <code data-no-translation=\"\">files<\/code>. Los archivos faltantes son una causa com\u00fan de pantallas NUI rotas.<\/p>\n<h2>Ejemplo de recurso de mapa o MLO<\/h2>\n<pre data-no-translation=\"\"><code data-no-translation=\"\">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, mant\u00e9n los archivos de stream en una <code data-no-translation=\"\">stream<\/code> carpeta y verifica que el recurso se inicie sin advertencias en la consola. Si un mapa no carga, usa la consola FiveM y los logs de txAdmin antes de editar recursos no relacionados.<\/p>\n<h2>Errores comunes<\/h2>\n<ul>\n<li>Usando <code data-no-translation=\"\">__resource.lua<\/code> en un nuevo recurso.<\/li>\n<li>Poner <code data-no-translation=\"\">server.lua<\/code> bajo <code data-no-translation=\"\">client_scripts<\/code>.<\/li>\n<li>Olvidar archivos NUI bajo <code data-no-translation=\"\">files<\/code>.<\/li>\n<li>Poner secretos dentro <code data-no-translation=\"\">shared_scripts<\/code>.<\/li>\n<li>Escribir mal nombres de carpetas, especialmente <code data-no-translation=\"\">client<\/code>, <code data-no-translation=\"\">server<\/code>, y <code data-no-translation=\"\">stream<\/code>.<\/li>\n<\/ul>\n<h2>Lista de verificaci\u00f3n<\/h2>\n<ol>\n<li>La carpeta del recurso tiene <code data-no-translation=\"\">fxmanifest.lua<\/code> en el nivel superior.<\/li>\n<li><code data-no-translation=\"\">game 'gta5'<\/code> est\u00e1 presente para FiveM.<\/li>\n<li>Los archivos de cliente se cargan en el cliente, los archivos de servidor se cargan en el servidor.<\/li>\n<li>Cada archivo NUI\/est\u00e1tico est\u00e1 listado bajo <code data-no-translation=\"\">files<\/code>.<\/li>\n<li><code data-no-translation=\"\">server.cfg<\/code> incluye <code data-no-translation=\"\">ensure resource-name<\/code>.<\/li>\n<\/ol>\n<h2>Gu\u00edas relacionadas<\/h2>\n<ul>\n<li><a href=\"https:\/\/fivemx.com\/es\/introduccion-a-los-scripts-de-lua\/\">Introducci\u00f3n a la programaci\u00f3n en Lua para FiveM<\/a><\/li>\n<li><a href=\"https:\/\/fivemx.com\/es\/escribir-scripts-fivem-usando-inteligencia-artificial\/\">C\u00f3mo escribir scripts de FiveM usando IA<\/a><\/li>\n<li><a href=\"https:\/\/fivemx.com\/es\/como-comprobar-los-registros-de-txadmin-en-busca-de-errores\/\">C\u00f3mo revisar los registros de txAdmin<\/a><\/li>\n<\/ul>\n<section data-fivemx-rework-extra=\"2026-06-25\">\n<h2>Orden de dependencias en server.cfg<\/h2>\n<p>El manifiesto le indica a FiveM qu\u00e9 archivos pertenecen a un recurso, pero <code data-no-translation=\"\">server.cfg<\/code> a\u00fan controla el orden de inicio. Inicie las bibliotecas compartidas y las dependencias del framework antes que los recursos que las usan.<\/p>\n<pre data-no-translation=\"\"><code data-no-translation=\"\">ensure oxmysql\nensure ox_lib\nensure qb-core\nensure my-script<\/code><\/pre>\n<p>Si un recurso muestra errores de exportaci\u00f3n al inicio, verifique si la dependencia est\u00e1 instalada, nombrada correctamente y asegurada antes del script que la llama.<\/p>\n<h2>Notas espec\u00edficas del framework<\/h2>\n<p>Los recursos de ESX, QBCore y Qbox a menudo necesitan importaciones del framework, bibliotecas de base de datos y archivos de configuraci\u00f3n. Mantenga la configuraci\u00f3n del framework en archivos documentados. No oculte configuraciones importantes en archivos de cliente aleatorios. Un manifiesto limpio facilita el soporte porque el personal puede ver cada archivo que se carga.<\/p>\n<h2>Lista de verificaci\u00f3n antes de publicar un script<\/h2>\n<ul>\n<li>Sin secretos en archivos compartidos o de cliente.<\/li>\n<li>No hay archivos de prueba no utilizados listados en el manifiesto.<\/li>\n<li>Todos los activos NUI listados bajo <code data-no-translation=\"\">files<\/code>.<\/li>\n<li>Dependencias documentadas en el README o la descripci\u00f3n del producto.<\/li>\n<li>El recurso se inicia correctamente despu\u00e9s de un reinicio completo del servidor.<\/li>\n<\/ul>\n<\/section>\n<section data-fivemx-quality-wave=\"2026-07-01:162266\">\n<h2>El orden de las dependencias a\u00fan importa<\/h2>\n<p>El manifiesto le dice a FXServer qu\u00e9 archivos pertenecen a un recurso, pero <code data-no-translation=\"\">server.cfg<\/code> a\u00fan controla el orden de inicio. Inicie las bibliotecas compartidas, frameworks y dependencias de base de datos antes que los scripts que los llaman. Si un recurso arroja errores de exportaci\u00f3n al iniciar, verifique el nombre y orden de la dependencia antes de editar el script en s\u00ed.<\/p>\n<pre data-no-translation=\"\"><code data-no-translation=\"\">ensure oxmysql\nensure ox_lib\nensure qb-core\nensure my-script<\/code><\/pre>\n<h2>Revise antes de enviar un recurso<\/h2>\n<p>Verifique que los archivos del cliente no contengan secretos, que los archivos del servidor no se env\u00eden al cliente, que los activos NUI est\u00e9n listados bajo <code data-no-translation=\"\">files<\/code>, y las dependencias se nombren exactamente como est\u00e1n instaladas. Un manifiesto funcional deber\u00eda hacer que el recurso sea comprensible para otro desarrollador sin abrir cada archivo Lua.<\/p>\n<p>Si un script utiliza exportaciones de framework, bibliotecas de base de datos o configuraci\u00f3n compartida, documente eso en el README o en las notas del producto. La mayor\u00eda de los problemas de instalaci\u00f3n provienen de dependencias faltantes o un orden de inicio incorrecto, no de la sintaxis del manifiesto en s\u00ed.<\/p>\n<p>Despu\u00e9s de editar el manifiesto, reinicie el servidor completo una vez. Las recargas en caliente pueden ocultar archivos faltantes o problemas de orden que solo aparecen en un inicio limpio.<\/p>\n<p>Si el inicio limpio falla, lea el primer error, no la \u00faltima cascada de errores despu\u00e9s de que las dependencias ya est\u00e9n rotas.<\/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=\"capas de fxmanifest.lua para metadatos, scripts, dependencias y archivos\" width=\"1600\" height=\"900\" title=\"\"><figcaption>Un manifiesto de recurso declara metadatos, scripts ejecutables, dependencias y archivos empaquetados.<\/figcaption><\/figure>\n<h2>Lee un fxmanifest en cuatro capas<\/h2>\n<ul>\n<li><strong>Metadatos:<\/strong> declara la versi\u00f3n de FX, el juego soportado y detalles \u00fatiles del autor, descripci\u00f3n y versi\u00f3n.<\/li>\n<li><strong>Guiones:<\/strong> separar la ejecuci\u00f3n del cliente, servidor y compartida deliberadamente; no expongas la l\u00f3gica solo del servidor a los clientes.<\/li>\n<li><strong>Dependencias:<\/strong> estado de los recursos o restricciones de tiempo de ejecuci\u00f3n que deben existir antes de que este recurso pueda ejecutarse.<\/li>\n<li><strong>Archivos:<\/strong> incluir NUI y activos de datos que los clientes necesitan. Cfx.re notas que un local <code data-no-translation=\"\">ui_page<\/code> y sus dependencias deben ser referenciadas en <code data-no-translation=\"\">files<\/code>.<\/li>\n<\/ul>\n<p>El manifiesto es Lua semi-declarativo ejecutado por separado de los scripts del recurso. Mant\u00e9nlo expl\u00edcito, elimina las entradas obsoletas y verifica cada ruta referenciada en un sistema de archivos de producci\u00f3n sensible a may\u00fasculas y min\u00fasculas.<\/p>\n<p><a href=\"https:\/\/docs.fivem.net\/docs\/scripting-reference\/resource-manifest\/\" rel=\"nofollow noopener\" target=\"_blank\">Referencia de manifiesto de recurso Cfx.re<\/a><\/p>\n<\/section>\n<p><!-- fivemx-blog-portfolio-wave2:2026-08-09:setting-up-fxmanifest-lua-fivem --><\/p>\n<h2>Revisi\u00f3n editorial y pol\u00edtica de fuentes<\/h2>\n<p>Los ejemplos de manifiesto se mantuvieron porque coinciden con el modelo actual de manifiesto de recursos Cfx.re. La referencia oficial del manifiesto es la autoridad para las directivas, y los ejemplos obsoletos <code data-no-translation=\"\">__resource.lua<\/code> no deben introducirse.<\/p>\n<p>Esta p\u00e1gina fue revisada t\u00e9cnicamente el 9 de agosto de 2026. Los comandos y la configuraci\u00f3n deben verificarse con la documentaci\u00f3n principal vinculada y la versi\u00f3n exacta del recurso instalada en el servidor. Pruebe los cambios en el entorno de prueba, registre la l\u00ednea de base y conserve una copia de reversi\u00f3n antes de cambiar la producci\u00f3n.<\/p>","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\/es\/wp-json\/wp\/v2\/posts\/162266","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/comments?post=162266"}],"version-history":[{"count":6,"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/posts\/162266\/revisions"}],"predecessor-version":[{"id":213809,"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/posts\/162266\/revisions\/213809"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/media\/162267"}],"wp:attachment":[{"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/media?parent=162266"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/categories?post=162266"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/fivemx.com\/es\/wp-json\/wp\/v2\/tags?post=162266"}],"curies":[{"name":"gracias","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}