Inicio › Documentación › Configuración · origen_banking

Configuración · origen_banking

Toda la configuración está en config/main.lua. Los valores exclusivos del servidor están en config/server/webhooks.lua.

General

Variable	Por defecto	Descripción
`Config.Debug`	`false`	Imprime la salida de depuración en la consola del servidor
`Config.Language`	`'en'`	Idioma del recurso — `'es'` o `'en'`
`Config.MaxAccounts`	`3`	Número máximo de cuentas que puede tener un jugador

Config.Framework se detecta automáticamente en init.lua. No lo sobrescribas en el fichero de configuración.

IBAN

Los ID de cuenta se generan como IBANPrefix seguido de dígitos aleatorios, hasta completar IBANLength caracteres en total.

Variable	Por defecto	Descripción
`Config.IBANPrefix`	`''`	Prefijo que se antepone a cada ID de cuenta generado
`Config.IBANLength`	`16`	Longitud total del ID de cuenta, incluido el prefijo

Bancos

Cada entrada crea un punto de interacción bancario físico con su blip.

Campo	Tipo	Descripción
`coords`	`vector3`	Obligatorio. Posición del punto de interacción del banco
`isCentral`	`boolean`	Opcional, por defecto `false`. Si es `true`, los jugadores pueden crear nuevas cuentas compartidas desde esta sucursal
`label`	`string`	Opcional. Texto que se muestra en el blip

lua

Config.Banks = {
    { coords = vector3(150.266, -1040.203, 29.374),  isCentral = false, label = 'Banco - Legion Square' },
    { coords = vector3(-1212.980, -330.841, 37.787), isCentral = false, label = 'Banco - Pillbox Hill' },
    { coords = vector3(-2962.582, 482.627, 15.703),  isCentral = false, label = 'Banco - Del Perro' },
    { coords = vector3(314.187, -278.621, 54.170),   isCentral = false, label = 'Banco - Alta Street' },
    { coords = vector3(-112.202, 6469.295, 31.626),  isCentral = true,  label = 'Banco Central - Paleto Bay' },
    { coords = vector3(246.727, 223.705, 106.286),   isCentral = true,  label = 'Banco Central - Vinewood Hills' },
    { coords = vector3(1830.41, 3850.33, 35.89),     isCentral = false, label = 'Banco - Sandy' },
    { coords = vector3(-351.04, -49.71, 49.04),      isCentral = false, label = 'Banco - Rockford Hills' },
}

Marcador

Marcador que se dibuja en cada punto de interacción bancario.

lua

Config.Marker = {
    type = 20,
    color = {0, 0, 0, 200},
    size = vector3(0.3, 0.3, -0.3),
    coords = vector3(0.0, 0.0, 1.0),
    bobUpAndDown = false,
    faceCamera = false,
    rotate = true,
}

Cajeros

Los props de cajero se detectan automáticamente por modelo; no tienen blips.

Variable	Por defecto	Descripción
`Config.ATM.Models`	`prop_atm_01`, `prop_atm_02`, `prop_atm_03`, `prop_fleeca_atm`	Modelos de prop que se tratan como cajeros
`Config.ATM.DetectRadius`	`1.5`	Distancia en metros para mostrar la interfaz de texto y permitir la interacción
`Config.ATM.ShowSharedAccounts`	`true`	Si es `true`, las cuentas compartidas (trabajo, banda, sociedad) a las que el jugador tiene acceso también se pueden usar desde un cajero

Límites de los cajeros

Los límites se aplican por cuenta, por ciclo y solo en el canal de cajeros. Las sucursales bancarias no tienen límite.

Variable	Por defecto	Descripción
`Config.ATM.Limits.Enabled`	`true`	Activa el sistema de límites por ciclo
`Config.ATM.Limits.ResetMinutes`	`20`	Minutos reales antes de que se reinicie un ciclo y los límites vuelvan a cero
`Config.ATM.Limits.WithdrawPerCycle`	`50000`	Máximo que se puede retirar por cuenta y ciclo
`Config.ATM.Limits.DepositPerCycle`	`50000`	Máximo que se puede ingresar por cuenta y ciclo

Los límites se guardan en memoria caché. Reiniciar el recurso o el servidor pone todos los contadores a cero.

Préstamos

Toda la validación (importes, plazos, elegibilidad y fondos del banco) se hace en el servidor. La interfaz solo simula y muestra; nunca decide.

Aprobación

Variable	Por defecto	Descripción
`Config.Loans.Enabled`	`true`	Activa el sistema de préstamos
`Config.Loans.AutoApproveUnder`	`25000`	Los préstamos de esta cantidad o menos se aprueban al instante; por encima pasan a la cola manual
`Config.Loans.ApprovalJob`	`'banker'`	Trabajo autorizado a aprobar préstamos, siempre que su rango sea al menos `ApprovalGrade`
`Config.Loans.ApprovalGrade`	`2`	Rango mínimo del trabajo necesario para aprobar
`Config.Loans.ApprovalAce`	`'origen_banking.approve'`	Permiso ACE que también concede derechos de aprobación
`Config.Loans.ApprovalCommand`	`'loansadmin'`	Comando de chat que abre la NUI en la cola de aprobación. Pon `''` para desactivarlo

Límites globales

Variable	Por defecto	Descripción
`Config.Loans.MaxActiveLoans`	`2`	Préstamos activos simultáneos por jugador, incluidos los pendientes
`Config.Loans.MinAmount`	`1000`	Importe mínimo global de un préstamo
`Config.Loans.BlockIfOverdue`	`true`	Bloquea los préstamos nuevos mientras el jugador tenga uno vencido

Penalizaciones

Variable	Por defecto	Descripción
`Config.Loans.Penalty.Enabled`	`true`	Activa las penalizaciones por pago tardío
`Config.Loans.Penalty.RatePerMiss`	`5.0`	Porcentaje adicional que se suma a la cuota por cada pago fallido
`Config.Loans.Penalty.MaxMisses`	`3`	Fallos permitidos antes de que el préstamo se marque como `defaulted` y se dispare el evento de garantía

Amortización anticipada

Variable	Por defecto	Descripción
`Config.Loans.EarlyPayoff.Enabled`	`true`	Permite saldar el préstamo antes de plazo
`Config.Loans.EarlyPayoff.InterestRebate`	`50`	Porcentaje de los intereses restantes que se perdona al amortizar anticipadamente

Tipos de préstamo

Campo	Descripción
`label`	Nombre que se muestra en la interfaz
`interestRate`	Porcentaje total de interés
`minAmount` / `maxAmount`	Rango permitido del principal
`allowedTerms`	Array con los números de cuotas permitidos
`frequency`	Días entre cuotas
`requiresCollateral`	Exige una referencia a un bien (matrícula, ID de propiedad)
`forceManualApproval`	Envía siempre el préstamo a la cola manual, ignorando `AutoApproveUnder`

lua

Config.Loans.Types = {
    personal = {
        label              = 'Personal',
        interestRate       = 12.0,
        minAmount          = 1000,
        maxAmount          = 50000,
        allowedTerms       = { 6, 12, 24 },
        frequency          = 7,
        requiresCollateral = false,
    },
    mortgage = {
        label               = 'Mortgage / Vehicle',
        interestRate        = 6.0,
        minAmount           = 25000,
        maxAmount           = 500000,
        allowedTerms        = { 24, 48, 96 },
        frequency           = 7,
        requiresCollateral  = true,
        forceManualApproval = true,
    },
}

Proveedores del bridge

Se definen en init.lua. Usa "auto" para detectar el recurso activo, o fuerza un proveedor concreto por su nombre.

lua

BridgeConfig.HelpText  = "auto"
BridgeConfig.Notify    = "auto"
BridgeConfig.Inventory = "auto"

Webhooks

Fichero: config/server/webhooks.lua

lua

Config.Webhook = {
    banking = "YOUR_DISCORD_WEBHOOK_URL"
}