Monta un servidor QBCore desde cero
Instalación limpia, items compartidos, trabajos, permisos y las trampas del primer día.
11 min de lectura · 10 pasos
Antes de empezar
- Un servidor de FiveM con su llave de licencia ya puesta
- La base de datos MySQL creada desde el panel
- El repositorio qbcore-framework a mano
Descarga la plantilla oficial, no un «pack completo»
QBCore publica un txAdmin recipe y los repositorios sueltos en github.com/qbcore-framework. Los «QBCore completo con 200 scripts» que circulan por Discord traen scripts pirateados y, muy a menudo, puertas traseras. Monta la base limpia y añade tú lo que compres.
La forma más rápida y limpia de instalarlo es la receta de txAdmin: Setup → Recipe → QBCore. Deja la estructura correcta y la base de datos importada sola.
Estructura de carpetas
QBCore reparte sus recursos por grupos temáticos. Respétalo: los tutoriales y los scripts que compres dan por hecha esta disposición.
resources/ ├── [qb]/ → qb-core y todo lo del framework ├── [standalone]/ → oxmysql, ox_lib, PolyZone, progressbar ├── [voice]/ → pma-voice ├── [defaultmaps]/ └── [mis-scripts]/ → lo que tú compresConecta la base de datos e importa el esquema
qb-core trae su .sql en la carpeta del repositorio. Impórtalo antes de arrancar. Crea players, bans, apartments, player_vehicles y las demás.
server.cfg
set mysql_connection_string "mysql://usuario:contraseña@localhost/tu_bd?charset=utf8mb4"server.cfg de QBCore que arranca
Ojo con el orden: qb-core va antes que cualquier cosa que dependa de él, y oxmysql antes que qb-core.
server.cfg
# --- Red --- endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" sv_maxclients 64 set onesync on sv_enforceGameBuild 3095 # --- Base --- ensure oxmysql ensure ox_lib ensure [standalone] # --- Framework --- ensure qb-core ensure [qb] # --- Voz --- ensure pma-voice # --- Lo tuyo --- ensure [mis-scripts] sv_hostname "Mi servidor de RP" sv_licenseKey "tu_llave_de_keymaster" sets locale "es-MX"sv_enforceGameBuild fija la versión de GTA con la que entran tus jugadores. Si tus MLOs o vehículos son de un DLC reciente, sin esta línea no se ven. Y si la subes, todos tus jugadores tienen que tener el juego actualizado.
Los objetos viven en un archivo, no en la base
Es la diferencia más práctica con ESX y la que más despista: en QBCore los objetos se declaran en shared/items.lua. Si compras un script que añade objetos, sus líneas van aquí o el objeto no existirá.
resources/[qb]/qb-core/shared/items.lua
['radio'] = { ['name'] = 'radio', ['label'] = 'Radio', ['weight'] = 1000, ['type'] = 'item', ['image'] = 'radio.png', ['unique'] = true, ['useable'] = true, ['shouldClose'] = true, ['description'] = 'Para hablar con tu equipo' },El campo image tiene que corresponder a un archivo real en el inventario (qb-inventory/html/images/ o ox_inventory/web/images/). Sin la imagen el objeto funciona pero se ve como un cuadro roto, y llueven los reportes.
Trabajos y bandas, también en shared
Los trabajos se declaran en shared/jobs.lua con sus grados y sueldos. Es lo primero que vas a tocar para adaptar el servidor a tu ciudad.
resources/[qb]/qb-core/shared/jobs.lua
['policia'] = { label = 'Policía', type = 'leo', defaultDuty = true, offDutyPay = false, grades = { ['0'] = { name = 'Cadete', payment = 50 }, ['1'] = { name = 'Oficial', payment = 75 }, ['2'] = { name = 'Sargento', payment = 100, isboss = true }, }, },Ponte administrador
QBCore usa el sistema de permisos de FiveM combinado con el suyo. Con esto tienes los dos:
server.cfg
add_ace group.admin command allow add_principal identifier.license:tu_identificador group.admin # Y en QBCore, desde la consola del servidor: # /addpermission [id] godArranca y comprueba
Entra y recorre lo básico antes de meter un solo script comprado:
- Crear personaje, ver que aparezca en la tabla players con su citizenid
- /setjob, /giveitem, /addmoney funcionando
- El inventario abre y los objetos se ven con su imagen
- El teléfono abre, si instalaste qb-phone o similar
- La voz funciona: pma-voice es la que se rompe más callada
Lo que casi todo QBCore acaba llevando
La base con la que arrancan la mayoría de las ciudades hispanas:
Necesidad Recurso Inventario ox_inventory o qb-inventory Interacción ox_target o qb-target Voz por proximidad pma-voice Teléfono qb-phone, lb-phone o npwd Ropa y apariencia illenium-appearance o fivem-appearance Vehículos y concesionario qb-vehicleshop, qb-garages Trabajos base qb-policejob, qb-ambulancejob Administración txAdmin + qb-adminmenu Qbox, si empiezas hoy
Si vas a montar todo desde cero, mira Qbox antes de decidir: es este mismo framework reescrito sobre ox_lib y ox_inventory, rinde mejor y acepta la mayoría de scripts de QBCore. La documentación de conversión que publican es corta de verdad.
Lo que nos preguntan después
¿Qué diferencia hay entre citizenid y license?
El license identifica la cuenta de Rockstar del jugador; el citizenid identifica a cada uno de sus personajes. Un jugador puede tener varios citizenid y un solo license.
El objeto no aparece aunque lo añadí a items.lua
Reinicia qb-core entero, no solo el inventario. Y comprueba que no dejaste una coma de más al final de la tabla: el Lua se rompe callado.
¿Se te atoró algo?
Escríbenos y lo vemos contigo. Si la duda se repite, la agregamos a esta guía.
Pedir ayudaGuías relacionadas
BásicoFiveMESX, QBCore, Qbox o vRP: cuál elegir y en qué se diferencian
La decisión que condiciona todos los scripts que vas a comprar los próximos dos años.
8 min9 pasos
AvanzadoFiveMConvierte un script de ESX a QBCore (y al revés)
La tabla de equivalencias completa. Con esto, casi cualquier script del otro framework se adapta en media hora.
12 min11 pasos
IntermedioFiveMox_lib, ox_inventory y oxmysql: la base moderna de FiveM
Las tres piezas que hoy usan casi todos los scripts nuevos, funcionen sobre ESX o sobre QBCore.
9 min10 pasos

