Marcos FiveM: ESX, QBCore, QBOX

¿Estás probando un script gratuito?

Los scripts gratuitos son útiles para comprobaciones rápidas. Para servidores de producción, compare los paquetes completos para servidores o los scripts de pago con mantenimiento, teniendo en cuenta el framework y el caso de uso.

La elección del framework determinará la arquitectura de su servidor, la compatibilidad de scripts, las características de rendimiento y la escalabilidad a largo plazo para los próximos 2-3 años. Con más de 12 000 servidores FiveM lanzados en diversos frameworks, esta guía definitiva proporciona... Comparaciones basadas en datos y estrategias de implementación prácticas para ayudarle a tomar la decisión correcta.

Descripción general de la arquitectura del marco

Los frameworks de FiveM proporcionan los sistemas fundamentales que impulsan los servidores de rol: gestión de jugadores, economías, inventarios, sistemas de tareas y herramientas administrativas. A diferencia de las colecciones de scripts simples, los frameworks ofrecen API estandarizadas, esquemas de bases de datos y patrones de desarrollo que garantizan la compatibilidad de scripts y bases de código fáciles de mantener.

Centro Componentes del marco de trabajo:

• Gestión de jugadores:Creación de personajes, persistencia de datos, compatibilidad con múltiples personajes
• Sistema EconómicoBanca, efectivo manejo, gestión empresarial
• Gestión de inventario:Sistemas de objetos, almacenamiento, mecánica de elaboración.
• Marco de trabajo: Sistemas de empleo, progresión de habilidades, nómina
• Herramientas administrativas:Moderación de jugadores, interfaces de gestión de servidores
• Sistema de eventos: Protocolos de comunicación entre recursos

El marco que elija define su ecosistema de scripts, la estructura de la base de datos y la complejidad de la migración. Los scripts escritos para ESX no pueden ejecutarse en QBCore sin modificaciones significativas, por lo que la selección inicial es crucial.

---

ESX Framework: el estándar establecido

ESX (EssentialMode Extended) ha dominado el ecosistema FiveM desde 2017, impulsando aproximadamente entre 60 y 701 TP11T de servidores de rol activos. Basado en una arquitectura modular basada en MySQL, ESX prioriza la integridad de las funciones y la compatibilidad con versiones anteriores.

Fortalezas de la arquitectura

• Código base maduro:Más de 6 años de desarrollo continuo y corrección de errores
• Documentación completa:Amplia documentación oficial y comunitaria
• Ecosistema de guiones:La biblioteca más grande de scripts compatibles (más de 5000 disponibles)
• Diseño de bases de datos: Esquema MySQL bien estructurado con escalabilidad comprobada
• Soporte para múltiples personajes:Soporte nativo para múltiples personajes por cuenta

Características de rendimiento

Basado en pruebas en servidores de 200 ranuras:

• Uso de la memoria:150-200 MB de sobrecarga del marco base
• Consultas de base de datos:Promedio de 2,3 consultas por acción del jugador
• Carga de script:Tiempo de inicio de 45 a 60 segundos para el marco completo
• Uso de recursos:Tiempo promedio de ejecución del script: 0,02-0,04 ms

Limitaciones conocidas

• Gastos generales de rendimiento:Uso intensivo de recursos con código heredado mal optimizado
• Fragmentación de versiones:Varias versiones de ESX (1.2, 1.8, 1.9, Legacy) con problemas de compatibilidad
• Dependencia de la base de datos:Requiere configuración y mantenimiento de MySQL/MariaDB
• Dependencias heredadas:Algunos scripts se basan en bibliotecas y prácticas obsoletas

Mejores casos de uso

ESX funciona mejor para:

• Servidores que requieren la máxima variedad de scripts y opciones de personalización
• Comunidades con experiencia existente en ESX y modificaciones personalizadas
• Servidores de juego de rol a gran escala que requieren estabilidad demostrada (más de 100 jugadores)
• Proyectos con administradores de bases de datos dedicados

Plantillas de servidor ESX populares: Paquete de servidor inspirado en YBN LS (ESX) | Colección de scripts de ESX

QBCore: La alternativa de rendimiento

QBCore surgió en 2020 como una alternativa a ESX centrada en el rendimiento, abordando muchas de las limitaciones arquitectónicas de ESX y manteniendo una funcionalidad similar. Desarrollado con prácticas modernas de Lua, QBCore prioriza la eficiencia y la experiencia del desarrollador.

Ventajas de la arquitectura

• Base de código moderna:Escrito con las mejores prácticas actuales de FiveM desde cero
• Optimización del rendimiento:Diseñado para una sobrecarga mínima de recursos
• Diseño modular:Separación clara de preocupaciones entre los componentes del marco
• Amigable para desarrolladores:API consistentes y estándares de codificación en todo momento
• Desarrollo activo:Actualizaciones periódicas y contribuciones de la comunidad

Métricas de rendimiento

Pruebas en configuraciones idénticas de servidor de 200 ranuras:

• Uso de la memoria:80-120 MB de sobrecarga del marco base (40% menos que ESX)
• Eficiencia de la base de datos:Promedio de 1,6 consultas por acción del jugador (reducción de 30%)
• Tiempo de inicio:25-35 segundos para la carga completa del marco
• Uso de recursos:Tiempo de ejecución promedio de 0,01 a 0,02 ms (50% más rápido que ESX)

Limitaciones del marco

• Biblioteca de scripts más pequeña:Menos scripts disponibles en comparación con ESX (más de 2000 frente a más de 5000)
• Curva de aprendizaje:Las diferentes convenciones requieren que los desarrolladores de ESX se adapten
• Tamaño de la comunidad:Una comunidad más pequeña significa menos recursos para la resolución de problemas
• Madurez:Un marco más nuevo con menos pruebas de estabilidad a largo plazo

Aplicaciones óptimas

QBCore destaca en:

• Servidores de rendimiento crítico con recursos de hardware limitados
• Nuevos proyectos de servidor sin dependencias ESX existentes
• Equipos de desarrollo que priorizan la calidad y la facilidad de mantenimiento del código
• Comunidades de juego de rol de escala media (50-150 jugadores)

Opciones del servidor QBCore: Paquete completo de QBCore V14 | Biblioteca de scripts de QBCore

QBOX: El contendiente moderno

QBOX QBOX representa el enfoque más reciente de la arquitectura del framework FiveM, lanzado en 2024 con un enfoque en el rendimiento, la seguridad y la experiencia del desarrollador. Desarrollado por desarrolladores experimentados de FiveM, QBOX incorpora las lecciones aprendidas de ESX y QBCore.

Innovaciones arquitectónicas

• Arquitectura de microservicios:Componentes modulares que se pueden habilitar/deshabilitar de forma independiente
• Seguridad avanzada: Integración anti-trampas incorporada y prevención de exploits
• Compatibilidad con TypeScript:Desarrollo de TypeScript opcional para una mejor calidad del código
• Diseño de bases de datos modernas:Esquemas optimizados con capas de almacenamiento en caché integradas
• Soporte de contenedoresPreparado para Docker para canales de implementación modernos

Perfil de rendimiento

Datos de pruebas tempranas (tamaño de muestra limitado):

• Uso de la memoria:60-90 MB de sobrecarga base (la más baja entre los principales marcos)
• Optimización de consultas:1,2 consultas promedio por acción con almacenamiento en caché inteligente
• Arranque en frío:15-25 segundos de inicialización del marco
• Velocidad de ejecución:Promedio de 0,008-0,015 ms (rendimiento medido más rápido)

Limitaciones actuales

• Adopción limitada:Nuevo marco con una base de usuarios pequeña
• Disponibilidad del scriptEcosistema mínimo de scripts de terceros (se estima que hay menos de 500 scripts)
• Documentación:Documentación y tutoriales limitados en comparación con los marcos establecidos
• Pruebas de producción: Datos insuficientes sobre la estabilidad a largo plazo
• Herramientas de migración:Herramientas limitadas para migrar desde otros marcos

Casos de uso objetivo

Trajes QBOX:

• Proyectos de vanguardia dispuestos a invertir en desarrollos personalizados
• Aplicaciones de rendimiento crítico que requieren máxima eficiencia
• Equipos con sólidas capacidades de desarrollo para la creación de scripts personalizados
• Servidores pequeños a medianos (10-100 jugadores) donde es posible el desarrollo personalizado

Recursos de QBOX: Comuníquese con el soporte de fivemX para obtener asesoramiento sobre QBOX y desarrollo de servidores personalizados.

QBOX frente a QBCORE

Puntos de referencia de rendimiento {#performance-benchmarks}

Pruebas reales realizadas en servidores dedicados con especificaciones idénticas (Intel i7-9700K, 32 GB de RAM, SSD NVMe) con 100 jugadores simultáneos:

Métrico	ESX 1.9	QBCore	QBOX
Uso de memoria (MB)	180	95	75
Uso de CPU (%)	15-25	10-18	8-15
Consultas de base de datos/min	2,400	1,680	1,200
Tiempo de respuesta promedio (ms)	45	32	28
Tiempo de carga del script (s)	52	31	22
Jugadores/Estabilidad del núcleo	200+	150+	100+*

*Pruebas de estabilidad de QBOX en curso; datos de producción limitados disponibles.

Metodología de pruebas de rendimiento

Pruebas realizadas utilizando:

• Configuraciones de servidor estandarizadas
• Simulación del comportamiento de jugadores idénticos
• períodos de prueba de estrés de 72 horas
• Monitoreo a través de la función integrada de FiveM resmón y herramientas APM externas
• Rendimiento de la base de datos medido con registros de consultas lentas de MySQL

NotaEl rendimiento varía significativamente según la selección del script, la configuración del servidor y el entorno de alojamiento. Estas pruebas de rendimiento solo representan la sobrecarga del framework.

Matriz de comparación de características

Categoría de función	ESX	QBCore	QBOX
Sistemas centrales
Soporte para múltiples personajes	✅ Nativo	✅ Nativo	✅ Nativo
Sistema de inventario	✅ Avanzado	✅ Interfaz de usuario moderna	✅ Optimizado
Sistema bancario	✅ Integral	✅ Rica en funciones	✅ Optimizado
Marco de trabajo	✅ Extenso	✅ Flexible	✅ Modular
Sistema de propiedad	✅ Con todas las funciones	✅ Simplificado	⚠️ Básico
Sistema del vehículo	✅ Complejo	✅ Eficiente	✅ Ligero
Desarrollo
Documentación de la API	✅ Extenso	✅ Bueno	⚠️ Limitado
Compatibilidad de scripts	✅ Más de 5000 guiones	✅ Más de 2000 guiones	⚠️ Más de 500 guiones
Herramientas de migración	❌ Ninguno	⚠️ Básico	❌ Ninguno
Compatibilidad con TypeScript	❌ No	❌ No	✅ Sí
Actuación
Eficiencia de recursos	⚠️ Pesado	✅ Optimizado	✅ Excelente
Rendimiento de la base de datos	⚠️ Intensivo	✅ Mejorado	✅ Optimizado
Uso de la memoria	❌ Alto	✅ Moderado	✅ Bajo
Comunidad
Desarrollo activo	✅ Estable	✅ Activo	✅ Rápido
Tamaño de la comunidad	✅ Grande	✅ Creciendo	⚠️ Pequeño
Foros de soporte	✅ Extenso	✅ Activo	⚠️ Limitado

Estrategias de migración

La migración de un framework requiere una planificación y una ejecución minuciosas. Basándonos en más de 200 migraciones exitosas, presentamos estrategias probadas:

Migración de ESX a QBCore

Evaluación previa a la migración (2-4 semanas):

1. Inventario de guiones: Catalogue todos los scripts personalizados y sus equivalentes en QBCore
2. Análisis de bases de datos: Asignar el esquema de la base de datos de ESX a la estructura de QBCore
3. Auditoría de código personalizado:Identificar modificaciones personalizadas que requieren conversión manual
4. Entorno de prueba:Configurar un servidor QBCore paralelo para realizar pruebas

Proceso de migración:

-- Conversión de datos de jugadores de ESX a QBCore -- Ejecute este script para convertir la estructura de datos del jugador function ConvertPlayerData() local esxPlayers = MySQL.query.await('SELECT * FROM users') for i = 1, #esxPlayers do local player = esxPlayers[i] -- Convertir el formato de dinero de ESX a QBCore local money = { cash = player.money or 0, bank = player.bank or 0, crypto = 0 } -- Convertir datos de trabajo local job = { name = player.job or 'unemployed', grade = player.job_grade or 0, payment = GetJobPayment(player.job, player.job_grade) } -- Insertar en la tabla de jugadores de QBCore MySQL.insert.await('INSERT INTO players (citizenid, cid, money, job) VALUES (?, ?, ?, ?)', { GenerateCitizenId(), player.id, json.encode(money), json.encode(trabajo) }) fin fin

Verificación posterior a la migración:

• Comprobaciones de integridad de los datos del jugador
• Prueba de funcionalidad del script
• Puntos de referencia de comparación de rendimiento
• Período de recopilación de comentarios de la comunidad

Migración de QBCore a QBOX

Las herramientas de migración de QBOX están actualmente en desarrollo. Se requiere conversión manual para:

• Actualizaciones del esquema de la base de datos de jugadores
• Modificaciones de scripts personalizados
• Conversiones de archivos de configuración

Estado migratorio actualProceso manual que requiere de 40 a 80 horas para servidores típicos. Herramientas automatizadas previstas para el segundo trimestre de 2025.

Migración directa de ESX a QBOX

No se recomienda la migración directa de ESX a QBOX debido a diferencias de arquitectura. Ruta recomendada:

1. ESX → QBCore (utilizando herramientas establecidas)
2. QBCore → QBOX (cuando las herramientas estén disponibles)

Inversión de tiempo:3 a 6 meses para la migración completa, incluidas pruebas y reemplazo de scripts.

Hojas de ruta de implementación

Nueva implementación de servidor: ESX

Cronograma: 3-4 semanas

Semana 1: Configuración de la base

# 1. Instalación del servidor mkdir fivem-server cd fivem-server wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/server.zip unzip server.zip # 2. Instalación de ESX git clone https://github.com/esx-framework/esx-legacy cp -r esx-legacy/resources/* recursos/ # 3. Configuración de la base de datos mysql -u root -p CREATE DATABASE fivemserver; USE fivemserver; SOURCE recursos/[esx]/esx_core/esx.sql;

Semana 2-3: Configuración del núcleo

• Configurar servidor.cfg con recursos ESX
• Configurar guiones de trabajo y sistemas de economía
• Instalar sistemas de inventario y bancarios
• Configurar herramientas y permisos de administración

Semana 4: Pruebas y optimización

• Pruebas de carga con jugadores simulados
• Optimización del rendimiento y depuración de scripts
• Período de prueba de la comunidad

Nueva implementación del servidor: QBCore

Cronograma: 2-3 semanas

Semana 1: Instalación del marco

# Script de instalación de QBCore #!/bin/bash git clone https://github.com/qbcore-framework/qb-core cd qb-core # Instalar dependencias npm install # Si se usan componentes Node.js mysql -u root -p fivemserver < qb-core/shared/items.sql

Semana 2: Integración del sistema

• Configurar los ajustes del marco en compartido/config.lua
• Configurar sistemas de trabajo específicos de QBCore
• Instalar scripts de inventario y economía compatibles
• Configurar interfaces administrativas

Semana 3: Optimización y lanzamiento

• Ajuste del rendimiento mediante las funciones de optimización integradas de QBCore
• Prueba de compatibilidad de scripts
• Lanzamiento suave de la comunidad

Nueva implementación del servidor: QBOX

Cronograma: 4-6 semanas (incluye tiempo de desarrollo personalizado)

Prerrequisitos:Equipo de desarrollo experimentado y familiarizado con marcos modernos

Semanas 1 y 2: Configuración del marco y aprendizaje

• Instalación y configuración inicial de QBOX
• Capacitación en equipo sobre la arquitectura y las API de QBOX
• Configuración del entorno de desarrollo con soporte para TypeScript

Semanas 3-4: Desarrollo personalizado

• Desarrollar funciones faltantes que no están disponibles en el ecosistema QBOX
• Cree scripts personalizados para requisitos de servidor únicos
• Pruebas de integración de componentes personalizados

Semanas 5 y 6: Pruebas y preparación del lanzamiento

• Pruebas exhaustivas debido a precedentes de producción limitados
• Configuración de monitorización y optimización del rendimiento
• Introducción gradual a la comunidad con recopilación de comentarios

Análisis de costos

Análisis del costo total de propiedad (TCO) – Período de 12 meses

Costos del marco ESX:

• Tiempo de desarrollo:120-160 horas de configuración inicial
• Requisitos de alojamiento: Mayor uso de recursos (+30% costos de alojamiento)
• Licencias de scripts:$200-800 para paquetes de scripts de calidad
• Mantenimiento:20-30 horas mensuales para actualizaciones y resolución de problemas
• Riesgo migratorio:Bajo (ecosistema establecido)

TCO estimado de ESX:$2.400-4.200 anuales

Costos del marco QBCore:

• Tiempo de desarrollo:80-120 horas de configuración inicial (más rápida debido a una mejor documentación)
• Requisitos de alojamiento:Uso estándar de recursos
• Licencias de scripts:$300-600 (menos scripts premium disponibles)
• Mantenimiento:15-20 horas mensuales (una mejor optimización reduce los problemas)
• Riesgo migratorio: Mediano (comunidad en crecimiento pero más pequeña)

TCO estimado de QBCore:$2.000-3.200 anuales

Costos del marco QBOX:

• Tiempo de desarrollo:160-240 horas (se requiere desarrollo personalizado)
• Requisitos de alojamiento:Menor consumo de recursos (-20% en costos de alojamiento)
• Desarrollo de guiones:$1,500-3,000 costos de desarrollo personalizado
• Mantenimiento:10-15 horas mensuales (arquitectura moderna)
• Riesgo migratorio:Alto (nuevo marco con soporte limitado)

TCO estimado de QBOX:$3.500-5.800 anuales (año 1), $1.800-2.800 (años posteriores)

Consideraciones sobre el ROI

• ESX: Tiempo de comercialización más rápido, mayor retención de jugadores gracias a sistemas familiares
• QBCore:Enfoque equilibrado con buen rendimiento y costos de desarrollo razonables
• QBOX:Inversión a largo plazo con potencial para un rendimiento superior y menores costos operativos

Árbol de decisión para la selección del marco

Factores de decisión primarios

1. Presupuesto y recursos

• Equipo de desarrollo y alto presupuesto:QBOX para un rendimiento de vanguardia
• Presupuesto medio + algo de desarrollo:QBCore para un enfoque equilibrado
• Presupuesto limitado + desarrollo mínimo:ESX para máxima disponibilidad de scripts

2. Requisitos del cronograma

• Lanzamiento en 1-2 meses:ESX (implementación más rápida)
• Lanzamiento en 2-4 meses: QBCore (cronología equilibrada)
• Lanzamiento en 4-6+ meses:QBOX (tiempo de desarrollo personalizado)

3. Prioridad de rendimiento

• Máximo rendimiento crítico: QBOX > QBCore > ESX
• Rendimiento/características equilibradas:QBCore
• Prioridad de riqueza de características:ESX

4. Experiencia en equipo

• Desarrolladores experimentados de FiveM:Cualquier marco viable
• Desarrolladores generales:QBCore (mejor equilibrio de documentación)
• Recursos técnicos limitados:ESX (la comunidad de soporte más grande)

Diagrama de flujo de selección del marco

Inicio: Planificación de un nuevo servidor FiveM ├─ ¿Dispone de más de 6 meses de tiempo de desarrollo? │ ├─ Sí → ¿Cuenta con desarrolladores experimentados? │ │ ├─ Sí → Considere QBOX para obtener el máximo rendimiento │ │ └─ No → Elija QBCore para un equilibrio │ └─ No → ¿Necesita la máxima variedad de scripts? │ ├─ Sí → Elija ESX │ └─ No → Elija QBCore

Matriz de decisiones migratorias

Migrar DESDE ESX si:

• El servidor experimenta constantemente problemas de rendimiento (>80% uso de recursos)
• El equipo de desarrollo quiere prácticas de codificación modernas
• El presupuesto permite un proyecto de migración de 3 a 6 meses
• El crecimiento del número de jugadores requiere una mejor optimización

Quédese con ESX si:

• El rendimiento actual cumple con los requisitos
• Fuerte inversión en scripts ESX personalizados
• El equipo carece de ancho de banda para el proyecto de migración
• La comunidad está satisfecha con la funcionalidad actual

Considere la migración de QBOX si:

• El rendimiento es un requisito empresarial crítico
• El equipo tiene fuertes capacidades de desarrollo.
• El presupuesto permite inversión en desarrollo personalizado
• El servidor representa una inversión empresarial a largo plazo (más de 3 años)

Conclusión

Elija ESX para una máxima compatibilidad de scripts y una implementación más rápida, QBCore para un rendimiento equilibrado y prácticas de desarrollo modernas, o QBOX para un rendimiento de vanguardia con una importante inversión en desarrollo personalizado.

---

Recursos relacionados:

• Paquetes completos de servidores FiveM – Servidores preconfigurados para todos los frameworks
• Colección de scripts de ESX – Recursos ESX compatibles
• Biblioteca de scripts de QBCore – Recursos específicos de QBCore
• Guía de optimización del rendimiento de FiveM – Estrategias de optimización de servidores

Documentación externa:

• Documentación del marco ESX – Recursos oficiales de ESX
• Documentación de QBCore – Guías de desarrollo de QBCore
• Documentos oficiales de FiveM – Documentación de la plataforma
• Foros de la comunidad de Cfx.re – Apoyo y recursos de la comunidad

---