Inicio › Documentación › Configuración · origen_vendings

Configuración · origen_vendings

Toda la configuración del cliente está en config.lua. La configuración de logs del servidor está en svconfig.lua. Ambos ficheros están excluidos del escrow y se pueden editar libremente.

config.lua

General

Variable	Tipo	Por defecto	Descripción
`Config.Framework`	`string`	`'qb-core'`	Framework a usar. Se detecta automáticamente en ejecución: define este valor solo como alternativa. Valores admitidos: `'qb-core'`, `'qbx_core'`, `'esx'`
`Config.Inventory`	`string`	`'auto'`	Proveedor de inventario. Usa `'auto'` para que el recurso lo detecte, o fuerza uno concreto: `'ox_inventory'`, `'qb-inventory'`, `'qs-inventory'`, `'ps-inventory'`, `'origen_inventory'`, `'codem-inventory'`, `'tgiann-inventory'`, `'core_inventory'`
`Config.GroupPermissions`	`string[]`	`{ 'god', 'admin', 'superadmin' }`	Grupos ACE con acceso completo al panel de administración. Se comprueban mediante `IsPlayerAceAllowed`
`Config.Debug`	`boolean`	`false`	Imprime logs detallados en la consola del servidor (creación de tablas, adición de columnas, etc.)
`Config.Language`	`string`	`'en'`	Idioma de la interfaz. Valores admitidos: `'en'`, `'es'`

Notificación

Variable	Tipo	Por defecto	Descripción
`Config.NotificationPosition`	`string`	`'top-right'`	Posición de los avisos de las notificaciones del juego. Se pasa directamente al bridge de notificaciones en `custom/client.lua`

Mundo

Variable	Tipo	Por defecto	Descripción
`Config.DistanceRender`	`float`	`60.0`	Distancia en unidades del juego a la que el prop de la máquina aparece o desaparece para el jugador
`Config.InteractDistance`	`float`	`2.5`	Radio en unidades del juego dentro del cual aparece el aviso `[E]` y se puede abrir la máquina

Catálogo de props

Config.PropCatalog define las categorías de props disponibles y sus modelos de GTA asociados. Controla qué props pueden asignar los administradores a los grupos de máquinas expendedoras.

lua

Config.PropCatalog = {
    {
        category = 'drinks',
        label    = 'Bebidas',
        props    = {
            { model = 'prop_vend_soda_01',  label = 'Máquina eCola',           interactive = true },
            { model = 'prop_vend_soda_02',  label = 'Máquina Sprunk',          interactive = true },
            { model = 'prop_vend_fridge01', label = 'Refrigerador de bebidas', interactive = true },
            { model = 'prop_vend_water_01', label = 'Máquina de agua',         interactive = true },
            { model = 'sf_prop_sf_vend_drink_01a',        label = 'Máquina bebidas (The Contract)', interactive = true },
            { model = 'ch_chint10_vending_smallroom_01',  label = 'Máquina vending (Casino)',       interactive = true },
        },
    },
    {
        category = 'snacks',
        label    = 'Snacks',
        props    = {
            { model = 'prop_vend_condom_01',  label = 'Máquina vending compacta',    interactive = true },
            { model = 'prop_vend_snak_01_tu', label = 'Máquina de snacks (variante)', interactive = true },
        },
    },
    {
        category = 'coffee',
        label    = 'Café',
        props    = {
            { model = 'prop_vend_coffe_01', label = 'Cafetera Bean Machine (A)', interactive = true },
            { model = 'p_ld_coffee_vend_s', label = 'Cafetera móvil',           interactive = true },
        },
    },
    {
        category = 'cigarettes',
        label    = 'Cigarrillos',
        props    = {
            { model = 'prop_vend_fags_01', label = 'Máquina de cigarrillos', interactive = true },
            { model = 'v_ret_247_cigs',    label = 'Exhibidor de cigarrillos', interactive = true },
        },
    },
}

Campos de cada prop

Campo	Tipo	Descripción
`model`	`string`	Nombre del modelo del prop de GTA V
`label`	`string`	Nombre que se muestra en el panel de administración
`interactive`	`boolean`	Si es `false`, el prop aparece en el catálogo de administración pero no se puede colocar como punto de venta activo

Categorías

Categoría	Comportamiento
`'drinks'`, `'snacks'`, `'coffee'`, `'cigarettes'`	Estándar: los props se asignan automáticamente al crear un grupo o al cambiar su categoría. Los administradores no pueden añadir ni quitar props de forma manual
`'custom'`	Los grupos empiezan sin props. Los administradores pueden asignar manualmente cualquier prop interactivo de cualquier categoría del catálogo

Para añadir más props, agrega entradas a cualquier categoría existente o crea un bloque de categoría nuevo. Los props personalizados deben tener interactive = true para poder colocarse.

svconfig.lua

Controla los logs por webhook de Discord. Este fichero se ejecuta solo en el servidor y está excluido del escrow.

Campo	Tipo	Por defecto	Descripción
`enabled`	`boolean`	`true`	Interruptor general. Ponlo en `false` para desactivar todos los logs de Discord
`webhooks['group-created']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando un administrador crea un grupo de máquinas nuevo
`webhooks['group-updated']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando un administrador actualiza un grupo de máquinas
`webhooks['group-deleted']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando un administrador elimina un grupo de máquinas
`webhooks['item-added']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando se añade un objeto a un grupo
`webhooks['item-updated']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando se actualiza un objeto de un grupo
`webhooks['item-removed']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando se quita un objeto de un grupo
`webhooks['machine-created']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando se coloca una máquina expendedora
`webhooks['machine-updated']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando se actualiza una máquina expendedora
`webhooks['machine-deleted']`	`string`	`'YOUR_WEBHOOK_URL'`	Se dispara cuando se elimina una máquina expendedora

lua

-- svconfig.lua
return {
    enabled = true,
    webhooks = {
        ['group-created']   = 'https://discord.com/api/webhooks/...',
        ['group-updated']   = 'https://discord.com/api/webhooks/...',
        ['group-deleted']   = 'https://discord.com/api/webhooks/...',
        ['item-added']      = 'https://discord.com/api/webhooks/...',
        ['item-updated']    = 'https://discord.com/api/webhooks/...',
        ['item-removed']    = 'https://discord.com/api/webhooks/...',
        ['machine-created'] = 'https://discord.com/api/webhooks/...',
        ['machine-updated'] = 'https://discord.com/api/webhooks/...',
        ['machine-deleted'] = 'https://discord.com/api/webhooks/...',
    },
}

Puedes usar la misma URL de webhook para varios eventos, o un canal distinto por tipo de evento. Si dejas un valor como 'YOUR_WEBHOOK_URL' con enabled = true, se producirá una petición HTTP fallida para ese evento: sustituye todos los valores antes de salir en producción.