HZ-Banking

What is HZ-Banking?

HZ-Banking is a complete banking script for FiveM. It puts a counter and a banker in every bank of the map, opens a bank app styled after each bank's own website, and turns every ATM into a working machine: the bank screen shows on the ATM itself, the card goes in and the PIN is typed on the keypad.

It covers what a roleplay server expects from its bank: personal, society, gang and shared accounts, transfers by IBAN, scheduled transfers, bank cards, savings with interest, loans by credit score and bills. And it replaces qb-banking, Renewed-Banking, esx_banking and okokBanking without breaking the scripts that use them.

Runs on ESX, QBCore and Qbox through hz_lib.

Why the bank matters on an RP server

Every job, shop and paycheck on a roleplay server ends up at the bank. Yet most banking scripts open a flat menu next to a blip, and the ATM is the same menu with another title. Players never feel they went to the bank.

HZ-Banking makes it a place. The banker looks up when you walk in, greets you and asks what they can do for you. At the ATM, your character slides their card in and types the PIN with their own hand, and the notes come out of the slot. Fines come with a due date, loans with a credit score, and money left on savings grows.

Behind it, the server checks everything: distance to the counter or ATM, card, PIN, access rights and amounts. The personal balance stays your framework's bank money, so every script sees the same number.

Features in detail

A bank app for each bank

The app looks like the bank's own website: Fleeca, Maze Bank, Pacific Standard, Blaine County or Union Depository, with its logo, colours and card, in dark or light mode. It opens on an animated sign-in, then: an overview with a 7-day chart, transactions with search and filters, transfers by IBAN with saved recipients, scheduled transfers (once, daily, weekly or monthly), cards, savings, loans, bills, a custom IBAN and the PIN. English and French ship; another language takes one JSON file.

Bankers who talk

Each of the 8 banks has a named banker. They follow players with their eyes, greet them, answer every operation (deposit, withdrawal, transfer, new card, loan granted or refused, not enough money) and say goodbye, with male and female voices in English or French. Talking to one opens a dialogue box with choices that open the app on the right page: the account, the cards or a loan.

ATMs with their own screen

On the four ATM models of the game, the bank screen shows on the machine itself: Maze Bank on the street ATMs, Fleeca on the Fleeca ATMs. The character faces the ATM, inserts their card, and their hand follows the mouse over the keypad. Withdraw, deposit or check the last transactions: the notes come out of the slot, deposits are taken in, and every key beeps.

Bank cards and PIN

Each card is a bank_card item from the bank that issued it, with its last four digits and its expiry. Players can hold several, freeze or cancel each one, and the first card is free. Cards expire after 90 days by default, and three wrong PINs lock the card for 5 minutes. The card can also be made optional, PIN only.

Society, gang and shared accounts

Every job gets a society account and every gang its own, with grade rules, the Qbox bank access setting, and ESX society money kept in esx_addonaccount. Players open shared accounts, add members by IBAN or citizen ID, and close them with the balance paid back to the owner.

Savings and loans

Savings earn interest on the lowest balance of each period, so quick deposits can't farm interest. Loans follow a credit score from 300 to 850, with four tiers up to 200,000, plans of 4, 8 or 12 payments taken automatically, late fees, savings used as a backup, and default with a server event for your debt collection scripts. Both are on by default and each one can be turned off.

Bills

Jobs and gangs bill nearby players with /invoice. Police and EMS fines can't be declined. Bills are due in 7 days, then get a 10 % late fee and are collected from the bank automatically. ESX job menus that send bills through esx_billing keep working.

Replaces your bank

HZ-Banking answers the exports of qb-banking, Renewed-Banking, esx_banking and okokBanking, and imports their accounts with hz_banking_migrate, dry run first. Robberies from qb-bankrobbery and qbx_bankrobbery close the bank while they run.

Compatibility

• ESX, QBCore and Qbox, through hz_lib. Servers without a framework are not supported.
• Requires hz_lib (free), ox_lib, oxmysql and OneSync.
• Works with ox_inventory and qb-inventory. ox_inventory and ESX need the bank_card item added: the definitions are included.
• Works with ox_target, qb-target and HZ-TextUi, or hz_lib's [E] prompt.
• Replaces qb-banking, Renewed-Banking, esx_banking and okokBanking: remove the old bank first.

Installation

1. Remove your old banking resource from your server.cfg.
2. Drop hz_banking into your resources folder and add the bank_card item to your inventory.
3. Add ensure hz_banking after your framework, inventory, target and hz_lib, then restart the server.

To bring your accounts over, run hz_banking_migrate, then hz_banking_migrate apply, in the server console. After an update, restart the whole server rather than hz_banking alone. Full guide in the documentation.

Performance

Away from banks and ATMs, HZ-Banking only checks distances about once a second, and bankers only appear when players come within 60 m. The work happens near a counter or an ATM and while the app is open. Every operation is checked by the server, with per-player request limits.