lation banking
lation banking is a bank for FiveM with personal, savings, shared, society and business accounts, bills between players and businesses, loans, ATMs and a register, set up in game and answering the exports of the bank it replaces.
lation banking (lation_banking) is a bank for FiveM servers: personal, savings, shared, society and business accounts, bills and requests, loans, ATMs and a register for the businesses you choose, all in one panel. It answers the exports and events of Renewed-Banking, qb-banking, qb-management and okokBanking, so the scripts you already run keep working after you swap banks, and it reads their society and shared balances on first start. There is no config file: every option lives in the database and is edited in game from /bankadmin.
Works on Qbox, QBCore and ESX. Gang accounts need Qbox or QBCore; ESX has no gangs.
Requirements
| Resource | Needed | What for |
|---|---|---|
ox_lib | Required | Callbacks, commands and points |
oxmysql | Required | The tables and the live configuration |
qbx_core, qb-core or es_extended | Required | Player money, jobs and gangs |
lation_interact, ox_target or qb-target | For branches, ATMs and registers | Every prompt in the world. lation interact is picked first when it runs. |
lation_ui | Optional | The bank follows your lation ui theme, and notifications use it |
esx_addonaccount | Optional, ESX only | While it runs, each society's balance stays in its society_<job> vault |
| An inventory | Optional, for the register | Product pictures and a usable register item. The menu builder lists ox_inventory's items, or the framework's. |
JG Dealerships (jg-dealerships) | Optional | Financed vehicles listed under a player's bills, with a Pay button |
fmsdk | Optional | Logging to Fivemanage |
Personal balances are your framework's own bank money. lation banking reads and moves them through the framework, or the character's row while the player is offline, and never keeps a second copy, so nothing drifts.
Install
Follow the install guide, then:
Keep the folder name lation_banking. A renamed folder prints an error on start and again every 15 minutes.
Remove the bank it replaces. Delete or rename its folder; leave its database tables, which are only read.
Remove Renewed-Banking, qb-banking or okokBanking, whichever you run. qb-management can stay: it holds no money.
Remove qb-banking, Renewed-Banking or okokBanking, whichever you run. qb-management can stay: it holds no money.
Remove only your bank UI, such as okokBanking or Renewed-Banking.
- Keep
esx_addonaccount: society balances stay in itssociety_<job>accounts, and lation banking is the bank over them. - Keep
esx_societytoo, when lation banking runs on its own. With lation jobs, removeesx_societyand set nothing: lation jobs stands in for it. Keepesx_datastorethen if a job uses a society garage.
Migrating says what each old bank leaves behind and which of its exports are answered.
Ensure it after your framework, ox_lib, oxmysql and your interaction system, and before anything that uses society money. If you run lation ui, it goes first, above ox_lib, because the lation ox_lib fork looks for it when ox_lib starts.
ensure lation_ui # optional
ensure ox_lib
ensure oxmysql
ensure qbx_core # your framework
ensure lation_interact # or ox_target / qb-target
ensure lation_banking
ensure [standalone] # shops, phones, boss menus, job scriptsensure lation_ui # optional
ensure ox_lib
ensure oxmysql
ensure qb-core # your framework
ensure lation_interact # or ox_target / qb-target
ensure lation_banking
ensure [standalone] # shops, phones, boss menus, job scriptsensure lation_ui # optional
ensure ox_lib
ensure oxmysql
ensure es_extended # your framework
ensure esx_addonaccount # before the bank, so society money stays in it
ensure lation_interact # or ox_target / qb-target
ensure lation_banking
ensure [standalone] # shops, phones, boss menus, job scriptsGive admins the panel. Add this to server.cfg:
add_ace group.admin lation_banking.admin allowRestart the server fully, not just the resource.
Delete or rename the old bank's folder; stopping it is not enough. While Renewed-Banking, qb-banking or okokBanking is still in your resources, the console warns about it two seconds after every start: two banks answering one name means two sets of books.
There is no SQL to import. The tables are created on start, and later versions add what they need on their own.
First start
On the first start lation banking creates its tables (lation_banking_players, lation_banking_accounts, lation_banking_members, lation_banking_transactions, lation_banking_bills, lation_banking_schedules, lation_banking_loans, lation_banking_config and lation_banking_pos_products), seeds every setting from its default, and opens a society account for every job the framework knows, and every gang on Qbox and QBCore. Each player gets an account number the first time the bank sees them.
Read the console. When one old bank still holds society or shared money, it is imported and the console prints imported N account(s) from <bank>. When it can't tell which old bank is the right one, it prints YOUR SOCIETY BALANCES WERE NOT IMPORTED and imports nothing. See how balances come across.
Run /bankadmin. Its dashboard lists any old bank still waiting with its totals: Import the one your server was using, or dismiss the card.
Under Config, list what nothing does by default: the societies that send bills (Bills > Businesses that bill) and the businesses that get a register (POS > Businesses). Branches, ATMs, savings and loans already work.
Walk up to a branch (eight are placed, each with a blip) and pick Open Bank, or use any ATM.
shared/defaults.lua only seeds the database on the very first start. Editing it on a server that has already started changes nothing; use /bankadmin > Config instead.
Language
English ships in locales/en.json. Pick a language with a replicated convar, so clients read it too; a file that doesn't exist falls back to English:
setr lation:locale "en"The locale files ship open, so you can edit the text or add a language.
Works with
- lation ui. While
lation_uiruns, the bank takes on its theme, each player's own included, and follows live edits. Without it the bank uses the same defaults. Notifications go through lation ui when it runs and throughox_libotherwise. - lation interact. The interaction setting
autopickslation_interactfirst, thenox_target, thenqb-target. - lation shops. lation shops can keep each shop's balance as a business account here: the owner sees it under Business accounts with a number, a PIN and a history, and customers can transfer to it. It is switched in lation shops; see Bank accounts.
- lation jobs. lation jobs keeps each job's money in its society account here, and needs lation banking 1.2.0 or newer for it. A job created in lation jobs gets its account at once, Open in bank in its boss menu opens the bank on that account, grades with money permissions are made members of it, and a register placed in lation jobs is listed under Config > POS, keeping the tax, tax account and menu setting you give it here. See the bank on the lation jobs overview.
Troubleshooting
No prompt at branches, ATMs or registers
The client console (F8) prints No supported interaction system was detected when none of lation_interact, ox_target or qb-target is running. Start one before lation_banking, or pick yours under Config > General > Interaction system.
The console says an old bank is still installed
<bank> is still installed alongside lation_banking means its folder is still in your resources. Delete or rename it, even if it isn't ensured, so every script reaches one bank.
Society balances are all zero after the switch
Look for the YOUR SOCIETY BALANCES WERE NOT IMPORTED banner in the console. It appears when more than one old bank holds money, or the bank already holds money of its own. Open /bankadmin and press Import on the old bank your server was really using. A job or gang account is filled only if that job or gang still exists in your framework.
A boss can't see the society account
On Qbox and QBCore a boss is a grade with isboss or bankAuth; on ESX, a job grade named boss. The rule is HasSocietyAccess in bridge/server.lua, which ships open. Check that Config > Accounts > Society accounts is on, and Gang accounts too for a gang.
A society on ESX keeps its balance in the bank
The console prints esx_addonaccount has no account for <job> and would not open one; the bank holds its balance when the vault refused to open society_<job>. That society's money stays with lation banking until the vault has the account and the server restarts. Ensure esx_addonaccount before lation_banking.
A society balance on ESX looks behind
A script that changes society_<job> in esx_addonaccount without an event, such as esx_society's money-wash payout, is caught within a minute, and before any payment from that account. The difference is written in the society's history. Payments are always checked against the vault's own balance.
An ATM says to set a PIN at a branch first
Config > ATMs > Ask for a PIN is on and the player has none. They set one at a branch from their profile, the picture at the bottom of the side rail.
/bill says you have nothing to bill from
Only the societies listed under Config > Bills > Businesses that bill send bills, and only while Config > Bills > Bills is on. With Requests off too, the card has nothing to send. List the society, or turn requests on.
The Bills page is called Requests, or is gone
Config > Bills > Bills is off. While it is, nothing billed shows or can be paid, and the register and ongoing payments are gone too; with Requests off as well, the page is gone. Turn it back on and everything still waiting returns. See switching bills off.
lation jobs says Banking opens no society accounts
Config > Accounts > Society accounts is off, so no job gets an account, and lation jobs has nowhere to keep its money. Turn it on, and Gang accounts too for gangs; the missing accounts open the moment you save.
/pos says you do not work anywhere with a register
Add the business under Config > POS > Businesses, and keep Bills on: every sale is a bill. See Register.
Fivemanage logs never arrive
fmsdk has to be started before lation_banking; it is looked for once, when the bank starts. Ensure it earlier and restart the bank.
Migrating
Switching from Renewed-Banking, qb-banking, qb-management or okokBanking.
Admin panel and commands
/bankadmin, the commands and who can use them.
Accounts
Personal, savings, shared, society and business accounts, transfers, ATMs and PINs.
Bills and requests
Society bills, business-to-business bills, player requests, repeating bills and ongoing payments.
Register
A point of sale for the businesses you list.
Loans
Borrowing, daily installments and defaults.
Configuration
Every option, its default and what it does.
Developers
Exports, events and the hooks you can edit.
Still stuck? Ask in our Discord: the people who write the scripts answer.
Last updated