Cómo instalar ESX Legacy en FiveM

El problema

Quieres montar un servidor de FiveM con el framework ESX Legacy pero no sabes qué recursos descargar, en qué orden cargarlos ni cómo conectar la base de datos. Al primer arranque la consola escupe «attempt to index a nil value (ESX)» y nada funciona.

La causa

ESX Legacy no es un único recurso: es es_extended más una cadena de dependencias (oxmysql, ox_lib y el menú) que deben estar descargadas, con su tabla SQL importada y, sobre todo, cargadas en el orden correcto. Si falta una dependencia, el connection_string de MySQL es incorrecto o el orden de ensure está mal, el framework no inicializa y cualquier recurso que dependa de ESX recibe un valor nil.

La solución

Descarga es_extended y sus dependencias, importa el .sql a tu base de datos, define mysql_connection_string y carga los recursos en este orden exacto en server.cfg (oxmysql → ox_lib → es_extended → tus recursos):

# server.cfg — cadena de carga de ESX Legacy

# 1) Conexión a la base de datos (oxmysql la lee de aquí)
set mysql_connection_string "mysql://usuario:password@localhost:3306/esx_legacy?charset=utf8mb4"

# 2) Orden de ensure: las dependencias SIEMPRE antes que es_extended
ensure oxmysql       # capa de base de datos (debe ir primero)
ensure ox_lib        # librería compartida que usa ESX
ensure es_extended   # el framework (después de sus dependencias)

# 3) A partir de aquí, tus recursos que dependen de ESX
# ensure mi_recurso_esx

Paso a paso

1. 1.Requisitos previos: ten un FXServer (artifacts) funcionando y un servidor MySQL/MariaDB accesible. Crea una base de datos vacía, por ejemplo `esx_legacy`.
2. 2.Descarga oxmysql (overextended/oxmysql), ox_lib (overextended/ox_lib) y es_extended del repositorio oficial esx-framework/es_extended (release Legacy). Descomprime cada uno en tu carpeta `resources` con su nombre exacto de carpeta.
3. 3.Importa el SQL: dentro de es_extended hay un archivo `.sql` (p. ej. `[sql]/es_extended.sql`). Impórtalo a tu base de datos con phpMyAdmin, HeidiSQL o `mysql < es_extended.sql`. Esto crea las tablas `users`, `items`, `jobs`, etc.
4. 4.Configura la conexión: añade en server.cfg `set mysql_connection_string "mysql://usuario:password@localhost:3306/esx_legacy?charset=utf8mb4"` con tus credenciales reales. oxmysql lee esta línea para conectar.
5. 5.Define el orden de ensure correcto: `ensure oxmysql` → `ensure ox_lib` → `ensure es_extended`, y solo DESPUÉS tus recursos que usen ESX. Las dependencias siempre van antes que quien las consume.
6. 6.Arranca el servidor completo y comprueba la consola: deberías ver oxmysql conectando a la base de datos y es_extended inicializando sin errores rojos. Si aparece «attempt to index a nil value (ESX)», casi siempre es el orden de ensure: es_extended o un recurso tuyo se cargó antes que oxmysql/ox_lib.
7. 7.Verifica en el juego: conéctate y comprueba que generas con dinero, trabajo e inventario base. Si el jugador carga correctamente, ESX está instalado y funcionando.

Guías relacionadas