Fundamentos: tu primer recurso en QBCore · Lección 1/5 · 7 min

Qué es un recurso y cómo importar QBCore

Un recurso es una carpeta con un fxmanifest.lua. Aquí aprendes a estructurarlo y a engancharlo a QBCore.

En FiveM todo lo que añades a tu servidor es un «recurso»: una carpeta dentro de resources/ con un fxmanifest.lua. Ese manifiesto le dice al servidor qué scripts cargar y en qué contexto (cliente, servidor o compartido). En un servidor QBCore, además, tu recurso necesita que el core (qb-core) esté cargado antes.

La estructura mínima

text
resources/
└── [custom]/
    └── mi_primer_script/
        ├── fxmanifest.lua
        ├── client.lua
        └── server.lua

Carpeta del recurso

El fxmanifest.lua con QBCore

lua
fx_version 'cerulean'
game 'gta5'

author 'TuNombre'
description 'Mi primer recurso QBCore'
version '1.0.0'

-- QBCore se obtiene por export, no hace falta importarlo en shared,
-- pero SÍ debes declararlo como dependencia para el orden de carga:
shared_scripts {
  'config.lua',
}

client_scripts {
  'client.lua',
}

server_scripts {
  'server.lua',
}

dependency 'qb-core'

fxmanifest.lua

  • client_scripts: corren en el PC de cada jugador. NO son de confianza.
  • server_scripts: corren en tu servidor. Son la autoridad.
  • shared_scripts: se cargan en ambos lados (ideal para config.lua).
  • dependency 'qb-core': asegura que el core arranca antes que tu recurso.

Para activarlo, ponlo en resources/[custom]/ y añade ensure mi_primer_script en tu server.cfg DESPUÉS de ensure qb-core. Recarga con refresh + ensure mi_primer_script.

Practica lo aprendido

0/3
Test

¿Qué es un «recurso» en FiveM?

Rellena los huecos

Completa la línea del fxmanifest que garantiza que el core arranca antes que tu recurso.

1client_scripts {
2 'client.lua',
3}
4
5server_scripts {
6 'server.lua',
7}
8
9 'qb-core'
Pista

No se importa qb-core en shared_scripts; se declara como dependencia para fijar el orden de carga.

Test

¿En qué se diferencian client_scripts y server_scripts?

Reto: prográmalo tú

Crea un fxmanifest.lua para un recurso QBCore llamado «taxi_job» con client.lua, server.lua y config.lua compartido, declarando qb-core como dependencia.

Escríbelo tú en tu editor (VS Code) y pruébalo en tu servidor. Aquí se aprende haciéndolo, no copiando.

Ver pista

Usa fx_version 'cerulean', game 'gta5', las tres listas de scripts y dependency 'qb-core'.

Escribe aquí tu solución:

¿Qué tal esta lección?