FzD Scripts Documentation

A contextual menu belongs to one interaction and does not modify the player’s normal action registry.

local function openCheckout(registerId)
    if GetResourceState('fzd_actionwheel') ~= 'started' then return end

    local ok, reason = exports.fzd_actionwheel:open({
        {
            id = 'my_shop:pay',
            label = 'Pay for items',
            icon = 'cash-register',
            serverEvent = 'my_shop:requestPayment',
            payload = { registerId = registerId }
        },
        {
            id = 'my_shop:return',
            label = 'Put items back',
            icon = 'basket-shopping',
            clientEvent = 'my_shop:returnItems',
            payload = { registerId = registerId }
        }
    }, {
        title = 'SHOP',
        position = { x = 70, y = 50 }
    })

    if not ok then
        print(('[my_shop] Wheel failed: %s'):format(tostring(reason)))
    end
end

Call openCheckout(theRegisterId) from your existing target, proximity or interaction handler. FzD Action Wheel does not create interaction zones itself.

Open options

Option	Description
`title`	Centre text, maximum 32 bytes
`position`	`{ x, y }` wheel-centre percentages

if exports.fzd_actionwheel:isOpen() then
    exports.fzd_actionwheel:close()
end

There is only one visible wheel per client. close() does not track which resource opened the current menu, so avoid delayed unconditional closes that could close a newer menu.

Security

Payloads and visibility checks are client-controlled. A real server event must independently validate price, money, items, permissions, distance and transaction state.