Banks & bankers

The eight banks

HZ-Banking opens a counter in every bank of the map, each with its own banker:

Bank	Where	Banker
Fleeca	Legion Square	Martin Kessler
Fleeca	Rockford Hills, Boulevard Del Perro	Linda Park
Fleeca	Great Ocean Highway	Dale Whitaker
Fleeca	Route 68, Harmony	Brenda Cole
Blaine County	Paleto Bay	Peggy Lund
Fleeca	Hawick Avenue, Alta	Victor Reyes
Fleeca	Hawick Avenue, Burton	Grace Holloway
Pacific Standard	Vinewood	Howard Sterling

Each bank uses the brand of its building in GTA V. The brand gives the bank app its logo, colours, web address and bank card. Maze Bank and Union Depository are there too, for the banks you add.

Every bank has a blip in the colour of its brand. Bankers appear when players come within 60 m.

Bankers who talk

Bankers are not statues behind the counter:

They follow the player with their eyes when they come close, and greet them as they walk up (once every 5 minutes per bank).
They answer each operation: a deposit, a withdrawal, a transfer, a new card, a new PIN, a loan granted or refused, not enough money on the account, or a simple "All set."
They say goodbye when the app closes, and send players away when the bank is closed during a robbery.

Each banker has a male or female voice to match their model. Voices are in English by default, French as an option (Config.StaffVoice.language). Only the player at the counter hears them. ATMs don't talk.

Talking to the banker

Using a counter opens a dialogue box with the banker's name and bank. Their line is voiced and written, and the camera frames them. Then the player picks:

Choice	What happens
Open my account	The bank app opens on the Overview page.
I need a bank card	The bank app opens on the Cards page.
About a loan	The bank app opens on the Loans page. Hidden when loans are off.
Never mind	The banker says goodbye.

Escape closes the box, and the banker says goodbye.

The text follows the language of the app (Config.Locale), the voice its own language, like subtitles in GTA V.

To skip the dialogue and open the app at once, set Config.Dialogue.enabled = false. With an older hz_lib that has no dialogue box, the app also opens at once.

Prompt, target or pins

HZ-Banking uses what your server runs, through hz_lib:

ox_target or qb-target — the eye goes on the banker and their counter, and on every ATM.
HZ-TextUi — its pins show above each banker and on each ATM when players come near, with no key to hold.
Neither — hz_lib's [E] prompt.

Players can't use the bank while dead or in a vehicle. If they die or get in a vehicle with the app open, it closes.

Settings: Target, sounds & HUD.

Adding or moving a bank

Banks live in Config.Banks (config/locations.lua):

{ -- Mission Row
    coords = vec3(0.0, 0.0, 0.0), brand = 'maze',
    ped = { model = 'a_f_m_business_02', coords = vec4(0.0, 0.0, 0.0, 0.0), name = 'Jane Doe' },
},

coords is where the player stands in front of the banker, not the banker's position. The server checks players against this point.
ped.coords is the banker, with their heading.
The server warns in the console at start when a counter is more than 3 m from its banker.

All fields: Configuration → Banks.

Closed during a robbery

When qb-bankrobbery or qbx_bankrobbery starts a robbery, the bank closes: no new customer, open sessions at that counter end, and the banker sends players away. It reopens when the robbery ends, or after 30 minutes at the latest. ATMs stay open.

Any robbery script can do the same by sending this server-side event:

TriggerEvent('qb-banking:server:SetBankClosed', bankId, true)  -- false reopens it

Config.RobberyBanks matches the robbery script's bank ids to the banks of Config.Banks. A server restart reopens every bank.