Cómo instalar la base ESX en un servidor FiveM desde cero

ESX es el framework de roleplay dominante en FiveM hispanohablante. A pesar de que existen alternativas (QBCore, Ox Core, vRP), la mayoría de los scripts comerciales y gratuitos del mercado presuponen ESX instalado — entonces saber montar la base limpia, sin deuda técnica acumulada de tutoriales antiguos, es el punto de partida para cualquier servidor que pretenda crecer.

Esta guía cubre la instalación de es_extended 1.10+ con oxmysql como driver de base de datos, ox_lib como biblioteca base y ox_inventory como inventario. Es el stack moderno mantenido activamente en 2026 — distinto de los tutoriales de 2020-2022 que aún recomiendan mysql-async y esx_inventoryhud.

Tiempo estimado de ejecución: 30 a 45 minutos para quien ya tiene el servidor FiveM en funcionamiento. Si todavía necesitas instalar txAdmin y levantar el artifact de FXServer, reserva una hora extra.

Prerrequisitos

Antes de descargar cualquier cosa, confirma que el servidor base arranca limpio — sin ESX todavía, solo el FXServer puro. Conecta vía cliente FiveM a la IP del servidor y verifica que entras al mapa por defecto sin error de conexión. Si ya hay problemas en este punto, resuélvelos primero: ESX amplificará cualquier inestabilidad de la capa inferior.

Ten a mano los datos de conexión de la base:

Preparar la base de datos

ESX usa MySQL para persistir jugadores, inventario, vehículos, empleos y todo lo que necesita sobrevivir a un reinicio. La primera acción es crear la base con el charset correcto — utf8mb4 no es negociable, los scripts modernos esperan soporte completo a 4 bytes (emojis, caracteres asiáticos, símbolos especiales usados en RP).

mysql -u root -p

CREATE DATABASE esx_server CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'esx_user'@'localhost' IDENTIFIED BY 'ContrasenaFuerteAqui123!';
GRANT ALL PRIVILEGES ON esx_server.* TO 'esx_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

cd server-data/resources/
git clone https://github.com/overextended/oxmysql.git [standalone]/oxmysql

set mysql_connection_string "mysql://esx_user:ContrasenaFuerteAqui123!@localhost/esx_server?charset=utf8mb4"
ensure oxmysql

Instalar ox_lib y es_extended

Con la base respondiendo, sigue la base del framework. ox_lib es una biblioteca de utilidades (UI, callbacks, locale, cache) que el ESX moderno y la mayoría de los scripts actuales requieren como dependencia declarada en el manifest.

cd server-data/resources/[standalone]/
git clone https://github.com/overextended/ox_lib.git

mkdir -p server-data/resources/\[esx\]
cd server-data/resources/\[esx\]
git clone https://github.com/esx-framework/esx_core.git

mysql -u esx_user -p esx_server < server-data/resources/\[esx\]/esx_core/\[core\]/es_extended/install.sql

Configurar el server.cfg

El orden de ensure define qué se inicia primero. ESX es sensible a esto — recursos que llaman a ESX.GetPlayerFromId() antes de que el framework termine de inicializar retornan nil silenciosamente y el jugador se vuelve un fantasma. La regla es simple: drivers de bajo nivel primero, biblioteca después, framework a continuación, recursos consumidores al final.

# Base (ya configurada anteriormente)
set mysql_connection_string "mysql://esx_user:ContrasenaFuerteAqui123!@localhost/esx_server?charset=utf8mb4"
ensure oxmysql

# Biblioteca base
ensure ox_lib

# Framework ESX (el orden importa)
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list
ensure esx_notify
ensure esx_textui
ensure esx_progressbars

# Inventario (después del framework)
ensure ox_inventory

cd server-data/resources/[standalone]/
git clone https://github.com/overextended/ox_inventory.git

Verificar la instalación

Arrancar sin error en la consola es la mitad del trabajo — el otro lado es confirmar que el framework realmente funciona en runtime, con un jugador conectado.

[oxmysql] Database server connection established!
Started resource ox_lib
Started resource es_extended
[es_extended] ESX has started successfully!
Started resource ox_inventory

/setjob mecanico boss

Resolución de problemas comunes

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

Significa que un script intentó usar ESX = exports['es_extended']:getSharedObject() antes de que el framework terminara de cargar. Ocurre en client scripts mal escritos. Solución: envuelve la inicialización del client en un loop de espera:

ESX = nil
CreateThread(function()
    while ESX == nil do
        ESX = exports['es_extended']:getSharedObject()
        Wait(0)
    end
end)

Este patrón es el oficial recomendado por el equipo de ESX desde la versión 1.10.

El jugador entra pero el inventario queda vacío

Verifica si la tabla users tiene registro para el identificador Steam/license del jugador. Si no lo tiene, ox_inventory no puede cargar slots. Solución: asegúrate de que ensure es_extended esté antes de ensure ox_inventory y que la base esté respondiendo (sin error de conexión en la consola).

La consola muestra oxmysql was unable to establish a connection

La cadena de conexión está mal. Causas comunes: contraseña con carácter especial sin escape (usa contraseña alfanumérica simple o escapa con %XX), MySQL escuchando solo en socket Unix y no en TCP 127.0.0.1 (edita bind-address en my.cnf), firewall bloqueando 3306 localmente (raro pero ocurre en servidor con UFW configurado agresivo).

Próximos pasos

Con la base ESX en funcionamiento, el servidor está listo para recibir la capa de gameplay. Sugerencias para continuar:

• Empleos y bandas: agrega esx_jobs, esx_society, esx_billing para completar la economía base. Edita el seeder jobs en la base para crear empleos custom de tu RP.
• MDT y sistema policial: integra mdt-fivem o similar — depende de oxmysql y es_extended ya en ejecución, por eso la base que acabas de montar es prerrequisito.
• Loadouts y armas: configura Config.EnablePVP en es_extended/config.lua y usa ox_inventory para controlar permisos de armas por job.
• Persistencia de vehículos: instala esx_vehicleshop para concesionaria y activa el spawn de garaje con esx_garage o qb-garages-esx-bridge.
• Rendimiento: usa el profiler del FXServer (profiler record 1000, luego profiler view) para medir el tick de cada recurso. Por encima de 1ms por resource en loop, refactoriza o reemplaza.

Si estás poniendo el servidor en producción con más de 32 slots, una máquina dedicada al FiveM vale la inversión — el tick rate cae sensiblemente cuando el servidor compite con web, base y otras cargas en el mismo host. Los planes de hospedaje de juegos de Hostini ya vienen con CPU aislada y NVMe local, que es exactamente el perfil que ESX prefiere bajo carga real.