Cómo instalar scripts de FiveM: La guía completa para principiantes
Domina la instalación de scripts de FiveM con nuestro tutorial paso a paso. Desde la descarga hasta la solución de problemas: todo lo que necesitas para configurar tu servidor.
Instalar scripts de FiveM puede parecer desalentador al principio, pero con la guía adecuada, tendrás tu servidor funcionando con mods personalizados en poco tiempo. Ya sea que estés configurando un servidor de roleplay, añadiendo nuevos trabajos o mejorando las mecánicas de juego, esta guía cubre todo, desde lo básico hasta la solución avanzada de problemas.
Al final de este tutorial, entenderás cómo instalar scripts para cualquier framework principal (ESX, QBCore, QBOX), solucionar problemas comunes y seguir las mejores prácticas que mantendrán tu servidor estable y seguro.
Requisitos previos
Antes de empezar
Lo que necesitarás:
- Un servidor FiveM (FXServer) funcionando en Windows o Linux
- Acceso a los archivos de tu servidor (vía FTP, SFTP o acceso directo a archivos)
- Comprensión básica de la estructura de carpetas de tu servidor
- Acceso a la base de datos (MySQL/MariaDB) para scripts que requieren almacenamiento de datos
- Editor de texto (VS Code, Notepad++ o similar) para editar archivos de configuración
Configuración de la base de datos
Muchos scripts requieren una conexión a la base de datos. La mayoría de los frameworks utilizan oxmysql para operaciones de base de datos. Asegúrate de tener MySQL o MariaDB instalado y configurado.
-- Example SQL import for ESX
CREATE DATABASE fivem_server;
USE fivem_server;
-- Import your framework SQL files
SOURCE es_extended.sql;
SOURCE essentialmode.sql;Entendiendo los tipos de scripts
Scripts del lado del cliente
Estos se ejecutan en la computadora del jugador y manejan elementos visuales, UI y lógica del lado del cliente. Los ejemplos incluyen HUDs, menús personalizados y efectos visuales.
Scripts del lado del servidor
Estos se ejecutan en el servidor y manejan la persistencia de datos, operaciones sensibles a la seguridad y la lógica del juego que necesita ser autoritativa. Los ejemplos incluyen sistemas económicos, gestión de inventario y sistemas de trabajos.
Scripts compartidos
Estos contienen código utilizado tanto por el cliente como por el servidor, típicamente archivos de configuración y funciones de utilidad que ambos lados necesitan.
MLOs y mapas
Los Map Loader Objects añaden interiores personalizados, edificios y modificaciones al mundo del juego. Estos son recursos del lado del cliente que modifican el mundo del juego.
Instalación paso a paso
Localiza tu carpeta de recursos
Navega a la carpeta de recursos de tu servidor FiveM. Aquí es donde se almacenan todos los scripts. La ubicación predeterminada varía según el proveedor de alojamiento o si estás alojándolo tú mismo.
# Windows - Default path
C:FiveMserver
esources
# Linux - Default path
/home/fivem/server/resourcesDescarga y extrae el script
Descarga los archivos del script y extráelos en tu carpeta de recursos. Asegúrate de que el nombre de la carpeta coincida con el nombre del script (sin espacios, caracteres especiales o números de versión en el nombre de la carpeta).
Consejo profesional
Añadir a server.cfg
Abre tu archivo server.cfg y añade una línea 'ensure' o 'start' para tu nuevo script. El orden importa: las dependencias deben cargarse antes que los scripts que las necesitan.
# Add to your server.cfg file
# Place after your framework (ESX/QBCore)
# Essential resources first
ensure oxmysql
ensure ox_lib
# Your new script
ensure my-awesome-script
# Alternative: use 'start' instead of 'ensure'
start my-awesome-scriptReinicia tu servidor
Reinicia tu servidor FiveM para cargar el nuevo script. También puedes usar comandos de consola para recargar recursos sin un reinicio completo.
Comandos de consola útiles:
refresh- Recarga todos los recursos sin reiniciarensure [script-name]- Inicia un recurso específicorestart [script-name]- Reinicia un recurso en ejecuciónstop [script-name]- Detiene un recurso en ejecución
Verifica la instalación
Comprueba la consola de tu servidor en busca de errores. Si el script se cargó correctamente, deberías ver un mensaje de confirmación. Prueba la funcionalidad en el juego para asegurarte de que todo funciona.
¡Éxito!
Instalación específica del framework
Diferentes frameworks tienen diferentes requisitos y órdenes de carga. Aquí te explicamos cómo instalar scripts para cada framework principal:
LegacyESX Installation
ESX es el framework legacy con amplio soporte de scripts. La mayoría de los scripts ESX requieren que es_extended se cargue primero, seguido de cualquier dependencia.
# ESX server.cfg order example
ensure oxmysql
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
# Your ESX scripts
ensure esx_policejob
ensure esx_mechanicjob
ensure my-custom-esx-scriptPopularQBCore Installation
QBCore es el framework moderno más popular. Requiere que qb-core se cargue antes que cualquier script específico de QBCore. Muchos scripts también necesitan qb-target para interacciones.
# QBCore server.cfg order example
ensure oxmysql
ensure qb-core
ensure qb-target
# Your QBCore scripts
ensure qb-policejob
ensure qb-mechanicjob
ensure my-custom-qb-scriptModernQBOX Installation
QBOX es el framework más nuevo con mejor rendimiento. Es compatible con muchos scripts de QBCore pero tiene su propio recurso core (qbx-core) que debe cargarse primero.
# QBOX server.cfg order example
ensure oxmysql
ensure qbx-core
ensure ox_lib
# Your QBOX scripts
ensure qbx-police
ensure my-custom-qbox-script¿Necesitas ayuda para elegir?
Solución de problemas comunes
El script no carga / Error 'No se pudo encontrar'
Esto generalmente significa que el nombre de la carpeta del script no coincide con lo que está en server.cfg, o el script está en la ubicación incorrecta.
- Verifica que el nombre de la carpeta coincida exactamente con lo que está en server.cfg (sensible a mayúsculas y minúsculas)
- Asegúrate de que el script esté directamente en la carpeta de recursos, no en una subcarpeta
- Comprueba que fxmanifest.lua o __resource.lua exista en la carpeta del script
Errores de dependencias
Muchos scripts requieren otros recursos para funcionar. Las dependencias comunes incluyen oxmysql, ox_lib y cores de frameworks.
- Instala todas las dependencias requeridas listadas en la documentación del script
- Asegúrate de que las dependencias se carguen ANTES que el script en server.cfg (colócalas más arriba en el archivo)
Errores de conexión a la base de datos
Los scripts que almacenan datos fallarán si no pueden conectarse a la base de datos.
- Verifica que MySQL esté ejecutándose y sea accesible
- Comprueba las credenciales de la base de datos en la configuración de tu servidor
Comprueba la consola del servidor
Mejores prácticas
Organiza tus recursos
Mantén tu carpeta de recursos organizada creando subcarpetas para diferentes tipos de scripts (por ejemplo, [jobs], [vehicles], [maps]).
Copia de seguridad antes de cambios
Siempre haz una copia de seguridad de tu server.cfg y scripts importantes antes de hacer cambios. Esto facilita revertir si algo se rompe.
Ten en cuenta el orden de carga
Los cores de frameworks y recursos compartidos deben estar en la parte superior de server.cfg. Los scripts sin dependencias pueden cargarse más tarde.
Prueba en un servidor de desarrollo
Nunca instales nuevos scripts directamente en tu servidor en vivo. Pruébalos primero en un servidor local o de desarrollo para detectar problemas temprano.
Scripts recomendados para empezar
Aquí tienes algunos scripts excelentes para empezar, que van desde esenciales gratuitos hasta funciones premium:
HUD esencial
Un sistema HUD limpio y personalizable que funciona con todos los frameworks principales. Muestra salud, armadura, hambre, sed e información del trabajo.
Sistema de policía avanzado
Sistema completo de trabajo de policía con despacho, evidencias, armería y gestión de vehículos. Compatible con todos los frameworks principales.
Sistema de combustible para vehículos
Sistema de combustible realista con gasolineras, consumo de combustible y bidones de gasolina. Ligero y optimizado para el rendimiento.
Paquete económico completo
Sistema completo de banca, tiendas y negocios con red de cajeros automáticos, tiendas personalizables y gestión de empresas.
¿Quieres tener todo preconfigurado?
Ahorra horas de tiempo de configuración con nuestras plantillas de servidor completas. Todo instalado, configurado y listo para ejecutar.
Explorar plantillas de servidorPreguntas frecuentes
¿Necesito conocimientos de programación para instalar scripts?
¿Puedo usar scripts de diferentes frameworks juntos?
¿Por qué se bloquea mi servidor después de instalar un script?
¿Cómo actualizo un script sin perder mi configuración?
¿Dónde puedo obtener ayuda si me atasco?
¿Listo para mejorar tu servidor?
Explora nuestra colección de scripts de FiveM verificados. Desde esenciales gratuitos hasta sistemas premium, encuentra todo lo que necesitas para crear una experiencia de juego increíble.