{"id":147431,"date":"2024-07-11T20:13:19","date_gmt":"2024-07-11T18:13:19","guid":{"rendered":"https:\/\/hifivem.com\/?p=147431"},"modified":"2026-08-09T14:39:21","modified_gmt":"2026-08-09T12:39:21","slug":"qbcore","status":"publish","type":"post","link":"https:\/\/rpcrate.com\/es\/qbcore\/","title":{"rendered":"Gu\u00eda del framework QBCore: Arquitectura, Instalaci\u00f3n y Compatibilidad"},"content":{"rendered":"<p class=\"translation-block\"><strong>QBCore es un framework de c\u00f3digo abierto para roleplay en FiveM.<\/strong> Su recurso <code>qb-core<\/code> 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 <code>qb-core<\/code> una instalaci\u00f3n completa.<\/p>\n<h2 id=\"key-takeaways\">Puntos clave<\/h2>\n<ul>\n<li><code data-no-translation=\"\" translate=\"no\">qb-core<\/code> es el recurso principal, no un servidor de roleplay completo por s\u00ed mismo.<\/li>\n<li>La gu\u00eda oficial de Windows despliega la plantilla popular del Framework QBCore a trav\u00e9s de txAdmin.<\/li>\n<li>La receta oficial incluye la configuraci\u00f3n de la base de datos y un conjunto m\u00e1s amplio de recursos de QB.<\/li>\n<li>La compatibilidad depende de las versiones exactas, dependencias, exportaciones, SQL y el orden de los recursos.<\/li>\n<li>No existe una fuente oficial que establezca a QBCore como un ganador universal de rendimiento; perfila la pila completa que planeas ejecutar.<\/li>\n<\/ul>\n<h2 id=\"what-qbcore-provides\">Qu\u00e9 proporciona QBCore<\/h2>\n<p>El Objeto Principal de QBCore es la interfaz compartida utilizada por muchos recursos de QB. La documentaci\u00f3n oficial agrupa sus capacidades en funciones, datos de jugadores, datos compartidos, configuraci\u00f3n y comandos. Un recurso puede solicitar solo las partes del Objeto Principal que necesita, pero su superficie de API requerida a\u00fan debe coincidir con la versi\u00f3n principal en el servidor.<\/p>\n<p>Las definiciones compartidas incluyen trabajos, pandillas, elementos y veh\u00edculos 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\u00e1s amplio. Estas son capacidades arquitect\u00f3nicas, no pruebas de que cada servidor o recurso tendr\u00e1 el mismo rendimiento o comportamiento.<\/p>\n<h2 id=\"install-qbcore-with-the-official-recipe\">Instala QBCore con la receta oficial<\/h2>\n<p>El procedimiento oficial actual de instalaci\u00f3n 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\u00eda de instalaci\u00f3n actual de QBCore. El repositorio de recetas muestra por qu\u00e9 instalar solo un ZIP es incompleto: aprovisiona la base de datos y descarga una colecci\u00f3n de recursos alrededor de <code data-no-translation=\"\" translate=\"no\">qb-core<\/code>.<\/p>\n<ol>\n<li>Prepara un entorno de servidor FiveM compatible y un artefacto FXServer actual.<\/li>\n<li>Inicia txAdmin y crea una nueva implementaci\u00f3n utilizando la receta popular oficial de QBCore.<\/li>\n<li>Proporciona la clave del servidor y la configuraci\u00f3n de la base de datos solicitadas en el flujo de configuraci\u00f3n documentado.<\/li>\n<li>Permite que la receta despliegue su SQL y recursos en lugar de copiar manualmente solo <code data-no-translation=\"\" translate=\"no\">qb-core<\/code>.<\/li>\n<li class=\"translation-block\">Revisa el <code>server.cfg<\/code> generado, el orden de los recursos y los secretos antes de hacer accesible el servidor.<\/li>\n<li>Inicia el servidor y verifica la conectividad de la base de datos, la creaci\u00f3n de personajes, los permisos y los registros.<\/li>\n<\/ol>\n<p>La conexi\u00f3n a la base de datos pertenece a la configuraci\u00f3n del servidor utilizada por oxmysql. No busques un campo de conexi\u00f3n a la base de datos gen\u00e9rico en <code data-no-translation=\"\" translate=\"no\">qb-core\/config.lua<\/code>; ese archivo se utiliza para la configuraci\u00f3n principal y del jugador.<\/p>\n<h2 id=\"add-a-qbcore-resource-safely\">Agrega un recurso de QBCore de manera segura<\/h2>\n<p>Antes de instalar un recurso de trabajos, inventario, interacci\u00f3n, tel\u00e9fono o interfaz de usuario, anota la versi\u00f3n exacta de <code data-no-translation=\"\" translate=\"no\">qb-core<\/code> y cada sistema relacionado con el que se integrar\u00e1. Luego trabaja a trav\u00e9s de este l\u00edmite:<\/p>\n<div aria-label=\"Tabla con desplazamiento horizontal\" class=\"fmx-guide-table\" role=\"region\" tabindex=\"0\">\n<table>\n<thead>\n<tr>\n<th>Comprueba<\/th>\n<th>Qu\u00e9 verificar<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>API del Framework<\/td>\n<td>Funciones, exportaciones, eventos y campos de datos del jugador del Objeto Principal requeridos.<\/td>\n<\/tr>\n<tr>\n<td>Dependencias<\/td>\n<td>Recursos de inventario, interacci\u00f3n, men\u00fas, entrada de datos, base de datos y utilidades, con sus versiones exactas.<\/td>\n<\/tr>\n<tr>\n<td>Datos<\/td>\n<td>Migraciones SQL, suposiciones de tablas, definiciones de elementos o trabajos y retroceso seguro.<\/td>\n<\/tr>\n<tr>\n<td>Configuraci\u00f3n<\/td>\n<td>Permisos, locales, coordenadas, indicadores de caracter\u00edsticas y secretos solo para el servidor.<\/td>\n<\/tr>\n<tr>\n<td>Orden<\/td>\n<td>Las dependencias comienzan antes del recurso y no hay reemplazo duplicado activo.<\/td>\n<\/tr>\n<tr>\n<td>Validaci\u00f3n<\/td>\n<td>Roles permitidos y denegados, reconexiones, reinicios, registros del cliente y registros del servidor.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<p>Una etiqueta de producto que dice QBCore es solo la primera se\u00f1al de compatibilidad. Si el servidor reemplaza la capa de inventario, interacci\u00f3n o men\u00fa de la receta, un script puede requerir un adaptador documentado o un cambio de configuraci\u00f3n. Aplica los cambios de la base de datos a una copia de prueba primero y mant\u00e9n un rollback que cubra tanto los archivos como los datos.<\/p>\n<h2 id=\"who-qbcore-fits\">Para qui\u00e9n es adecuado QBCore<\/h2>\n<p>QBCore es un candidato razonable para un nuevo servidor cuyos recursos requeridos soportan expl\u00edcitamente el ecosistema QB actual, o un servidor QB existente que ya usa su Objeto Principal y modelo de datos. La elecci\u00f3n se vuelve m\u00e1s costosa cuando un equipo tiene un gran conjunto de datos ESX, scripts espec\u00edficos 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.<\/p>\n<p>Qbox comenz\u00f3 a partir de la base de c\u00f3digo QBCore y proporciona un puente de compatibilidad para muchos recursos QB bien escritos, pero la documentaci\u00f3n 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\u00f3n de rendimiento amplia. Compara la cobertura de recursos, el conocimiento del equipo, la conversi\u00f3n de datos y el plan de prueba.<\/p>\n<h2 id=\"qbcore-qbox-or-esx\">QBCore, Qbox o ESX<\/h2>\n<ul>\n<li><strong>Mantente con QBCore<\/strong> cuando tus recursos actuales y equipo ya dependen de APIs QBCore documentadas y el camino de actualizaci\u00f3n es comprendido.<\/li>\n<li><strong>Considera Qbox<\/strong> cuando deliberadamente desees sus APIs y receta actuales y puedas auditar excepciones de puente recurso por recurso.<\/li>\n<li><strong>Mantente con ESX<\/strong> cuando tus datos de producci\u00f3n, integraciones y conocimiento operativo sean espec\u00edficos de ESX y no haya una raz\u00f3n probada para migrar.<\/li>\n<\/ul>\n<p>Utiliza la comparaci\u00f3n de frameworks para un m\u00e9todo de decisi\u00f3n neutral. Al elegir en el <a href=\"https:\/\/rpcrate.com\/es\/shop\/\">cat\u00e1logo de scripts de FiveM de pago<\/a>, comienza con <a href=\"https:\/\/rpcrate.com\/es\/scripts-de-qbcore\/\">Scripts de QBCore<\/a>, confirma los requisitos en la p\u00e1gina exacta del producto y prueba el recurso en preproducci\u00f3n con una base de datos representativa antes de la producci\u00f3n.<\/p>\n<h2 id=\"use-the-official-qbcore-recipe-as-the-installation-boundary\">Utiliza la receta oficial de QBCore como l\u00edmite de instalaci\u00f3n<\/h2>\n<p class=\"translation-block\">Empieza por la <a href=\"https:\/\/github.com\/qbcore-fivem\/txAdminRecipe\" rel=\"nofollow noopener\">receta de QBCore para txAdmin<\/a> mantenida actualmente y la <a href=\"https:\/\/qbcore.org\/docs\/guides\/windows-installation\" rel=\"nofollow noopener\">gu\u00eda oficial de instalaci\u00f3n<\/a>. 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\u00f3n. Registra el commit de la receta y comprueba cada recurso a\u00f1adido en un entorno de pruebas antes de usarlo en producci\u00f3n.<\/p>","protected":false},"excerpt":{"rendered":"<p class=\"translation-block\"><strong>QBCore es un framework de c\u00f3digo abierto para roleplay en FiveM.<\/strong> Su recurso <code>qb-core<\/code> 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 <code>qb-core<\/code> una instalaci\u00f3n completa.<\/p>","protected":false},"author":1,"featured_media":152045,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2347],"tags":[2950,2859],"class_list":["post-147431","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-frameworks","tag-framework","tag-qbcore"],"_links":{"self":[{"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/posts\/147431","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/comments?post=147431"}],"version-history":[{"count":7,"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/posts\/147431\/revisions"}],"predecessor-version":[{"id":215650,"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/posts\/147431\/revisions\/215650"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/media\/152045"}],"wp:attachment":[{"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/media?parent=147431"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/categories?post=147431"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rpcrate.com\/es\/wp-json\/wp\/v2\/tags?post=147431"}],"curies":[{"name":"gracias","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}