Qbox vs QBCore: Diferencias, Compatibilidad y Migración

Elige Qbox para un nuevo servidor cuando quieras su pila moderna integrada con OX y estés preparado para seguir sus convenciones. Mantén QBCore cuando tu servidor estable dependa de recursos específicos de QBCore y una migración no tenga un claro beneficio. Qbox proporciona un puente de compatibilidad para la mayoría de los scripts de QBCore escritos correctamente, pero la compatibilidad no es universal.

¿Vas a montar tu primer servidor? Sigue nuestra guía paso a paso sobre cómo crear un servidor FiveM.

Qbox vs QBCore de un vistazo

Pregunta	Qbox	QBCore
Origen	Comenzó como una bifurcación de QBCore y ahora sigue su propia arquitectura	Marco y ecosistema de roleplay de FiveM establecido
Scripts QB existentes	La mayoría de los scripts documentados y escritos correctamente funcionan a través del puente	Objetivo nativo para recursos de QBCore
Integración OX	Diseñado alrededor de integraciones como ox_lib y ox_inventory	Depende del stack del servidor elegido y de las adaptaciones de recursos
Acceso al núcleo	Utiliza exports e imports de módulos; no hay objeto principal nativo de Qbox	Muchos recursos utilizan el familiar objeto principal de QBCore
Riesgo de migración	Requiere auditoría del acceso a la base de datos, acceso a archivos principales y recursos personalizados	No hay migración de marco si el servidor ya es estable

¿Qué es Qbox?

Qbox es un framework de roleplay de FiveM creado en 2022. Comenzó como una bifurcación de QBCore, mantiene la compatibilidad con versiones anteriores para casi todos los scripts de QBCore correctamente implementados, y utiliza cada vez más sus propios exports, módulos e integraciones basadas en OX. La propia documentación de Qbox recomienda los recursos publicados y advierte contra el acceso no compatible a las tablas o archivos de la base de datos propiedad del núcleo.

¿Qué es QBCore?

QBCore es un marco de roleplay maduro con un amplio catálogo de trabajos, inventarios, herramientas de administración y scripts personalizados. Su principal ventaja para un servidor existente es la predictibilidad: si tus recursos están probados contra tu versión actual de QBCore, quedarte evita el costo y el riesgo de una migración de marco.

¿Funcionarán los scripts de QBCore en Qbox?

La mayoría sí, pero no todos. Qbox proporciona un puente QB para recursos que utilizan correctamente los exports y eventos documentados de QBCore. Los scripts son más propensos a fallar cuando:

• leen o modifican directamente las tablas de base de datos propiedad de QBCore;
• abren o parchean archivos internos del núcleo;
• dependen de funciones no documentadas o de un uso de eventos no válido;
• reemplazan datos multijob o multigang integrados con tablas incompatibles;
• asumen que existe un objeto central de Qbox en lugar de usar exports y módulos compatibles.

Cuando Qbox es la mejor opción

• Estás construyendo un nuevo servidor y quieres una base orientada a Qbox/OX.
• Tus scripts críticos usan APIs documentadas o ya declaran soporte para Qbox.
• Quieres mover el código personalizado hacia exports y módulos en lugar de editar el núcleo.
• Puedes probar la migración de la base de datos y los personajes en una copia completa de ensayo.

Cuando QBCore es la mejor opción

• Tu servidor en vivo es estable y la migración no resolvería un problema medido.
• Un recurso crítico depende directamente de los internos de QBCore.
• No tienes una copia de seguridad completa de la base de datos y un entorno de ensayo.
• Tu equipo ya mantiene un despliegue y proceso de actualización de QBCore probados.

Migración segura de QBCore a Qbox

1. Inventaría cada recurso. Registra su versión, tablas de base de datos, llamadas de framework y estado de soporte.
2. Haz una copia de seguridad de los archivos y la base de datos. Demuestra que la copia de seguridad se restaura antes de modificar la producción.
3. Instala Qbox con la receta recomendada. Comienza desde los archivos de configuración actuales en lugar de mezclar archivos antiguos del núcleo en la nueva pila.
4. Revisa los trabajos y las bandas. Qbox utiliza grados numéricos de trabajo y banda, y su documentación de migración señala los cambios requeridos en los archivos compartidos y la intercalación.
5. Configura y convierte la base de datos de inventario. Sigue la documentación exacta del inventario y trabaja en una copia.
6. Prueba los scripts por categoría. Comienza con identidad, personajes, trabajos, dinero e inventario, luego vehículos, vivienda, teléfonos y herramientas de administración.
7. Reemplaza gradualmente los internos no soportados. Qbox soporta la conversión parcial de llamadas de QBCore a exports y módulos de Qbox.
8. Realiza el cambio solo después de que las pruebas de paridad pasen. Mantén un plan de reversión programado y la copia de seguridad pre-migración intacta.

Decisión

Para un nuevo proyecto, Qbox es una opción sólida por defecto cuando el equipo desea su arquitectura y conjunto de recursos compatibles. Para un servidor QBCore rentable o altamente personalizado, no migres por moda: muévete solo cuando una auditoría en el entorno de pruebas demuestre que el beneficio supera el riesgo de compatibilidad y datos.

Referencias oficiales

• Introducción a Qbox
• Preguntas frecuentes sobre compatibilidad de Qbox
• Guía oficial de conversión de QBCore a Qbox
• Repositorio principal de QBCore

¿La etiqueta QBCore garantiza compatibilidad con Qbox?

No. Qbox documenta un puente de compatibilidad, pero los scripts que acceden a componentes internos del framework pueden necesitar cambios. Revisa la versión exacta, el acceso a la base de datos y las integraciones de inventario y voz antes de comprar. La categoría QBCore por sí sola no es una prueba de compatibilidad con Qbox.

Documentación de compatibilidad de Qbox

Ver los requisitos del paquete FiveM Baby Script

Cómo migrar un servidor ESX a QBCore