Integrations — Darts | Quasar Store | Quasar Store

Integrations — Darts | Quasar Store | Quasar Store

How Integrations Work#

Darts 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, the HUD and the 3D prompts. The framework is detected when the resource starts; the optional resources are used whenever they are running.

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

Function	Decides
`CanAfford(src, amount, method)`	Whether a player can pay an entry fee or a stake.
`RemoveMoney(src, amount, method)`	Takes it.
`AddMoney(src, amount, method)`	Pays out a pot or refunds a stake.
`HasPermission(src)`	Who may use the creator and the calibration tools.
`GetCharacterName(src)`	The name on the scoreboard, in the opponent list and on a challenge. ESX uses the character's name, QBCore and Qbox the first and last name; without one, the FiveM name.

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

Config.AddMoney = function(src, amount, method)
    exports.ox_inventory:AddItem(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' then return true end
    return IsPlayerAceAllowed(src, Config.Creator.permission)
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, otherwise `lib.notify`.
`ToggleGameHud(visible)`	Hides the HUD when a game or a calibration tool starts, and brings it back after.	GTA's HUD and minimap, plus `qs-interface`'s HUD.
`DrawText3D(x, y, z, text, id, key)`	The [E] - Play Darts and [E] - Collect darts prompts.	`qs-textui` if it was running when Darts started, otherwise drawn text.

lua

-- client/custom/framework.lua
function Notification(msg, kind)
    local types = { inform = 'info', success = 'success', error = 'error' }
    exports['okokNotify']:Alert('Darts', msg, 3000, types[kind] or 'info')
end