¿Cómo instalo QBCore en mi servidor de FiveM con txAdmin?

QBCore es el framework de roleplay más popular para FiveM, pero instalarlo a mano — decenas de resources, una base de datos y un server.cfg que funcione — es un trabajo propenso a errores. La buena noticia: txAdmin incluye una recipe lista para usar que monta el framework completo en cuestión de minutos. En esta guía primero crearás una base de datos en el panel, después desplegarás la recipe de QBCore con el asistente de configuración de txAdmin y, por último, entrarás en tu propia ciudad como admin.

¿QBCore o Qbox? Qbox (qbx_core) es una evolución moderna de QBCore, con desarrollo activo, mejor rendimiento y una seguridad más sólida. La lista de recipes de txAdmin incluye ambos frameworks y los pasos de abajo son idénticos para los dos; si te decides por Qbox, simplemente selecciona esa recipe en el paso 3. ¿Empiezas totalmente de cero y aún no has comprado scripts específicos de QBCore? Entonces merece la pena plantearse Qbox.

Paso 1: crea una base de datos en el panel

1. Inicia sesión en el panel de MC-Node y abre tu servidor de FiveM.
2. Ve a la pestaña Databases y haz clic en New Database. Si no ves el botón o has llegado a tu límite, lee ¿Cómo creo y gestiono una base de datos?
3. Ponle a la base de datos un nombre reconocible, por ejemplo qbcore, y confirma.
4. Abre los detalles de la nueva base de datos y apunta cuatro datos: el endpoint (el host, incluido el número de puerto que lo acompaña), el nombre de la base de datos, el nombre de usuario y la contraseña (visible con el icono del ojo).

Ojo: el host es una dirección de base de datos propia, no localhost. Si más adelante escribes localhost o 127.0.0.1, tu servidor nunca podrá llegar a la base de datos. Tienes más contexto en ¿Cómo me conecto a mi base de datos?

Paso 2: abre txAdmin

1. Comprueba que txAdmin está activado en tu servidor. Si todavía no lo está, sigue primero ¿Cómo activo txAdmin?
2. Arranca tu servidor desde la pestaña Console.
3. En la salida de la consola aparece la dirección de txAdmin junto con un código PIN de cuatro dígitos. El PIN solo es válido unos minutos; si ha caducado, reinicia el servidor para obtener uno nuevo.
4. Abre la dirección (http://ip-del-servidor:puerto-txadmin) en tu navegador, inicia sesión con tu cuenta de Cfx.re e introduce el PIN. Esta vinculación solo hace falta la primera vez: tu cuenta pasa a ser la cuenta master de este txAdmin.

Paso 3: despliega la recipe de QBCore con el asistente de configuración

1. Como todavía no hay ningún servidor configurado, txAdmin abre automáticamente el asistente de configuración. Dale un nombre a tu servidor.
2. En el tipo de instalación elige Popular Recipes y selecciona QBCore Framework (o Qbox).
3. Introduce tu license key de Cfx.re. Puedes crear una gratis en portal.cfx.re; cómo funciona exactamente lo tienes en He comprado un servidor de FiveM, ¿y ahora qué?
4. En los campos de la base de datos introduce exactamente los datos del paso 1: host (con el número de puerto), nombre de usuario, contraseña y nombre de la base de datos.
5. Inicia el despliegue. txAdmin descarga entonces todos los resources de QBCore, importa las tablas SQL en tu base de datos y genera un server.cfg. Suele tardar unos minutos.
6. Al terminar, revisa el server.cfg generado (los valores por defecto van bien para empezar) y haz clic en Save & Run Server.

Paso 4: primer arranque, hacerte admin y entrar en la ciudad

1. Sigue el primer arranque en la consola de txAdmin y espera a que se carguen todos los resources y dejen de aparecer errores en rojo.
2. Abre el cliente de FiveM, pulsa F8 y escribe connect ip:puerto con la dirección de tu servidor (la encontrarás en el panel).
3. Aterrizarás en el menú de personajes: crea tu primer personaje y elige una ubicación inicial o un apartamento.
4. Hacerte admin: abre en txAdmin la página Live Console y escribe setgroup 1 god, sustituyendo 1 por tu ID en el servidor (visible en la página Players de txAdmin). Con el grupo god puedes abrir el menú de admin dentro de la ciudad, por defecto con /admin.

Problemas habituales

• Connection refused o Access denied (oxmysql) — los datos de la base de datos no son correctos. La recipe los escribe en la línea set mysql_connection_string del server.cfg; abre ese archivo desde la pestaña Files y revisa el host con su número de puerto, el nombre de usuario (incluido el prefijo, si lo hay), la contraseña y el nombre de la base de datos. No uses nunca localhost. Después reinicia el servidor.
• Recipe ejecutada sobre una instalación existente — el deployer espera un entorno limpio. Si pasas el asistente por encima de una instalación anterior, acabarás con resources en conflicto y tablas duplicadas en la base de datos. Haz primero una copia de seguridad desde la pestaña Backups, elimina después los archivos antiguos del servidor (o pide que reinstalen tu servidor) y usa una base de datos vacía o nueva.
• La license key falta o ya está en uso — sin una key válida FiveM no arranca, y una misma key solo puede funcionar en un servidor activo a la vez. Crea una key nueva en Keymaster y cámbiala desde la pestaña Startup; los detalles están en ¿Cómo cambio mi license key de FiveM?
• La página de txAdmin no carga — comprueba que el puerto de txAdmin está configurado y que tu servidor está realmente en marcha; los pasos están en el artículo de txAdmin del paso 2.

¿Necesitas ayuda?

¡Enhorabuena, tu ciudad ya está en marcha! A partir de aquí puedes añadir resources, configurar jobs y seguir dando forma a tu servidor. ¿Te has quedado atascado en algún punto, por ejemplo con un despliegue que se detiene a mitad? Abre un ticket en nuestra página de soporte e indica el nombre de tu servidor y el error de la consola de txAdmin — le echamos un vistazo contigo.