Esta guía cubre cómo instalar recursos (scripts) en tu servidor de FiveM, configurar una base de datos MySQL para frameworks como ESX o QBCore, y entender el orden de carga de recursos. Si aún no has completado la configuración inicial del servidor, comienza primero con la FiveM Server Setup Guide.

Instalación de Recursos y Scripts

Los servidores de FiveM se amplían con recursos (también llamados scripts). Los recursos agregan funciones como concesionarios de autos, trabajos, elementos de HUD, frameworks y más.

Cómo Instalar un Recurso

1. Descarga el recurso desde su fuente (GitHub, foros de Cfx.re, Tebex, etc.).
2. Extrae la carpeta del recurso del archivo ZIP si es necesario.
3. Sube la carpeta del recurso al directorio resources/ de tu servidor usando la pestaña Files de GPanel o vía SFTP.
4. Abre server.cfg y agrega una línea ensure para el recurso:

# Add your custom resources
ensure my-new-resource

5. Reinicia el servidor desde GPanel o TXAdmin para que el recurso se cargue.

Manifiestos de Recursos

Cada recurso válido debe contener un archivo de manifiesto. Los recursos modernos usan fxmanifest.lua, mientras que los más antiguos usan __resource.lua. Si una carpeta de recurso descargada no contiene ninguno de estos archivos, el recurso no se cargará. Algunas descargas anidan la carpeta real del recurso dentro de una carpeta exterior — asegúrate de que la carpeta que colocas en resources/ sea la que contiene el manifiesto.

Orden de Carga de Recursos

Los recursos se cargan en el orden en que aparecen en server.cfg. Si un recurso depende de otro (por ejemplo, un script de trabajo que depende de un framework como ESX o QBCore), asegúrate de que la dependencia esté listada antes del recurso que la necesita:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Organización de Recursos con Carpetas de Categorías

Puedes organizar los recursos en subcarpetas dentro del directorio resources/. Usa la notación de corchetes en server.cfg para asegurar una carpeta de categoría completa:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Esto carga todos los recursos dentro de la subcarpeta nombrada. Es una forma conveniente de agrupar scripts relacionados sin listar cada uno individualmente.

Carga en Caliente de Recursos vía TXAdmin

No siempre necesitas un reinicio completo del servidor para cargar un nuevo recurso. TXAdmin puede iniciar, detener y reiniciar recursos individuales desde su página de Resources. Después de subir un nuevo recurso y agregar su línea ensure, puedes ejecutar el siguiente comando en la consola en vivo de TXAdmin:

refresh
ensure my-new-resource

El comando refresh le dice al servidor que vuelva a escanear el directorio resources/ en busca de nuevas entradas.

Configuración de Base de Datos (MySQL / MariaDB)

Muchos frameworks y recursos de FiveM (como ESX, QBCore o vRP) requieren una base de datos MySQL o MariaDB. Legion Hosting proporciona credenciales de base de datos con tu servidor.

Encontrar tus Credenciales de Base de Datos

1. En GPanel, ve a la pestaña Databases.
2. Si aún no existe una base de datos, haz clic en New Database para crear una.
3. Anota los siguientes datos:
   • Host de la Base de Datos (dirección y puerto)
   • Nombre de la Base de Datos
   • Nombre de Usuario
   • Contraseña (haz clic en el ícono del ojo para revelarla)

Configuración de la Conexión a la Base de Datos

Los detalles de conexión a la base de datos se establecen en server.cfg usando una cadena de conexión. El formato exacto depende del recurso MySQL que estés usando, pero el formato más común es:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Reemplaza los marcadores de posición con tus credenciales reales de la pestaña Databases. Por ejemplo:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Elegir un Recurso MySQL

Cualquier recurso MySQL que uses debe estar asegurado en server.cfg antes de cualquier recurso que dependa de él:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Conceptos Básicos de Frameworks

Un framework proporciona los sistemas principales de juego sobre los que otros recursos se construyen — cosas como identidad de jugador, dinero, inventario, trabajos y vehículos. Los dos frameworks de FiveM más populares son:

La mayoría de los frameworks se instalan a través del sistema de recetas de TXAdmin durante la configuración inicial. Si elegiste una receta como "QBCore" o "ESX" durante la configuración de TXAdmin, el framework y sus dependencias principales ya están instalados. Si necesitas instalar un framework manualmente, sigue su documentación oficial:

• ESX Documentation
• QBCore Documentation

Obtener Ayuda

Si necesitas asistencia con la instalación de recursos o la configuración de la base de datos:

1. Consulta la documentación del recurso o su página de GitHub para instrucciones de instalación y problemas conocidos.
2. Revisa la consola de GPanel o los registros de TXAdmin en busca de mensajes de error.
3. Abre un ticket de soporte en https://legionhosting.net/submitticket.php con tus mensajes de error y el nombre del recurso que estás intentando instalar.

Artículos Relacionados

• FiveM Server Setup Guide
• FiveM Troubleshooting
• How to Upload Files via SFTP
• How to Find Your Server IP and Port