Configuration

Enables verbose debug logging across server, client, and NUI consoles.

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

Whether to 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'.

Seconds a loaded account stays in the in-memory cache before re-fetch.

Cache TTL for a player's default personal account lookup.

How often expired cache entries are swept, in milliseconds.

When a player without a default account logs in, 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.

Lua pattern that account names must match. Shipped default allows alphanumerics, whitespace, dashes, underscores, and apostrophes.

Max serialized metadata size per account.

Owners can close their own accounts.

Owners can freeze their own accounts.

Framework group names treated as admin for banking actions.

Additional permission names recognized as admin.

ACE permission checked for admin actions.

Master toggle for multi-owner (shared) accounts.

Cache TTL for shared account membership lookups.

Admins bypass shared-account role checks.

Role assigned when inviting a new member without explicit role.

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

Inactivity timeout before the ATM session is killed.

Max distance (meters) from the ATM before the session is force-closed.

Heartbeat interval in milliseconds from client to server.

Allowed wrong-PIN attempts before lockout.

Lockout duration in seconds after exceeding pinAttempts.

Array of ATM prop definitions. Each entry: { model = `hash`, type = 'standalone' | 'wall' | 'maze_bank', brand? = 'maze' }. These determine which camera offset and 3D panel calibration apply.

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

Master toggle for 3D panels. If false, UI renders as a flat overlay.

Render debug spheres / wireframes for panel positioning.

Resource name that provides the 3D rendering.

DUI texture width.

DUI texture height.

Distance within which finger-IK interaction activates.

Panel update interval in milliseconds.

Distance beyond which the panel stops updating entirely.

IK finger-press configuration: enable flag, cursor hide, PED IK part / blend timings, per-axis screen-press response, per-ped height normalization (so taller peds / high heels don't misalign the hand). Values are tuned for mp_m_freemode_01.

Per-model panel calibration keyed by prop hash. Each entry defines screen / keypad dimensions, tilt, IK offsets, and the card-prop attachment pose. Shipped entries: prop_fleeca_atm, prop_atm_01, prop_atm_02. Recalibrate in-world using Config.NUI3D.debug = true.

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

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

Reject sequential PINs like 1234.

Reject PINs with all identical digits like 1111.

Seconds to lock out after exceeding maxAttempts.

Charged on ATM withdrawals.

Charged on transfers. sameBankFree waives the fee for intra-bank movement.

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.

Per-ATM-type player offset used to anchor the cinematic camera. Keys: wall, standalone, maze_bank.

Scripted camera parameters: camera name, rotation order, ease timings, clipping, motion blur, sensitivity, pitch clamp. Tuned for the stock ATM camera feel; edit only if you're replacing the camera behavior.

Enter / idle animation dicts, card prop (bone, pos, rot, duration), and frozen offset used when the card is stuck in the slot.

Dict/anim used for the ATM idle loop.

Animation played when dispensing cash.

Animation played when depositing cash.

Master volume multiplier for all ATM sounds.

Per-effect { file, volume, loop? } map. Shipped effects: atmAmbient, cardInsert, buttonPress, transactionSuccess, transactionFail, cashDispense, screenTransition, error, sessionTimeout.

One of 'none', 'basic', 'verbose', 'paranoid'. Controls how much detail is written to the security audit log.

Anti-exploit toggles. Distance checks are cheap and recommended; the others add overhead.

Flag thresholds for security events (not hard blocks).

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

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. Opening the bank triggers nx_realbanking:server:openBank.

Map of job name → { 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.

Commission taken from freelance invoices. See Config.Commission for separate society-invoice commission.

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

Whether freelance invoices can be addressed to offline players.

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

Minutes between sweeps that expire un-accepted personal invoices.

Adds an 'Invoice this player' option to the ox_target player menu.

VAT percentage.

Society account that receives collected VAT.

Display VAT as a separate line in invoice UI.

Commission clamped between minAmount and maxAmount.

Days before due date at which autopay attempts settlement.

Minutes between autopay sweeps.

Society account that accumulates unpaid debt.

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 let you 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. Edit carefully. Tier eligibility is driven by these numbers.

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

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.

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

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

When enabled, invoices become overdue after `days`.

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.

Optional 3D text prompt above bank peds.

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