FAQ
Can I configure it for my server?
Yes. The five files of config/ and locales/ are open, not encrypted: language and currency, cards and PIN, fees and prices, savings, loans, bills, society, gang and shared accounts, banks, bankers and their voices, blips, ATMs, target, sounds and commands. With hz_lib, 48 of these settings also change in game from /hzpanel, live, with no restart. Every setting is on the Configuration page.
Does it work with ESX, QBCore and Qbox?
Yes, through hz_lib. Servers without a framework are not supported: the personal balance is your framework's bank money.
Do I need hz_lib?
Yes. hz_lib is free and handles the framework, inventory, target, notifications, the banker's dialogue box and your theme fonts. Start it before HZ-Banking. See Installation.
Will my other scripts still pay into the bank?
Yes. HZ-Banking answers the exports of qb-banking, Renewed-Banking, esx_banking and okokBanking, so jobs, shops and boss menus written for them keep working. See Replacing your banking script.
Can I keep my old accounts?
Yes. hz_banking_migrate imports society, gang and shared accounts, IBANs, PINs and history from okokBanking, Renewed-Banking, qb-banking and esx_banking. Personal balances don't need it: they stay in your framework. See Importing your accounts.
Players don't get a card, or ATMs refuse them.
The bank_card item is missing from your inventory. ox_inventory and ESX don't have it by default: add it as shown in Installation, then restart the server. The server console warns about it in red at start.
Can ATMs work without a card?
Yes. Set Config.RequireCreditCardForATM = false (or untick it in /hzpanel): ATMs then ask for the PIN only.
Which ATMs work?
Every ATM of the map: the three Maze Bank models and the Fleeca ATM, with the bank screen on the machine itself. You can add other models to Config.AtmModels (they open full screen), or limit ATMs to a list of positions with Config.AtmPositions.
Can I turn off savings, loans or bills?
Yes, each one on its own, with Config.Features or in /hzpanel. The page leaves the menu and nothing is deleted. See Savings & loans.
Can I add a bank or move a banker?
Yes, in Config.Banks. See Adding or moving a bank.
Can bankers speak French?
Yes. Voices exist in English and French: set Config.StaffVoice.language = 'fr', or 'auto' to follow Config.Locale. Config.StaffVoice.enabled = false silences them.
Can I translate the app?
Yes. English and French ship. Copy locales/en.json to a new file, translate it and set Config.Locale. No rebuild needed. See Configuration.
Does it work with ox_target, qb-target or HZ-TextUi?
Yes. The eye goes on bankers and ATMs with ox_target or qb-target; with HZ-TextUi, its pins show when players come near. Without any of them, hz_lib shows an [E] prompt.
A transfer says "The recipient is not in town".
On ESX and Qbox, the framework can't credit the bank of an offline player, so the transfer is refused instead of losing the money. Try again when the player is in town. On QBCore, transfers to offline players go through.
Do bank robberies close the bank?
Yes, with qb-bankrobbery and qbx_bankrobbery out of the box, and any robbery script that sends the same event. See Closed during a robbery.
Is there a Discord log?
Yes. Set the hz_banking_webhook convar: deposits, withdrawals, transfers, /givecash, loans and shared account closures are logged.
How do I update?
Replace the files, keep your config/ and locales/ changes, keep hz_lib up to date, and restart the whole server rather than restarting hz_banking alone.
Is it heavy?
No. Away from banks and ATMs it only checks distances about once a second. The work happens near a counter or an ATM, and while the app is open.