Puedes usar Resources para ampliar tu servidor de FiveM con funciones adicionales. Esto resulta especialmente interesante si planeas proyectos grandes, como un servidor de roleplay o algo similar. Es difícil hacer algo así sin estos Resources adicionales.
FiveM y su comunidad ofrecen una enorme variedad de Resources. En el foro de Cfx.re encontrarás una lista de los Resources más populares: https://forum.cfx.re/c/development/releases/7
La forma más rápida de instalar un Resource es con el FiveM Resource Installer, directamente desde el dashboard. Sube el archivo ZIP y el instalador colocará el Resource en la carpeta correcta, lo añadirá a server.cfg y, si quieres, importará los archivos SQL incluidos a tu base de datos. Más abajo encontrarás el método clásico por SFTP.
El Resource Installer está disponible para servidores de FiveM. Para FiveM Enhanced y RedM, usa el método por SFTP.
Abre el dashboard de tu servidor de FiveM, ve a la pestaña Herramientas y selecciona FiveM Resource Installer. No hace falta que detengas el servidor.
Para poder usarlo, primero debes configurar una plantilla de servidor (Recipe) en txAdmin. Solo entonces existirán server.cfg y la carpeta resources en las que puede escribir el instalador.
Sube el Resource como archivo ZIP. Puedes usar directamente una descarga de GitHub mediante Code → Download ZIP o un ZIP de una versión publicada.
- Se admiten archivos ZIP de hasta 100 MB (máximo 400 MB y 5.000 archivos una vez descomprimidos).
- Si tienes archivos RAR o 7z, vuelve a empaquetarlos como ZIP.
- El instalador elimina las carpetas intermedias innecesarias (por ejemplo,
mi-resource-main) y quita del nombre los sufijos de versión y-main. - Si el archivo contiene varios Resources, el instalador los muestra por separado y los ordena según sus dependencias.
- Los archivos ejecutables, como
.exe,.bato.sh, nunca se guardan en tu servidor.
Antes de instalar nada, el instalador te muestra el contenido del archivo:
- Nombre y carpeta de destino: El nombre puede incluir letras, números y los caracteres
_,.y-(máximo 64 caracteres). En Carpeta en resources/, elige la carpeta de categoría; por ejemplo,[standalone]. Si el archivo no incluye ninguna, se selecciona[local]de forma predeterminada. Con Directamente en resources/ (sin carpeta), el Resource se guardará sin una carpeta de categoría. - Dependencias: Para cada dependencia (por ejemplo, ESX, QBCore, Qbox, ox_lib u oxmysql), verás si está incluida en el archivo, si está en el servidor o si falta en el servidor. Las dependencias que solo aparecen en el código y no en
fxmanifest.luase marcan como sospechosas. - Análisis de seguridad: El instalador comprueba todos los archivos
.luay.jspara detectar patrones de código malicioso conocidos. Si detecta alguno, te avisará. Aun así, puedes instalar el Resource, pero el análisis de seguridad lo desactivará la próxima vez que inicies el servidor. Si crees que se trata de un falso positivo, ponte en contacto con nuestro equipo de soporte. - Archivos SQL: Se muestran los archivos
.sqlincluidos y se indica qué tablas crean, modifican o rellenan.
Si el Resource ya está en tu servidor, el instalador se detendrá de forma predeterminada. Si quieres reemplazarlo (por ejemplo, para actualizarlo), marca la casilla Sobrescribir recurso existente. Se reemplazará toda la carpeta, incluidos tus ajustes, como config.lua. Antes, se guardará una copia de la carpeta anterior en backups/resource-installer/.
Deja marcada la casilla Añadir a server.cfg para que se inicie automáticamente. El instalador añadirá ensure <Name> a server.cfg, después de las dependencias del Resource, en la carpeta activa de tu servidor. Antes, guardará una copia de la server.cfg anterior como server.cfg.bak-….
Haz clic en Instalar en el servidor. Verás el progreso (copia de seguridad, descompresión, colocación, actualización de server.cfg y comprobación del resultado). La instalación continuará aunque cierres la página.
El resultado te indica cómo se inicia el Resource:
- Línea ensure añadida a server.cfg: todo listo.
- ya figuraba en server.cfg: la línea ya existía.
- se inicia mediante la carpeta de categoría:
server.cfgya contieneensure [Categoría], que también inicia el Resource. - Aún falta la línea ensure: añade
ensure <Name>manualmente aserver.cfg(consulta Activación).
Para que FiveM cargue el nuevo Resource, reinicia el servidor con Reiniciar servidor. Como alternativa, escribe refresh y después ensure <Name> en la consola en vivo.
Si el Resource necesita una base de datos, puedes importar su archivo SQL directamente desde el instalador. No se importa automáticamente; solo se hará si haces clic en Importar a la base de datos junto al archivo correspondiente.
- Selecciona la base de datos de tu servidor. La base de datos principal está seleccionada de forma predeterminada. Si tu servidor aún no tiene una base de datos, créala desde la pestaña Bases de datos, con Crear base de datos.
- Si ya existen tablas incluidas en el archivo, el cuadro de diálogo te lo indicará. Deja seleccionada la opción Omitir las tablas existentes (recomendado). Así, las tablas existentes y sus datos permanecerán intactos.
- Si tienes ZapX Pass, se creará automáticamente una copia de seguridad de la base de datos antes de la importación. Si no tienes Pass, confirma Importar sin Backup.
- Haz clic en Importar ahora.
Se admiten archivos de hasta 2 MB y 5.000 instrucciones SQL. Si tus archivos son más grandes, impórtalos con phpMyAdmin siguiendo los pasos de FiveM: importar un archivo SQL.
La importación siempre se realiza en la base de datos seleccionada. Por eso, no se permiten líneas como CREATE DATABASE … o USE …. Si el archivo contiene alguna de ellas, no se importará. Elimina esas líneas, vuelve a empaquetar el ZIP y súbelo otra vez.
| Mensaje o problema | Solución |
|---|---|
| No se admiten archivos RAR ni 7z | Descomprime el archivo y vuelve a empaquetar la carpeta como ZIP. |
| Este archivo comprimido no se puede instalar | Comprueba el nombre y la carpeta de destino. Si ya existe un Resource con el mismo nombre en otra carpeta, cambia el nombre del nuevo o elimina el anterior. Si el archivo no contiene fxmanifest.lua (o __resource.lua), no se trata de un Resource, sino, por ejemplo, de un archivo de mapa o de vehículo. |
| Falta una dependencia en el servidor | Instala primero el Resource que falta (por ejemplo, ox_lib), también con el instalador. Sin él, normalmente el Resource no se iniciará. |
| Aviso de que falta una Recipe o una plantilla de servidor | Configura primero una plantilla de servidor en txAdmin y vuelve a abrir el instalador. |
| Ya hay una instalación en curso en este servidor | Espera a que termine la instalación en curso. Seguirá apareciendo en la página. |
| La instalación se interrumpió o falló | Comprueba el servidor e inicia de nuevo la instalación. Si se sobrescribió un Resource existente, el instalador restaurará la carpeta anterior si se produce un error. |
| SQL: USE no está permitido o No se permite crear, modificar ni eliminar bases de datos | Elimina las líneas USE y CREATE DATABASE del archivo SQL y vuelve a subir el ZIP. |
| SQL: Error en la línea … | Las instrucciones anteriores a esa línea ya se han ejecutado. Corrige el archivo y vuelve a iniciar la importación con Omitir las tablas existentes. |
| El Resource no se inicia después de reiniciar | Comprueba el mensaje de error en la consola en vivo, que todas las dependencias estén en ejecución y que la línea ensure aparezca después de ellas. Encontrarás ayuda para errores frecuentes en FiveM: problemas frecuentes. |
¿Quieres comprobar primero un archivo sin instalarlo? Nuestra herramienta gratuita FiveM Resource Installer lo analiza directamente en el navegador, sin subir nada.
Fuente preferida en Google
