Cómo instalar QBCore en FiveM

El problema

Quieres montar un servidor QBCore desde cero pero no sabes qué recursos hace falta, en qué orden cargarlos ni cómo conectar la base de datos. Un orden mal puesto suele acabar en «attempt to index a nil value (QBCore)».

La causa

QBCore no es un único recurso: es qb-core más una familia de recursos (multicharacter, spawn, apartments, target, menu, input) que dependen de oxmysql y de una base de datos MySQL bien conectada. Si oxmysql o qb-core no cargan antes que el resto, los demás recursos arrancan sin core y todo falla.

La solución

Lo más rápido y fiable es usar el deployment recipe oficial de QBCore desde txAdmin (te descarga el framework completo y crea la base de datos por ti). Si lo montas a mano, instala oxmysql + qb-core + los recursos qb, importa los .sql, define la cadena de conexión MySQL y respeta este orden de ensure en server.cfg:

# server.cfg — conexión a la base de datos (oxmysql)
set mysql_connection_string "mysql://usuario:password@localhost/qbcore?charset=utf8mb4"

# ORDEN DE ENSURE (crítico): primero la base de datos, luego el core, luego el resto
ensure oxmysql        # 1) capa de base de datos: SIEMPRE primero
ensure qb-core        # 2) el core: define exports['qb-core']:GetCoreObject()

# 3) recursos qb (dependen de qb-core, van después)
ensure qb-multicharacter
ensure qb-spawn
ensure qb-apartments
ensure qb-target
ensure qb-menu
ensure qb-input

# 4) a partir de aquí, tus propios recursos
# ensure mi_recurso

Paso a paso

1. 1.Requisitos previos: ten un FXServer (artifacts) actualizado, un servidor MySQL/MariaDB y crea una base de datos vacía (por ejemplo `qbcore`).
2. 2.Forma fácil (recomendada): en txAdmin elige «Deployment» → recipe de QBCore. Descarga qb-core y todos los recursos qb automáticamente y te configura la base de datos.
3. 3.Forma manual: descarga oxmysql y qb-core, más qb-multicharacter, qb-spawn, qb-apartments, qb-target, qb-menu y qb-input desde el GitHub oficial de Qbox/QBCore.
4. 4.Importa los archivos .sql de qb-core (y de cada recurso que traiga el suyo) en tu base de datos con HeidiSQL, phpMyAdmin o `mysql < qb-core.sql`.
5. 5.En server.cfg define `set mysql_connection_string` con tu usuario, contraseña, host y nombre de base de datos.
6. 6.Coloca el orden de ensure correcto: oxmysql → qb-core → recursos qb → tus recursos. Reinicia el servidor completo, no solo un recurso.
7. 7.En tus scripts obtén el core con `local QBCore = exports['qb-core']:GetCoreObject()` (no asumas una global QBCore vacía).

Guías relacionadas