Instalar ESX Legacy para roleplay

¿Qué es ESX Legacy?

ESX Legacy es el framework de roleplay más popular para FiveM. Proporciona un sistema de economía, inventario, trabajos, identidad de personajes y una base sobre la cual instalar cientos de scripts RP.

Requisitos previos

• Servidor FiveM funcionando con txAdmin
• Base de datos MariaDB configurada (ver guía de base de datos)
• oxmysql instalado y conectado

Paso 1: Descargar ESX Legacy

Conectate por SSH a tu VPS y cloná el repositorio oficial:

cd ~/fxserver/server-data/resources/
git clone https://github.com/esx-framework/esx_core.git [esx]

Esto descarga el core de ESX con todos los módulos base.

Paso 2: Importar la base de datos

ESX necesita tablas en tu base de datos. Importá el SQL incluido:

mysql -u fivem -p fivem_db < ~/fxserver/server-data/resources/[esx]/[SQL]/legacy.sql

Esto crea las tablas: users, owned_vehicles, jobs, items, etc.

Paso 3: Configurar server.cfg

Agregá las siguientes líneas a tu server.cfg:

# ESX Core
ensure es_extended
ensure esx_identity
ensure esx_society
ensure esx_status
ensure esx_basicneeds
ensure esx_skin
ensure esx_multicharacter

# Dependencias
ensure oxmysql
ensure ox_lib

Importante: El orden de carga importa. oxmysql y ox_lib deben ir antes que ESX.

Paso 4: Configurar ESX

Editá el archivo de configuración de ESX en resources/[esx]/es_extended/config.lua:

Config = {}
Config.Locale = 'es'  -- Idioma español
Config.MaxWeight = 24  -- Peso máximo del inventario
Config.PaycheckInterval = 10  -- Minutos entre pagos de trabajo
Config.EnableDefaultInventory = true
Config.EnableSocietyPayouts = true
Config.StartingAccountMoney = { bank = 50000, money = 500 }

Paso 5: Instalar scripts complementarios

ESX funciona con scripts adicionales para cada mecánica RP:

cd ~/fxserver/server-data/resources/[esx]
git clone https://github.com/esx-framework/esx_policejob.git
git clone https://github.com/esx-framework/esx_ambulancejob.git
git clone https://github.com/esx-framework/esx_mechanicjob.git

Y agregalos al server.cfg:

ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

Paso 6: Reiniciar y verificar

Desde txAdmin, reiniciá el servidor. En la consola deberías ver:

[ESX] [es_extended] Loaded successfully
[ESX] [esx_identity] Loaded successfully

Si hay errores, revisá que oxmysql esté conectado correctamente a la base de datos.

Estructura de carpetas recomendada

resources/
├── [esx]/           # Framework core y scripts ESX
├── [standalone]/    # Scripts independientes
├── [maps]/          # MLOs y mapas custom
└── [vehicles]/      # Vehículos custom

Recomendaciones

• Usá siempre la versión Legacy de ESX (no la v1 antigua)
• Mantené ESX actualizado con git pull periódicamente
• No mezcles scripts de ESX con scripts de QBCore (son incompatibles)
• Probá cada script nuevo en un servidor de desarrollo antes de producción
• Consultá la documentación oficial en docs.esx-framework.org