Inicio › Documentación › Configuración · origen_inventory

Configuración · origen_inventory

origen_inventory se configura mediante config.lua, config_sv.lua y los ficheros modulares de la carpeta config/. Esta página documenta todas las variables agrupadas por área.

General — `config.lua`

Variable	Tipo	Por defecto	Descripción
`Config.Debug`	`boolean`	`true`	Activa el registro de depuración en todos los subsistemas. Desactívalo en producción.
`Config.Language`	`string`	`"es"`	Idioma cargado desde `locales/translations/`. Acepta `es` o `en`.
`Config.Framework`	`string`	detección automática	`"qbx"`, `"esx"`, `"qbcore"` o `"NONE"`. Lo devuelve `AutoSelectFramework()`.
`Config.Phone.Resource`	`string`	`"qs-smartphone-pro"`	Integración con el teléfono. Acepta `"qs-smartphone-pro"`, `"lb-phone"`, `"none"`.
`Config.Progressbar`	`string`	`"default"`	Proveedor de la barra de progreso. Uno de `default`, `esx_progressbar`, `qb-core`, `qs-progressbar`, `ox_lib`.
`Config.UseInventoryComsumables`	`boolean`	`true`	Activa la gestión integrada de consumibles de comer/beber/alcohol.
`Config.CreateStashIfNoExists`	`boolean`	`true`	Crea automáticamente una fila de stash cuando se abre un ID de stash desconocido.
`Config.DefaultOpenKey`	`string`	`"F2"`	Tecla asignada solo la primera vez para abrir el inventario. Tras el registro, los jugadores la cambian desde los atajos de teclado de FiveM.
`Config.HotbarOpenKey`	`string`	`"TAB"`	Tecla asignada para alternar la hotbar. Solo se usa cuando `Config.UI.Hotbar = true`.
`Config.DisableEscOnInventoryOpen`	`boolean`	`true`	Desactiva `ESC` mientras la interfaz del inventario está abierta.
`Config.DisableMovementOnInventoryOpen`	`boolean`	`false`	Inmoviliza al jugador mientras la interfaz está abierta.
`Config.DisablePKey`	`boolean`	`true`	Desactiva la tecla del mapa por defecto (`P`) mientras el inventario está abierto.
`Config.NotifyExports.GiveItem`	`boolean`	`true`	Envía una notificación al jugador cuando se usa `giveItem`.
`Config.NotifyExports.RemoveItem`	`boolean`	`true`	Envía una notificación al jugador cuando se usa `removeItem`.

Ajustes de drops

Variable	Tipo	Por defecto	Descripción
`Config.Drop.MaxWeight`	`number`	`100000`	Peso total máximo por drop en el suelo.
`Config.Drop.MaxSlots`	`number`	`10`	Número máximo de slots por drop en el suelo.

Colores de los marcadores

lua

Config.MarkerColors = {
    give_player = vec4(0, 0, 0, 255),
}

Flags experimentales

Variable	Tipo	Por defecto	Descripción
`Config.Experimentals.giveItemAlgorithm`	`string`	`"no_stack"`	Algoritmo que se usa al dar objetos. `stack_unique` permite dar stacks de objetos únicos, `slot_based` asigna slots automáticamente a las armas y `no_stack` es el comportamiento heredado de un solo objeto.

Los flags experimentales pueden corromper los datos del inventario en casos límite. Actívalos primero solo en un servidor de pruebas.

Jugador — `config/player.lua`

Variable	Tipo	Por defecto	Descripción
`Config.Player.GiveDistance`	`number`	`3.5`	Distancia máxima en metros para dar objetos a otro jugador.
`Config.Player.DropMarkerDistance`	`number`	`3.0`	Distancia a la que se hace visible el marcador del drop en el suelo.
`Config.Player.MaxWeight`	`number`	`120000`	Peso total máximo del inventario (gramos).
`Config.Player.MaxInventorySlots`	`number`	`40`	Número máximo de slots.
`Config.Player.SaveInterval`	`number`	`40`	Intervalo de guardado automático en minutos.
`Config.Player.ShopTimeout`	`number`	`2`	Tiempo de espera en segundos antes de volver a abrir una tienda.

Protección anti-trampas

Variable	Tipo	Por defecto	Descripción
`Config.Player.CheatProtect.Enable`	`boolean`	`true`	Interruptor general de las medidas anti-trampas. Se ignora para los administradores detectados por `Bridge.IsAdmin`.
`Config.Player.CheatProtect.MaxDistanceRemoteOpen`	`number`	`10.0`	Distancia máxima permitida entre el jugador y el inventario que está abriendo.
`Config.Player.CheatProtect.EnableNoItemWeapons`	`boolean`	`true`	Elimina las armas entregadas al jugador sin pasar por el inventario (scripts de terceros).

Clothes-As-Item (CAI)

Variable	Tipo	Por defecto	Descripción
`Config.Player.ClothesAsItem.Enable`	`boolean`	`true`	Activa el subsistema Clothes-As-Item. Requiere `origen_clothing`.

Money-As-Item (MAI)

Variable	Tipo	Por defecto	Descripción
`Config.Player.MoneyAsItem.Enable`	`boolean`	`true`	Activa Money-As-Item. El recurso registra automáticamente el objeto de dinero.
`Config.Player.MoneyAsItem.Accounts`	`table`	ver más abajo	Cuentas asignadas a objetos del inventario.

lua

Config.Player.MoneyAsItem.Accounts = {
    [DetectMoneyOrCash()] = {
        account = DetectMoneyOrCash(),
        label = 'Dinero',
        description = 'El mundo gira a su alrededor',
        weight = 0,
    },
    -- black_money = {
    --     account = 'black_money',
    --     label = 'Black Money',
    --     description = 'Black Money',
    --     weight = 0,
    -- }
}

Interfaz

Variable	Tipo	Por defecto	Descripción
`Config.UI.Mini`	`boolean`	`true`	Al abrir un inventario secundario (stash, maletero, etc.), oculta el inventario del jugador hasta que se cierre el secundario.
`Config.UI.ShowPlayerNameOnGiveItem`	`boolean`	`true`	Muestra el nombre del receptor en el aviso de dar un objeto.
`Config.UI.Hotbar`	`boolean`	`true`	Activa la hotbar.
`Config.UI.ShowCraftingIndicator`	`boolean`	`true`	Muestra un pequeño indicador mientras se ejecuta una acción de crafteo.
`Config.UI.PlayerInventoryLabel`	`string`	`"Inventory"`	Etiqueta que se muestra en la parte superior de la pestaña del inventario del jugador.
`Config.UI.Color`	`string`	`"default"`	Tema de color de la interfaz.
`Config.UI.DelayNuiFocusForTabKey`	`boolean`	`false`	Retrasa el foco NUI al pulsar TAB (soluciona problemas de entrada en algunos clientes).
`Config.UI.EnableTabs`	`table`	ver más abajo	Activa o desactiva la visibilidad y las subacciones de las pestañas del inventario.

lua

Config.UI.EnableTabs = {
    personal = {
        enable = true,
        clothes = true,
        enableActions = true,
        actions = {
            toggleHair = true,
            searchPlayer = true,
            carry = true,
            piggyback = true,
            rockstarEditor = true,
        }
    },
    settings = {
        enable = true,
        keybinds = true,
        appearance = true
    },
    vehicle = {
        enable = true,
    }
}

Animaciones

Config.Animations.Carry y Config.Animations.Piggyback definen los diccionarios y clips de animación que usan las acciones de cargar a cuestas y a caballito. Consulta config/player.lua para ver la tabla completa.

Vehículos — `config/vehicles.lua`

Variable	Tipo	Por defecto	Descripción
`Config.OpenTrunkAnywhere`	`boolean`	`false`	Permite abrir el maletero sin importar la posición del jugador alrededor del coche.
`Config.TrunkOpenDistance`	`number`	`3.0`	Distancia máxima al maletero para poder abrirlo (cuando `OpenTrunkAnywhere = false`).
`Config.BackEngineVehicles`	`string[]`	ver fichero	Vehículos cuyo motor/maletero está delante. La posición del maletero se invierte automáticamente para ellos.
`Config.Trunks.vehicles`	`table`	ver más abajo	Capacidad del maletero por vehículo. La clave `default` se aplica a cualquier vehículo sin configuración propia.
`Config.Gloveboxes.vehicles`	`table`	ver más abajo	Capacidad de la guantera por vehículo.

lua

Config.Trunks.vehicles = {
    default = {
        slots = 35,
        maxweight = 60000,
        label = 'Maletero',
    },
    [`speedo`] = {
        slots = 2,
        maxweight = 40000,
        label = 'Speedo Trunk',
        bone = 'door_dside_r',
    }
}
 
Config.Gloveboxes.vehicles = {
    default = {
        slots = 5,
        maxweight = 12500,
        label = 'Glovebox',
    },
    [`sultan`] = {
        slots = 5,
        maxweight = 12500,
        label = 'Sultan Glovebox',
    },
}

Usa comillas invertidas (`) alrededor del nombre del modelo del vehículo, no comillas simples ni dobles. El script calcula internamente el hash del nombre de spawn.

Stashes — `config/stashes.lua`

lua

Config.Stashes = {
    default = {
        slots = 30,
        maxweight = 120000,
    },
    ['example'] = {
        label = 'ORIGEN TEST',
        slots = 8,
        marker = {
            type = 20,
            size = vector3(0.3, 0.3, 0.3),
            color = { r = 0, g = 0, b = 0, a = 255 },
        },
        locations = { vector3(-1319.3, -2493.41, 14.95) },
        -- job = 'police',
        -- job_gradeup = 0,
        -- job_gradedown = 2,
        -- gang = 'origen',
        -- gang_gradeup = 0,
        -- gang_gradedown = 3,
    },
}

Campo	Descripción
`slots`	Número de slots de este stash.
`maxweight`	Peso total permitido (solo válido en `default`).
`label`	Etiqueta que se muestra.
`locations`	Array de `vector3`. El stash se crea en cada posición.
`marker`	`type`, `size` y `color` opcionales para el marcador del mundo.
`job` / `job_gradeup` / `job_gradedown`	Restringe el acceso a un rango de grados de trabajo.
`gang` / `gang_gradeup` / `gang_gradedown`	Igual que lo anterior, para bandas.

Tiendas — `config/shops.lua`

El fichero de tiendas se divide en tres partes:

Config.Shop — define el objeto de pago de cada ID de tienda ('money' si MAI está activado; en caso contrario, el nombre de una cuenta).
Config.ShopItems — listas de objetos, reutilizables entre tiendas.
Config.Shops — las ubicaciones reales de las tiendas, con marcadores, blips y asignación de objetos.

lua

Config.Shops = {
    ['weapons'] = {
        label = 'Shop',
        slots = 4,
        marker = {
            type = 20,
            size = vector3(0.3, 0.3, 0.3),
            color = { r = 0, g = 0, b = 0, a = 255 },
            distanceView = 5,
            distanceInteract = 1,
        },
        blip = {
            enabled = true,
            sprite = 52,
            color = 2,
            scale = 0.8,
            name = 'ORIGEN Shop Armas',
        },
        locations = { vector3(-1299.95, -2458.56, 13.94) },
        items = Config.ShopItems['weapons'],
    },
}

Cada entrada de objeto dentro de Config.ShopItems acepta:

Campo	Tipo	Descripción
`name`	`string`	Nombre del objeto o del arma.
`price`	`number`	Coste por unidad.
`amount`	`number`	Existencias que se muestran en la tienda.
`metadata`	`table`	Metadatos opcionales aplicados al objeto comprado (p. ej. el número de serie de un arma).
`type`	`string`	Por defecto `'item'`.

Las restricciones de trabajo y banda (job, job_gradeup, job_gradedown, gang, gang_gradeup, gang_gradedown) funcionan igual que en los stashes.

World Points — `config/worldpoints.lua`

El sistema de world points es el motor que dibuja los sprites y marcadores de stashes, tiendas, mesas de crafteo y drops.

Variable	Tipo	Por defecto	Descripción
`Config.WorldPoints.Enabled`	`boolean`	`true`	Interruptor general. Si lo desactivas, se eliminan todos los world points.
`Config.WorldPoints.ForceGroundZ`	`boolean`	`true`	Fuerza los puntos al nivel del suelo al copiar las coordenadas.
`Config.WorldPoints.BlipsShortRange`	`boolean`	`true`	Los blips solo se ven cerca, en lugar de aparecer siempre en el minimapa.
`Config.WorldPoints.UseDropModel`	`boolean`	`true`	Genera un prop en las bolsas de objetos soltados.
`Config.WorldPoints.DefaultDropModel`	`hash`	`prop_med_bag_01b`	Prop que se usa cuando `UseDropModel = true`, es decir, el prop que se genera en las bolsas.
`Config.WorldPoints.MarkerColors`	`table`	ver fichero	Colores de marcador por tipo de punto.
`Config.WorldPoints.DefaultMarkers`	`table`	ver fichero	Definiciones de marcador por defecto para `stash`, `shop` y `crafting`.
`Config.WorldPoints.PointTypes`	`table`	ver fichero	Sprite, marcador, hooks y comportamiento por tipo de punto.
`Config.WorldPoints.Initialization`	`table`	ver fichero	Retrasos de inicio en milisegundos.
`Config.WorldPoints.Interaction.keys.interact`	`number`	`38` (E)	Tecla de interacción.
`Config.WorldPoints.Interaction.behavior.cooldownMs`	`number`	`100`	Tiempo de espera entre interacciones.
`Config.WorldPoints.Interaction.behavior.allowInteractionInVehicle`	`boolean`	`false`	Indica si se permiten interacciones dentro de un vehículo.
`Config.WorldPoints.Interaction.feedback.playSounds`	`boolean`	`true`	Activa los sonidos de interacción.
`Config.WorldPoints.VisualEffects.sprites.enableFloatingLight`	`boolean`	`true`	Añade una luz flotante debajo de los sprites.
`Config.WorldPoints.Debug.enabled`	`boolean`	`Config.Debug`	Activa los logs detallados y los elementos visuales de depuración.
`Config.WorldPoints.Security.maxInteractionsPerSecond`	`number`	`1`	Límite de frecuencia anti-spam.
`Config.WorldPoints.Security.checkPlayerState`	`boolean`	`true`	Desactiva las interacciones mientras el jugador está muerto.

Armas — `config/weaponoptions.lua`

Variable	Tipo	Por defecto	Descripción
`Config.Weapons.InventoryWeaponSystem`	`boolean`	`true`	Activa el sistema de armas integrado (accesorios, sincronización, reparación, recarga, chaleco). Desactívalo solo si usas un sistema de armas externo.
`Config.Weapons.DisableDecay`	`boolean`	`false`	Desactiva el desgaste de durabilidad de las armas.
`Config.Weapons.RepairSystem.enabled`	`boolean`	`true`	Activa los talleres de reparación de armas.
`Config.Weapons.RepairSystem.points`	`table`	ver fichero	Definiciones de los puntos de reparación: `location`, `restrictions` (trabajo/objetos) y `time` en minutos.
`Config.Weapons.Draw.enabled`	`boolean`	`true`	Activa el subsistema de desenfundar armas.
`Config.Weapons.Draw.variants`	`number[]`	`{ 130, 122, 3, 6, 8 }`	Variantes de componente que se dibujan en la funda.
`Config.Weapons.Draw.weapons`	`string[]`	ver fichero	Armas compatibles con el desenfundado de la funda.
`Config.Weapons.Draw.weapon_reload_animation.enable`	`boolean`	`true`	Reproduce una animación de recarga. Desactívalo si quieres que el arma se recargue al instante.
`Config.Weapons.Draw.weapon_reload_animation.progress`	`boolean`	`true`	Muestra una barra de progreso durante la animación de recarga.
`Config.Weapons.AmmoReloadTime`	`table`	ver fichero	Tiempo de recarga por tipo de munición, en milisegundos.
`Config.Weapons.FastReload.enabled`	`boolean`	`true`	Activa la tecla de recarga rápida.
`Config.Weapons.FastReload.key`	`string`	`"R"`	Tecla de recarga rápida.
`Config.Weapons.FastReload.NeedAmmoInHotbar`	`boolean`	`false`	Si es `true`, exige munición en los slots 1–6 para la recarga rápida.
`Config.Weapons.Throwables`	`table`	ver fichero	Lista blanca de armas arrojadizas.
`Config.Weapons.Melee`	`table`	ver fichero	Lista blanca de armas cuerpo a cuerpo.
`Config.Weapons.AmmoTypes`	`table`	ver fichero	Asigna los objetos de munición a tipos de munición y tamaño de cargador.
`Config.DurabilityMultiplier`	`table`	ver fichero	Multiplicador de durabilidad por arma (más bajo = se desgasta más despacio).
`Config.DurabilityBlockedWeapons`	`string[]`	ver fichero	Armas exentas de durabilidad.
`Config.WeaponTints`	`table`	ver fichero	Mapa de nombre de objeto → ID de tinte.
`Config.Armors`	`table`	`armor = 50, heavyarmor = 100`	Cantidad de armadura por objeto de armadura.
`Config.MaximumAmmoValues`	`table`	`weapon_pistol = 10`	Límite máximo solo visual en la NUI.
`Config.WeaponAttachments`	`table`	ver fichero	Objetos de accesorio asignados a hashes de componente por arma.
`Config.Weapons.list`	`string[]`	ver fichero	Registro maestro de armas.

Crafteo — `config/crafting.lua`

Variable	Tipo	Por defecto	Descripción
`Config.Crafting.enable`	`boolean`	`true`	Activa el sistema de crafteo.
`Config.Crafting.items`	`table`	ver fichero	Recetas. Cada entrada define `ingredients`, `resultItem` opcional, `resultCount` y `time` en milisegundos.
`Config.Crafting.zones`	`table`	ver fichero	Zonas de crafteo con `enable`, `locations`, `radius`, `label` y la lista de `items` disponibles.

lua

["tosti"] = {
    ingredients = {
        ["sandwich"]     = 2,
        ["water_bottle"] = 1,
        ["weapon_pistol"] = 1,
    },
    resultCount = 1,
    time = 5000,
}

Airdrops — `config/airdrops.lua`

El sistema de airdrops está marcado como WIP en el código fuente. Úsalo primero en entornos de pruebas.

Variable	Tipo	Por defecto	Descripción
`Config.Airdrop.CrateModel`	`string`	`"prop_box_wood02a_pu"`	Modelo del prop de la caja.
`Config.Airdrop.ParachuteModel`	`string`	`"prop_v_parachute"`	Modelo del prop del paracaídas.
`Config.Airdrop.DropHeight`	`number`	`100.0`	Altura de lanzamiento en metros sobre el suelo.
`Config.Airdrop.LandingTime`	`number`	`10000`	Tiempo de aterrizaje en milisegundos (`0` = colocación instantánea en el suelo).
`Config.Airdrop.StashSlots`	`number`	`20`	Número máximo de slots dentro del stash del airdrop.
`Config.Airdrop.Smoke.enable`	`boolean`	`true`	Activa el humo del aterrizaje.
`Config.Airdrop.Smoke.particle`	`table`	`dict = "scr_ar_planes", name = "scr_ar_trail_smoke"`	Diccionario y nombre de la partícula.
`Config.Airdrop.Smoke.scale`	`number`	`0.8`	Escala de la partícula.
`Config.Airdrop.Smoke.color`	`table`	`{ r = 170, g = 30, b = 80 }`	Color de la partícula (limitado por la compatibilidad de la partícula).

Drift — `config/drift.lua`

Variable	Tipo	Por defecto	Descripción
`Config.EnableDriftMode`	`boolean`	`false`	Activa el interruptor del modo drift (`exports.origen_inventory:ToggleDriftMode(true)`).
`Config.DriftHandling.InitialDragCoeff`	`number`	`90.22`	Resistencia aerodinámica durante el drift.
`Config.DriftHandling.DriveInertia`	`number`	`0.31`	Inercia de tracción. Más alto = aceleración más lenta.
`Config.DriftHandling.SteeringLock`	`number`	`22`	Ángulo máximo de giro.
`Config.DriftHandling.TractionCurveMax`	`number`	`-1.1`	Tracción máxima en curva. Los valores negativos son intencionados.
`Config.DriftHandling.TractionCurveMin`	`number`	`-0.4`	Tracción mínima en curva.
`Config.DriftHandling.TractionCurveLateral`	`number`	`2.5`	Agarre lateral en las curvas.
`Config.DriftHandling.LowSpeedTractionLossMult`	`number`	`-0.57`	Multiplicador de pérdida de tracción a baja velocidad.

Animaciones de registro — `config/search.lua`

Config.SearchAnims es una lista de pares de animación (dict, anim) que se usan al azar cuando se registra a un jugador. Edita el fichero para añadir o quitar animaciones.

Webhooks — `config_sv.lua`

URLs de webhooks de Discord solo para el servidor. Sustituye cada valor WEBHOOK_URL_HERE por tu URL real o deja el marcador para desactivar ese canal.

lua

Config.Webhook = {
    default  = "WEBHOOK_URL_HERE",
    giveItem = "WEBHOOK_URL_HERE",
    search   = "WEBHOOK_URL_HERE",
    stash    = "WEBHOOK_URL_HERE",
    trunks   = "WEBHOOK_URL_HERE",
    glovebox = "WEBHOOK_URL_HERE",
    drops    = "WEBHOOK_URL_HERE",
    money    = "WEBHOOK_URL_HERE",
}

Prendas de ropa — `config/clothes.lua`

Define Config.Clothings.Standalone, Config.Clothings.DefaultHairy, Config.Clothings.Variations, Config.Clothings.Drawables y Config.Clothings.Props. Estas tablas dirigen los cambios de componentes de ropa que usa la pestaña de ropa del inventario.

Este fichero es grande porque lista todas las variaciones de componentes por género. Normalmente solo lo editas para añadir variaciones personalizadas con AddNewVariation(category, gender, source, target, single).

Configuración · origen_inventory

General — config.lua

Ajustes de drops

Colores de los marcadores

Flags experimentales

Jugador — config/player.lua

Protección anti-trampas

Clothes-As-Item (CAI)

Money-As-Item (MAI)

Interfaz

Animaciones

Vehículos — config/vehicles.lua

Stashes — config/stashes.lua

Tiendas — config/shops.lua

World Points — config/worldpoints.lua

Armas — config/weaponoptions.lua

Crafteo — config/crafting.lua

Airdrops — config/airdrops.lua

Drift — config/drift.lua

Animaciones de registro — config/search.lua

Webhooks — config_sv.lua

Prendas de ropa — config/clothes.lua

General — `config.lua`

Jugador — `config/player.lua`

Vehículos — `config/vehicles.lua`

Stashes — `config/stashes.lua`

Tiendas — `config/shops.lua`

World Points — `config/worldpoints.lua`

Armas — `config/weaponoptions.lua`

Crafteo — `config/crafting.lua`

Airdrops — `config/airdrops.lua`

Drift — `config/drift.lua`

Animaciones de registro — `config/search.lua`

Webhooks — `config_sv.lua`

Prendas de ropa — `config/clothes.lua`