Quasar Framework (qs-core) gives every character one wallet that every script on your FiveM server shares: the cash an ESX script pays out is the cash a QBCore script charges, and the bank balance a Quasar Framework job fills is the one an ESX Legacy shop reads. On top of that wallet you get paychecks by job grade, a full FiveM banking script (qs-banking) with bank branches, ATMs, account numbers, transfers and history, and society and boss funds through the esx_society and qb-management compatibility bridges.

Part	Resource	Folder
Money accounts, paychecks, money commands and exports	`qs-core`	`[core]`
Bank branches, ATMs, transfers, history	`qs-banking`	`[addons]`
ESX society accounts	`esx_society`	`[bridge]`
QBCore job and gang funds	`qb-management`	`[bridge]`

Money accounts#

Every character has three accounts:

Account	Key	Starting balance	Where players see it	Used for
Cash	`cash`	$500	HUD, `/cash`, banks and ATMs, shop window	Shops, `/givemoney`, hospital treatment, job sales and deliveries, the medic revive reward.
Bank	`bank`	$5,000	HUD, `/cash`, banks and ATMs	Paychecks, transfers, the vehicle dealership, police fines.
Black money	`black_money`	$0	The drug dealer	Dirty money: dealer sales from the drug economy pay into it.

Cash and bank are the money ESX and QBCore scripts work with: ESX's money account and QBCore's cash are Quasar Framework's cash, and bank is bank everywhere. A paycheck paid by Quasar Framework is in xPlayer.getAccount('bank') and in Player.PlayerData.money.bank straight away.

Black money is an account of its own: banks and ATMs only handle cash and bank, and admins move it with /addmoney and /removemoney (see below).

Starting money#

New characters get the balances of Config.Accounts in qs-core/shared/config.lua:

lua

Config.Accounts = {
    cash = 500,
    bank = 5000,
    black_money = 0,
}

Changing the numbers affects characters created afterwards; existing characters keep their balances. This is the only place that sets starting money — Config.StartingAccountMoney in es_extended is not used.

Where money comes from and where it goes#

Every change of cash, bank or black money carries a reason, which you see in your logs and in the qs:server:moneyChange event.

What happens	Account	Amount	Reason
Paycheck	+ bank	Salary of your job grade	`paycheck`
Selling job goods (miner, lumberjack, fisher)	+ cash	Per item sold	`job:<job>`
Delivery job: each package, end-of-shift bonus	+ cash	Per stop / bonus	`job:delivery`, `job:delivery-bonus`
Delivery van deposit (taken, then returned)	− / + cash	$100	`job:delivery-deposit`
Medic stabilises a downed patient	+ cash (medic)	$250	`ems-revive`
Drug sales to a dealer	+ black money	Per sale	`drug-sale`
`/givemoney`	cash, player to player	Any	`give`
Shop purchase	− cash	Price × amount	`shop:<shop>`
Vehicle dealership	− bank, or cash if the bank is short	Vehicle price	`vehicleshop:<model>`
Hospital treatment	− cash	$250	`hospital`
Police fine	− bank	$1 – $50,000	`police-fine`
Bank deposit / withdrawal	cash ↔ bank	Any	`bank-deposit`, `bank-withdraw`
Bank transfer	− bank (sender), + bank (recipient)	Amount (+ fee for the sender)	`bank-transfer`
Admin command or admin menu	Any	Any	`admin`

One more option shapes the economy: Config.Death.loseCashOnDeath in qs-core/shared/config.lua (default false). Set it to true and players lose all their cash when they respawn at the hospital.

Money commands#

Command	Who	What it does
`/cash`	Everyone	Shows your cash and bank balance.
`/givemoney <amount>`	Everyone	Gives cash to the nearest player within 3 m. Both players get a notification.
`/addmoney <id> <account> <amount>`	Admins (`command.qs`)	Adds money to `cash`, `bank` or `black_money` of player `<id>`.
`/removemoney <id> <account> <amount>`	Admins (`command.qs`)	Removes money. Nothing happens if the player does not have that much.

<account> is the Quasar Framework key: cash, bank or black_money (not ESX's money). From the server console or txAdmin the same commands work without the slash, for example addmoney 1 bank 10000. Admins can also add, remove or set any account from the admin menu (F6) — see Administration.

To keep a record in Discord, set the webhooks in qs-core/shared/config.lua:

Option	Default	What it logs
`Config.Webhooks.money`	`''` (off)	Every `/givemoney`.
`Config.Webhooks.admin`	`''` (off)	Every `/addmoney` and `/removemoney` (and other admin actions).

Money from your own scripts#

lua

local core = exports['qs-core']

local cash = core:GetMoney(source, 'cash')

-- pay 250 into the bank, tagged for your logs
core:AddMoney(source, 'bank', 250, 'myscript:reward')

-- charge 100 cash; false when the player cannot afford it
if core:RemoveMoney(source, 'cash', 100, 'myscript:fee') then
    -- paid
end

-- set an exact balance
core:SetMoney(source, 'bank', 10000)

lua

local xPlayer = ESX.GetPlayerFromId(source)

xPlayer.addMoney(250)                  -- cash
xPlayer.addAccountMoney('bank', 250)
xPlayer.removeAccountMoney('bank', 100)

local bank = xPlayer.getAccount('bank').money

lua

local Player = QBCore.Functions.GetPlayer(source)

Player.Functions.AddMoney('bank', 250, 'reward')
Player.Functions.RemoveMoney('cash', 100, 'fee')

local cash = Player.Functions.GetMoney('cash')

Server export	Parameters	Returns
`GetMoney`	`source, account`	Balance (number).
`AddMoney`	`source, account, amount, reason?`	`true` / `false`. The amount must be above 0 and the account must exist.
`RemoveMoney`	`source, account, amount, reason?`	`true` / `false` (`false` when the balance is too low).
`SetMoney`	`source, account, amount`	`true` / `false`. The amount must be 0 or more.

Every AddMoney and RemoveMoney fires the server event qs:server:moneyChange — the easiest way to build a money log:

lua

AddEventHandler('qs:server:moneyChange', function(source, account, kind, amount, reason)
    -- kind is 'add' or 'remove'
    print(('[money] %s %s $%s %s (%s)'):format(source, kind, amount, account, reason or '-'))
end)

SetMoney changes the balance without firing it.

Driving the economy from your own scripts? The player object (exports['qs-core']:GetPlayer(source) with getMoney, addMoney, removeMoney, setMoney), every money export and every event are listed in Commands and Exports.

Paychecks#

Every 30 minutes, everyone online with a character loaded receives the salary of their job grade in their bank, with the notification Paycheck received: $500. The timer is shared: everyone is paid at the same moment. A grade with salary 0 is not paid.

Option	Default	What it does
`Config.Paycheck.enabled`	`true`	Turns paychecks on or off.
`Config.Paycheck.interval`	`30 * 60 * 1000`	Time between paychecks, in milliseconds.

Both are in qs-core/shared/config.lua and are read when qs-core starts.

Salaries by job and grade#

Job	Grade	Rank	Salary
`unemployed` (Civilian)	0	Freelancer	$200
`police`	0	Recruit	$500
`police`	1	Officer	$750
`police`	2	Sergeant	$1,000
`police`	3	Chief (boss)	$2,000
`ambulance` (EMS)	0	Trainee	$500
`ambulance` (EMS)	1	Paramedic	$800
`ambulance` (EMS)	2	Doctor	$1,200
`ambulance` (EMS)	3	Chief (boss)	$2,000
`hunter`	0	Hunter	$200
`delivery`	0	Driver	$200
`miner`	0	Miner	$175
`lumberjack`	0	Lumberjack	$175
`fisher`	0	Fisherman	$150

Players without a job are unemployed and still receive $200 as Freelancer. Set that salary to 0 to stop paying the unemployed.

Salaries live in qs-core/shared/jobs.lua:

lua

['police'] = {
    label = 'Police',
    grades = {
        [0] = { name = 'recruit',  label = 'Recruit',  salary = 500 },
        [1] = { name = 'officer',  label = 'Officer',  salary = 750 },
        [2] = { name = 'sergeant', label = 'Sergeant', salary = 1000 },
        [3] = { name = 'boss',     label = 'Chief',    salary = 2000, isBoss = true },
    },
},

Banking#

qs-banking (in [addons]) is the FiveM banking script of Quasar Framework: 8 bank branches with tellers, every ATM on the map, personal account numbers, deposits, withdrawals, transfers to online and offline players and a transaction history. The balances it shows are the same cash and bank used by every ESX, QBCore and Quasar Framework script.

Bank branches and ATMs#

Each branch has a green Bank blip on the map and a teller. Walk up to the counter: within about 2.4 m you see Press E to use the bank; press E. ATMs need no blip — every ATM prop in the world works: stand within 1.6 m to see Press E to use the ATM.

#	Branch	Coordinates
1	Legion Square	`149.6, -1042.2`
2	Rockford Hills	`-1211.9, -332.0`
3	Great Ocean Highway	`-2961.1, 483.1`
4	Paleto Bay	`-112.2, 6471.1`
5	Alta, Hawick Avenue	`313.8, -280.5`
6	Burton	`-351.3, -51.3`
7	Route 68, Harmony	`1175.0, 2708.2`
8	Pacific Standard, Vinewood	`247.0, 225.2`

What you can do	Bank branch	ATM
See your bank balance, cash and account number	Yes	Yes
Deposit cash	Yes	Yes
Withdraw cash	Yes	Yes
Transfer to another account	Yes	—
Transaction history	Yes	Yes

The HUD hides while the bank is open. Amount fields have quick buttons ($100, $500, $1,000, $5,000, $25,000) and MAX.

Account numbers#

Every character gets one account number the first time they open a bank or an ATM: QS followed by 9 digits, for example QS482910375. It never changes. Click the balance card to copy it (Account number copied) and share it to receive transfers.

Deposit and withdraw#

Deposit moves cash into the bank. You need that much cash (You don't have that much cash).
Withdraw moves money from the bank into your cash. You need that much in the bank (Insufficient funds).
Amounts are whole dollars above 0. You see Deposited $500 or Withdrew $500, and the balances update at once.

Transfers#

Get the recipient's account number
They find it on the balance card of any bank or ATM and can copy it with one click.
Open a bank branch
Transfers are made at a branch (ATMs do not have the Transfer tab). Choose Transfer.
Enter the number and the amount
Paste the account number (spaces are ignored), type the amount and confirm.
Done
You see Transferred $1000. If the recipient is online, the money is in their bank at once and they see You received $1000. If they are offline, it is added to their bank and waiting for them at their next login.

Rule	What happens
The account number does not exist	That account does not exist
It is your own account	You cannot transfer to yourself
Your bank does not cover the amount plus the fee	Insufficient funds
Transfer fee	`Config.TransferFee` × amount, rounded down, paid by the sender on top of the amount. The recipient always receives the full amount. Default `0.0` (no fee).

Example with Config.TransferFee = 0.02 (2%): sending $10,000 costs the sender $10,200 and the recipient receives $10,000.

History#

The History tab lists your 25 newest operations (Config.HistoryLimit), newest first. Each one is stored with its amount, your bank balance after it, a label and the date.

Type	Sign	Label
`deposit`	+	Cash deposit
`withdraw`	−	Cash withdrawal
`transfer_in`	+	Transfer from `<sender's citizen ID>`
`transfer_out`	−	Transfer to `<recipient's account number>`

The sender's transfer_out shows the amount sent; the fee is not a separate line. For a transfer received while offline, the balance column of that line shows 0.

Limits#

Limit	Value
Amounts	Whole dollars above 0 (decimals are rounded down).
Deposits and withdrawals	One every 0.6 seconds per player.
Transfers	One every 1.2 seconds per player.
Maximum per operation	None — up to your balance.
Going below zero	Not possible.
History shown	25 newest operations (`Config.HistoryLimit`).

Banking configuration#

All options are in qs-banking/config.lua.

Option	Default	What it does
`Config.OpenKey`	`38` (E)	Control that opens a bank or an ATM.
`Config.InteractDistance`	`1.6`	ATM reach in metres. Bank branches use this + 0.8 m.
`Config.TransferFee`	`0.0`	Fee charged to the sender, as a fraction of the amount (`0.02` = 2%).
`Config.HistoryLimit`	`25`	How many history lines are shown.
`Config.ATMModels`	`prop_atm_01`, `prop_atm_02`, `prop_atm_03`, `prop_fleeca_atm`	Props that work as ATMs.
`Config.Banks`	8 branches	`{ coords = vec4(...), ped = 'U_M_M_BankMan', scenario = 'WORLD_HUMAN_CLIPBOARD' }`. Leave `ped` out for a counter without a teller.
`Config.Blip`	`{ sprite = 108, color = 2, scale = 0.6, label = 'Bank' }`	Blip of every branch.

To add a branch, stand where the teller should be, run /coords and add a line to Config.Banks:

lua

Config.Banks = {
    -- ...existing branches...
    { coords = vec4(0.0, 0.0, 0.0, 0.0), ped = 'U_M_M_BankMan', scenario = 'WORLD_HUMAN_CLIPBOARD' }, -- paste the vec4 from /coords
}

Then restart qs-banking.

Events and callbacks for integrators#

qs-banking has no commands and no exports. Phone banking apps, tablets and logs can use these:

qs-banking:data (server callback)

Returns the calling player's { cash, bank, account, history } and creates their account number if they do not have one yet.

lua

-- client side
exports['qs-core']:TriggerCallback('qs-banking:data', function(data)
    print(data.account, data.bank, #data.history)
end)

qs-banking:server:deposit / qs-banking:server:withdraw (net events)

TriggerServerEvent('qs-banking:server:deposit', amount) and TriggerServerEvent('qs-banking:server:withdraw', amount). The server applies every rule above (balance, whole amounts, rate limit), logs the operation and notifies the player.

qs-banking:server:transfer (net event)

TriggerServerEvent('qs-banking:server:transfer', accountNumber, amount). Same checks, fee and history as a transfer made at a branch, so a phone app can offer transfers too.

qs-banking:client:update (client event)

Sent to the player with { cash, bank, history } after each of their operations, and to the recipient of a transfer.

Money log reasons

Bank operations fire qs:server:moneyChange with the reasons bank-deposit, bank-withdraw and bank-transfer.

Database tables

bank_accounts (citizenid, account_number) and bank_transactions (citizenid, type, amount, balance, label, created) are created by the Quasar Framework SQL file.

sql

SELECT account_number FROM bank_accounts WHERE citizenid = 'QSABC123';

Integrating a phone or a tablet? The qs-core callbacks (TriggerCallback) and money exports are documented in Commands and Exports.

Society and boss funds#

Many ESX and QBCore scripts keep a shared balance per job or gang — the money of the police department, a mechanic shop or a gang. Quasar Framework ships two compatibility resources in [bridge] that answer exactly like the originals, so those scripts work unmodified:

Bridge	For	Database table	Holds
`esx_society`	ESX scripts	`society_accounts` (`name`, `money`)	One balance per society account name.
`qb-management`	QBCore scripts	`management_funds` (`job_name`, `amount`, `type`)	One balance per job (`type = 'job'`) and per gang (`type = 'gang'`).

Both create their table on start and save every change.

Export / callback	What it does
`exports['esx_society']:getSocietyMoney(account)`	Balance of that account.
`exports['esx_society']:addMoney(account, amount)`	Adds a whole amount above 0.
`exports['esx_society']:removeMoney(account, amount)`	Removes it; the balance never goes below 0. No return value.
`exports['esx_society']:getSociety(name)`	The registered society.
Callbacks `esx_society:getSociety`, `esx_society:getSocieties`, `esx_society:getSocietyMoney`	Same data through `ESX.TriggerServerCallback`.
Event `esx_society:registerSociety(name, label, account, datastore, jobs, data)`	Registers a society, as ESX job scripts do on start.

lua

exports['esx_society']:addMoney('society_police', 500)
local balance = exports['esx_society']:getSocietyMoney('society_police')

Export	What it does
`exports['qb-management']:GetAccount(job)`	Balance of a job.
`exports['qb-management']:AddMoney(job, amount)`	Adds; returns `true` / `false`.
`exports['qb-management']:RemoveMoney(job, amount)`	Removes; `false` when the fund cannot cover it.
`exports['qb-management']:GetGangAccount(gang)`	Balance of a gang.
`exports['qb-management']:AddGangMoney(gang, amount)`	Adds to a gang.
`exports['qb-management']:RemoveGangMoney(gang, amount)`	Removes from a gang; `false` when it cannot cover it.

lua

exports['qb-management']:AddMoney('police', 500)

if exports['qb-management']:RemoveMoney('police', 200) then
    -- paid from the police fund
end

Frequently asked questions#

I did not get a paycheck.

Paychecks arrive every 30 minutes for everyone online at that moment, into the bank. Check that your job grade has a salary above 0 in qs-core/shared/jobs.lua (jobs created by ESX or QBCore scripts start at 0) and that Config.Paycheck.enabled is true.

A transfer says "That account does not exist".

The number is wrong, or the recipient has never opened a bank or ATM — account numbers are created on the first visit. Ask them to open one and send you the QS… number from their balance card.

Can I send money to someone who is offline?

Yes. Bank transfers to offline characters are added to their bank and waiting for them at their next login.

How do I give a player money as an admin?

/addmoney <id> <account> <amount>, for example /addmoney 3 bank 25000, or the Money action of the admin menu (F6).

How do I add a fee to bank transfers?

Set Config.TransferFee in qs-banking/config.lua, for example 0.02 for 2%. The sender pays it on top of the amount.

Can players pay at shops by card?

Yes. Set Config.PayAccount = 'bank' in qs-coreshops/config.lua and every shop charges the bank instead of cash.

Do ESX and QBCore scripts see the same money?

Yes for cash and bank: there is one wallet. xPlayer.getMoney(), xPlayer.getAccount('bank'), Player.Functions.GetMoney('cash') and exports['qs-core']:GetMoney() all read the same balances.

Money accounts#

Starting money#

Where money comes from and where it goes#

Money commands#

Money from your own scripts#

Paychecks#

Salaries by job and grade#

Banking#

Bank branches and ATMs#

Account numbers#

Deposit and withdraw#

Transfers#

Get the recipient's account number

Open a bank branch

Enter the number and the amount

Done

History#

Limits#

Banking configuration#

Events and callbacks for integrators#

Society and boss funds#

Frequently asked questions#

Money accounts#

Starting money#

Where money comes from and where it goes#

Money commands#

Money from your own scripts#

Paychecks#

Salaries by job and grade#

Banking#

Bank branches and ATMs#

Account numbers#

Deposit and withdraw#

Transfers#

Get the recipient's account number

Open a bank branch

Enter the number and the amount

Done

History#

Limits#

Banking configuration#

Events and callbacks for integrators#

Society and boss funds#

Frequently asked questions#

Money accounts#

Starting money#

Where money comes from and where it goes#

Money commands#

Money from your own scripts#

Paychecks#

Salaries by job and grade#

Banking#

Bank branches and ATMs#

Account numbers#

Deposit and withdraw#

Transfers#

Get the recipient's account number

Open a bank branch

Enter the number and the amount

Done

History#

Limits#

Banking configuration#

Events and callbacks for integrators#

Society and boss funds#

Frequently asked questions#

Money accounts#

Starting money#

Where money comes from and where it goes#

Money commands#

Money from your own scripts#

Paychecks#

Salaries by job and grade#

Banking#

Bank branches and ATMs#

Account numbers#

Deposit and withdraw#

Transfers#

Get the recipient's account number

Open a bank branch