Qbox es un framework de roleplay para FiveM que comenzó como una bifurcación de QBCore y ahora proporciona sus propias APIs y recursos principales. Mantiene un puente de compatibilidad para muchos recursos bien escritos de QBCore, pero el acceso directo a la base de datos, el acceso a archivos internos y el comportamiento no soportado son excepciones documentadas. Usa la receta oficial de txAdmin de Qbox para una nueva instalación y audita cada recurso antes de una migración.
Puntos clave
- Qbox es un framework, no simplemente un paquete de utilidades de Ox o una carpeta de QBCore renombrada.
- La instalación oficial actual utiliza la receta QBox de la sección de recetas populares de txAdmin.
- El puente de QB puede ayudar con los recursos compatibles, pero no es una garantía para cada script de QBCore.
- La migración incluye configuración, grados, inventario y conversión de base de datos, más pruebas recurso por recurso.
- No hay un ranking universal de rendimiento respaldado por la fuente entre Qbox, QBCore y ESX.
Qué es Qbox
La introducción oficial de Qbox registra la creación del proyecto el 27 de septiembre de 2022 y describe su origen en QBCore. Desde entonces, el proyecto ha desarrollado su propio núcleo y recursos relacionados. Su capa de compatibilidad existe para facilitar el uso de muchos recursos de QB mientras los equipos adoptan las APIs actuales de Qbox, pero Qbox debe evaluarse como su propio framework y receta.
El manifiesto actual de qbx_core declara directamente las dependencias ox_lib y oxmysql. La receta oficial reúne Qbox y recursos seleccionados de terceros en un conjunto inicial completo. Como el contenido de la receta puede cambiar, enlaza la receta actual en lugar de fijar una larga lista de dependencias en un tutorial de instalación pensado para mantenerse vigente.
Instala Qbox mediante la receta oficial
- Prepara un entorno FXServer compatible y abre su configuración txAdmin incluida.
- Cumple con los requisitos de la base de datos listados en la documentación de instalación actual de Qbox.
- Selecciona la receta oficial QBox de la sección de recetas populares en lugar de ensamblar manualmente un núcleo incompleto.
- Completa las variables de la receta, la configuración de la base de datos y la configuración del servidor utilizando la documentación actual.
- Revisa la lista de recursos generada y el orden de inicio antes del primer inicio público.
- Verifica la carga de jugadores, la creación de personajes, los permisos, la persistencia y los registros en un servidor de prueba.
No reemplaces los manifiestos del proveedor con ejemplos acortados copiados de una guía. Instala las versiones oficiales o de la receta y trata sus manifiestos como parte del contrato de dependencia. Cuando una actualización cambie un requisito de núcleo o biblioteca, compara la documentación de la versión con cada recurso dependiente antes del despliegue.
Qbox y el puente de QBCore
La guía de conversión oficial de Qbox explica cómo el puente de QB apoya la compatibilidad mientras las APIs son reemplazadas de manera incremental. El FAQ de Qbox indica que la mayoría de los scripts de QBCore bien escritos pueden funcionar a través de ese puente, luego identifica excepciones importantes: los recursos que acceden directamente a las tablas de la base de datos, leen o modifican archivos principales internos, o dependen de un comportamiento no soportado pueden necesitar cambios.
| Comportamiento del recurso | Expectativa de migración |
|---|---|
| Usa APIs de QB documentadas cubiertas por el puente | Candidato para pruebas de puente; la compatibilidad aún necesita verificación. |
| Lee directamente las tablas del framework | Audita consultas y supuestos de esquema antes de tocar datos en vivo. |
| Carga archivos internos del núcleo | Refactorizar a exportaciones o módulos soportados donde esté documentado. |
| Da por hecho que los rangos de trabajos o bandas son valores de texto | Revisa los requisitos de conversión de grados numéricos de Qbox. |
| Gestiona los datos de inventario o de personajes | Usa la ruta de conversión documentada y valida cada relación. |
Un producto marcado como compatible con QBCore debe ser probado, por lo tanto, contra Qbox como un objetivo separado. Pregunta si usa solo APIs cubiertas por el puente documentadas, qué sistemas de inventario e interacción espera, y si su SQL asume un esquema QB que Qbox no expone de la misma manera.
Lista de verificación de migración para un servidor QBCore existente
- Congelar e inventariar: registrar núcleo, base de datos, inventario, trabajos, pandillas, vehículos, viviendas, teléfonos, permisos y recursos personalizados.
- Haz una copia de seguridad: crear instantáneas de base de datos y recursos restaurables antes del trabajo de conversión.
- Revisar configuración: Qbox documenta cambios en archivos de configuración y acceso a API; no copies componentes internos antiguos del núcleo sin revisarlos.
- Convertir grados y datos: sigue los pasos oficiales actuales para grados numéricos de trabajos y pandillas, conversión de inventario y base de datos.
- Auditar recursos: clasifica cada integración como cubierta por el puente, adaptable o incompatible.
- Prueba por etapas: valida personajes, dinero, trabajos, bandas, inventario, vehículos, permisos y comportamiento de reconexión.
- Inspecciona la evidencia: revisa los registros del servidor, cliente y base de datos y compara los recuentos de registros clave antes del cambio.
- Mantén la reversión disponible: no modifiques la única base de datos de producción con un fragmento de conversión genérico.
Elige Qbox por razones explícitas
Qbox se ajusta a un nuevo servidor que desea deliberadamente la receta y las API actuales de Qbox. También puede ajustarse a un equipo de QBCore preparado para auditar la compatibilidad del puente y completar el trabajo de conversión documentado. Es un objetivo de migración deficiente cuando los recursos críticos dependen de componentes internos del núcleo no documentados y el equipo no puede reemplazarlos o adaptarlos de manera segura.
No elijas Qbox porque una página prometa que un inventario, biblioteca de bases de datos o framework es automáticamente más rápido. El rendimiento depende del conjunto completo de recursos, la carga de trabajo de la base de datos, el comportamiento del jugador, el artefacto y la configuración del servidor. Si el rendimiento es un factor de decisión, compara acciones representativas en entornos equivalentes y conserva los registros.
Validación de producción
Prueba las acciones exitosas y denegadas, no solo el caso en el que todo funciona. Confirma que los cambios de dinero ocurran una vez, que los permisos de trabajo y de banda rechacen a los jugadores no autorizados, que el inventario permanezca consistente en las reconexiones, que los vehículos propios persistan y que las acciones administrativas se registren. Las solicitudes del cliente deben validarse en el servidor; un evento activado por el cliente no es seguro simplemente porque la interfaz de usuario lo oculte a los jugadores normales.
Utiliza la comparación de frameworks para la decisión más amplia entre ESX/QBCore/Qbox. Al seleccionar del catálogo de scripts de FiveM de pago, comienza con QBOX Scripts y verifica el framework actual, el puente, el inventario y los requisitos de dependencias en la página del producto antes de comprar.
Coloca Qbox en la decisión del framework
Compara la receta actual de Qbox con la guía específica de arquitectura de QBCore y la guía completa para elegir entre ESX, QBCore y Qbox antes de convertir datos de producción.
Documentación de referencia
Fuente: docs.qbox.re · Fuente: docs.qbox.re · Fuente: docs.qbox.re