QBCore es un marco de interpretación de roles 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-corees el recurso principal, no un servidor de interpretación de roles completo por sí mismo.- La guía oficial de Windows despliega la plantilla popular del Marco 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 planea 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 marco, 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 de marco más amplio. Estas son capacidades arquitectónicas, no pruebas de que cada servidor o recurso tendrá el mismo rendimiento o comportamiento.
Instale QBCore con la receta oficial
La ruta oficial actual de Windows utiliza la interfaz txAdmin incluida con FXServer. En el implementador de recetas, seleccione la plantilla popular del Marco QBCore y siga la guía de instalación actual de QBCore. El repositorio de recetas muestra por qué instalar solo un ZIP es incompleto: proporciona la base de datos y descarga una colección de recursos alrededor de qb-core.
- Prepare un entorno de servidor compatible con FiveM y un artefacto actual de FXServer.
- Inicie txAdmin y cree una nueva implementación utilizando la receta popular oficial de QBCore.
- Proporcione la clave del servidor y la configuración de la base de datos solicitadas en el flujo de configuración documentado.
- Permita que la receta despliegue su SQL y recursos en lugar de copiar manualmente solo
qb-core. - Revise el
server.cfg, orden de recursos y secretos antes de exponer el servidor. - Inicie el servidor y verifique 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 busque 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.
Agregue un recurso de QBCore de manera segura
Antes de instalar un trabajo, inventario, objetivo, teléfono o recurso de interfaz de usuario, registre la versión exacta de qb-core y cada sistema relacionado con el que se integrará. Luego trabaje a través de este límite:
| Controlar | Qué verificar |
|---|---|
| API del Framework | Funciones, exportaciones, eventos y campos de datos del jugador del Objeto Principal requeridos. |
| Dependencias | Recursos de inventario, objetivo, menú, entrada, base de datos y utilidades con 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. |
| Pedido | 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, objetivo o menú de la receta, un script puede requerir un adaptador o cambio de configuración documentado. Aplique los cambios en la base de datos a una copia de prueba primero y mantenga un retroceso que cubra tanto archivos como datos.
A quién le corresponde 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, inventarie la superficie de migración 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 asuma que cada script QBCore es un script Qbox de reemplazo directo. Del mismo modo, no migre de ESX a QBCore basado en una afirmación de rendimiento amplia. Compare la cobertura de recursos, el conocimiento del equipo, la conversión de datos y el plan de prueba.
QBCore, Qbox o ESX
- Manténgase con QBCore cuando sus recursos actuales y equipo ya dependen de APIs QBCore documentadas y el camino de actualización es comprendido.
- Considere Qbox cuando deliberadamente desee sus APIs y receta actuales y pueda auditar excepciones de puente recurso por recurso.
- Manténgase con ESX cuando sus datos de producción, integraciones y conocimiento operativo sean específicos de ESX y no haya una razón probada para migrar.
Utilice la comparación de frameworks para un método de decisión neutral. Al seleccionar entre catálogo de scripts de FiveM de pago, comienza con Scripts de QBCore, confirme los requisitos en la página exacta del producto y prepare el recurso contra una base de datos representativa antes de la producción.
Próximos pasos seguros
- Lea la guía de instalación de Windows QBCore actual y la receta oficial antes de crear el servidor.
- Registe las versiones del núcleo y dependencias desplegadas después de que la receta se complete.
- Elige un recurso a la vez, lee sus notas de instalación oficiales y prueba sus permisos y rutas de fallo.
- Mantén las copias de seguridad de la base de datos y los recursos juntas para que un retroceso restaure un estado consistente.
Compara QBCore antes de comprometerte
Utilice el Comparación de ESX, QBCore y Qbox para la decisión más amplia, luego revisa la migración y límite de compatibilidad de Qbox si se está considerando una pila orientada a Ox.
Use the official QBCore recipe as the installation boundary
Start with the currently maintained QBCore txAdmin recipe and the official installation guide. A recipe provisions a baseline; it does not prove that an older third-party script supports the installed framework, database, inventory or target versions. Record the recipe commit and verify every added resource on staging before production.