Configuration — foltone_banking

All configuration is done in config.lua at the root of the script.

Language

Config.Locale = "fr" -- "fr" or "en"

Translations are in the locales/ folder. You can add your own language by creating a new file (e.g., locales/de.lua) and setting Config.Locale = "de".

Framework

Config.Framework = "esx" -- "esx", "qbcore" or "qbx"

Interaction Mode

Config.InteractionType = "drawtext" -- "marker", "ox_target", "qb-target", "qtarget", "drawtext"

IBAN & Account Settings

Config.IBANPrefix = "FB"
Config.DefaultPIN = "0000"
Config.StartingBalance = 0

ATM Configuration

Config.ATMs = {
    models = {"prop_atm_01", "prop_atm_02", "prop_atm_03", "prop_fleeca_atm"},
    features = {"deposit", "withdraw", "balance", "transfer", "history"},
    distance = 1.5,
    blip = false,
}

Note: Joint accounts, savings, and crypto are not available at ATMs (bank only).

Bank Configuration

Config.Banks = {
    ped = { model = "s_m_m_bankman_01", scenario = "WORLD_HUMAN_CLIPBOARD" },
    features = {"deposit", "withdraw", "balance", "transfer", "history", "card", "pin"},
    distance = 2.0,
    blip = { sprite = 108, color = 2, scale = 0.8, label = "Banque" },
    positions = {
        { pos = vector3(149.0, -1040.0, 29.4), heading = 336.0 },
        { pos = vector3(314.2, -278.7, 54.2), heading = 336.0 },
        { pos = vector3(-351.5, -49.5, 49.0), heading = 336.0 },
        { pos = vector3(-1212.9, -330.1, 37.8), heading = 336.0 },
        { pos = vector3(-2962.5, 482.6, 15.7), heading = 336.0 },
        { pos = vector3(1175.0, 2706.8, 38.1), heading = 336.0 },
    },
}

Card System

Config.CardSystem = {
    useItem = false,
    cardItem = "bank_card",
    reissuePrice = 500,
    pinChangePrice = 100,
}

Transfer Settings

Config.Transfer = {
    allowByServerId = true,
    allowByIBAN = true,
    offlineTransfer = true,
}

Transaction History

Config.History = {
    perPage = 50,
}

Theme

Config.theme = {}

The default theme is the Blue Edition (Cyber Street Design System). The theme table is empty by default, which applies the built-in blue color scheme. You can override specific CSS variables by adding key-value pairs to this table.

Note: The design system uses electric blue accents, dark panel backgrounds, and three font families (Bebas Neue, Rajdhani, JetBrains Mono). Do not use gold, orange, purple, or cyan colors.

Notifications

Config.Notification = function(message)
    SetNotificationTextEntry("STRING")
    AddTextComponentString(message)
    DrawNotification(false, false)
end

Replace this function with your preferred notification system (e.g., okokNotify, ox_lib, etc.). This is a client-side function.

Display Text

Config.DisplayText = function(text)
    SetTextComponentFormat("STRING")
    AddTextComponentString(text)
    DisplayHelpTextFromStringLabel(0, 0, 1, -1)
end

Customize the help text display shown when the player is near an interaction point (used with "drawtext" interaction mode).

Society / Job Account Settings

Config.Society = {
    defaultGrades = {"boss", "manager"},
    jobs = {
        -- Per-job override:
        -- ["police"] = { grades = {"boss", "lieutenant"} },
    },
    features = {"balance", "deposit", "withdraw", "transfer", "payroll", "history"},
    positions = {
        -- { job = "police", pos = vector3(440.0, -981.0, 30.7), heading = 0.0 },
    },
    distance = 2.0,
    ped = { model = "s_m_m_accountant_01", scenario = "WORLD_HUMAN_CLIPBOARD" },
    blip = false,
}

Features

Per-Job Grade Override

Config.Society.jobs = {
    ["police"] = { grades = {"boss", "lieutenant"} },
    ["ambulance"] = { grades = {"boss"} },
}

If a job is not listed in jobs, the defaultGrades list is used.

Credit Score

Config.CreditScore = {
    default = 500,
    min = 0,
    max = 1000,
    rewards = {
        deposit = 2,
        withdraw = -1,
        transfer_out = 1,
        transfer_in = 1,
        upgrade = 5,
    },
}

Reward Actions

Account Levels

Config.AccountLevels = {
    standard = {
        label = "Standard",
        interestRate = 0.5,
        interestCap = 5000,
        transferMax = 50000,
        taxReduction = 0,
    },
    premium = {
        label = "Premium",
        interestRate = 1.5,
        interestCap = 20000,
        transferMax = 200000,
        taxReduction = 25,
        upgradePrice = 50000,
        minCreditScore = 700,
    },
}

Standard Level

Premium Level

Interest System

Config.Interest = {
    interval = 60,
    resetPeriod = 1440,
}

Interest is only calculated for online players. The actual rate is modulated by the player’s credit score and capped by their account level.

Progressive Taxation

Config.Tax = {
    deposit = {
        { from = 0, to = 10000, rate = 0 },
        { from = 10000, to = 50000, rate = 2 },
        { from = 50000, to = 0, rate = 5 },
    },
    withdraw = {
        { from = 0, to = 10000, rate = 0 },
        { from = 10000, to = 50000, rate = 1 },
        { from = 50000, to = 0, rate = 3 },
    },
    transfer = {
        { from = 0, to = 10000, rate = 0 },
        { from = 10000, to = 50000, rate = 1.5 },
        { from = 50000, to = 0, rate = 4 },
    },
}

Each operation type (deposit, withdraw, transfer) has its own set of tax brackets.

How Brackets Work

Tax is calculated progressively across brackets. For example, a $30,000 deposit with the default config:

• $0 to $10,000: 0% tax = $0
• $10,000 to $30,000: 2% tax = $400
• Total tax: $400

Important: Brackets must be contiguous and ordered. Society operations, joint accounts, savings, and crypto are exempt from taxation. Premium accounts receive a 25% tax reduction.

Joint Account Settings

Config.JointAccount = {
    enabled = true,
    maxMembers = 4,
    maxAccountsPerPlayer = 2,
    transferMax = 50000,
    features = {"deposit", "withdraw", "transfer", "history"},
}

Joint accounts are only accessible at banks (not ATMs). They are exempt from taxation, interest, and credit score changes.

Phone Notifications

Config.PhoneNotifications = {
    enabled = true,
    resource = "lb_phone",
    events = {
        transfer_received = true,
        society_payroll_received = true,
        interest_credited = true,
        joint_deposit = true,
        joint_withdraw = true,
        joint_transfer = true,
        joint_member_added = true,
        joint_member_left = true,
    },
    appTitle = "Fleeca Bank",
    appIcon = "bank",
}

Notification Events

Phone notifications are only sent to online players.

Discord Webhook

Config.Webhook = {
    enabled = true,
    url = "",
    botName = "Fleeca Bank",
    color = 3899126,
}

All banking operations (personal, society, joint, savings, crypto) are logged to the webhook. The webhook uses a fire-and-forget approach.

Savings Account

Config.Savings = {
    enabled = true,
    interestRate = 3.0,
    interestCap = 50000,
    maxWithdrawalsPerDay = 1,
    minLockAmount = 1000,
    locks = {
        { days = 3,  rate = 2.0,  label = "3 jours"  },
        { days = 7,  rate = 5.0,  label = "7 jours"  },
        { days = 14, rate = 12.0, label = "14 jours" },
        { days = 30, rate = 30.0, label = "30 jours" },
    },
}

Fixed-Term Lock Options

Savings accounts have a separate interest cron from the main checking account. Interest is online-only with a configurable cap.

Crypto Trading

Config.Crypto = {
    enabled = true,
    apiSource = "binance",
    refreshInterval = 5,
    coins = {
        { id = "bitcoin",  symbol = "BTC", label = "Bitcoin"  },
        { id = "ethereum", symbol = "ETH", label = "Ethereum" },
        { id = "litecoin", symbol = "LTC", label = "Litecoin" },
    },
    currency = "usd",
    minTradeAmount = 100,
    historyPerPage = 50,
}

Coin Configuration

Prices are fetched server-side via sv_crypto_prices.lua and broadcast to all connected clients. The server maintains a cache to minimize API calls. Crypto operations are exempt from taxation.