Configuration

Active locale, applied to both the ATM and the bank app. Shipped values: 'en', 'fi', 'de', 'fr', 'pt-br', 'es', 'tr', 'nl', 'it', 'pl'.

Use a targeting system (ox_target / qb-target) for ATM and bank-ped interactions. If false, falls back to proximity prompts.

Target resource name. One of 'ox_target', 'qb-target', 'qtarget'.

Inactivity timeout before the ATM session is killed.

Allowed wrong-PIN attempts before lockout.

Lockout duration in seconds after exceeding pinAttempts.

When a player without a default account uses an ATM, create one automatically.

Type assigned to the auto-created default account.

Display name assigned to the auto-created default account.

If true, mirror the framework's bank balance onto the linked personal account on login.

Minimum allowed length for an account name.

Maximum allowed length for an account name.

Owners can close their own accounts.

Owners can freeze their own accounts.

Framework group names treated as bank admins.

Additional QBCore permissions recognized as bank admins.

ACE permission checked for admin actions.

Master toggle for multi-owner (shared) accounts.

Allow personal accounts to be shared with other players.

Allow business accounts to be shared.

Allow savings accounts to be shared.

Allow the framework-linked personal account to be shared.

Cache TTL for shared account membership lookups.

Admins bypass shared-account role checks.

Role assigned when inviting a new member without an explicit role.

Role to permission map. Shipped with owner, manager, teller, viewer. Each role sets boolean flags: view, withdraw, deposit, transfer, manage_members, edit_limits, freeze, close.

When true, deposit and withdraw flows write the cash item directly through ox_inventory instead of calling the framework's AddMoney / RemoveMoney. Use this if your server renamed the cash item and the framework's auto-sync no longer fires.

ox_inventory item name that represents cash. Common values: 'money', 'cash'. Only used when useOxInventoryForCash is true.

Fee charged when the user changes their PIN. First creation is free.

Fee charged for a PIN reset (no old PIN required).

Whether players may set a run of consecutive digits such as 1234 or 4321. Off means those PINs are refused.

Whether players may set the same digit four times, such as 1111. Off means those PINs are refused. PINs are always 4 digits; attempts and lockout are set under Config.Session.

Charged on ATM withdrawals, on top of the amount requested: the player receives what they asked for and the account loses amount + fee. Ships disabled so updating does not change your economy.

Charged on transfers. sameBankFree waives the fee for transfers between accounts of the same player.

Taken out of the deposit: the player hands over the amount and the account is credited amount - fee. Ships disabled.

Per-account-tier limits: default, premium, business, savings. Each entry: { dailyWithdrawal, dailyDeposit, dailyTransfer, transactionMax, transactionMin }. Shipped defaults use a deliberately permissive ceiling. Tighten these for your economy.

Scales the whole ATM sound mix (0.0 to 1.0). 0.5 is the shipped level, 0.0 mutes the ATM.

One of 'none', 'basic', 'verbose', 'paranoid'. Controls how much detail is written to the security audit log. The bank app's Security Center reads from these logs, so 'basic' is the minimum if you want session and PIN events to appear there. Set to 'none' to silence all security logs.

Anti-exploit toggles. Distance checks are cheap and recommended. The movement checks are heuristics and ship off, because an admin teleport menu or a vehicle launcher will trip them. injectionDetection refuses malformed payloads from a client.

Heuristic thresholds for flagging suspicious activity. These flag, they do not hard-block.

Array of ATM prop definitions. Each entry: { model = `hash`, type = 'standalone' | 'wall' | 'maze_bank' }. Shipped models: prop_atm_01, prop_atm_02, prop_fleeca_atm, v_5_b_atm1, v_5_b_atm2.

Global toggle for ATM blips. Per-location visibility is still controlled by Config.ATMLocations[i].blip.

ATM marker / blip definitions at fixed coordinates. Each entry: { coords = vector3, name = string, blip = boolean }.

Array of in-world bank-access points. Each entry: { coords = vector3, heading, type = 'fleeca' | 'pacific' | 'blaine' | 'maze', label, blip, ped }. Peds spawn with the given model and scenario. Targeting a banker triggers nx_realbanking:server:openBank.

Options surfaced when a player targets a bank ped or counter.

Marker placed at bank locations. Fields: enabled, type, color {r,g,b,a}, size, bobUpAndDown, faceCamera, rotate. Disabled by default in favor of target-based interaction.

Maximum distance at which markers and 3D text are drawn.

Optional 3D text prompt above bank peds.

Proximity keypress, used only when Config.UseTarget is false. If you turn targeting off, leave this on or players cannot reach the bank peds.

Map of job name to { label, account, canBill, canInspect, finePresets, requireReason }. Shipped jobs: police, sheriff, ambulance, mechanic, taxi, realestate, cardealer. Each finePresets is an array of { label, amount } quick-fill options surfaced in the invoice UI.

Master toggle for freelance (player-to-player) invoicing.

Maximum amount for a single freelance invoice.

Minimum amount for a single freelance invoice.

Reject freelance invoices without a description.

Anti-spam cooldown between invoices issued by the same player.

Whether freelance invoices can be addressed to offline players.

Enable player-to-player personal invoices.

Enable job-issued society invoices.

Allow a player to send an invoice to themselves.

Personal invoices require the receiver to accept before they can be paid.

Minutes between sweeps that expire un-accepted personal invoices.

Restrict invoice creation to currently online recipients.

Adds a billing option to the target menu for every player in the world. Off by default. The bank app's Send Invoice tab works either way.

Hard cap on simultaneously pending invoices per player, split by direction.

Maximum amount a single invoice may carry.

Minimum amount a single invoice may carry.

Per-player daily cap on invoice count and total amount issued.

When enabled, invoices become overdue after `days`.

Apply VAT on top of invoice amounts.

VAT percentage.

Society account that receives collected VAT.

Apply VAT to society-issued invoices.

Apply VAT to freelance-issued invoices.

Display VAT as a separate line in the invoice UI.

Commission on society invoices, clamped between minAmount and maxAmount.

Commission on freelance invoices. Disabled by default.

Auto-debit invoices that pass their due date.

Days after the due date at which autopay attempts settlement.

Minutes between autopay sweeps.

Notify the player before autopay runs against them.

Behavior when autopay cannot collect funds.

Master toggle. If false, all credit-card exports return CREDIT_DISABLED.

ox_inventory item name that represents a credit card, and whether to give the physical item on approval.

Billing cycle knobs: inGameDayMinutes, cycleDays, dueDays, checkIntervalSeconds, interestIntervalDays, minimumPaymentPercent, minimumPaymentFlat. In-game days compress real-world billing windows into a gameplay-friendly pace.

Credit score model: min/max bounds, base score, stable-job bonus, bank-balance thresholds, account-age bonus, payment bonuses and penalties, usage bonus, and a usage-bonus cap (cardUsageBonusCap). These numbers drive tier eligibility.

Late fees and collections behavior. autoSeizeEnabled will seize funds from linked accounts when debt exceeds collectionsThreshold.

Hard limits on cards per player and the maximum value of a single charge.

ATM cash-advance flow: enabled, autoFallbackOnInsufficient, requirePhysicalCard, merchant label, transactionType identifier.

Tier definitions keyed by tier id. Shipped: standard, gold, black. Each: label, creditLimit, interestRate, graceInterestRate, graceDays, minimumScore, requiresStableJob, whitelistedJobs. The black tier whitelists specific jobs.

Order used when auto-assigning a tier from score. Highest eligible tier wins.

Master switch for all Discord logging.

Used by any enabled category that has no webhook of its own. Leave this and every category webhook empty and nothing is sent.

Name shown on the messages. The category is appended, so a security message posts as 'NX Banking - Security'.

Optional avatar image URL for the messages.

Role id pinged on critical events only. Empty means never ping. Everything else posts with notifications suppressed so a busy channel does not spam your staff.

How long an event may wait to be grouped with others. Lower feels more live, higher is quieter. Critical events ignore this and send immediately.

Backlog limit per channel. If Discord cannot keep up, the oldest events are dropped and the next message reports how many were lost.

One entry per category: transactions, security, invoices, credit, accounts, admin. Each takes enabled, webhook, label, mode and minSeverity. transactions also takes minAmount to ignore small movements.

Citizen ids are always shortened in the message. These two opt in to also recording the player's IP address and full identifier list. An IP counts as personal data in most jurisdictions.