G.A.S. National Bank
A complete banking system — personal, savings and business accounts with role-based signers, debit cards, loans, recurring transfers and an immutable ledger. Drop-in replacement for Renewed-Banking, qb-management and esx_society.
G.A.S. National Bank — a complete banking system for FiveM Qbox / QBCore servers. Personal, savings, and business accounts with role-based signers, debit cards, payroll, loans, and an immutable ledger. Drop-in replacement for Renewed-Banking, qb-management, and esx_society (it provides those export namespaces).
Part of the Gas Team Developers script library.
Features
- Three account types — personal, savings, and business, with per-citizen ownership limits.
- Role-based business accounts — owner / manager / signer permissions, auto-seeded from your
qbx_corejobs and gangs. - Debit cards as ox_inventory items — daily limits, ATM withdrawal caps, per-card spend tracking.
- ATMs — works on stock GTA props (
prop_atm_01/02/03,prop_fleeca_atm) with configurable fees and daily limits. - Bank branches — eight Fleeca + Pacific Standard locations preconfigured, no peds required (proximity textUI).
- Loans — request, approve, auto-debit recurring payments at a configurable rate.
- Recurring transfers + savings interest — pay cycle is configurable (default 60 min).
- Ledger — every transaction logged with memo support; per-account ledger view in the NUI.
- Drop-in compat — exposes
Renewed-Banking,qb-management, andesx_societyexports so existing resources (qbx_vehicleshop,qbx_police,qbx_ambulancejob, paycheck systems) keep working with zero edits. - Migration — on first boot, optionally imports your existing
bank_accounts_new+player_transactionsfrom Renewed-Banking.
Requirements
- Framework: Qbox (
qbx_core) - Dependencies:
ox_lib,ox_target,oxmysql - Inventory:
ox_inventory(for thedebit_carditem) - Server artifact:
ceruleanor newer, Lua 5.4
Installation
See INSTALL.md for step-by-step setup.
Quick version:
- Drop the folder in
resources/[custom]/rr-bank - Add
debit_carditem to yourox_inventoryitems ensure rr-bankin yourserver.cfg- (Optional) Set
Config.MigrateLegacyData = trueto import existing Renewed-Banking data
Configuration
All knobs live in config.lua. The most-used settings:
| Setting | Default | What it does |
|---|---|---|
Config.PayCycleMinutes | 60 | How often savings interest, recurring transfers, and loan auto-debits run |
Config.SavingsInterestRate | 0.5% | Interest applied to savings each pay cycle |
Config.LoanInterestRate | 2.5% | Interest on loan principal each pay cycle |
Config.LoanPaymentRatio | 5% | Auto-debit percentage of remaining loan principal each pay cycle |
Config.LoanMaxAmount | $50,000 | Max loan size |
Config.MaxTransferAmount | $10,000,000 | Single-transaction transfer ceiling |
Config.RequireMemoOver | $100,000 | Transfers above this require a memo |
Config.ATMDailyLimit | $25,000 | Per-card daily ATM withdrawal limit |
Config.CardDefaultLimit | $25,000 | Default daily spend limit on new debit cards |
Config.MaxBusinessPerOwner | 5 | How many business accounts a single citizen can own |
Config.AutoSeedJobs | true | Auto-create society accounts for every qbx job on boot |
Config.AutoSeedGangs | true | Auto-create society accounts for every qbx gang on boot |
Config.MigrateLegacyData | true | Import Renewed-Banking data on first boot, then mark migrated |
Drop-in compatibility
rr-bank registers the following export namespaces, so resources written against the legacy systems work without edits:
Renewed-Banking—getAccountMoney,addAccountMoney,removeAccountMoney, etc.qb-management—GetAccount,AddMoney,RemoveMoneyesx_society— society account read/write
If you currently ensure Renewed-Banking, just stop ensuring it and ensure rr-bank instead. Your qbx_vehicleshop, qbx_police, paycheck flows, etc. should continue to function.
License
MIT © 2026 Real Results / G.A.S. Team Developers. See LICENSE.
Support
- Website: gasteamdevelopers.com
- Issues: open one in this repo.