Cómo instalar un script de FiveM
Instalación
Instalar un script de FiveM no es complicado. Pero si nunca lo has hecho, conviene entender cómo carga los scripts el servidor antes de empezar.
¿Qué es un script de FiveM?
En FiveM, los scripts se llaman recursos. Un recurso es una carpeta que contiene todo lo que un script necesita para funcionar: archivos de cliente, archivos de servidor, archivos de config y cualquier archivo de la UI.
Toda carpeta de recurso necesita un archivo llamado fxmanifest.lua. Este archivo le indica al servidor qué debe cargar. Sin él, el servidor ignora la carpeta por completo.
Paso 1: descarga y extrae el script
Los scripts suelen distribuirse como archivo .zip o .rar. Extráelo con 7-Zip o WinRAR.
Dentro encontrarás la carpeta del recurso. Como mínimo debe contener:
fxmanifest.lua- Uno o más archivos del script (
client.lua,server.lua,config.lua, etc.)
No cambies el nombre de los archivos de la carpeta salvo que la documentación diga que es seguro hacerlo. Las rutas de archivo dentro de fxmanifest.lua distinguen entre mayúsculas y minúsculas, y deben coincidir exactamente con los nombres reales de los archivos.
Paso 2: sube el recurso a tu servidor
Los recursos van dentro de la carpeta resources/ del directorio de datos de tu servidor. Una estructura típica se ve así:
server-data/
└── resources/
└── [scripts]/
└── your-script/
├── fxmanifest.lua
├── client.lua
└── server.lua
Las carpetas entre corchetes, como [scripts], son solo categorías para organizar. No son recursos en sí mismas, y los scripts que contienen funcionan sin problema.
Sube la carpeta del recurso por FTP, SFTP o con el administrador de archivos del panel de tu hosting.
Paso 3: configura el script
La mayoría de los scripts incluyen un archivo config.lua. Ábrelo y ajusta los valores a tu servidor. Normalmente incluye cosas como el tipo de framework, los nombres de los trabajos y los nombres de los ítems.
Lee la documentación antes de iniciar el script. Saltarse este paso es la razón más común por la que un script no funciona después de instalarlo.
Paso 4: añade el script a server.cfg
Abre server.cfg y añade esta línea:
ensure your-script
Sustituye your-script por el nombre exacto de la carpeta del recurso. Las mayúsculas importan.
Si el script depende de otros recursos como ESX, QBCore u ox_lib, asegúrate de que estén más arriba en server.cfg para que se carguen primero.
ensurees el estándar actual. Inicia el recurso y lo reinicia automáticamente si se cae. La directiva antiguastartsigue funcionando, pero se recomiendaensure.
Paso 5: inicia el recurso
No hace falta reiniciar todo el servidor. Hay dos formas de iniciar un recurso:
- txAdmin: ve al panel Resources, busca el script y haz clic en Start.
- Consola del servidor: escribe
start your-scriptdirectamente en la consola.
Revisa la salida de la consola por si hay errores. Si el script se cargó correctamente, verás:
Started resource your-script
Problemas comunes
| Problema | Causa probable |
|---|---|
| Recurso no encontrado | El nombre de la carpeta en server.cfg no coincide con el nombre real de la carpeta |
Aviso de que falta fxmanifest.lua | El archivo no existe o está en el directorio equivocado |
| El script se inicia pero no funciona | La config no está bien ajustada o falta una dependencia |
| Errores del framework al iniciar | El script se hizo para un framework distinto al que usa tu servidor |
Resumen
- Extrae el archivo comprimido y localiza la carpeta del recurso.
- Súbela a
server-data/resources/. - Edita
config.luasegún la configuración de tu servidor. - Añade
ensure your-scriptaserver.cfg. - Inicia el recurso y revisa la consola por si hay errores.
El proceso es el mismo para todos los scripts. Lo único que cambia es la configuración.




