Início › Documentação › Configuração · origen_vendings

Configuração · origen_vendings

Toda a configuração do cliente está em config.lua. A configuração de logs do servidor está em svconfig.lua. Ambos os ficheiros estão excluídos do escrow e podem ser editados livremente.

config.lua

Geral

Variável	Tipo	Por omissão	Descrição
`Config.Framework`	`string`	`'qb-core'`	Framework a utilizar. É detetada automaticamente em execução: define este valor apenas como alternativa. Valores aceites: `'qb-core'`, `'qbx_core'`, `'esx'`
`Config.Inventory`	`string`	`'auto'`	Fornecedor de inventário. Usa `'auto'` para que o recurso o detete, ou força um específico: `'ox_inventory'`, `'qb-inventory'`, `'qs-inventory'`, `'ps-inventory'`, `'origen_inventory'`, `'codem-inventory'`, `'tgiann-inventory'`, `'core_inventory'`
`Config.GroupPermissions`	`string[]`	`{ 'god', 'admin', 'superadmin' }`	Grupos ACE com acesso total ao painel de administração. Verificados através de `IsPlayerAceAllowed`
`Config.Debug`	`boolean`	`false`	Imprime logs detalhados na consola do servidor (criação de tabelas, adição de colunas, etc.)
`Config.Language`	`string`	`'en'`	Idioma da interface. Valores aceites: `'en'`, `'es'`

Notificação

Variável	Tipo	Por omissão	Descrição
`Config.NotificationPosition`	`string`	`'top-right'`	Posição dos avisos das notificações no jogo. É passada diretamente ao bridge de notificações em `custom/client.lua`

Mundo

Variável	Tipo	Por omissão	Descrição
`Config.DistanceRender`	`float`	`60.0`	Distância em unidades do jogo a que o prop da máquina aparece ou desaparece para o jogador
`Config.InteractDistance`	`float`	`2.5`	Raio em unidades do jogo dentro do qual aparece o aviso `[E]` e a máquina pode ser aberta

Catálogo de props

Config.PropCatalog define as categorias de props disponíveis e os respetivos modelos de GTA associados. Controla os props que os administradores podem atribuir aos grupos de máquinas de venda automática.

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	Descrição
`model`	`string`	Nome do modelo do prop do GTA V
`label`	`string`	Nome apresentado no painel de administração
`interactive`	`boolean`	Se for `false`, o prop aparece no catálogo de administração mas não pode ser colocado como ponto de venda ativo

Categorias

Categoria	Comportamento
`'drinks'`, `'snacks'`, `'coffee'`, `'cigarettes'`	Padrão: os props são atribuídos automaticamente ao criar um grupo ou ao alterar a sua categoria. Os administradores não podem adicionar nem remover props manualmente
`'custom'`	Os grupos começam sem props. Os administradores podem atribuir manualmente qualquer prop interativo de qualquer categoria do catálogo

Para adicionar mais props, acrescenta entradas a qualquer categoria existente ou cria um novo bloco de categoria. Os props personalizados têm de ter interactive = true para poderem ser colocados.

svconfig.lua

Controla os logs por webhook do Discord. Este ficheiro é executado apenas no servidor e está excluído do escrow.

Campo	Tipo	Por omissão	Descrição
`enabled`	`boolean`	`true`	Interruptor geral. Define como `false` para desativar todos os logs do Discord
`webhooks['group-created']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando um administrador cria um novo grupo de máquinas
`webhooks['group-updated']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando um administrador atualiza um grupo de máquinas
`webhooks['group-deleted']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando um administrador elimina um grupo de máquinas
`webhooks['item-added']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando um item é adicionado a um grupo
`webhooks['item-updated']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando um item de um grupo é atualizado
`webhooks['item-removed']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando um item é removido de um grupo
`webhooks['machine-created']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando uma máquina de venda automática é colocada
`webhooks['machine-updated']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando uma máquina de venda automática é atualizada
`webhooks['machine-deleted']`	`string`	`'YOUR_WEBHOOK_URL'`	Disparado quando uma máquina de venda automática é eliminada

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/...',
    },
}

Podes usar o mesmo URL de webhook para vários eventos, ou um canal diferente por tipo de evento. Se deixares um valor como 'YOUR_WEBHOOK_URL' com enabled = true, será feito um pedido HTTP falhado para esse evento: substitui todos os valores antes de entrares em produção.