RexHost — Hosting y VPS
Todas las guías
FiveMIntermedio

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
  1. 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.

  2. 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ú compres
  3. Conecta 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"
  4. 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.

  5. 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.

  6. 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 },
        },
    },
  7. 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] god
  8. Arranca 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
  9. Lo que casi todo QBCore acaba llevando

    La base con la que arrancan la mayoría de las ciudades hispanas:

    NecesidadRecurso
    Inventarioox_inventory o qb-inventory
    Interacciónox_target o qb-target
    Voz por proximidadpma-voice
    Teléfonoqb-phone, lb-phone o npwd
    Ropa y aparienciaillenium-appearance o fivem-appearance
    Vehículos y concesionarioqb-vehicleshop, qb-garages
    Trabajos baseqb-policejob, qb-ambulancejob
    AdministracióntxAdmin + qb-adminmenu
  10. 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 ayuda

¿Todavía no tienes servidor?

QBCore · ESX · vRP · qbox, desde $547 al mes.

Ver planes de FiveM