Integrations — Air Hockey | Quasar Store | Quasar Store

Integrations — Air Hockey | Quasar Store | Quasar Store

How Integrations Work#

Air Hockey talks to the rest of your server through a handful of small, open files: server/custom/framework/ for money, permissions and names, and client/custom/framework.lua for notifications and the prompt. Everything else is detected on its own:

Layer	Supported	Without it
Framework	`es_extended` · `qb-core` · `qbx_core`	Runs standalone: nobody is charged, and players are listed by their FiveM name.

Function	Decides
`CanAfford(src, amount, method)`	Whether a player can pay a table's entry fee — checked before a game against the bot, when a challenge is sent and when it is accepted.
`RemoveMoney(src, amount, method)`	Takes the entry fee.
`HasPermission(src)`	Who may open the creator and create, move or delete tables.
`GetCharacterName(src)`	The name shown in the opponent list and in the challenge window: the character's name on ESX, QBCore and Qbox, the FiveM name standalone.

lua

-- config/config.lua
Config.CanAfford = function(src, amount, method)
    return exports.ox_inventory:GetItemCount(src, 'casino_chips') >= amount
end

Config.RemoveMoney = function(src, amount, method)
    exports.ox_inventory:RemoveItem(src, 'casino_chips', amount)
end

lua

-- server/custom/framework/esx.lua
function HasPermission(src)
    local xPlayer = ESX.GetPlayerFromId(src)
    if xPlayer and (xPlayer.getGroup() == 'admin' or xPlayer.getGroup() == 'superadmin') then
        return true
    end
    local perm = Config.Creator and Config.Creator.permission or 'command.ahcreator'
    return IsPlayerAceAllowed(src, perm)
end

lua

-- server/custom/framework/qb.lua
function HasPermission(src)
    if QBCore.Functions.HasPermission(src, 'admin') then
        return true
    end
    local perm = Config.Creator and Config.Creator.permission or 'command.ahcreator'
    return IsPlayerAceAllowed(src, perm)
end

Function	What it does	Default
`Notification(msg, kind)`	Every message a player sees. `kind` is `inform`, `success` or `error`.	`qs-interface` when it is running, an `ox_lib` notification otherwise.
`DrawText3D(x, y, z, text, id, key)`	The [E] - Play Air Hockey prompt over a table.	`qs-textui` when it started before Air Hockey, built-in 3D text otherwise.

lua

-- client/custom/framework.lua
function Notification(msg, kind)
    local types = { inform = 'primary', success = 'success', error = 'error' }
    TriggerEvent('QBCore:Notify', msg, types[kind] or 'primary')
end

lua

Config.TableModel = joaat('prop_airhockey_01')

-- Puck: tried in order, the first that exists in the game is used
Config.PuckModels = {
    joaat('proair_hoc_puck'),
    joaat('prop_air_hoc_puck_01'),
    joaat('prop_air_hoc_puck'),
}

Config.PaddleModels = {
    [1] = joaat('prop_air_hoc_paddle_01'), -- red  (the solo player / the challenger)
    [2] = joaat('prop_air_hoc_paddle_02'), -- blue (the bot / the challenged player)
}