QBCore es un framework de código abierto para roleplay en FiveM. Su recurso qb-core expone datos compartidos de jugadores, funciones del framework, comandos y definiciones que pueden utilizar otros recursos QB. Para un servidor nuevo, utiliza la receta oficial de QBCore para txAdmin en lugar de considerar la carpeta qb-core una instalación completa.
Puntos clave
qb-corees 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.
- Prepara un entorno de servidor FiveM compatible y un artefacto FXServer actual.
- Inicia txAdmin y crea una nueva implementación utilizando la receta popular oficial de QBCore.
- Proporciona la clave del servidor y la configuración de la base de datos solicitadas en el flujo de configuración documentado.
- Permite que la receta despliegue su SQL y recursos en lugar de copiar manualmente solo
qb-core. - Revisa el
server.cfggenerado, el orden de los recursos y los secretos antes de hacer accesible el servidor. - 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
Empieza por la receta de QBCore para txAdmin mantenida actualmente y la guía oficial de instalación. Una receta prepara una base inicial; no demuestra que un script antiguo de terceros sea compatible con las versiones instaladas del framework, la base de datos, el inventario o el sistema de interacción. Registra el commit de la receta y comprueba cada recurso añadido en un entorno de pruebas antes de usarlo en producción.