Integrations — Ping Pong | Quasar Store | Quasar Store

Integrations — Ping Pong | Quasar Store | Quasar Store

How Integrations Work#

Ping Pong talks to the rest of your server through a few small, open files: custom/<framework>/server.lua for money, names and identifiers, custom/<framework>/client.lua for the player's data, and client/custom/ for notifications, the 3D prompt, sounds and ox_target. All of them are outside the escrow and are yours to change.

Layer	Supported	Without it
Framework	`es_extended` · `qb-core` · `qbx_core`

Function	Decides	Shipped behaviour
`framework:getMoney(source)`	Whether a player can cover a stake.	Cash on ESX, QBCore and Qbox. Unlimited standalone.
`framework:removeMoney(source, amount)`	Takes a stake.	From cash, logged as `pingpong-bet` on QBCore. Does nothing standalone.
`framework:addMoney(source, amount)`	Pays a win or a pot.	To cash, logged as `pingpong-win` on QBCore. Does nothing standalone.
`framework:getName(source)`	The name on the scoreboard, the player list, invitations and the leaderboard.	The character's name on ESX and QBCore; the FiveM name standalone.
`framework:getIdentifier(source)`	Who a leaderboard row belongs to.	The ESX identifier, the QBCore `citizenid` (one row per character), or the `license:` identifier standalone.

lua

-- custom/esx/server.lua
function framework:getMoney(source)
    local xPlayer = self:getPlayerFromId(source)
    if not xPlayer then return 0 end
    return xPlayer.getAccount('bank').money
end

function framework:removeMoney(source, amount)
    local xPlayer = self:getPlayerFromId(source)
    if not xPlayer then return false end
    xPlayer.removeAccountMoney('bank', amount)
    return true
end

function framework:addMoney(source, amount)
    local xPlayer = self:getPlayerFromId(source)
    if not xPlayer then return false end
    xPlayer.addAccountMoney('bank', amount)
    return true
end

lua

-- custom/qb/server.lua
function framework:getMoney(source)
    return exports.ox_inventory:GetItemCount(source, 'casino_chips') or 0
end

function framework:removeMoney(source, amount)
    return exports.ox_inventory:RemoveItem(source, 'casino_chips', amount)
end

function framework:addMoney(source, amount)
    return exports.ox_inventory:AddItem(source, 'casino_chips', amount)
end

Function	What it does	Default
`Notification(msg, type)`	Every message a player sees. `type` is `info`, `success`, `error` or `warning`.	`qs-interface` if it is started, otherwise ox_lib with the title Ping Pong.
`DrawText3D(x, y, z, text)`	The [E] - Ping Pong prompt over the nearest table.	`qs-textui` if it was started before Ping Pong, otherwise built-in 3D text.
`PlayGameSound(key, coords)`	The `hit`, `win` and `lose` sounds of `Config.Sounds`. Hits play at the ball, so players nearby hear them too.	GTA V's own sounds.

lua

Config.TableSkins = {
    { net = 'prop_table_tennis',   nonet = 'prop_table_tennis_nonet',   label = 'Blue' },
    { net = 'prop_table_tennis_b', nonet = 'prop_table_tennis_b_nonet', label = 'Green' },
    -- ...
}

Config.Creator = {
    permission  = 'command.pingpongcreator',
    model       = `prop_table_tennis_b`, -- the green table
    rotateSpeed = 80.0,
    heightStep  = 0.05,
}