HZ Scripts

Bills

HZ-Banking has its own bills: a mechanic bills a repair, the police writes a fine, and the player pays from the bank. No other billing script needed. Bills are on by default (Config.Features).

Writing a bill

Stand next to the player and type /invoice. A form asks for:

  • Bill to — the players close enough (5 m).
  • Bill for — the job, the gang, or yourself, depending on what you're allowed.
  • Amount and Reason.
The player gets a notification right away. Who can bill:
  • Employees of every job that has a society account, from grade 0. Limit it with Jobs and MinGrade in config/billing.lua, for example Jobs = { 'police', 'ambulance', 'mechanic' }.
  • Gang members, for their gang (Gangs).
  • Players, to their own account, only with PlayerInvoices = true (off by default).
The money goes to the society or gang account, or to the player's personal account. With IssuerCommission, the employee who wrote a society bill gets a share.

Other scripts write bills with the CreateInvoice export.

Paying a bill

The Bills page of the bank app shows:

  • the total to pay, the number of unpaid and overdue bills;
  • each bill with who sent it, the reason, the author, the date and the time left, with Pay and Decline;
  • the history of past bills;
  • an Issued tab for players who can bill, to follow their bills and withdraw one while it is unpaid.
Bills are paid from the personal bank account.
  • Fines can't be declined — bills from the jobs of NoDecline (police and ambulance by default). Every other bill can be declined.
  • Withdrawing — the author, or the boss of the society or gang, can withdraw a bill while it is unpaid.

Due dates & late fees

  • A bill is due 7 real days after it is written.
  • Once overdue, a late fee of 10 % is added, once.
  • Then it is taken from the bank automatically as soon as the account covers it (AutoCollect). The account never goes below zero.
  • A player can't have more than 20 unpaid bills at once.
Both sides get notified: new bill, overdue, collected for the player; paid or declined for the author.

All keys: Configuration → Bills.

ESX job menus

On ESX, job menus send bills through esx_billing. HZ-Banking picks them up: a bill sent from a job menu becomes an HZ-Banking bill, paid to the society. Remove esx_billing from your server.cfg, see Replacing your banking script.