Configuration

Active locale. Shipped values: 'en', 'fi'.

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.

Render the ATM UI on the physical screen and keypad in the world via nx-3d. Set to false for a traditional fullscreen NUI.

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).

Minimum PIN length.

Maximum PIN length.

Reject sequential PINs like 1234 or 4321.

Reject PINs with all identical digits like 1111.

Failed-attempt threshold before lockout.

Seconds to lock out after exceeding maxAttempts.

Charged on ATM withdrawals.

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

Charged on deposits. Disabled by default.

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

Master volume multiplier for ATM sound effects (0.0 to 1.0).

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 others add overhead.

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.

Fallback keybind prompt if the targeting system is not in use.

Map of job name to { label, account, canFine, 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.

Commission taken from freelance invoices. Society-invoice commission is configured separately under Config.Commission.

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 an 'Invoice this player' option to the ox_target player menu.

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.

Society account that accumulates unpaid debt.

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.