Browse docs

Banking

Overview

Sky Banking lets players manage accounts, invoices, and ATM interactions directly inside your framework of choice. The script ships with framework-aware exports, optional billing integration, configurable blips, and reusable locale strings so you can align the UI with the rest of your server.


Configuration

Job Account Fallback

Sky job scripts use the shared banking bridge from sky_base for society/job account balances. If your banking resource handles society accounts differently, use sky_base internal job banking as the primary backend with Config.banking = "sky" or as a fallback with Config.useSkyBankingFallback = true.

Billing Options

  • Config.UseBilling: disables the invoice tab entirely when false.
  • Config.BillingSystem: pick the billing export used when generating invoices.
    • ESX values: esx_billing, okokbilling, loaf_billing.
    • QBCore values: g_billing.
  • Config.BillingMode: set to data when invoices stay inside the bank UI (esx_billing, loaf_billing, legacy okokbilling), or menu when the bank should close and the billing menu takes over (g_billing, new okokbilling).

Interaction Settings

  • Config.UseSounds: toggles teller/ATM audio feedback.
  • Config.UseATMs: disables world ATMs when false, leaving only staffed branches.

Map Data

  • Config.Blips.Bank: turn the bank blip on/off and customize name, sprite (108 by default), and color.
  • Config.Locations.Bank: add/remove bank coordinates; each entry is a simple {x, y, z} table.

Sample Config

config.lua
Locales = {} -- edit translation in config/locales
Config = {}

-- Documentation: https://docs.sky-systems.net/docs/scripts/banking
Config.UseBilling = true
Config.ESXCoreResource = "es_extended" -- ONLY ESX
Config.QBCoreResource = "qb-core" -- ONLY QBCore

-- Choose your billing system.
-- ESX values: 'esx_billing', 'okokbilling', 'loaf_billing'
-- QBCore values: 'g_billing'
Config.BillingSystem = 'okokbilling'

-- Choose how invoices open:
-- 'data' keeps players inside the bank UI
-- 'menu' closes the bank and opens the billing script UI
Config.BillingMode = 'menu'

Config.UseSounds = true
Config.UseATMs = true

Config.Blips = {
    Bank = {
        showBlip = true,
        blip = {
            name = "Bank",
            sprite = 108,
            color = 2
        },
    },
}

Config.Locations = {
    Bank = {
        {x = 150.266, y = -1040.203, z = 29.374},
        {x = -1212.98, y = -330.841, z = 37.787},
        {x = -2962.582, y = 482.627, z = 15.703},
        {x = -112.202, y = 6469.295, z = 31.626},
        {x = 314.187, y = -278.621, z = 54.17},
        {x = -351.534, y = -49.529, z = 49.042},
        {x = 241.727, y = 220.706, z = 106.286},
        {x = 1175.064, y = 2706.643, z = 38.094}
    },
}

Support

Need help? Our support team is always ready to assist

Join Discord