Configuracion — foltone_banking

Toda la configuracion se realiza en config.lua en la raiz del script.

Idioma

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

Las traducciones se encuentran en la carpeta locales/. Puedes agregar tu propio idioma creando un nuevo archivo (por ejemplo, locales/de.lua) y configurando Config.Locale = "de".

Framework

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

Modo de Interaccion

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

Configuracion de IBAN y Cuenta

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

Configuracion de Cajeros Automaticos

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

Nota: Las cuentas conjuntas, ahorros y criptomonedas no estan disponibles en cajeros automaticos (solo en bancos).

Configuracion del Banco

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

Sistema de Tarjetas

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

Configuracion de Transferencias

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

Historial de Transacciones

Config.History = {
    perPage = 50,
}

Tema

Config.theme = {}

El tema por defecto es la Blue Edition (Sistema de Diseno Cyber Street). La tabla theme esta vacia por defecto, lo que aplica el esquema de colores azul incorporado. Puedes personalizar variables CSS especificas agregando pares clave-valor a esta tabla.

Nota: El sistema de diseno utiliza acentos en azul electrico, fondos de panel oscuros y tres familias tipograficas (Bebas Neue, Rajdhani, JetBrains Mono). No uses colores dorado, naranja, morado o cian.

Notificaciones

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

Reemplaza esta funcion con tu sistema de notificaciones preferido (por ejemplo, okokNotify, ox_lib, etc.). Esta es una funcion del lado del cliente.

Texto en Pantalla

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

Personaliza la visualizacion del texto de ayuda que se muestra cuando el jugador esta cerca de un punto de interaccion (usado con el modo de interaccion "drawtext").

Configuracion de Sociedad / Cuenta de Trabajo

Config.Society = {
    defaultGrades = {"boss", "manager"},
    jobs = {
        -- Configuracion por trabajo:
        -- ["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,
}

Funciones

Configuracion de Grados por Trabajo

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

Si un trabajo no esta listado en jobs, se utiliza la lista defaultGrades.

Puntuacion Crediticia

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

Acciones de Recompensa

Niveles de Cuenta

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

Nivel Standard

Nivel Premium

Sistema de Intereses

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

Los intereses solo se calculan para jugadores en linea. La tasa real esta modulada por la puntuacion crediticia del jugador y limitada por su nivel de cuenta.

Tributacion Progresiva

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

Cada tipo de operacion (deposit, withdraw, transfer) tiene su propio conjunto de tramos fiscales.

Como Funcionan los Tramos

Los impuestos se calculan progresivamente a traves de los tramos. Por ejemplo, un deposito de $30,000 con la configuracion por defecto:

• $0 a $10,000: 0% de impuesto = $0
• $10,000 a $30,000: 2% de impuesto = $400
• Impuesto total: $400

Importante: Los tramos deben ser contiguos y estar ordenados. Las operaciones de sociedad, cuentas conjuntas, ahorros y criptomonedas estan exentas de tributacion. Las cuentas Premium reciben una reduccion de impuestos del 25%.

Configuracion de Cuentas Conjuntas

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

Las cuentas conjuntas solo son accesibles en bancos (no en cajeros automaticos). Estan exentas de tributacion, intereses y cambios de puntuacion crediticia.

Notificaciones por Telefono

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

Eventos de Notificacion

Las notificaciones por telefono solo se envian a jugadores en linea.

Webhook de Discord

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

Todas las operaciones bancarias (personales, de sociedad, conjuntas, ahorros, criptomonedas) se registran en el webhook. El webhook utiliza un enfoque de enviar y olvidar.

Cuenta de Ahorro

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

Opciones de Deposito a Plazo Fijo

Las cuentas de ahorro tienen un cron de intereses separado de la cuenta corriente principal. Los intereses son solo para jugadores en linea con un limite configurable.

Trading de Criptomonedas

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

Configuracion de Monedas

Los precios se obtienen del lado del servidor mediante sv_crypto_prices.lua y se transmiten a todos los clientes conectados. El servidor mantiene una cache para minimizar las llamadas a la API. Las operaciones con criptomonedas estan exentas de tributacion.