Configuration — foltone_banking

Toute la configuration se fait dans le fichier config.lua a la racine du script.

Langue

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

Les traductions sont dans le dossier locales/. Vous pouvez ajouter vos propres langues en creant un nouveau fichier (ex: locales/de.lua).

Framework

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

Mode d’interaction

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

IBAN et Compte

Config.IBANPrefix = "FB"          -- prefixe pour les IBAN generes
Config.DefaultPIN = "0000"        -- PIN par defaut des nouveaux comptes
Config.StartingBalance = 0        -- solde initial des nouveaux comptes

ATM

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,
}

Les comptes joints, l’epargne et la crypto ne sont pas accessibles depuis les ATM, uniquement depuis les banques.

Banques

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 },
    },
}

Ajouter une nouvelle banque

Ajoutez une entree dans le tableau positions :

{ pos = vector3(x, y, z), heading = 0.0 },

Le PED banquier sera automatiquement cree a chaque position configuree.

Cartes bancaires

Config.CardSystem = {
    useItem = false,          -- true = carte comme item ox_inventory
    cardItem = "bank_card",   -- nom de l'item dans ox_inventory
    reissuePrice = 500,       -- prix de reedition de carte
    pinChangePrice = 100,     -- prix de changement de PIN
}

Virements

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

Historique

Config.History = {
    perPage = 50,
}

Theme

Config.theme = {}

Le theme par defaut est le Blue Edition (bleu electrique sur fond sombre). La table theme permet de surcharger les variables CSS si necessaire. En laissant la table vide {}, le theme par defaut est applique.

Attention : Le design system impose des regles strictes. N’utilisez jamais de noir pur, de blanc, de dore/orange ou de violet/cyan.

Notifications

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

Remplacez cette fonction par votre systeme de notification prefere (ex: okokNotify, ox_lib notify, etc.).

Texte d’aide

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

Personnalisez l’affichage du texte d’aide (affiche quand un joueur est pres d’un PED ou d’un ATM).

Societes

Config.Society = {
    defaultGrades = {"boss", "manager"},
    jobs = {
        -- Override par job : ["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 },
        -- { job = "ambulance", pos = vector3(311.0, -592.0, 43.3), heading = 0.0 },
    },
    distance = 2.0,
    ped = { model = "s_m_m_accountant_01", scenario = "WORLD_HUMAN_CLIPBOARD" },
    blip = false,
}

Ajouter un PED societe

Ajoutez une entree dans le tableau positions :

{ job = "police", pos = vector3(440.0, -981.0, 30.7), heading = 0.0 },

Le PED n’est visible que par les joueurs ayant le grade requis pour le job correspondant. L’acces aux comptes societe est egalement disponible depuis les banques et ATM (onglet societe).

Override de grades par job

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

Si un job n’a pas d’override, les defaultGrades sont utilises.

Score de credit

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

Table des rewards

Niveaux de compte

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,
    },
}

Comparaison Standard vs Premium

Interets

Config.Interest = {
    interval = 60,       -- minutes entre chaque cycle de cron
    resetPeriod = 1440,  -- minutes avant reinitialisation du cap d'interets (24h)
}

Les interets ne sont credites qu’aux joueurs connectes (online-only by design).

Taxation progressive

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 },
    },
}

Fonctionnement par tranches

La taxation est progressive : chaque portion du montant est taxee au taux de sa tranche.

Exemple : Un depot de $60 000 avec la configuration par defaut :

Important : Les tranches doivent etre contigues et ordonnees. Les operations de societe, les comptes joints, l’epargne et la crypto sont exempts de taxation.

Les comptes Premium beneficient d’une reduction de 25% sur les taxes (configurable via taxReduction).

Comptes joints

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

Les comptes joints sont accessibles uniquement en banque (pas depuis les ATM). Ils ne sont pas soumis a la taxation, aux interets ni au score de credit.

Notifications telephone

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",
}

Events disponibles

Webhook Discord

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

Toutes les operations sont loguees : depots, retraits, virements, operations societe, comptes joints, epargne et crypto.

Epargne

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" },
    },
}

Options de placement a terme

L’epargne est accessible uniquement en banque (pas depuis les ATM). Les interets sont calcules par un cron separe, online-only. L’epargne est exemptee de taxation.

Crypto

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,
}

Ajouter une cryptomonnaie

Ajoutez une entree dans le tableau coins :

{ id = "dogecoin", symbol = "DOGE", label = "Dogecoin" },

L’identifiant id doit correspondre au slug utilise par l’API configuree (apiSource). Le crypto est accessible uniquement en banque. Les trades sont exempts de taxation.