Guía del framework QBCore: Arquitectura, Instalación y Compatibilidad

QBCore es un framework de roleplay de código abierto para FiveM. Su qb-core recurso expone datos de jugadores compartidos, funciones del marco, comandos y definiciones que otros recursos de QB pueden usar. Para un servidor nuevo, use la receta oficial de txAdmin de QBCore en lugar de tratar la qb-core carpeta como una instalación completa.

Puntos clave

• qb-core es el recurso principal, no un servidor de roleplay completo por sí mismo.
• La guía oficial de Windows despliega la plantilla popular del Framework QBCore a través de txAdmin.
• La receta oficial incluye la configuración de la base de datos y un conjunto más amplio de recursos de QB.
• La compatibilidad depende de las versiones exactas, dependencias, exportaciones, SQL y el orden de los recursos.
• No existe una fuente oficial que establezca a QBCore como un ganador universal de rendimiento; perfila la pila completa que planeas ejecutar.

Qué proporciona QBCore

El Objeto Principal de QBCore es la interfaz compartida utilizada por muchos recursos de QB. La documentación oficial agrupa sus capacidades en funciones, datos de jugadores, datos compartidos, configuración y comandos. Un recurso puede solicitar solo las partes del Objeto Principal que necesita, pero su superficie de API requerida aún debe coincidir con la versión principal en el servidor.

Las definiciones compartidas incluyen trabajos, pandillas, elementos y vehículos representados en tablas Lua. Las funciones principales cubren operaciones comunes del framework, mientras que los objetos de jugadores exponen datos de personajes estructurados y funciones relacionadas con los jugadores. Los comandos y permisos son parte del modelo del framework más amplio. Estas son capacidades arquitectónicas, no pruebas de que cada servidor o recurso tendrá el mismo rendimiento o comportamiento.

Instala QBCore con la receta oficial

El procedimiento oficial actual de instalación en Windows utiliza la interfaz txAdmin incluida en FXServer. En el desplegador de recetas, selecciona la plantilla popular de QBCore Framework y sigue la guía de instalación actual de QBCore. El repositorio de recetas muestra por qué instalar solo un ZIP es incompleto: aprovisiona la base de datos y descarga una colección de recursos alrededor de qb-core.

1. Prepara un entorno de servidor FiveM compatible y un artefacto FXServer actual.
2. Inicia txAdmin y crea una nueva implementación utilizando la receta popular oficial de QBCore.
3. Proporciona la clave del servidor y la configuración de la base de datos solicitadas en el flujo de configuración documentado.
4. Permite que la receta despliegue su SQL y recursos en lugar de copiar manualmente solo qb-core.
5. Revise el server.cfg, orden de recursos y secretos antes de exponer el servidor.
6. Inicia el servidor y verifica la conectividad de la base de datos, la creación de personajes, los permisos y los registros.

La conexión a la base de datos pertenece a la configuración del servidor utilizada por oxmysql. No busques un campo de conexión a la base de datos genérico en qb-core/config.lua; ese archivo se utiliza para la configuración principal y del jugador.

Agrega un recurso de QBCore de manera segura

Antes de instalar un recurso de trabajos, inventario, interacción, teléfono o interfaz de usuario, anota la versión exacta de qb-core y cada sistema relacionado con el que se integrará. Luego trabaja a través de este límite:

Comprueba	Qué verificar
API del Framework	Funciones, exportaciones, eventos y campos de datos del jugador del Objeto Principal requeridos.
Dependencias	Recursos de inventario, interacción, menús, entrada de datos, base de datos y utilidades, con sus versiones exactas.
Datos	Migraciones SQL, suposiciones de tablas, definiciones de elementos o trabajos y retroceso seguro.
Configuración	Permisos, locales, coordenadas, indicadores de características y secretos solo para el servidor.
Orden	Las dependencias comienzan antes del recurso y no hay reemplazo duplicado activo.
Validación	Roles permitidos y denegados, reconexiones, reinicios, registros del cliente y registros del servidor.

Una etiqueta de producto que dice QBCore es solo la primera señal de compatibilidad. Si el servidor reemplaza la capa de inventario, interacción o menú de la receta, un script puede requerir un adaptador documentado o un cambio de configuración. Aplica los cambios de la base de datos a una copia de prueba primero y mantén un rollback que cubra tanto los archivos como los datos.

Para quién es adecuado QBCore

QBCore es un candidato razonable para un nuevo servidor cuyos recursos requeridos soportan explícitamente el ecosistema QB actual, o un servidor QB existente que ya usa su Objeto Principal y modelo de datos. La elección se vuelve más costosa cuando un equipo tiene un gran conjunto de datos ESX, scripts específicos del framework o eventos personalizados no documentados. En ese caso, haz un inventario de todo lo que debas migrar antes de seleccionar un nuevo framework.

Qbox comenzó a partir de la base de código QBCore y proporciona un puente de compatibilidad para muchos recursos QB bien escritos, pero la documentación oficial de Qbox lista excepciones. No asumas que cada script QBCore es un script Qbox de reemplazo directo. Del mismo modo, no migres de ESX a QBCore basado en una afirmación de rendimiento amplia. Compara la cobertura de recursos, el conocimiento del equipo, la conversión de datos y el plan de prueba.

QBCore, Qbox o ESX

• Mantente con QBCore cuando tus recursos actuales y equipo ya dependen de APIs QBCore documentadas y el camino de actualización es comprendido.
• Considera Qbox cuando deliberadamente desees sus APIs y receta actuales y puedas auditar excepciones de puente recurso por recurso.
• Mantente con ESX cuando tus datos de producción, integraciones y conocimiento operativo sean específicos de ESX y no haya una razón probada para migrar.

Utiliza la comparación de frameworks para un método de decisión neutral. Al elegir en el catálogo de scripts de FiveM de pago, comienza con Scripts de QBCore, confirma los requisitos en la página exacta del producto y prueba el recurso en preproducción con una base de datos representativa antes de la producción.

Utiliza la receta oficial de QBCore como límite de instalación

Comience con la receta de QBCore txAdmin actualmente mantenida y la guía de instalación oficial. Una receta proporciona una base; no prueba que un script de terceros más antiguo sea compatible con el framework, la base de datos, el inventario o las versiones instaladas del sistema de interacción. Registra el commit de la receta y verifica cada recurso añadido en staging antes de la producción.