Installation

1. Prerequisites

Optional: ox_inventory, ox_target or qb-target, phone resource (collections), Discord bot token (statement export).

2. Download and place the resource

1. Copy the finals_banking folder into your server resources tree (for example resources/[finals]/finals_banking).
2. Do not rename the folder unless you also change every ensure and any exports that reference finals_banking.

3. Database (Don't do untill any error because script handle itself)

Run the files that match your stack. Use HeidiSQL, phpMyAdmin, or the MySQL CLI. Back up your database first.

If a file fails because a table already exists, read the error: you may have partially installed already—resolve duplicates carefully or restore from backup.

{% content-ref url="sql-and-job" %} sql-and-job {% endcontent-ref %}

4. Configuration (before first start)

1. Open shared/config.lua.
2. Set Config.Framework to 'ox', 'qb', 'qbx', 'esx_legacy', 'esx_finals_v1', or 'auto' (recommended only when you know detection order).
3. Set Config.Banks (and blips, interaction mode, ATMs) to match your server.
4. If you use loans / banker tablet features, edit shared/banker_config.lua.

5. server.cfg load order

Start dependencies before this resource. Example pattern:

ensure ox_lib
ensure oxmysql
# ensure ox_core   OR   ensure qb-core / qbx_core   OR   ensure es_extended
# ensure ox_inventory
ensure finals_banking

Add ox_core, qb-core / qbx_core, or es_extended as your server uses. Add ox_inventory if you rely on cash items and debit cards.

6. Add these items

Names must match your config: the debit card item key (e.g. bankcard_fleeca) must match Config.DebitCard.item in shared/config.lua. The loan agreement item key must match BankerConfig.LoanAgreementItem in shared/banker_config.lua if you use that feature (adjust the first block if your config uses a different name than loan_agreement).

['loan_agreement'] = {
    label = 'Loan agreement',
    weight = 50,
    stack = false,
    close = true,
    consume = 0,
    client = { export = 'finals_banking.useLoanAgreementItem' },
},

['banker_tablet'] = {
    label = 'Banker Tablet',
    weight = 800,
    stack = false,
    close = true,
    consume = 0,
    client = { export = 'finals_banking.useBankerTablet' },
},

['bankcard_fleeca'] = {
    label = 'Bankcard Fleeca',
    weight = 100,
    stack = false,
    close = true,
    consume = 0,
    description = '',
    client = {
        image = 'bankcard_fleeca.png',
        export = 'finals_banking.useDebitCardItem',
    },
},

7. First start checklist

• SQL executed with no blocking errors
• Config.Framework and bank locations set
• ensure order in server.cfg correct
• Restart the server or ensure finals_banking and test at a branch

Key Features Summary

• Full banking system (accounts, ATM, cards)
• Advanced loan system with RP mechanics
• Credit score system
• Debt collection gameplay
• Society/company banking
• Phone + billing integration

Notes

• Always backup database before migration.
• Configure items in ox_inventory & qb-inventory.
• Ensure correct framework detection.
• Tune economy values carefully for RP balance.