Qbox es un marco de interpretación de roles 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. Use la receta oficial de txAdmin de Qbox para una nueva instalación y audite cada recurso antes de una migración.
Puntos clave
- Qbox es un marco, no simplemente un paquete de utilidades de Ox o una carpeta de QBCore renombrada.
- La ruta de instalación oficial actual es la receta más popular de QBox en 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. El proyecto ha desarrollado desde entonces 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 marco y receta.
El actual núcleo qbx manifest declara directamente biblioteca de buey y oxmysql dependencias. La receta oficial reúne Qbox y recursos de terceros seleccionados en una pila de inicio completa. Como el contenido de la receta puede cambiar, enlace a la receta actual en lugar de congelar una larga lista de dependencias en un tutorial de instalación evergreen.
Instale Qbox a través de la receta oficial
- Prepare un entorno FXServer compatible y abra su configuración txAdmin incluida.
- Cumpla con los requisitos de la base de datos listados en la documentación de instalación actual de Qbox.
- Seleccione la receta oficial más popular de QBox en lugar de ensamblar un núcleo parcial manualmente.
- Complete las variables de la receta, la configuración de la base de datos y la configuración del servidor utilizando la documentación actual.
- Revise la lista de recursos generada y el orden de inicio antes del primer inicio público.
- Verifique la carga de jugadores, la creación de personajes, los permisos, la persistencia y los registros en un servidor de prueba.
No reemplace los manifiestos del proveedor con ejemplos acortados copiados de una guía. Instale las versiones oficiales o de la receta y trate sus manifiestos como parte del contrato de dependencia. Cuando una actualización cambie un requisito de núcleo o biblioteca, compare 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 tablas de marco directamente | Audite 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. |
| Asume trabajos de texto o grados de pandilla | Revisar los requisitos de conversión de grados numéricos de Qbox. |
| Posee datos de inventario o caracteres | Use la ruta de conversión documentada y valide cada relación. |
Un producto marcado como compatible con QBCore debe ser probado, por lo tanto, contra Qbox como un objetivo separado. Pregunte si usa solo APIs cubiertas por el puente documentadas, qué sistemas de inventario y objetivo 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.
- Copiar 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 copie internos antiguos del núcleo de manera ciega.
- Convertir grados y datos: siga los pasos oficiales actuales para grados numéricos de trabajos y pandillas, conversión de inventario y base de datos.
- Auditar recursos: clasificar cada integración como cubierta por el puente, adaptable o incompatible.
- Probar en etapas: validar personajes, dinero, trabajos, pandillas, inventario, vehículos, permisos y comportamiento de reconexión.
- Inspeccionar evidencia: revisar registros del servidor, cliente y base de datos y comparar conteos de registros clave antes del corte.
- Mantener disponible el rollback: no mutar la única base de datos de producción con un fragmento de conversión genérico.
Elegir Qbox por razones explícitas
Qbox se ajusta a un nuevo servidor que deliberadamente quiere la receta y las APIs 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 mal objetivo de migración cuando los recursos críticos dependen de internos principales no documentados y el equipo no puede reemplazarlos o adaptarlos de manera segura.
No elija Qbox porque una página prometa que un inventario, biblioteca de bases de datos o marco 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, realice benchmarks de acciones representativas en entornos equivalentes y conserve los registros.
Validación de producción
Pruebe las acciones exitosas y denegadas, no solo el camino feliz. Confirme que los cambios de dinero ocurran una vez, que los permisos de trabajo y pandilla rechacen a los jugadores no autorizados, que el inventario permanezca consistente en las reconexiones, que los vehículos propiedad persistan y que las acciones administrativas sean registradas. Las solicitudes del cliente deben ser validadas en el servidor; un evento desencadenado por el cliente no es seguro solo porque el UI lo oculte de 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 Scripts de QBOX y verifica el framework actual, el puente, el inventario y los requisitos de dependencias en la página del producto antes de comprar.
Colocar Qbox en la decisión del marco
Compare la receta actual de Qbox con la dedicada guía de arquitectura de QBCore y la completa guía de decisión de ESX, QBCore y Qbox antes de convertir los datos de producción.
