Integrations

Integrations — Arm Wrestling | Quasar Store | Quasar Store

How Integrations Work#

Arm Wrestling talks to the rest of your server through one small, open file per framework, in custom/, which handles money and player names. 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`	Runs standalone: bets move no money, and names come from FiveM.

Resource	Mode
`es_extended`	`esx` — ESX
`qb-core`	`qb` — QBCore
`qbx_core`	`qb` — Qbox, through its QBCore compatibility
None of them	`standalone`

Function	Decides
`getMoney(source)`	How much a player can bet. ESX reads the cash (`money`) account, QBCore and Qbox `cash`.
`removeMoney(source, amount)`	Takes a bet when a challenge is accepted.
`addMoney(source, amount)`	Pays the winner, or refunds a bet.
`getName(source)`	The name in the opponent list, on a challenge and in the messages. ESX uses the character's name, QBCore and Qbox the first and last name, standalone the FiveM name.
`getIdentifier(source)`	The player's identifier: the ESX `identifier`, the QBCore `citizenid`, or the license on 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)
    local player = self:getPlayerFromId(source)
    if not player then return 0 end
    return player.PlayerData.money.bank or 0
end

function framework:removeMoney(source, amount)
    local player = self:getPlayerFromId(source)
    if not player then return false end
    return player.Functions.RemoveMoney('bank', amount, 'qs-armwrestling-bet')
end

function framework:addMoney(source, amount)
    local player = self:getPlayerFromId(source)
    if not player then return false end
    return player.Functions.AddMoney('bank', amount, 'qs-armwrestling-win')
end

lua

-- in the file of the framework you run: custom/esx, custom/qb or custom/standalone
function framework:getMoney(source)
    return exports.ox_inventory:GetItemCount(source, 'casino_chips')
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

Part	With	Otherwise
Notifications	`qs-interface` whenever it is running — an info, error or success notice for 2.5 seconds.	`lib.notify` from ox_lib, titled Arm Wrestling.
The table prompt	`qs-textui`, if it was running when Arm Wrestling started, with `E` as its key.	Drawn 3D text on a dark backdrop above the table.
The table menu	ox_lib's context menu.	—
Keys on screen	GTA V's own instructional buttons, during a match and while placing a table.	—

Copy the closest bridge
Copy custom/esx/ or custom/qb/ to a folder named after your framework, for example custom/myframework/, keeping the file name server.lua.
Change the calls inside
Fill in getPlayerFromId, getIdentifier, getMoney, removeMoney, addMoney and getName with your framework's own functions. The file must end with return framework, as the originals do.

Register it for detection

Add your framework's resource to the list at the top of config.lua, pointing at the folder's name, and make sure it starts before qs-armwrestling.

lua

local frameworks = {  -- resource name -> internal name
    ['es_extended'] = 'esx',
    ['qb-core']     = 'qb',
    ['qbx_core']    = 'qb',
    ['my_core']     = 'myframework',
}

Integrations

How Integrations Work#

Frameworks#

Paying Bets From the Bank#

A Custom Currency#

Permissions#

Notifications and the Prompt#

Adding a Framework#

Copy the closest bridge

Change the calls inside

Register it for detection

Languages#