Cómo instalar ESX Legacy en un servidor de FiveM: receta e instalación manual

Quieres un servidor de FiveM ejecutando ESX Legacy, y quieres saber cuál es la mejor forma de instalarlo. Hay dos: una receta de txAdmin, que lo hace todo, y una instalación manual, donde colocas cada parte tú mismo. Esta guía cubre ambas, luego qué verificar en tu primer inicio de sesión y los errores que es más probable que veas.

#Opción 1: la receta de txAdmin

Esta es la ruta recomendada. En la configuración de txAdmin, elige la plantilla de ESX Legacy de las recetas populares. Sigue los pasos en configuración de txAdmin y recetas: ingresa tu clave de licencia y credenciales de base de datos, luego revisa el server.cfg generado e inicia el servidor.

La receta descarga es_extended y los recursos básicos, oxmysql y ox_lib, crea la base de datos e importa el archivo SQL de ESX. Cuando termines, tienes una base de funcionamiento. Salta a "Verificaciones de primer inicio".

#Opción 2: instalación manual

Haz esto cuando agregues ESX a un servidor que construiste tú mismo. Necesitas un FXServer en ejecución, una base de datos MySQL o MariaDB y una clave de licencia.

#1. Descarga los recursos

De las versiones de ESX Legacy, obtén el paquete básico (es_extended y los recursos básicos que usa, como los recursos de identidad, menú y notificación). Colócalos en tu carpeta resources, por ejemplo en resources/[esx]. También necesitas:

• oxmysql, la capa de base de datos.
• ox_lib, una dependencia común para recursos modernos de ESX.
• Un inventario. Muchos servidores ESX Legacy usan ox_inventory. Sigue la documentación de la versión que descargues, porque la configuración predeterminada puede cambiar entre versiones.

#2. Crea la base de datos e importa el SQL

Crea una base de datos vacía, por ejemplo esx:

CREATE DATABASE esx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Luego importa el archivo SQL que viene con es_extended (busca un archivo .sql en su carpeta, nombrado legacy.sql en el momento de escribir). Usa HeidiSQL, phpMyAdmin o la línea de comandos mysql. Sin ella, te encontrarás con errores de tabla no existe.

#3. Edita server.cfg

Establece la cadena de conexión e inicia los recursos en un buen orden:

set mysql_connection_string "mysql://user:password@localhost/esx?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure ox_inventory
ensure [esx]
ensure [standalone]

El orden se explica en orden de ensure de server.cfg. Si utilizas los recursos de identidad o multicarácter de ESX, asegúrate de que solo se ejecute un recurso de selección de personaje.

#Verificaciones de primer inicio

Inicia el servidor y lee la consola de arriba a abajo antes de unirte. Luego verifica:

1. oxmysql se conecta. Hay una línea sobre la conexión a la base de datos y sin error rojo inmediatamente después de ella.
2. es_extended se inicia sin errores.
3. Puedes unirte y llegar a la creación de personaje o spawn.
4. Tu fila de jugador existe. Después de unirte, deberías ver una fila para ti en la tabla users.
5. El dinero y el trabajo cargan. Abre tu inventario o ejecuta un comando que imprima tu cuenta y trabajo.

Para derechos de administrador, establece tu group a admin en tu fila users, luego rejoin. Para txAdmin y comandos ACE, ver permisos ACE.

#Errores comunes del primer inicio

ESX es nulo en un script. Un recurso que aún usa una forma antigua para obtener ESX muestra:

attempt to index a nil value (global 'ESX')

La forma moderna es ESX = exports['es_extended']:getSharedObject(). Ver ESX es nulo: fijando esx:getSharedObject y no such export getSharedObject in es_extended.

No se puede conectar a la base de datos. La cadena de conexión es incorrecta, la base de datos no se ejecuta, o el usuario no tiene derechos. Ver error de conexión oxmysql.

Un recurso no se inicia. A menudo una dependencia faltante o un nombre de carpeta incorrecto. Ver no se pudo encontrar la dependencia y no se pudo iniciar el recurso.

Los jugadores atascados en la carga. Mira la consola del recurso que da error durante la unión. Ver jugadores atascados en la pantalla de carga.

Consejo: cuando agregues un script, agrega uno a la vez y reinicia. Si aparece un error, sabes qué script lo causó.

#Agregando trabajos e artículos

Una vez que la base funciona, las siguientes tareas son trabajos y artículos. Agregar un trabajo en ESX muestra las filas de base de datos que necesitas. Para artículos, la forma depende de tu inventario: ver ox_inventory agregar artículos.

#Lista de verificación