Prueba ya Smartphone V3Consíguelo Black Friday empieza enBlack Friday · 25% de descuento en toda la tienda · Tiempo limitadoComprar ahora

QUASARSTORE

[71.10] Quasar Framework (qs-core)

Configuración

Configura Quasar Framework (qs-core) para FiveM: dinero, sueldos, tema, idiomas, ítems, trabajos, inventario, armas y pantalla de carga. Para ESX y QBCore.

Sección: 71.10
Leer: 18 min
Actualizado: 1 nov

■ 18 min read · Actualizado 1 nov 2026

Todo lo que cambia el dueño de un servidor en Quasar Framework (qs-core) está en archivos de configuración Lua sencillos y en server.cfg. Esta página es la referencia completa de este framework de roleplay para FiveM: cada opción de la config principal, los colores del tema, los idiomas, los ítems, los trabajos y las bandas, los ajustes del inventario y de las armas, y la pantalla de carga. Cada sección lista la opción, su valor por defecto y lo que cambia en el juego, seguido de un breve ejemplo.

Archivo	Qué configura
`[core]/qs-core/shared/config.lua`	Cuentas, personajes, aparición, guardado, sueldos, muerte, mundo, webhooks, baneos, backend del inventario, tema e identificadores.
`[core]/qs-core/shared/items.lua`	El catálogo base de ítems.
`[core]/qs-core/shared/jobs.lua`	Trabajos, rangos y salarios.
`[core]/qs-core/shared/gangs.lua`	Bandas y rangos de bandas.
`[core]/qs-core/locales/*.lua`	Los textos de qs-core en cada idioma (cada recurso tiene su propia carpeta `locales`).
`[core]/qs-coreinventory/shared/config.lua`	Slots y peso del inventario, maleteros, guanteras, almacenes, pilas, llaves e ítems iniciales.
`[core]/qs-coreweapons/config.lua`	Tamaños de cargador, arrojables, y los ítems de armas y munición.
`[core]/loadingscreen/config.js`	Nombre, textos, pistas de teclas y consejos de la pantalla de carga.
`server.cfg`	Idioma (`setr qs:locale`), administradores y la lista de recursos.

Ajustes principales — qs-core/shared/config.lua#

Esta es la config principal del framework. Es un archivo compartido, así que el servidor y todos los clientes leen los mismos valores.

Cuentas y dinero inicial#

Opción	Por defecto	Qué hace
`Config.Accounts`	`{ cash = 500, bank = 5000, black_money = 0 }`	Las cuentas de dinero que tiene cada personaje, y el saldo con el que empieza un personaje nuevo. Una cuenta que falte en un personaje existente se añade con este saldo inicial cuando se carga el personaje. Los comandos y exports de dinero solo funcionan con las cuentas listadas aquí.

lua

-- A harder start: less cash, a smaller bank balance
Config.Accounts = {
    cash = 250,
    bank = 1500,
    black_money = 0,
}

Personajes, aparición y guardado#

Opción	Por defecto	Qué hace
`Config.MaxCharacters`	`5`	Cuántos personajes puede crear un jugador. La creación de personajes se rechaza al alcanzar el límite.
`Config.DefaultSpawn`	`vec4(-268.4842, -957.7139, 31.2231, 205.8032)`	Dónde aparece un personaje nuevo la primera vez (x, y, z, heading). Después, cada personaje aparece donde estuvo por última vez.
`Config.DefaultJob`	`'unemployed'`	El trabajo que se da a cada personaje nuevo. Debe existir en `shared/jobs.lua`.
`Config.DefaultJobGrade`	`0`	El rango de ese trabajo por defecto.
`Config.SaveInterval`	`5 * 60 * 1000`	Cada cuánto (en milisegundos) se guardan todos los personajes conectados. Los personajes también se guardan cuando el jugador se desconecta, cierra sesión y cuando `qs-core` se detiene.
`Config.Debug`	`true`	Muestra líneas de depuración en la consola, con el prefijo `[qs-core:server]` / `[qs-core:client]` (por ejemplo, el número de jugadores guardados en cada autoguardado). Ponlo en `false` en un servidor en producción para una consola más limpia.

lua

Config.MaxCharacters = 3

-- New characters start at the airport
Config.DefaultSpawn = vec4(-1037.74, -2737.84, 20.17, 330.0)

-- Autosave every 10 minutes
Config.SaveInterval = 10 * 60 * 1000
Config.Debug = false

Sueldo#

Opción	Por defecto	Qué hace
`Config.Paycheck.enabled`	`true`	Activa o desactiva los sueldos. Se lee una vez cuando `qs-core` se inicia.
`Config.Paycheck.interval`	`30 * 60 * 1000`	Tiempo entre sueldos, en milisegundos.

En cada intervalo, cada jugador con un personaje cargado cuyo rango de trabajo tenga un salario mayor que 0 recibe ese salario en su cuenta del banco y una notificación Paycheck received. Los salarios se definen por rango en shared/jobs.lua (consulta Trabajos y rangos más abajo).

lua

Config.Paycheck = {
    enabled  = true,
    interval = 15 * 60 * 1000, -- every 15 minutes
}

Muerte y hospitales#

Cuando un jugador muere, queda derribado en lugar de reaparecer. Pasados respawnTime segundos puede presionar E para reaparecer en el hospital más cercano, y puede presionar G para llamar a los paramédicos.

Opción	Por defecto	Qué hace
`Config.Death.respawnTime`	`20`	Segundos que un jugador derribado debe esperar antes de que E lo haga reaparecer en el hospital más cercano.
`Config.Death.loseCashOnDeath`	`false`	Cuando es `true`, el `cash` del jugador se pone a 0 cuando reaparece en un hospital.
`Config.Death.emsCooldown`	`30000`	Tiempo de espera en milisegundos entre dos llamadas con G a los paramédicos.
`Config.Death.anim`	`{ dict = 'mini@cpr@char_b@cpr_def', clip = 'cpr_pumpchest_idle' }`	La animación en la que yace un jugador derribado.
`Config.Death.hospitals`	`vec4(298.6, -584.6, 43.26, 65.0)`, `vec4(-247.6, 6331.4, 32.4, 200.0)`	Puntos de reaparición (x, y, z, heading). Se usa el más cercano al lugar donde cayó el jugador.

lua

Config.Death = {
    respawnTime = 60,          -- one minute to wait for EMS
    loseCashOnDeath = true,
    emsCooldown = 60000,
    anim = { dict = 'mini@cpr@char_b@cpr_def', clip = 'cpr_pumpchest_idle' },
    hospitals = {
        vec4(298.6, -584.6, 43.26, 65.0),    -- Pillbox Hill
        vec4(-247.6, 6331.4, 32.4, 200.0),   -- Paleto Bay
        vec4(1839.6, 3672.9, 34.28, 210.0),  -- add Sandy Shores
    },
}

Un jugador derribado también se puede reanimar con /revive o con la acción Heal de txAdmin. El tratamiento de EMS se explica en Trabajos, policía y EMS.

Opciones del mundo#

Opción	Por defecto	Qué hace
`Config.DisableWanted`	`true`	Elimina el nivel de búsqueda de GTA: los jugadores nunca reciben estrellas de búsqueda.
`Config.DisableDispatch`	`true`	Desactiva el despacho de emergencias de GTA, así que no se envían a los jugadores policías, ambulancias ni camiones de bomberos NPC.
`Config.EnablePvP`	`true`	Mantiene el fuego amigo activado, para que los jugadores puedan dañarse entre sí. `false` deja de forzarlo, pero no bloquea activamente el PvP.
`Config.DisableRain`	`true`	Mantiene el clima seco: cada vez que el clima va a cambiar a lluvia, tormenta o despejándose, cambia a nublado.
`Config.DisablePeds`	`false`	Elimina los peatones de ambiente de las calles.
`Config.DisableTraffic`	`false`	Elimina el tráfico NPC y los vehículos estacionados, además de los camiones de basura, los barcos aleatorios y los trenes.

lua

-- An empty city with rain allowed
Config.DisableRain = false
Config.DisablePeds = true
Config.DisableTraffic = true

Webhooks y baneos#

Opción	Por defecto	Qué hace
`Config.Webhooks.money`	`''`	URL del webhook de Discord para los logs de dinero (`/givemoney`). `''` lo desactiva.
`Config.Webhooks.admin`	`''`	URL del webhook de Discord para los logs de administración: `/setjob`, `/addmoney`, `/removemoney`, `/kick` y baneos. `''` lo desactiva.
`Config.Webhooks.connections`	`''`	Reservado: en la versión actual no se publica nada en este canal.
`Config.EnableBans`	`true`	Comprueba la tabla `bans` cuando un jugador se conecta y rechaza a los jugadores baneados con el motivo del baneo. Con `false`, los baneos no se aplican al conectar.

lua

Config.Webhooks = {
    money       = 'https://discord.com/api/webhooks/XXXXXXXX/money-channel',
    admin       = 'https://discord.com/api/webhooks/XXXXXXXX/admin-channel',
    connections = '',
}

Config.EnableBans = true

El menú de administración (qs-admin) tiene su propio webhook en su config.lua. Consulta Administración.

Backend del inventario#

Opción	Por defecto	Qué hace
`Config.Inventory`	`'auto'`	A qué inventario `qs-core` dirige las llamadas de ítems. Déjalo en `'auto'`: `qs-coreinventory` se usa siempre que esté iniciado; cuando no lo está y el `qs-inventory` avanzado de Quasar Store está en marcha, los ítems van a `qs-inventory`.

Para usar qs-inventory, ejecútalo en lugar de qs-coreinventory en server.cfg. Quasar Framework siempre prefiere qs-coreinventory mientras está iniciado. Consulta Integraciones.

lua

Config.Inventory = 'auto'

Identificadores e idioma de respaldo#

Opción	Por defecto	Qué hace
`Config.Identifier`	`'license'`	El tipo de identificador que vincula a un jugador con sus personajes y su paleta de colores guardada. No lo cambies en un servidor en producción: los personajes existentes se guardan con el identificador actual y ya no se encontrarían. Los baneos y los grupos siempre usan la licencia de Rockstar, `license`.
`Config.Locale`	`'en'`	Idioma de respaldo para `qs-core` cuando la convar `qs:locale` no está definida. Define el idioma con `setr qs:locale` en `server.cfg` en su lugar (consulta Idiomas más abajo).

lua

-- don't change this on a live server
Config.Identifier = 'license'
Config.Locale = 'en'

Colores del tema#

Todas las interfaces de Quasar Framework — HUD, inventario, menús, notificaciones, chat — leen una paleta compartida. Config.Theme en qs-core/shared/config.lua es la paleta por defecto del servidor: cámbiala y todas las interfaces cambian de aspecto para los jugadores que no han elegido sus propios colores.

Clave	Por defecto	Qué colorea
`name`	`'blue'`	El nombre de la paleta.
`text`	`'#eaf2ff'`	Texto principal.
`muted`	`'#8ea6cc'`	Texto secundario, atenuado.
`primary`	`'#3b82f6'`	El color primario.
`primaryDim`	`'#2563eb'`	Un tono más oscuro del color primario.
`accent`	`'#5cbaf0'`	El color de acento.
`gradientFrom`	`'rgba(59, 146, 246, 0.60)'`	Inicio del degradado.
`gradientTo`	`'rgba(37, 99, 235, 0.30)'`	Fin del degradado.
`glow`	`'rgba(59, 130, 246, 0.45)'`	Efectos de brillo.
`border`	`'rgba(96, 165, 250, 0.45)'`	Bordes.
`panel`	`'rgba(20, 40, 78, 0.32)'`	Fondos de los paneles.
`health`	`'#5cf07c'`	Barra de estado de salud.
`armor`	`'#3b82f6'`	Barra de estado de armadura.
`hunger`	`'#f0a83a'`	Barra de estado de hambre.
`thirst`	`'#24c8d8'`	Barra de estado de sed.

lua

-- A red server theme
Config.Theme = {
    name         = 'red',
    text         = '#fff1f1',
    muted        = '#cc8e8e',
    primary      = '#ef4444',
    primaryDim   = '#dc2626',
    accent       = '#f87171',
    gradientFrom = 'rgba(239, 68, 68, 0.60)',
    gradientTo   = 'rgba(220, 38, 38, 0.30)',
    glow         = 'rgba(239, 68, 68, 0.45)',
    border       = 'rgba(248, 113, 113, 0.45)',
    panel        = 'rgba(78, 20, 20, 0.32)',
    health       = '#5cf07c',
    armor        = '#3b82f6',
    hunger       = '#f0a83a',
    thirst       = '#24c8d8',
}

Paletas por jugador#

Los jugadores también pueden elegir sus propios colores. En su primera conexión, la introducción (qs-intro) les pide elegir una paleta, y después pueden cambiarla con /colors. La paleta de un jugador se guarda en su cuenta en la tabla player_colors y sustituye a Config.Theme solo para ese jugador.

Opción	Por defecto	Qué hace
`Config.AllowColorChange`	`true`	Registra el comando del selector de color. Con `false`, los jugadores no pueden cambiar sus colores con un comando.
`Config.ColorCommand`	`'colors'`	El nombre de ese comando (`/colors` por defecto).

lua

Config.AllowColorChange = true
Config.ColorCommand = 'theme' -- players type /theme instead of /colors

Idiomas#

Quasar Framework viene en 10 idiomas — en, es, fr, de, it, pt, pl, ru, tr y ar — y una sola convar en server.cfg cambia todos los recursos:

bash

setr qs:locale "de"

Debe ser setr (una convar replicada). Con un simple set, solo el servidor cambia de idioma y todos los textos en las pantallas de los jugadores se quedan en inglés. Reinicia el servidor después de cambiarla.

Añadir un idioma#

Cada recurso guarda sus textos en su propia carpeta locales (qs-core, qs-coreinventory, qs-clothing, qs-corechat, qs-corehud, qs-coremulticharacter, qs-coreshops, qs-corevehiclekeys, qs-coreweapons, qs-intro, qs-needs y todos los recursos de [addons]). Cada carpeta se carga automáticamente, así que un idioma nuevo es solo un archivo nuevo por recurso.

Copia el archivo en inglés
En cada recurso, copia locales/en.lua a locales/<code>.lua — por ejemplo locales/nl.lua para neerlandés.

Renombra la tabla y traduce

Cambia Locales.en a Locales.nl y traduce cada valor. Mantén las claves exactamente como están, y conserva marcadores como %s y %d: se sustituyen por nombres y cantidades.

lua

Locales = Locales or {}

Locales.nl = {
    no_permission    = 'Geen toestemming.',
    player_not_found = 'Speler niet gevonden.',
    invalid_amount   = 'Ongeldig bedrag.',
    paycheck         = 'Salaris ontvangen: $%d',
    -- ...every other key from en.lua
}

Cambia el servidor a ese idioma
Pon setr qs:locale "nl" en server.cfg y reinicia el servidor.

Ítems#

Todos los ítems del servidor están en un catálogo que pertenece a qs-core. El inventario, las tiendas, los scripts de ESX y los scripts de QBCore leen de él las etiquetas, los pesos y los ajustes de los ítems.

Ítems base#

qs-core/shared/items.lua define los ítems base. Otros recursos añaden los suyos al iniciarse (armas y munición, comida y bebida, policía, EMS, ítems de trabajos y de drogas).

Ítem	Etiqueta	Peso (g)	Usable
`water`	Water Bottle	500	Sí
`bread`	Bread	300	Sí
`bandage`	Bandage	100	Sí
`phone`	Phone	190	Sí
`id_card`	ID Card	10	No
`weapon_pistol`	Pistol	1000	Sí
`lockpick`	Lockpick	100	Sí
`repairkit`	Repair Kit	2500	Sí
`screwdriver`	Screwdriver	200	Sí

Campos de los ítems#

Campo	Por defecto	Qué hace
`label`	el nombre del ítem	El nombre que ven los jugadores.
`weight`	`0`	Peso de un ítem, en gramos (`1000` = 1 kg).
`useable`	`false`	Si el ítem se puede usar. Sin `useable = true`, usarlo no hace nada.
`description`	—	El texto que se muestra con el ítem.
`stack`	valor por defecto del inventario (`64`)	Cantidad máxima por slot para este ítem.
`unique`	—	`true` hace que cada ítem ocupe su propio slot (pila de 1).
`weapon`	—	Un nombre de arma de GTA como `'WEAPON_PISTOL'`. Usar el ítem equipa o enfunda esa arma. Los ítems de armas se apilan de 1 en 1 salvo que definan `stack`.
`ammo`	—	Balas cargadas la primera vez que se equipa un ítem `weapon`.

Las imágenes de los ítems son archivos PNG con el nombre del ítem (por ejemplo water.png) en qs-coreinventory/web/images.

Añadir ítems#

Añade ítems a la tabla base en qs-core/shared/items.lua, o regístralos desde cualquier recurso con el export RegisterItems — así es como los recursos de Quasar Framework añaden los suyos:

lua

-- server.lua of your own resource
local core = exports['qs-core']

core:RegisterItems({
    coffee_beans = { label = 'Coffee Beans', weight = 250, useable = false, description = 'Freshly roasted.' },
    energy_bar   = { label = 'Energy Bar',   weight = 80,  useable = true,  description = 'A quick snack.' },
    gold_watch   = { label = 'Gold Watch',   weight = 150, useable = false, unique = true },
})

exports['qs-core']:RegisterItem(name, data) añade un solo ítem. Registrar un nombre que ya existe reemplaza su definición. Para darle un efecto a un ítem usable, consulta Inventario, ítems y armas; los scripts de ESX y QBCore también pueden traer sus ítems mediante los puentes, consulta Compatibilidad con ESX y QBCore.

Trabajos y rangos#

Los trabajos se definen en qs-core/shared/jobs.lua. Cada trabajo tiene rangos, y cada rango tiene su propio salario, que paga el sueldo (consulta Sueldo más arriba).

Trabajos por defecto#

Trabajo	Etiqueta	Rangos (nivel: etiqueta — salario)
`unemployed`	Civilian	0: Freelancer — 200
`police`	Police	0: Recruit — 500 · 1: Officer — 750 · 2: Sergeant — 1000 · 3: Chief — 2000 (jefe)
`ambulance`	EMS	0: Trainee — 500 · 1: Paramedic — 800 · 2: Doctor — 1200 · 3: Chief — 2000 (jefe)
`hunter`	Hunter	0: Hunter — 200
`delivery`	Delivery Driver	0: Driver — 200
`miner`	Miner	0: Miner — 175
`lumberjack`	Lumberjack	0: Lumberjack — 175
`fisher`	Fisherman	0: Fisherman — 150

unemployed es el trabajo por defecto (Config.DefaultJob), así que cada civil también recibe el salario de Freelancer.

Campos de los trabajos#

Campo	Por defecto	Qué hace
`label`	el nombre del trabajo	El nombre del trabajo que ven los jugadores.
`defaultDuty`	—	El estado de servicio de un personaje que aún no tiene un valor de servicio guardado (los personajes creados por Quasar Framework empiezan en servicio). Los scripts lo leen como `job.onduty`.
`grades`	—	Una tabla de rangos indexada desde `[0]`.
`grades[n].name`	—	El id del rango (por ejemplo `'sergeant'`).
`grades[n].label`	—	El nombre del rango que ven los jugadores.
`grades[n].salary`	—	La cantidad que se paga al banco en cada sueldo. `0` significa sin sueldo.
`grades[n].isBoss`	`false`	Marca el rango de jefe. Los scripts de ESX y QBCore lo ven como el rango de jefe.

lua

-- qs-core/shared/jobs.lua — add a mechanic job inside the Jobs table
['mechanic'] = {
    label = 'Mechanic',
    defaultDuty = true,
    grades = {
        [0] = { name = 'apprentice', label = 'Apprentice', salary = 300 },
        [1] = { name = 'mechanic',   label = 'Mechanic',   salary = 550 },
        [2] = { name = 'boss',       label = 'Owner',      salary = 1200, isBoss = true },
    },
},

Los trabajos también se pueden añadir desde un script de servidor con exports['qs-core']:RegisterJob(name, definition) (o varios con RegisterJobs). Un rango que no existe pasa al rango más bajo del trabajo. Asigna un trabajo en el juego con /setjob <id> <job> [grade], por ejemplo /setjob 1 mechanic 2.

Bandas#

Las bandas se definen en qs-core/shared/gangs.lua. Cada personaje empieza en la banda none (No Gang, rango Unaffiliated).

Campo	Por defecto	Qué hace
`label`	el nombre de la banda	El nombre de la banda que ven los jugadores.
`grades`	`{ [0] = { name = 'member', label = 'Member', isBoss = false } }`	Rangos de la banda indexados desde `[0]`.
`grades[n].name`	—	El id del rango.
`grades[n].label`	—	El nombre del rango que ven los jugadores.
`grades[n].isBoss`	`false`	Marca el rango de líder.

lua

-- qs-core/shared/gangs.lua — below Gangs['none']
Gangs['ballas'] = {
    label = 'Ballas',
    grades = {
        [0] = { name = 'recruit', label = 'Recruit', isBoss = false },
        [1] = { name = 'og',      label = 'OG',      isBoss = false },
        [2] = { name = 'boss',    label = 'Shot Caller', isBoss = true },
    },
}

Usa nombres de bandas en minúsculas. Las bandas también se pueden añadir desde un script con exports['qs-core']:RegisterGang(name, data) y asignar con exports['qs-core']:SetGang(source, name, grade). Los scripts de QBCore ven la banda mediante el puente qb-core.

¿Controlas trabajos y bandas desde tus propios scripts? SetJob, SetGang, RegisterJob, RegisterGang y los eventos que disparan aparecen en Comandos y exports.

Inventario — qs-coreinventory/shared/config.lua#

qs-coreinventory es el inventario de FiveM que incluye Quasar Framework: slots y peso, un contenedor secundario (maletero, guantera o almacén), slots rápidos y una rueda de ítems.

Inventario del jugador#

Opción	Por defecto	Qué hace
`Config.MaxWeight`	`50000`	Cuánto puede cargar un jugador, en gramos (50 kg). Añadir un ítem por encima de este límite falla con Too heavy to carry.
`Config.Slots`	`30`	Número de slots del inventario del jugador.
`Config.Columns`	`5`	Número de columnas de la cuadrícula del jugador.
`Config.DefaultStack`	`64`	Cantidad máxima por slot, salvo que el ítem defina su propio `stack`. Las armas y los ítems `unique` siempre se apilan de 1 en 1.
`Config.StartingItems`	`water` ×2, `bread` ×2, `phone` ×1, `id_card` ×1	Ítems que se dan a cada personaje recién creado.

lua

Config.MaxWeight = 80000 -- 80 kg
Config.Slots = 40
Config.Columns = 5
Config.DefaultStack = 100

Config.StartingItems = {
    { name = 'water',   count = 3 },
    { name = 'bread',   count = 3 },
    { name = 'phone',   count = 1 },
    { name = 'id_card', count = 1 },
    { name = 'bandage', count = 2 },
}

Maletero y guantera#

Opción	Por defecto	Qué hace
`Config.TrunkSlots`	`10`	Slots del maletero de un vehículo.
`Config.TrunkColumns`	`5`	Columnas de la cuadrícula del maletero.
`Config.TrunkMaxWeight`	`100000`	Límite de peso del maletero, en gramos.
`Config.TrunkReach`	`1.8`	A qué distancia (en metros) debes estar de la parte trasera de un vehículo para que el inventario abra su maletero.
`Config.TrunkCloseDistance`	`5.0`	El maletero se cierra cuando te alejas del vehículo más de esta distancia. También es la distancia de cierre automático de las zonas de almacén sin radio propio.
`Config.GloveboxSlots`	`5`	Slots de una guantera.
`Config.GloveboxColumns`	`5`	Columnas de la cuadrícula de la guantera.
`Config.GloveboxMaxWeight`	`15000`	Límite de peso de la guantera, en gramos.

El maletero se abre cuando abres el inventario detrás de un vehículo sin seguro del que tienes las llaves; la guantera se abre cuando lo abres sentado en un vehículo del que tienes las llaves. El contenido se guarda por matrícula.

lua

Config.TrunkSlots = 20
Config.TrunkMaxWeight = 150000
Config.GloveboxMaxWeight = 10000

Almacenes#

Opción	Por defecto	Qué hace
`Config.Stashes`	`{}`	Almacenes registrados al iniciar el servidor: `{ id, label, slots, maxWeight, columns }`.

lua

Config.Stashes = {
    { id = 'town_locker', label = 'Town Locker', slots = 50, maxWeight = 200000, columns = 5 },
}

Un almacén registrado se abre desde un script, ya sea con una zona de almacén (los jugadores abren su inventario dentro de ella) o directamente. Consulta Inventario, ítems y armas.

Teclas#

Opción	Por defecto	Qué hace
`Config.OpenKey`	`'F1'`	Tecla por defecto que abre y cierra el inventario (comando `inventory`).
`Config.RadialKey`	`'TAB'`	Tecla por defecto que se mantiene para abrir la rueda de ítems.
`Config.RadialSlots`	`5`	Cuántos slots (desde el slot 1) muestra la rueda de ítems.

Los slots rápidos siempre usan las teclas 1 a 5 para los slots 1–5. Las teclas son asignaciones de teclas de FiveM: el valor por defecto solo se aplica a los jugadores que aún no han asignado la acción, y cada jugador puede cambiarla en Settings → Key Bindings → FiveM.

lua

Config.OpenKey = 'I'
Config.RadialKey = 'TAB'
Config.RadialSlots = 6

Armas — qs-coreweapons/config.lua#

qs-coreweapons convierte cada arma de GTA en un ítem del inventario: 105 armas y 9 tipos de munición, registrados en el catálogo de ítems cuando se inicia el recurso.

Opción	Por defecto	Qué hace
`WeaponsConfig.MagSize`	`pistol = 12`, `smg = 30`, `rifle = 30`, `shotgun = 8`, `sniper = 10`, `mg = 100`, `launcher = 1`, `flare = 1`, `taser = 1`	Balas por categoría: las balas que tiene un arma la primera vez que se equipa, y las balas que carga un ítem de munición.
`WeaponsConfig.ThrowableStack`	`10`	Tamaño de pila de las armas arrojables (granadas, molotovs...). Cada lanzamiento usa un ítem.
`WeaponsConfig.Weapons`	105 armas	Ítems de armas: `itemName = { weapon, cat, label, weight, ammo? }`.
`WeaponsConfig.Ammo`	9 tipos de munición	Ítems de munición: `itemName = { cat, label, weight }`.

Las categorías de armas son melee, pistol, smg, shotgun, rifle, mg, sniper, launcher, flare, taser, throwable y misc. Un ítem de munición se carga en un arma del mismo cat. Un arma nueva debe existir en tu build del juego o cargarse como add-on; reinicia qs-coreweapons y su ítem se registra automáticamente.

lua

-- Bigger pistol magazines: 15 rounds on first equip and per pistol ammo item
WeaponsConfig.MagSize = {
    pistol   = 15,
    smg      = 30,
    rifle    = 30,
    shotgun  = 8,
    sniper   = 10,
    mg       = 100,
    launcher = 1,
    flare    = 1,
    taser    = 1,
}

-- Inside WeaponsConfig.Weapons: an add-on weapon you stream yourself
weapon_mycarbine = { weapon = 'WEAPON_MYCARBINE', cat = 'rifle', label = 'Custom Carbine', weight = 3400 },

-- Inside WeaponsConfig.Ammo: ammo entries look like this
ammo_pistol = { cat = 'pistol', label = 'Pistol Ammo', weight = 200 },

La lista completa de las 105 armas y los 9 ítems de munición, con pesos y categorías, está en Inventario, ítems y armas.

Pantalla de carga — loadingscreen/config.js#

La pantalla de carga es lo que ven los jugadores mientras se conectan. Sus textos se definen en [core]/loadingscreen/config.js; edita el archivo y reinicia el recurso loadingscreen, y el próximo jugador que entre verá el cambio.

Opción	Por defecto	Qué hace
`name`	`'QSCORE'`	El título grande — el nombre de tu servidor.
`subtitle`	`'Roleplay Framework'`	La línea bajo el título.
`about`	`'Open-source roleplay framework · runs ESX & QBCore scripts'`	Una descripción de una línea bajo el subtítulo.
`keys`	8 entradas: `F1` Inventory, `TAB` Item wheel, `1-5` Quick slots, `E` Interact, `U` Lock vehicle, `B` Seatbelt, `G` Hotwire, `T` Chat	Pistas de teclas mostradas como pares `{ key, label }`.
`tips`	5 consejos	Líneas que rotan en la parte inferior de la pantalla.
`tipInterval`	`5.2`	Segundos entre dos consejos.

javascript

// loading screen branding. no build step, just restart the resource.
window.LOADING_CONFIG = {
  name: 'LOS SANTOS RP',
  subtitle: 'Serious Roleplay',

  about: 'Whitelisted roleplay community · discord.gg/yourserver',

  keys: [
    { key: 'I', label: 'Inventory' },   // matches Config.OpenKey = 'I'
    { key: 'TAB', label: 'Item wheel' },
    { key: '1-5', label: 'Quick slots' },
    { key: 'U', label: 'Lock vehicle' },
    { key: 'T', label: 'Chat' },
  ],

  // rotating lines at the bottom
  tips: [
    'Read the rules on our Discord before you play.',
    'Use /me and /do in the chat to roleplay your actions.',
  ],

  tipInterval: 6, // seconds
};

Páginas relacionadas#

Página	Qué cubre
Instalación	`server.cfg`, administradores, idioma y la base de datos.
Inventario, ítems y armas	Ítems usables, almacenes, tiendas y la lista completa de armas.
Trabajos, policía y EMS	El centro de empleo, los trabajos civiles, y los ajustes de policía y EMS.
Administración	Menú de administración, grupos, baneos y webhooks.
Comandos y exports	Todos los comandos, exports y eventos.

[··] Documentación

Cargandola guía

Ajustes principales — qs-core/shared/config.lua#

Cuentas y dinero inicial#

Personajes, aparición y guardado#

Sueldo#

Muerte y hospitales#

Opciones del mundo#

Webhooks y baneos#

Backend del inventario#

Identificadores e idioma de respaldo#

Colores del tema#

Paletas por jugador#

Idiomas#

Añadir un idioma#

Copia el archivo en inglés

Renombra la tabla y traduce

Cambia el servidor a ese idioma

Ítems#

Ítems base#

Campos de los ítems#

Añadir ítems#

Trabajos y rangos#

Trabajos por defecto#

Campos de los trabajos#

Bandas#

Inventario — qs-coreinventory/shared/config.lua#

Inventario del jugador#

Maletero y guantera#

Almacenes#

Teclas#

Armas — qs-coreweapons/config.lua#

Pantalla de carga — loadingscreen/config.js#

Páginas relacionadas#

Ajustes principales — qs-core/shared/config.lua#

Cuentas y dinero inicial#

Personajes, aparición y guardado#

Sueldo#

Muerte y hospitales#

Opciones del mundo#

Webhooks y baneos#

Backend del inventario#

Identificadores e idioma de respaldo#

Colores del tema#

Paletas por jugador#

Idiomas#

Añadir un idioma#

Copia el archivo en inglés

Renombra la tabla y traduce

Cambia el servidor a ese idioma

Ítems#

Ítems base#

Campos de los ítems#

Añadir ítems#

Trabajos y rangos#

Trabajos por defecto#

Campos de los trabajos#

Bandas#

Inventario — qs-coreinventory/shared/config.lua#

Inventario del jugador#

Maletero y guantera#

Almacenes#

Teclas#

Armas — qs-coreweapons/config.lua#

Pantalla de carga — loadingscreen/config.js#

Páginas relacionadas#