Cómo instalar un script (recurso) de FiveM paso a paso

Para instalar un script de FiveM, copia la carpeta de su recurso (la que contiene fxmanifest.lua) en el directorio resources de tu servidor, inicia primero sus dependencias, configúralo, añade una línea ensure después de ellas en server.cfg y lee la consola. Haz una copia de seguridad antes.

Revisado con la documentación enlazada de Cfx.re y de los frameworks el 2026-10-13. Esto es una revisión de documentación, no una prueba práctica: RPScripts no ha ejecutado estos pasos en un entorno de pruebas aislado. Los pasos asumen GTA V Legacy; Enhanced solo se señala en el paso 1. Todo lo que está escrito en monospace, como resource_name, es un marcador de posición para tu propio valor.

Paso 1: Comprueba la edición, el framework y las dependencias

Lee la página del producto o el readme y anota: el framework (ESX, QBCore, Qbox o standalone), las librerías necesarias, los recursos de inventario y target, y la edición de GTA V que admite. Una insignia de framework no te dice la edición.

La página Legacy/Enhanced de Cfx.re describe un servidor Enhanced con archivos de servidor de nombres distintos, una carpeta stream_enhanced para los assets que difieren de stream, y lista Asset Escrow como “Not implemented yet” para Enhanced. Pregunta al creador por la versión exacta si usas Enhanced. Contexto: FiveM Standard vs Enhanced: ¿qué versión debes usar?.

Comprobación de éxito: puedes enumerar framework, edición y dependencias a partir del propio texto del creador. Si no puedes: detente y pregunta al vendedor antes de instalar.

Paso 2: Haz una copia de seguridad para poder revertir

Copia server.cfg, las carpetas de recursos que vas a cambiar y cualquier archivo compartido de objetos o trabajos, y exporta la base de datos. Prueba primero la instalación en un servidor de pruebas con una base de datos de pruebas. Consulta Cómo hacer una copia de seguridad y restaurar un servidor de FiveM.

Comprobación de éxito: sabes dónde están las copias y qué archivo restaurarías primero.

Paso 3: Descomprime y localiza la carpeta del recurso

Extrae el archivo comprimido. Un recurso es una carpeta que tiene fxmanifest.lua directamente dentro; la introducción a los recursos de Cfx.re dice: “Every resource is required to contain a resource manifest by the name of fxmanifest.lua”. Una misma descarga puede contener varios recursos, y un zip puede añadir una carpeta contenedora extra.

Comprobación de éxito: cada carpeta que vas a copiar tiene fxmanifest.lua en su nivel superior, no una carpeta más abajo. Evidencia si algo falla: un listado de la carpeta que muestre dónde está el manifiesto.

Descarga la versión correcta. Dos ejemplos documentados indican usar una release, no el archivo de código fuente del repositorio: la documentación de QBCore dice que uses el build de release de oxmysql, y la documentación de ox_inventory dice que la interfaz debe venir empaquetada (bundled) y recomienda la release ya empaquetada (ox_inventory.zip).

Paso 4: Colócalo en resources y conserva el nombre de la carpeta

Mueve cada carpeta de recurso a resources, o a una carpeta con corchetes como resources/[scripts]. Los comandos de servidor de Cfx.re aceptan nombres entre corchetes como categorías, por ejemplo start [cars].

En el árbol de ejemplo de Cfx.re, el recurso se llama como su carpeta, así que el nombre de la carpeta es el nombre que pasas a ensure; los scripts que dependen de él suelen referirse a él con ese nombre. La página de Cfx.re dice que eres libre de nombrar las carpetas como quieras, pero renombrar un script comprado es un riesgo que RPScripts desaconseja, salvo que el creador lo indique.

Comprobación de éxito: la ruta queda como resources/[optional_group]/resource_name/fxmanifest.lua. En Linux, las mayúsculas y minúsculas importan.

Paso 5: Lee el manifiesto

Abre fxmanifest.lua sin modificarlo. La referencia del manifiesto lista fx_version y game (gta5 funciona en FiveM, rdr3 en RedM), y dice de dependency: “Requires the specified resource to load before the current resource.” Todos los archivos nombrados en client_script, server_script, shared_script o files deben existir en la carpeta. Para escribir uno tú mismo, consulta Cómo escribir y comprobar un fxmanifest.lua de FiveM y el generador de fxmanifest.

Comprobación de éxito: puedes nombrar cada dependencia y cada archivo listado existe.

Paso 6: Instala e inicia las dependencias

Dependencia	Por qué importa	Fuente
oxmysql	Acceso a la base de datos. Define mysql_connection_string con set antes de que arranque cualquier recurso, e inicia oxmysql al principio de la lista.	documentación de oxmysql
ox_lib	Se usa mediante shared_scripts { '@ox_lib/init.lua' } en el manifiesto de un recurso, por lo que la librería debe estar instalada.	documentación de ox_lib
Framework	es_extended, qb-core o qbx_core deben estar en marcha antes que los scripts que los usan.	Consulta la tabla de frameworks en el paso 12
Inventario y target	Deben coincidir con las opciones de la config del script (por ejemplo, ox_inventory frente a qb-inventory).	El readme del script

Listar tú mismo cada dependencia en server.cfg, en orden, es una precaución de RPScripts, no un requisito documentado.

Comprobación de éxito: cada dependencia está instalada y ya funciona por sí sola.

Paso 7: Importa el SQL con cuidado

Solo algunos scripts incluyen un archivo .sql. Léelo antes de ejecutarlo: DROP TABLE, TRUNCATE, DELETE, REPLACE y ALTER TABLE pueden eliminar o cambiar datos existentes, y CREATE TABLE IF NOT EXISTS no comprueba que una tabla existente tenga las columnas correctas. Un archivo de instalación nueva no es una actualización. Importa en la base de datos indicada en tu cadena de conexión, primero en la base de pruebas. Detalles y errores comunes: archivos SQL y errores de base de datos.

La página de instalación de Qbox exige MariaDB 10.9.0 o superior, no MySQL. Comprueba tu propio motor de base de datos con el requisito del framework antes de importar.

Comprobación de éxito: la importación no informa de errores y existen las tablas esperadas. Evidencia si falla: la sentencia que falló y el error exacto, sin contraseñas.

Paso 8: Configúralo

Edita config.lua (o la carpeta config) para que las opciones de framework, inventario, target y notificaciones apunten a recursos que realmente ejecutas. Registra los objetos que necesite el script en el sistema de objetos de tu framework. Las notas por framework están en la tabla del paso 12.

Comprobación de éxito: cada nombre de recurso de la config existe en tu carpeta resources.

Paso 9: Añade la línea ensure en el orden correcto

# server.cfg (placeholders: use your own framework and resources)
set mysql_connection_string "..."   # your own value, keep it private
ensure oxmysql
ensure ox_lib
ensure your_framework
ensure your_inventory_and_target

ensure resource_name

La documentación de oxmysql dice que añadas start oxmysql “to the top of your resource list” y la página de ox_inventory para Qbox dice que lo inicies “immediately after qbx_core”, así que el orden importa. Tu script va después de todo aquello de lo que depende. Orden de arranque por framework: QBCore, ESX, Qbox; referencia general: Configura el server.cfg de FiveM y verifica tus cambios y el generador de server.cfg. Los comentarios en server.cfg empiezan por #, como en la plantilla de QBCore.

Comprobación de éxito: tu línea queda debajo de la línea de cada dependencia.

Paso 10: Inícialo y comprueba el resultado

La página de comandos de servidor de Cfx.re documenta refresh, que vuelve a escanear resources y carga los manifiestos para que se puedan iniciar recursos nuevos, y ensure, que inicia un recurso o lo reinicia si ya está en marcha. En la consola del servidor ejecuta refresh y luego ensure resource_name; reiniciar el servidor también lo carga. Tras añadir objetos, trabajos o SQL, RPScripts sugiere un reinicio completo como precaución (consejo editorial, no una afirmación de Cfx.re).

1. Ninguna línea de error menciona resource_name en la consola del servidor.
2. Entra con una cuenta de prueba y pulsa F8: ninguna línea de error para el recurso.
3. Usa la función (abre su menú, usa el objeto, entra en el mapa).
4. Vuelve a conectarte y reinicia una vez para confirmar que los datos guardados se conservan.

Evidencia que debes recopilar si falla alguna comprobación: la primera línea de error tras el arranque (no la última), el nombre del recurso, tu framework y su versión, el número de artifact de FXServer, la edición y el bloque de ensure por encima y por debajo de tu línea. Si no arranca, continúa con Un recurso de FiveM no arranca: soluciona los errores según el mensaje de la consola.

Paso 11: Revierte limpiamente

Ejecuta stop resource_name, pon un # delante de su línea ensure y después restaura los archivos de config y la base de datos desde tu copia de seguridad del paso 2. Conserva la exportación de la base de datos del paso 2, porque un archivo SQL importado a medias no se deshace al detener el recurso.

Paso 12: Diferencias entre frameworks

Framework	Recurso principal	Objetos y datos	Fuente
ESX	es_extended	Los objetos y trabajos viven en tablas de la base de datos, salvo que uses ox_inventory (consulta las notas de ESX de RPScripts). La página de solución de problemas de ESX lista “Error ESX = nil” con la solución “update your es_extended to the latest version”.	documentación de ESX
QBCore	qb-core	La plantilla inicia ensure qb-core, luego ensure [qb] y [standalone].	documentación de QBCore
Qbox	qbx_core	Usa ox_inventory: añade setr inventory:framework "qbx" antes de que arranquen los recursos e inicia ox_inventory justo después de qbx_core.	configuración de ox_inventory para Qbox
Standalone	ninguno	Solo necesita lo que nombra su readme.	Creador

Un script hecho para un framework no se instala en otro solo copiándolo; consulta Convierte scripts de FiveM entre ESX, QBCore y Qbox. RPScripts vende scripts, así que este enlace de categoría es comercial: Scripts de QBCore. Los pasos de aquí valen para un recurso de cualquier origen.

Recursos protegidos con escrow

Los recursos protegidos con Cfx.re Asset Escrow suelen contener un archivo .fxap; consulta ¿Qué es un archivo .fxap en un recurso de FiveM?. No edites, fusiones ni borres los archivos protegidos. Según la documentación de Cfx.re Asset Escrow, un servidor sin el derecho de acceso (entitlement) correcto no puede iniciar el recurso e imprime “You lack the required entitlement” en la consola; las soluciones están en Cómo solucionar el error de entitlement requerido de FiveM. La documentación describe una directiva escrow_ignore que permite al creador dejar sin proteger ciertos archivos, como una config; edita solo los archivos que nombre el creador. La documentación de vendedores indica que las transferencias de archivos corruptas rompen los recursos con escrow. JG Scripts dice que subas el .zip tal cual y lo extraigas después de la transferencia, en lugar de transferir los archivos uno a uno, y que FileZilla puede corromper archivos (prueba WinSCP); Lation dice que FileZilla corrompe con frecuencia los archivos con escrow y recomienda WinSCP. Eso es una guía de los proveedores, no una afirmación de Cfx.re.

FAQ

¿Necesito reiniciar el servidor después de añadir un script?

No siempre. refresh y luego ensure resource_name carga un recurso nuevo, según la documentación de Cfx.re. Tras añadir objetos, trabajos o cambios de SQL, un reinicio completo es una precaución de RPScripts.

¿Puedo instalar un script de QBCore en ESX o Qbox?

No solo copiándolo. Comprueba la página del producto para tu framework; un script que llama al inventario o a las funciones principales de otro framework necesita una conversión o un bridge que documente el creador.