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

Personalização · origen_vendings

A pasta custom/ contém a camada de bridge do origen_vendings. Estes ficheiros estão excluídos do escrow e são os únicos que deves editar para integrar o recurso com a tua stack.

custom/
├── client.lua   ← TextUI and notification bridges
└── server.lua   ← Framework, permissions, economy, and inventory bridges

custom/client.lua

Define dois objetos bridge usados em todo o lado cliente: HelpText e Notify.

HelpText

Controla o aviso TextUI apresentado quando o jogador está perto de uma máquina de venda automática.

HelpText.GetResourceName() → string

Devolve o nome do recurso que fornece o TextUI.

HelpText.GetResourceName = function()
    return 'ox_lib'
end

HelpText.ShowHelpText(message, position?)

Mostra o TextUI no ecrã. É chamado automaticamente quando o jogador entra no raio de interação de uma máquina.

-- Default implementation (ox_lib)
HelpText.ShowHelpText = function(message, position)
    exports.ox_lib:showTextUI(message, {
        position = position or 'left-center',
        icon     = 'shopping-cart',
    })
end

HelpText.HideHelpText()

Oculta o TextUI ativo. É chamado automaticamente quando o jogador sai do raio de interação.

-- Default implementation (ox_lib)
HelpText.HideHelpText = function()
    exports.ox_lib:hideTextUI()
end

Notify

Controla as notificações emergentes do jogo enviadas ao jogador (compra bem-sucedida, erros, etc.).

Notify.GetResourceName() → string

Devolve o nome do recurso que fornece as notificações.

Notify.GetResourceName = function()
    return 'ox_lib'
end

Notify.SendNotify(message, type?, time?)

Notificação simples, sem título.

-- Default implementation (ox_lib)
Notify.SendNotify = function(message, _type, time)
    exports.ox_lib:notify({
        description = message,
        type        = _type or 'info',
        duration    = time  or 3000,
        position    = Config.NotificationPosition or 'top-right',
    })
end

Notify.SendNotification(title, message, type?, time?)

Notificação com título.

-- Default implementation (ox_lib)
Notify.SendNotification = function(title, message, _type, time)
    exports.ox_lib:notify({
        title       = title or 'Vending',
        description = message,
        type        = _type or 'info',
        duration    = time  or 3000,
        position    = Config.NotificationPosition or 'top-right',
    })
end

custom/server.lua

Define o objeto bridge Custom usado em todo o lado servidor. Trata da integração com a framework, das permissões, da economia e do inventário.

Custom.getIdentifier(source) → string | nil

Devolve o identificador único do jogador (citizenid no QBCore/QBX, license no ESX).

Custom.getStaffLevel(source) → 'full' | false

Verifica se o jogador tem acesso de administração ao painel das máquinas de venda automática. Devolve 'full' se tiver e false caso contrário.

Verifica (por ordem):

1. A marca de administrador da framework (qb-core / qbx_core)
2. Qualquer grupo ACE definido em Config.GroupPermissions
3. O ACE genérico command

-- Usage example inside a callback
local level = Custom.getStaffLevel(source)
if not level then return end -- not an admin

Custom.getMoney(source, account?) → number | nil

Devolve o saldo do jogador na conta indicada.

Custom.removeMoney(source, amount, account?, reason?) → boolean, string?

Retira dinheiro ao jogador. Devolve true em caso de sucesso, ou false mais uma cadeia de erro em caso de falha.

Possíveis cadeias de erro:

local ok, err = Custom.removeMoney(source, 50, 'cash')
if not ok then
    print('Payment failed:', err)
end

Custom.giveItem(source, itemName, amount, metadata?) → boolean

Entrega um item ao jogador através do inventário ativo. Verifica a capacidade de carga quando é suportado.

Custom.itemExists(itemName) → boolean

Devolve true se o item estiver registado no inventário ativo.

Custom.getInventoryName() → string

Devolve o nome do recurso de inventário atualmente ativo (por exemplo 'ox_inventory', 'qb-inventory'). Útil para logs e depuração.

Custom.getAllInventoryItems() → table[]

Devolve todos os itens registados no inventário ativo, ordenados alfabeticamente pela etiqueta. É usado pelo painel de administração para preencher o seletor de itens.

Cada entrada da tabela devolvida: